From 123b5a4646348edb68872d9bca7956415d8823ec Mon Sep 17 00:00:00 2001 From: Wolfgang Bangerth Date: Thu, 18 Jul 2024 18:04:05 -0600 Subject: [PATCH] Link to step-83. --- include/deal.II/base/discrete_time.h | 5 ++++- include/deal.II/grid/tria.h | 2 ++ include/deal.II/particles/particle_handler.h | 14 +++++++++----- 3 files changed, 15 insertions(+), 6 deletions(-) diff --git a/include/deal.II/base/discrete_time.h b/include/deal.II/base/discrete_time.h index bb74b434eb..b7dc64c092 100644 --- a/include/deal.II/base/discrete_time.h +++ b/include/deal.II/base/discrete_time.h @@ -25,7 +25,8 @@ DEAL_II_NAMESPACE_OPEN * $T_{\text{start}}$ to an end time $T_{\text{end}}$. It also allows adjusting * the time step size during the simulation. This class provides the necessary * interface to be incorporated in any time-dependent simulation. - * The usage of this class is demonstrated in step-19 and step-21. + * The usage of this class is demonstrated in step-19 (and step-83) as well as + * step-21. * * This class provides a number of invariants that are guaranteed to be * true at all times. @@ -404,6 +405,8 @@ public: * Write or read the data of this object to or from a stream for the purpose * of serialization using the [BOOST serialization * library](https://www.boost.org/doc/libs/1_74_0/libs/serialization/doc/index.html). + * + * This function is used in step-83. */ template void diff --git a/include/deal.II/grid/tria.h b/include/deal.II/grid/tria.h index 3effb34c56..d5eb9e8a7e 100644 --- a/include/deal.II/grid/tria.h +++ b/include/deal.II/grid/tria.h @@ -3672,6 +3672,8 @@ public: * Write and read the data of this object from a stream for the purpose * of serialization. using the [BOOST serialization * library](https://www.boost.org/doc/libs/1_74_0/libs/serialization/doc/index.html). + * + * This function is used in step-83. */ template void diff --git a/include/deal.II/particles/particle_handler.h b/include/deal.II/particles/particle_handler.h index c6fd1fde6c..4d9eada9bc 100644 --- a/include/deal.II/particles/particle_handler.h +++ b/include/deal.II/particles/particle_handler.h @@ -56,7 +56,7 @@ namespace Particles * * For examples on how to use this class to track particles, store properties * on particles, and let the properties on the particles influence the - * finite-element solution see step-19, step-68, and step-70. + * finite-element solution see step-19, step-68, step-70, and step-83. */ template class ParticleHandler : public Subscriptor @@ -821,6 +821,8 @@ namespace Particles /** * Serialize the contents of this class using the [BOOST serialization * library](https://www.boost.org/doc/libs/1_74_0/libs/serialization/doc/index.html). + * + * This function is used in step-83. */ template void @@ -1321,13 +1323,15 @@ namespace Particles inline void ParticleHandler::serialize(Archive &ar, const unsigned int) { - // Note that we do not serialize the particle data itself. Instead we + // Note that we do not serialize the particle data itself (i.e., the + // 'particles' member variable). Instead we // use the serialization functionality of the triangulation class, because // this guarantees that data is immediately shipped to new processes if // the domain is distributed differently after resuming from a checkpoint. - ar //&particles - &global_number_of_particles &global_max_particles_per_cell - &next_free_particle_index; + // + // See step-83 for how to serialize ParticleHandler objects. + ar &global_number_of_particles &global_max_particles_per_cell + &next_free_particle_index; } -- 2.39.5