From: Wolfgang Bangerth Date: Fri, 19 Feb 2021 18:17:39 +0000 (-0700) Subject: Rename the write/update particle functions. X-Git-Tag: v9.3.0-rc1~410^2 X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=4a04c6b5b542f50332d09e0ad0e61feb5343982e;p=dealii.git Rename the write/update particle functions. Give these functions a more systematic name. While also adjust to a more widely used idiom: A function that takes a pointer doesn't return the updated pointer location via that argument, but instead as an explicit return value. This idiom is in fact used just a couple of lines below the places where these functions are currently used in particle_handler.cc. --- diff --git a/include/deal.II/particles/particle.h b/include/deal.II/particles/particle.h index a42bdb9889..9514fe6490 100644 --- a/include/deal.II/particles/particle.h +++ b/include/deal.II/particles/particle.h @@ -187,17 +187,18 @@ namespace Particles * and later de-serializing the properties by calling the appropriate * constructor Particle(void *&data, PropertyPool *property_pool = nullptr); * - * @param [in,out] data The memory location to write particle data - * into. This pointer points to the begin of the memory, in which the - * data will be written and it will be advanced by the serialized size - * of this particle. + * @param [in] data The memory location to write particle data + * into. + * + * @return A pointer to the next byte after the array to which data has + * been written. */ - void - write_data(void *&data) const; + void * + write_particle_data_to_memory(void *data) const; /** - * Update all of the data associated with a particle : id, + * Update all of the data associated with a particle: id, * location, reference location and, if any, properties by using a * data array. The array is expected to be large enough to take the data, * and the void pointer should point to the first entry of the array to @@ -206,13 +207,15 @@ namespace Particles * class be built. This is used in the ParticleHandler to update the * ghost particles without de-allocating and re-allocating memory. * - * @param[in,out] data A pointer to a memory location from which + * @param[in] data A pointer to a memory location from which * to read the information that completely describes a particle. This - * class then de-serializes its data from this memory location and - * advance the pointer accordingly. + * class then de-serializes its data from this memory location. + * + * @return A pointer to the next byte after the array from which data has + * been read. */ - void - update_particle_data(const void *&data); + const void * + read_particle_data_from_memory(const void *data); /** * Set the location of this particle. Note that this does not check diff --git a/include/deal.II/particles/particle_accessor.h b/include/deal.II/particles/particle_accessor.h index b5d271a690..cd9d07d163 100644 --- a/include/deal.II/particles/particle_accessor.h +++ b/include/deal.II/particles/particle_accessor.h @@ -44,20 +44,17 @@ namespace Particles { public: /** - * Write particle data into a data array. The array is expected - * to be large enough to take the data, and the void pointer should - * point to the first element in which the data should be written. This - * function is meant for serializing all particle properties and - * afterwards de-serializing the properties by calling the appropriate - * constructor Particle(void *&data, PropertyPool *property_pool = nullptr); - * - * @param [in,out] data The memory location to write particle data - * into. This pointer points to the begin of the memory, in which the - * data will be written and it will be advanced by the serialized size - * of this particle. + * @copydoc Particle::write_particle_data_to_memory */ - void - write_data(void *&data) const; + void * + write_particle_data_to_memory(void *data) const; + + + /** + * @copydoc Particle::read_particle_data_from_memory + */ + const void * + read_particle_data_from_memory(const void *data); /** * Set the location of this particle. Note that this does not check @@ -316,12 +313,25 @@ namespace Particles template - inline void - ParticleAccessor::write_data(void *&data) const + inline const void * + ParticleAccessor::read_particle_data_from_memory( + const void *data) + { + Assert(particle != map->end(), ExcInternalError()); + + return particle->second.read_particle_data_from_memory(data); + } + + + + template + inline void * + ParticleAccessor::write_particle_data_to_memory( + void *data) const { Assert(particle != map->end(), ExcInternalError()); - particle->second.write_data(data); + return particle->second.write_particle_data_to_memory(data); } diff --git a/source/particles/particle.cc b/source/particles/particle.cc index 9dc5cb1571..923ccc9dfe 100644 --- a/source/particles/particle.cc +++ b/source/particles/particle.cc @@ -215,23 +215,25 @@ namespace Particles template - void - Particle::write_data(void *&data) const + void * + Particle::write_particle_data_to_memory( + void *data_pointer) const { - types::particle_index *id_data = static_cast(data); - *id_data = get_id(); + types::particle_index *id_data = + static_cast(data_pointer); + *id_data = get_id(); ++id_data; double *pdata = reinterpret_cast(id_data); - // Write location data + // Write location for (unsigned int i = 0; i < spacedim; ++i, ++pdata) *pdata = get_location()[i]; - // Write reference location data + // Write reference location for (unsigned int i = 0; i < dim; ++i, ++pdata) *pdata = get_reference_location()[i]; - // Write property data + // Write properties if (has_properties()) { const ArrayView particle_properties = @@ -240,17 +242,18 @@ namespace Particles *pdata = particle_properties[i]; } - data = static_cast(pdata); + return static_cast(pdata); } template - void - Particle::update_particle_data(const void *&data) + const void * + Particle::read_particle_data_from_memory( + const void *data_pointer) { const types::particle_index *id_data = - static_cast(data); + static_cast(data_pointer); set_id(*id_data++); const double *pdata = reinterpret_cast(id_data); @@ -274,7 +277,7 @@ namespace Particles particle_properties[i] = *pdata++; } - data = static_cast(pdata); + return static_cast(pdata); } diff --git a/source/particles/particle_handler.cc b/source/particles/particle_handler.cc index 4926f52ce3..c69838d84a 100644 --- a/source/particles/particle_handler.cc +++ b/source/particles/particle_handler.cc @@ -42,12 +42,14 @@ namespace Particles for (const auto &particle : particles) { - particle.write_data(current_data); + current_data = particle.write_particle_data_to_memory(current_data); } return buffer; } + + template std::vector> unpack_particles( @@ -1392,7 +1394,8 @@ namespace Particles memcpy(data, &cellid, cellid_size); data = static_cast(data) + cellid_size; - particles_to_send.at(neighbors[i])[j]->write_data(data); + data = particles_to_send.at(neighbors[i])[j] + ->write_particle_data_to_memory(data); if (store_callback) data = store_callback(particles_to_send.at(neighbors[i])[j], data); @@ -1596,7 +1599,7 @@ namespace Particles for (const auto i : neighbors) for (const auto &p : particles_to_send.at(i)) { - p->write_data(data); + data = p->write_particle_data_to_memory(data); if (store_callback) data = store_callback(p, data); } @@ -1659,7 +1662,8 @@ namespace Particles { // Update particle data using previously allocated memory space // for efficiency reasons - recv_particle->second.update_particle_data(recv_data_it); + recv_data_it = + recv_particle->second.read_particle_data_from_memory(recv_data_it); if (load_callback) recv_data_it = @@ -1874,6 +1878,8 @@ namespace Particles return pack_particles(stored_particles_on_cell); } + + template void ParticleHandler::load_particles( diff --git a/tests/particles/particle_04.cc b/tests/particles/particle_04.cc index 6f0262ddd1..c2a7edc94a 100644 --- a/tests/particles/particle_04.cc +++ b/tests/particles/particle_04.cc @@ -59,7 +59,7 @@ test() std::vector data(particle.serialized_size_in_bytes()); void * write_pointer = static_cast(&data.front()); - particle.write_data(write_pointer); + write_pointer = particle.write_particle_data_to_memory(write_pointer); const void *read_pointer = static_cast(&data.front()); const Particles::Particle new_particle(read_pointer); diff --git a/tests/particles/particle_06.cc b/tests/particles/particle_06.cc index 4fbe6149d2..0069ad6c5b 100644 --- a/tests/particles/particle_06.cc +++ b/tests/particles/particle_06.cc @@ -70,7 +70,7 @@ test() std::vector data(particle.serialized_size_in_bytes()); void * write_pointer = static_cast(&data.front()); - particle.write_data(write_pointer); + write_pointer = particle.write_particle_data_to_memory(write_pointer); const void *read_pointer = static_cast(&data.front()); const Particles::Particle new_particle(read_pointer, &pool);