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

Public Member Functions

void initialize () override
 
void update () override
 
void evaluate (const MaterialModel::MaterialModelInputs< dim > &in, MaterialModel::MaterialModelOutputs< dim > &out) const override
 
void create_additional_named_outputs (MaterialModel::MaterialModelOutputs< dim > &out) const override
 
Physical parameters used in the basic equations
virtual double viscosity (const double temperature, const double pressure, const std::vector< double > &compositional_fields, const SymmetricTensor< 2, dim > &strain_rate, const Point< dim > &position) const
 
Qualitative properties one can ask a material model
bool is_compressible () const override
 
- Public Member Functions inherited from aspect::MaterialModel::Interface< dim >
virtual void fill_additional_material_model_inputs (MaterialModel::MaterialModelInputs< dim > &input, const LinearAlgebra::BlockVector &solution, const FEValuesBase< dim > &fe_values, const Introspection< dim > &introspection) const
 
const NonlinearDependence::ModelDependenceget_model_dependence () const
 
- Public Member Functions inherited from aspect::Plugins::InterfaceBase
virtual ~InterfaceBase ()=default
 
- Public Member Functions inherited from aspect::SimulatorAccess< dim >
 SimulatorAccess ()
 
 SimulatorAccess (const Simulator< dim > &simulator_object)
 
virtual ~SimulatorAccess ()=default
 
virtual void initialize_simulator (const Simulator< dim > &simulator_object)
 
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_managers () const
 
const Particle::Manager< dim > & get_particle_manager (const unsigned int particle_manager_index) const
 
Particle::Manager< dim > & get_particle_manager (const unsigned int particle_manager_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
 

Private Member Functions

void fill_prescribed_outputs (const unsigned int i, const std::vector< double > &volume_fractions, const MaterialModel::MaterialModelInputs< dim > &in, MaterialModel::MaterialModelOutputs< dim > &out) const
 

Private Attributes

bool has_background_field
 
std::unique_ptr< ComponentMask > composition_mask
 
EquationOfState::ThermodynamicTableLookup< dim > equation_of_state
 
bool use_lateral_average_temperature
 
std::unique_ptr< ThermalConductivity::Interface< dim > > thermal_conductivity
 
std::vector< double > viscosity_prefactors
 
MaterialUtilities::CompositionalAveragingOperation viscosity_averaging_scheme
 
std::vector< double > average_temperature
 
unsigned int n_lateral_slices
 
double min_eta
 
double max_eta
 
double max_lateral_eta_variation
 
std::string data_directory
 
std::string radial_viscosity_file_name
 
std::string lateral_viscosity_file_name
 
std::unique_ptr< internal::LateralViscosityLookuplateral_viscosity_lookup
 
std::unique_ptr< internal::RadialViscosityLookupradial_viscosity_lookup
 

Functions used in dealing with run-time parameters

void parse_parameters (ParameterHandler &prm) override
 
static void declare_parameters (ParameterHandler &prm)
 

Additional Inherited Members

- Public Types inherited from aspect::MaterialModel::Interface< dim >
using MaterialModelInputs = MaterialModel::MaterialModelInputs< dim >
 
using MaterialModelOutputs = MaterialModel::MaterialModelOutputs< dim >
 
- 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)
 
- Protected Attributes inherited from aspect::MaterialModel::Interface< dim >
NonlinearDependence::ModelDependence model_dependence
 

Detailed Description

template<int dim>
class aspect::MaterialModel::Steinberger< dim >

A variable viscosity material model that reads the essential values of coefficients from tables in input files.

The viscosity of this model is based on the paper Steinberger & Calderwood 2006: "Models of large-scale viscous flow in the Earth's mantle with constraints from mineral physics and surface observations". The thermal conductivity is constant or follows a pressure-temperature dependent approximation and the other parameters are provided via lookup tables from the software PERPLEX.

Definition at line 127 of file steinberger.h.

Member Function Documentation

§ initialize()

template<int dim>
void aspect::MaterialModel::Steinberger< dim >::initialize ( )
overridevirtual

Initialization function. Loads the material data and sets up pointers.

Reimplemented from aspect::Plugins::InterfaceBase.

§ update()

template<int dim>
void aspect::MaterialModel::Steinberger< dim >::update ( )
overridevirtual

Called at the beginning of each time step and allows the material model to update internal data structures.

Reimplemented from aspect::Plugins::InterfaceBase.

§ viscosity()

template<int dim>
virtual double aspect::MaterialModel::Steinberger< dim >::viscosity ( const double  temperature,
const double  pressure,
const std::vector< double > &  compositional_fields,
const SymmetricTensor< 2, dim > &  strain_rate,
const Point< dim > &  position 
) const
virtual

§ is_compressible()

template<int dim>
bool aspect::MaterialModel::Steinberger< dim >::is_compressible ( ) const
overridevirtual

Return whether the model is compressible or not. Incompressibility does not necessarily imply that the density is constant; rather, it may still depend on temperature or pressure. In the current context, compressibility means whether we should solve the continuity equation as \(\nabla \cdot (\rho \mathbf u)=0\) (compressible Stokes) or as \(\nabla \cdot \mathbf{u}=0\) (incompressible Stokes).

Implements aspect::MaterialModel::Interface< dim >.

§ evaluate()

template<int dim>
void aspect::MaterialModel::Steinberger< dim >::evaluate ( const MaterialModel::MaterialModelInputs< dim > &  in,
MaterialModel::MaterialModelOutputs< dim > &  out 
) const
overridevirtual

Function to compute the material properties in out given the inputs in in.

Implements aspect::MaterialModel::Interface< dim >.

§ declare_parameters()

template<int dim>
static void aspect::MaterialModel::Steinberger< dim >::declare_parameters ( ParameterHandler &  prm)
static

Declare the parameters this class takes through input files.

§ parse_parameters()

template<int dim>
void aspect::MaterialModel::Steinberger< dim >::parse_parameters ( ParameterHandler &  prm)
overridevirtual

Read the parameters this class declares from the parameter file.

Reimplemented from aspect::Plugins::InterfaceBase.

§ create_additional_named_outputs()

template<int dim>
void aspect::MaterialModel::Steinberger< dim >::create_additional_named_outputs ( MaterialModel::MaterialModelOutputs< dim > &  outputs) const
overridevirtual

If this material model can produce additional named outputs that are derived from NamedAdditionalOutputs, create them in here. By default, this does nothing.

Reimplemented from aspect::MaterialModel::Interface< dim >.

§ fill_prescribed_outputs()

template<int dim>
void aspect::MaterialModel::Steinberger< dim >::fill_prescribed_outputs ( const unsigned int  i,
const std::vector< double > &  volume_fractions,
const MaterialModel::MaterialModelInputs< dim > &  in,
MaterialModel::MaterialModelOutputs< dim > &  out 
) const
private

A function that fills the prescribed additional outputs in the MaterialModelOutputs object that is handed over, if it exists, in this case, densities for the projected density approximation. Does nothing otherwise.

Member Data Documentation

§ has_background_field

template<int dim>
bool aspect::MaterialModel::Steinberger< dim >::has_background_field
private

Whether the compositional fields representing mass fractions should be normalized to one when computing their fractions (if false), or whether there is an additional composition (the background field) that is not represented by a compositional field, and makes up the remaining fraction of material if the compositional fields add up to less than one at any given location (if true).

Definition at line 216 of file steinberger.h.

§ composition_mask

template<int dim>
std::unique_ptr<ComponentMask> aspect::MaterialModel::Steinberger< dim >::composition_mask
private

Pointer to a composition mask, which is meant to be filled with one entry per compositional field that determines if this field is considered to represent a mass fractions (if the entry is set to true) or not (if set to false). This is needed for averaging of material properties.

Definition at line 225 of file steinberger.h.

§ equation_of_state

template<int dim>
EquationOfState::ThermodynamicTableLookup<dim> aspect::MaterialModel::Steinberger< dim >::equation_of_state
private

The thermodynamic lookup equation of state.

Definition at line 230 of file steinberger.h.

§ use_lateral_average_temperature

template<int dim>
bool aspect::MaterialModel::Steinberger< dim >::use_lateral_average_temperature
private

Boolean describing whether to use the lateral average temperature for computing the viscosity, rather than the temperature on the reference adiabat.

Definition at line 237 of file steinberger.h.

§ thermal_conductivity

template<int dim>
std::unique_ptr<ThermalConductivity::Interface<dim> > aspect::MaterialModel::Steinberger< dim >::thermal_conductivity
private

The thermal conductivity parametrization to use. This material model supports either a constant thermal conductivity or a pressure- and temperature-dependent thermal conductivity.

Definition at line 244 of file steinberger.h.

§ viscosity_prefactors

template<int dim>
std::vector<double> aspect::MaterialModel::Steinberger< dim >::viscosity_prefactors
private

Compositional prefactors with which to multiply the reference viscosity. Volume fractions are used to weight the prefactors according to the assigned viscosity averaging scheme.

Definition at line 251 of file steinberger.h.

§ viscosity_averaging_scheme

template<int dim>
MaterialUtilities::CompositionalAveragingOperation aspect::MaterialModel::Steinberger< dim >::viscosity_averaging_scheme
private

Definition at line 252 of file steinberger.h.

§ average_temperature

template<int dim>
std::vector<double> aspect::MaterialModel::Steinberger< dim >::average_temperature
private

Information about lateral temperature averages.

Definition at line 257 of file steinberger.h.

§ n_lateral_slices

template<int dim>
unsigned int aspect::MaterialModel::Steinberger< dim >::n_lateral_slices
private

Definition at line 258 of file steinberger.h.

§ min_eta

template<int dim>
double aspect::MaterialModel::Steinberger< dim >::min_eta
private

Minimum and maximum allowed viscosity, as well as the maximum allowed viscosity variation compared to the average radial viscosity.

Definition at line 264 of file steinberger.h.

§ max_eta

template<int dim>
double aspect::MaterialModel::Steinberger< dim >::max_eta
private

Definition at line 265 of file steinberger.h.

§ max_lateral_eta_variation

template<int dim>
double aspect::MaterialModel::Steinberger< dim >::max_lateral_eta_variation
private

Definition at line 266 of file steinberger.h.

§ data_directory

template<int dim>
std::string aspect::MaterialModel::Steinberger< dim >::data_directory
private

Information about the location of data files.

Definition at line 271 of file steinberger.h.

§ radial_viscosity_file_name

template<int dim>
std::string aspect::MaterialModel::Steinberger< dim >::radial_viscosity_file_name
private

Definition at line 272 of file steinberger.h.

§ lateral_viscosity_file_name

template<int dim>
std::string aspect::MaterialModel::Steinberger< dim >::lateral_viscosity_file_name
private

Definition at line 273 of file steinberger.h.

§ lateral_viscosity_lookup

template<int dim>
std::unique_ptr<internal::LateralViscosityLookup> aspect::MaterialModel::Steinberger< dim >::lateral_viscosity_lookup
private

Pointer to an object that reads and processes data for the lateral temperature dependency of viscosity.

Definition at line 279 of file steinberger.h.

§ radial_viscosity_lookup

template<int dim>
std::unique_ptr<internal::RadialViscosityLookup> aspect::MaterialModel::Steinberger< dim >::radial_viscosity_lookup
private

Pointer to an object that reads and processes data for the radial viscosity profile.

Definition at line 285 of file steinberger.h.


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