ASPECT
Public Member Functions | Static Public Member Functions | Private Attributes | List of all members
aspect::TimeStepping::Manager< dim > Class Template Reference
Inheritance diagram for aspect::TimeStepping::Manager< dim >:
Inheritance graph
[legend]

Public Member Functions

void initialize_simulator (const Simulator< dim > &simulator_object) override
 
void update () override
 
double get_next_time_step_size () const
 
bool should_repeat_time_step () const
 
bool should_refine_mesh () const
 
bool need_checkpoint_on_terminate () const
 
bool should_simulation_terminate_now () const
 
void parse_parameters (ParameterHandler &prm) override
 
- Public Member Functions inherited from aspect::Plugins::ManagerBase< Interface< dim > >
 ~ManagerBase () override
 
void update () override
 
bool has_matching_active_plugin () const
 
const PluginType & get_matching_active_plugin () const
 
const std::list< std::unique_ptr< Interface< dim > > > & get_active_plugins () const
 
const std::vector< std::string > & get_active_plugin_names () const
 
- Public Member Functions inherited from aspect::Plugins::InterfaceBase
virtual ~InterfaceBase ()=default
 
virtual void initialize ()
 
- Public Member Functions inherited from aspect::SimulatorAccess< dim >
 SimulatorAccess ()
 
 SimulatorAccess (const Simulator< dim > &simulator_object)
 
virtual ~SimulatorAccess ()=default
 
const Introspection< dim > & introspection () const
 
const Simulator< dim > & get_simulator () const
 
const Parameters< dim > & get_parameters () const
 
SimulatorSignals< dim > & get_signals () const
 
MPI_Comm get_mpi_communicator () const
 
TimerOutput & get_computing_timer () const
 
const ConditionalOStream & get_pcout () const
 
double get_time () const
 
double get_timestep () const
 
double get_old_timestep () const
 
unsigned int get_timestep_number () const
 
const TimeStepping::Manager< dim > & get_timestepping_manager () const
 
unsigned int get_nonlinear_iteration () const
 
const parallel::distributed::Triangulation< dim > & get_triangulation () const
 
double get_volume () const
 
const Mapping< dim > & get_mapping () const
 
std::string get_output_directory () const
 
bool include_adiabatic_heating () const
 
bool include_latent_heat () const
 
bool include_melt_transport () const
 
int get_stokes_velocity_degree () const
 
double get_adiabatic_surface_temperature () const
 
double get_surface_pressure () const
 
bool convert_output_to_years () const
 
unsigned int get_pre_refinement_step () const
 
unsigned int n_compositional_fields () const
 
double get_end_time () const
 
void get_refinement_criteria (Vector< float > &estimated_error_per_cell) const
 
void get_artificial_viscosity (Vector< float > &viscosity_per_cell, const bool skip_interior_cells=false) const
 
void get_artificial_viscosity_composition (Vector< float > &viscosity_per_cell, const unsigned int compositional_variable) const
 
const LinearAlgebra::BlockVectorget_current_linearization_point () const
 
const LinearAlgebra::BlockVectorget_solution () const
 
const LinearAlgebra::BlockVectorget_old_solution () const
 
const LinearAlgebra::BlockVectorget_old_old_solution () const
 
const LinearAlgebra::BlockVectorget_reaction_vector () const
 
const LinearAlgebra::BlockVectorget_mesh_velocity () const
 
const DoFHandler< dim > & get_dof_handler () const
 
const FiniteElement< dim > & get_fe () const
 
const LinearAlgebra::BlockSparseMatrixget_system_matrix () const
 
const LinearAlgebra::BlockSparseMatrixget_system_preconditioner_matrix () const
 
const MaterialModel::Interface< dim > & get_material_model () const
 
const GravityModel::Interface< dim > & get_gravity_model () const
 
const InitialTopographyModel::Interface< dim > & get_initial_topography_model () const
 
const GeometryModel::Interface< dim > & get_geometry_model () const
 
const AdiabaticConditions::Interface< dim > & get_adiabatic_conditions () const
 
bool has_boundary_temperature () const
 
const BoundaryTemperature::Manager< dim > & get_boundary_temperature_manager () const
 
const BoundaryHeatFlux::Interface< dim > & get_boundary_heat_flux () const
 
bool has_boundary_composition () const
 
const BoundaryComposition::Manager< dim > & get_boundary_composition_manager () const
 
const BoundaryTraction::Manager< dim > & get_boundary_traction_manager () const
 
std::shared_ptr< const InitialTemperature::Manager< dim > > get_initial_temperature_manager_pointer () const
 
const InitialTemperature::Manager< dim > & get_initial_temperature_manager () const
 
std::shared_ptr< const InitialComposition::Manager< dim > > get_initial_composition_manager_pointer () const
 
const InitialComposition::Manager< dim > & get_initial_composition_manager () const
 
const std::set< types::boundary_id > & get_fixed_temperature_boundary_indicators () const
 
const std::set< types::boundary_id > & get_fixed_heat_flux_boundary_indicators () const
 
const std::set< types::boundary_id > & get_fixed_composition_boundary_indicators () const
 
const std::set< types::boundary_id > & get_mesh_deformation_boundary_indicators () const
 
const BoundaryVelocity::Manager< dim > & get_boundary_velocity_manager () const
 
const HeatingModel::Manager< dim > & get_heating_model_manager () const
 
const MeshRefinement::Manager< dim > & get_mesh_refinement_manager () const
 
const MeltHandler< dim > & get_melt_handler () const
 
const VolumeOfFluidHandler< dim > & get_volume_of_fluid_handler () const
 
const NewtonHandler< dim > & get_newton_handler () const
 
const MeshDeformation::MeshDeformationHandler< dim > & get_mesh_deformation_handler () const
 
const LateralAveraging< dim > & get_lateral_averaging () const
 
const AffineConstraints< double > & get_current_constraints () const
 
bool simulator_is_past_initialization () const
 
double get_pressure_scaling () const
 
bool pressure_rhs_needs_compatibility_modification () const
 
bool model_has_prescribed_stokes_solution () const
 
TableHandler & get_statistics_object () const
 
const Postprocess::Manager< dim > & get_postprocess_manager () const
 
unsigned int n_particle_worlds () const
 
const Particle::World< dim > & get_particle_world (const unsigned int particle_world_index) const
 
Particle::World< dim > & get_particle_world (const unsigned int particle_world_index)
 
bool is_stokes_matrix_free ()
 
const StokesMatrixFreeHandler< dim > & get_stokes_matrix_free () const
 
RotationProperties< dim > compute_net_angular_momentum (const bool use_constant_density, const LinearAlgebra::BlockVector &solution, const bool limit_to_top_faces=false) const
 

Static Public Member Functions

static void declare_parameters (ParameterHandler &prm)
 
static void write_plugin_graph (std::ostream &output_stream)
 
static void register_time_stepping_model (const std::string &name, const std::string &description, void(*declare_parameters_function)(ParameterHandler &), std::unique_ptr< Interface< dim >>(*factory_function)())
 
- Static Public Member Functions inherited from aspect::Plugins::InterfaceBase
static void declare_parameters (ParameterHandler &prm)
 
- Static Public Member Functions inherited from aspect::SimulatorAccess< dim >
static void get_composition_values_at_q_point (const std::vector< std::vector< double >> &composition_values, const unsigned int q, std::vector< double > &composition_values_at_q_point)
 

Private Attributes

Reaction current_reaction
 
double next_time_step_size
 
double minimum_time_step_size
 
bool do_checkpoint_on_terminate
 
TerminationCriteria::Manager< dim > termination_manager
 

Additional Inherited Members

- Protected Attributes inherited from aspect::Plugins::ManagerBase< Interface< dim > >
std::list< std::unique_ptr< Interface< dim > > > plugin_objects
 
std::vector< std::string > plugin_names
 

Detailed Description

template<int dim>
class aspect::TimeStepping::Manager< dim >

A class to handle computation of the next time step (as desired by the user) and checking if the simulation is finished.

Definition at line 148 of file simulator_access.h.

Member Function Documentation

§ initialize_simulator()

template<int dim>
void aspect::TimeStepping::Manager< dim >::initialize_simulator ( const Simulator< dim > &  simulator_object)
overridevirtual

Override initialize_simulator() so that we can also initialize the contained termination_manager.

Reimplemented from aspect::SimulatorAccess< dim >.

§ update()

template<int dim>
void aspect::TimeStepping::Manager< dim >::update ( )
overridevirtual

Update the current state and determine what needs to happen based on the last computed solution (see functions below). This computes the size of the next time step potentially taking into account the current solution (convection time step, conduction time step), settings from parameters, and termination criteria (to hit the end time exactly).

Reimplemented from aspect::Plugins::InterfaceBase.

§ get_next_time_step_size()

template<int dim>
double aspect::TimeStepping::Manager< dim >::get_next_time_step_size ( ) const

Return the next step size as computed from update().

§ should_repeat_time_step()

template<int dim>
bool aspect::TimeStepping::Manager< dim >::should_repeat_time_step ( ) const

If true, a plugin requested to redo the last computed time step. Updated when calling update().

§ should_refine_mesh()

template<int dim>
bool aspect::TimeStepping::Manager< dim >::should_refine_mesh ( ) const

If true, execute a mesh refinement step now (potentially before repeating the current time step).

§ need_checkpoint_on_terminate()

template<int dim>
bool aspect::TimeStepping::Manager< dim >::need_checkpoint_on_terminate ( ) const

If true, the simulator should perform a checkpoint before terminating.

§ should_simulation_terminate_now()

template<int dim>
bool aspect::TimeStepping::Manager< dim >::should_simulation_terminate_now ( ) const

Check if the simulation is ready to terminate successfully.

§ declare_parameters()

template<int dim>
static void aspect::TimeStepping::Manager< dim >::declare_parameters ( ParameterHandler &  prm)
static

Declare the parameters of all known termination criteria plugins, as well as of ones this class has itself.

§ parse_parameters()

template<int dim>
void aspect::TimeStepping::Manager< dim >::parse_parameters ( ParameterHandler &  prm)
overridevirtual

Read the parameters this class declares from the parameter file. This determines which termination criteria objects will be created; then let these objects read their parameters as well.

Reimplemented from aspect::Plugins::InterfaceBase.

§ write_plugin_graph()

template<int dim>
static void aspect::TimeStepping::Manager< dim >::write_plugin_graph ( std::ostream &  output_stream)
static

For the current plugin subsystem, write a connection graph of all of the plugins we know about, in the format that the programs dot and neato understand. This allows for a visualization of how all of the plugins that ASPECT knows about are interconnected, and connect to other parts of the ASPECT code.

Parameters
output_streamThe stream to write the output to.

§ register_time_stepping_model()

template<int dim>
static void aspect::TimeStepping::Manager< dim >::register_time_stepping_model ( const std::string &  name,
const std::string &  description,
void(*)(ParameterHandler &)  declare_parameters_function,
std::unique_ptr< Interface< dim >>(*)()  factory_function 
)
static

A function that is used to register time stepping model objects in such a way that the Manager can deal with all of them without having to know them by name. This allows the files in which individual plugins are implemented to register these plugins, rather than also having to modify the Manager class by adding the new plugin class.

Parameters
nameA string that identifies the model
descriptionA text description of what this model does and that will be listed in the documentation of the parameter file.
declare_parameters_functionA pointer to a function that can be used to declare the parameters that this model wants to read from input files.
factory_functionA pointer to a function that can create an object of this model.

Member Data Documentation

§ current_reaction

template<int dim>
Reaction aspect::TimeStepping::Manager< dim >::current_reaction
private

The current Reaction computed by update().

Definition at line 236 of file interface.h.

§ next_time_step_size

template<int dim>
double aspect::TimeStepping::Manager< dim >::next_time_step_size
private

The next time step size computed by update().

Definition at line 241 of file interface.h.

§ minimum_time_step_size

template<int dim>
double aspect::TimeStepping::Manager< dim >::minimum_time_step_size
private

The minimum time step size specified by the user (in seconds).

Definition at line 246 of file interface.h.

§ do_checkpoint_on_terminate

template<int dim>
bool aspect::TimeStepping::Manager< dim >::do_checkpoint_on_terminate
private

Whether to do a final checkpoint before termination. This is specified in the parameters.

Definition at line 252 of file interface.h.

§ termination_manager

template<int dim>
TerminationCriteria::Manager<dim> aspect::TimeStepping::Manager< dim >::termination_manager
private

The termination manager keeps track of the termination plugins and we use it to determine the time_step size in the final time step.

Definition at line 258 of file interface.h.


The documentation for this class was generated from the following files: