aspect::Postprocess::Interface< dim > Class Template Reference

Inherits aspect::Plugins::InterfaceBase.

Inherited by aspect::Postprocess::BasicStatistics< dim >, aspect::Postprocess::BoundaryDensities< dim >, aspect::Postprocess::BoundaryPressures< dim >, aspect::Postprocess::BoundaryStrainRateResidualStatistics< dim >, aspect::Postprocess::BoundaryVelocityResidualStatistics< dim >, aspect::Postprocess::Command< dim >, aspect::Postprocess::CompositionStatistics< dim >, aspect::Postprocess::CompositionVelocityStatistics< dim >, aspect::Postprocess::CoreStatistics< dim >, aspect::Postprocess::CrystalPreferredOrientation< dim >, aspect::Postprocess::CurrentSurface< dim >, aspect::Postprocess::DepthAverage< dim >, aspect::Postprocess::DomainVolume< dim >, aspect::Postprocess::DynamicTopography< dim >, aspect::Postprocess::EntropyStatistics< dim >, aspect::Postprocess::EntropyViscosityStatistics< dim >, aspect::Postprocess::FluidVelocityStatistics< dim >, aspect::Postprocess::Geoid< dim >, aspect::Postprocess::GlobalStatistics< dim >, aspect::Postprocess::GravityPointValues< dim >, aspect::Postprocess::HeatFluxDensities< dim >, aspect::Postprocess::HeatFluxMap< dim >, aspect::Postprocess::HeatFluxStatistics< dim >, aspect::Postprocess::HeatingStatistics< dim >, aspect::Postprocess::LoadBalanceStatistics< dim >, aspect::Postprocess::MassFluxStatistics< dim >, aspect::Postprocess::MaterialStatistics< dim >, aspect::Postprocess::MatrixStatistics< dim >, aspect::Postprocess::MaxDepthField< dim >, aspect::Postprocess::MeltStatistics< dim >, aspect::Postprocess::MemoryStatistics< dim >, aspect::Postprocess::MobilityStatistics< dim >, aspect::Postprocess::ODEStatistics< dim >, aspect::Postprocess::ParticleCountStatistics< dim >, aspect::Postprocess::ParticleDistributionScore< dim >, aspect::Postprocess::ParticleDistributionStatistics< dim >, aspect::Postprocess::Particles< dim >, aspect::Postprocess::PointValues< dim >, aspect::Postprocess::PressureStatistics< dim >, aspect::Postprocess::RotationStatistics< dim >, aspect::Postprocess::SeaLevel< dim >, aspect::Postprocess::SphericalVelocityStatistics< dim >, aspect::Postprocess::StokesResidual< dim >, aspect::Postprocess::TemperatureStatistics< dim >, aspect::Postprocess::TimingStatistics< dim >, aspect::Postprocess::Topography< dim >, aspect::Postprocess::VelocityBoundaryStatistics< dim >, aspect::Postprocess::VelocityStatistics< dim >, aspect::Postprocess::ViscousDissipationStatistics< dim >, aspect::Postprocess::Visualization< dim >, and aspect::Postprocess::VolumeOfFluidStatistics< dim >.

Public Member Functions
virtual std::pair< std::string, std::string >	execute (TableHandler &statistics)=0
virtual std::list< std::string >	required_other_postprocessors () const
Public Member Functions inherited from aspect::Plugins::InterfaceBase
virtual	~InterfaceBase ()=default
virtual void	initialize ()
virtual void	update ()
virtual void	parse_parameters (ParameterHandler &prm)
virtual void	save (std::map< std::string, std::string > &status_strings) const
virtual void	load (const std::map< std::string, std::string > &status_strings)

Additional Inherited Members
Static Public Member Functions inherited from aspect::Plugins::InterfaceBase
static void	declare_parameters (ParameterHandler &prm)

Detailed Description

template<int dim>
class aspect::Postprocess::Interface< dim >

This class declares the public interface of postprocessors. Postprocessors must implement a function that can be called at the end of each time step to evaluate the current solution, as well as functions that save the state of the object and restore it (for checkpoint/restart capabilities).

Access to the data of the simulator is granted by the protected member functions of the SimulatorAccess class, i.e., classes implementing this interface will in general want to derive from both this Interface class as well as from the SimulatorAccess class.

Definition at line 69 of file interface.h.

Member Function Documentation

execute()

template<int dim>

virtual std::pair<std::string,std::string> aspect::Postprocess::Interface< dim >::execute ( TableHandler &  statistics )

pure virtual

Execute this postprocessor. Derived classes will implement this function to do whatever they want to do to evaluate the solution at the current time step.

Parameters

[in,out]

statistics

An object that contains statistics that are collected throughout the simulation and that will be written to an output file at the end of each time step. Postprocessors may deposit data in these tables for later visualization or further processing.

Returns

A pair of strings that will be printed to the screen after running the postprocessor in two columns; typically the first column contains a description of what the data is and the second contains a numerical value of this data. If there is nothing to print, simply return two empty strings.

Implemented in aspect::Postprocess::Visualization< dim >, aspect::Postprocess::Particles< dim >, aspect::Postprocess::HeatFluxMap< dim >, aspect::Postprocess::CrystalPreferredOrientation< dim >, aspect::Postprocess::GravityPointValues< dim >, aspect::Postprocess::BoundaryVelocityResidualStatistics< dim >, aspect::Postprocess::BoundaryStrainRateResidualStatistics< dim >, aspect::Postprocess::GlobalStatistics< dim >, aspect::Postprocess::CoreStatistics< dim >, aspect::Postprocess::Command< dim >, aspect::Postprocess::LoadBalanceStatistics< dim >, aspect::Postprocess::StokesResidual< dim >, aspect::Postprocess::CurrentSurface< dim >, aspect::Postprocess::SeaLevel< dim >, aspect::Postprocess::BasicStatistics< dim >, aspect::Postprocess::PointValues< dim >, aspect::Postprocess::DepthAverage< dim >, aspect::Postprocess::ParticleDistributionStatistics< dim >, aspect::Postprocess::HeatFluxDensities< dim >, aspect::Postprocess::HeatFluxStatistics< dim >, aspect::Postprocess::EntropyStatistics< dim >, aspect::Postprocess::ParticleDistributionScore< dim >, aspect::Postprocess::ODEStatistics< dim >, aspect::Postprocess::MeltStatistics< dim >, aspect::Postprocess::TimingStatistics< dim >, aspect::Postprocess::HeatingStatistics< dim >, aspect::Postprocess::BoundaryDensities< dim >, aspect::Postprocess::BoundaryPressures< dim >, aspect::Postprocess::VelocityBoundaryStatistics< dim >, aspect::Postprocess::DomainVolume< dim >, aspect::Postprocess::MassFluxStatistics< dim >, aspect::Postprocess::MaterialStatistics< dim >, aspect::Postprocess::SphericalVelocityStatistics< dim >, aspect::Postprocess::ViscousDissipationStatistics< dim >, aspect::Postprocess::CompositionStatistics< dim >, aspect::Postprocess::CompositionVelocityStatistics< dim >, aspect::Postprocess::DynamicTopography< dim >, aspect::Postprocess::FluidVelocityStatistics< dim >, aspect::Postprocess::ParticleCountStatistics< dim >, aspect::Postprocess::RotationStatistics< dim >, aspect::Postprocess::VolumeOfFluidStatistics< dim >, aspect::Postprocess::EntropyViscosityStatistics< dim >, aspect::Postprocess::Geoid< dim >, aspect::Postprocess::MatrixStatistics< dim >, aspect::Postprocess::MaxDepthField< dim >, aspect::Postprocess::MemoryStatistics< dim >, aspect::Postprocess::MobilityStatistics< dim >, aspect::Postprocess::PressureStatistics< dim >, aspect::Postprocess::TemperatureStatistics< dim >, aspect::Postprocess::Topography< dim >, and aspect::Postprocess::VelocityStatistics< dim >.

required_other_postprocessors()

template<int dim>

virtual std::list<std::string> aspect::Postprocess::Interface< dim >::required_other_postprocessors ( ) const

virtual

A function that is used to indicate to the postprocessor manager which other postprocessor(s) the current one depends upon. The returned list contains the names (as strings, as you would write them in the input file) of the postprocessors it requires. The manager will ensure that these postprocessors are indeed used, even if they were not explicitly listed in the input file, and are indeed run before this postprocessor every time they are executed.

The default implementation of this function returns an empty list.

Note

This mechanism is intended to support postprocessors that do not want to recompute information that other postprocessors already compute (or could compute, if they were run – which we can ensure using the current function). To do so, a postprocessor of course needs to be able to access these other postprocessors. This can be done by deriving your postprocessor from SimulatorAccess, and then using the SimulatorAccess::get_postprocess_manager() function, followed by asking the resulting object via get_matching_active_plugin() for a specific postprocessor object.

Reimplemented in aspect::Postprocess::Visualization< dim >, aspect::Postprocess::CrystalPreferredOrientation< dim >, aspect::Postprocess::SeaLevel< dim >, aspect::Postprocess::DynamicTopography< dim >, aspect::Postprocess::ParticleDistributionStatistics< dim >, aspect::Postprocess::ParticleDistributionScore< dim >, aspect::Postprocess::ParticleCountStatistics< dim >, and aspect::Postprocess::Geoid< dim >.

---

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

• /home/bob/source/include/aspect/postprocess/interface.h