Inheritance diagram for aspect::MaterialModel::GrainSize< dim >:

Public Member Functions
virtual void	initialize ()

virtual bool	is_compressible () const

virtual double	reference_viscosity () const

virtual void	evaluate (const typename Interface< dim >::MaterialModelInputs &in, typename Interface< dim >::MaterialModelOutputs &out) const

double	enthalpy (const double temperature, const double pressure, const std::vector< double > &compositional_fields, const Point< dim > &position) const

std::array< std::pair< double, unsigned int >, 2 >	enthalpy_derivative (const typename Interface< dim >::MaterialModelInputs &in) const

Public Member Functions inherited from aspect::MaterialModel::Interface< dim >
virtual	~Interface ()

virtual void	update ()

virtual void	evaluate (const MaterialModel::MaterialModelInputs< dim > &in, MaterialModel::MaterialModelOutputs< dim > &out) const =0

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::ModelDependence &	get_model_dependence () const

Public Member Functions inherited from aspect::SimulatorAccess< dim >
	SimulatorAccess ()

	SimulatorAccess (const Simulator< dim > &simulator_object)

virtual	~SimulatorAccess ()

virtual void	initialize_simulator (const Simulator< dim > &simulator_object)

template<typename PostprocessorType >
PostprocessorType *	find_postprocessor () const

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

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

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::BlockVector &	get_current_linearization_point () const

const LinearAlgebra::BlockVector &	get_solution () const

const LinearAlgebra::BlockVector &	get_old_solution () const

const LinearAlgebra::BlockVector &	get_old_old_solution () const

const LinearAlgebra::BlockVector &	get_reaction_vector () const

const LinearAlgebra::BlockVector &	get_mesh_velocity () const

const DoFHandler< dim > &	get_dof_handler () const

const FiniteElement< dim > &	get_fe () const

const LinearAlgebra::BlockSparseMatrix &	get_system_matrix () const

const LinearAlgebra::BlockSparseMatrix &	get_system_preconditioner_matrix () const

const MaterialModel::Interface< dim > &	get_material_model () const

void	compute_material_model_input_values (const LinearAlgebra::BlockVector &input_solution, const FEValuesBase< dim, dim > &input_finite_element_values, const typename DoFHandler< dim >::active_cell_iterator &cell, const bool compute_strainrate, MaterialModel::MaterialModelInputs< dim > &material_model_inputs) 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

DEAL_II_DEPRECATED const BoundaryTemperature::Interface< dim > &	get_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

DEAL_II_DEPRECATED const BoundaryComposition::Interface< dim > &	get_boundary_composition () const

const BoundaryComposition::Manager< dim > &	get_boundary_composition_manager () const

const std::map< types::boundary_id, std::shared_ptr< BoundaryTraction::Interface< dim > > > &	get_boundary_traction () const

DEAL_II_DEPRECATED const InitialTemperature::Interface< dim > &	get_initial_temperature () const

const InitialTemperature::Manager< dim > &	get_initial_temperature_manager () const

DEAL_II_DEPRECATED const InitialComposition::Interface< dim > &	get_initial_composition () 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_free_surface_boundary_indicators () const

DEAL_II_DEPRECATED const std::map< types::boundary_id, std::shared_ptr< BoundaryVelocity::Interface< dim > > >	get_prescribed_boundary_velocity () 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 NewtonHandler< dim > &	get_newton_handler () const

const WorldBuilder::World &	get_world_builder () const

const FreeSurfaceHandler< dim > &	get_free_surface_handler () const

const LateralAveraging< dim > &	get_lateral_averaging () const

const ConstraintMatrix &	get_current_constraints () const

bool	simulator_is_initialized () 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

template<typename PostprocessorType >
DEAL_II_DEPRECATED PostprocessorType *	find_postprocessor () const

const Postprocess::Manager< dim > &	get_postprocess_manager () const

Protected Types
enum	formats { perplex, hefesto }

Protected Member Functions
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

double	diffusion_viscosity (const double temperature, const double pressure, const std::vector< double > &compositional_fields, const SymmetricTensor< 2, dim > &, const Point< dim > &position) const

double	dislocation_viscosity (const double temperature, const double pressure, const std::vector< double > &compositional_fields, const SymmetricTensor< 2, dim > &strain_rate, const Point< dim > &position, const double viscosity_guess=0) const

double	dislocation_viscosity_fixed_strain_rate (const double temperature, const double pressure, const std::vector< double > &, const SymmetricTensor< 2, dim > &dislocation_strain_rate, const Point< dim > &position) const

double	density (const double temperature, const double pressure, const std::vector< double > &compositional_fields, const Point< dim > &position) const

double	compressibility (const double temperature, const double pressure, const std::vector< double > &compositional_fields, const Point< dim > &position) const

double	specific_heat (const double temperature, const double pressure, const std::vector< double > &compositional_fields, const Point< dim > &position) const

double	thermal_expansion_coefficient (const double temperature, const double pressure, const std::vector< double > &compositional_fields, const Point< dim > &position) const

double	seismic_Vp (const double temperature, const double pressure, const std::vector< double > &compositional_fields, const Point< dim > &position) const

double	seismic_Vs (const double temperature, const double pressure, const std::vector< double > &compositional_fields, const Point< dim > &position) const

double	grain_size_change (const double temperature, const double pressure, const std::vector< double > &compositional_fields, const SymmetricTensor< 2, dim > &strain_rate, const Tensor< 1, dim > &velocity, const Point< dim > &position, const unsigned int phase_index, const int crossed_transition) const

double	phase_function (const Point< dim > &position, const double temperature, const double pressure, const unsigned int phase) const

unsigned int	get_phase_index (const Point< dim > &position, const double temperature, const double pressure) const

void	convert_log_grain_size (std::vector< double > &compositional_fields) const

Protected Attributes
double	reference_rho

double	reference_T

double	eta

double	thermal_alpha

double	reference_specific_heat

double	reference_compressibility

double	k_value

std::vector< double >	grain_growth_activation_energy

std::vector< double >	grain_growth_activation_volume

std::vector< double >	grain_growth_rate_constant

std::vector< double >	grain_growth_exponent

double	minimum_grain_size

std::vector< double >	reciprocal_required_strain

std::vector< double >	recrystallized_grain_size

bool	use_paleowattmeter

std::vector< double >	grain_boundary_energy

std::vector< double >	boundary_area_change_work_fraction

std::vector< double >	geometric_constant

double	dislocation_viscosity_iteration_threshold

unsigned int	dislocation_viscosity_iteration_number

std::vector< double >	dislocation_creep_exponent

std::vector< double >	dislocation_activation_energy

std::vector< double >	dislocation_activation_volume

std::vector< double >	dislocation_creep_prefactor

std::vector< double >	diffusion_creep_exponent

std::vector< double >	diffusion_activation_energy

std::vector< double >	diffusion_activation_volume

std::vector< double >	diffusion_creep_prefactor

std::vector< double >	diffusion_creep_grain_size_exponent

double	max_temperature_dependence_of_eta

double	min_eta

double	max_eta

double	min_specific_heat

double	max_specific_heat

double	min_thermal_expansivity

double	max_thermal_expansivity

unsigned int	max_latent_heat_substeps

double	min_grain_size

double	pv_grain_size_scaling

bool	advect_log_grainsize

std::vector< double >	transition_depths

std::vector< double >	transition_temperatures

std::vector< double >	transition_slopes

std::vector< double >	transition_widths

std::string	datadirectory

std::vector< std::string >	material_file_names

std::vector< std::string >	derivatives_file_names

unsigned int	n_material_data

bool	use_table_properties

bool	use_enthalpy

bool	use_bilinear_interpolation

enum aspect::MaterialModel::GrainSize::formats	material_file_format

std::vector< std::shared_ptr< MaterialModel::Lookup::MaterialLookup > >	material_lookup

Protected Attributes inherited from aspect::MaterialModel::Interface< dim >
NonlinearDependence::ModelDependence	model_dependence

Functions used in dealing with run-time parameters
virtual void	parse_parameters (ParameterHandler &prm)

virtual void	create_additional_named_outputs (MaterialModel::MaterialModelOutputs< dim > &out) const

static void	declare_parameters (ParameterHandler &prm)

Additional Inherited Members
Public Types inherited from aspect::MaterialModel::Interface< dim >
typedef MaterialModel::MaterialModelInputs< dim >	MaterialModelInputs

typedef MaterialModel::MaterialModelOutputs< dim >	MaterialModelOutputs

Static Public Member Functions inherited from aspect::MaterialModel::Interface< dim >
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)

Detailed Description

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

A material model that relies on compositional fields that stand for average grain sizes of a mineral phase and source terms for them that determine the grain size evolution in dependence of the strain rate, temperature, phase transitions, and the creep regime. This material model only works if a compositional field named 'grain_size' is present. In the diffusion creep regime, the viscosity depends on this grain size. We use the grain size evolution laws described in Behn et al., 2009. Implications of grain size evolution on the seismic structure of the oceanic upper mantle, Earth Planet. Sci. Letters, 282, 178–189. Other material parameters are either prescribed similar to the 'simple' material model, or read from data files that were generated by the Perplex or Hefesto software. The material model is described in more detail in Dannberg, J., Z. Eilon, U. Faul, R. Gassmöller, P. Moulik, and R. Myhill (2017), The importance of grain size to mantle dynamics and seismological observations, Geochem. Geophys. Geosyst., 18, 3034–3061, doi:10.1002/2017GC006944., which is the canonical reference for this material model.

Definition at line 236 of file grain_size.h.

Member Enumeration Documentation

§ formats

template<int dim>

enum aspect::MaterialModel::GrainSize::formats

protected

The format of the provided material files. Currently we support the PERPLEX and HeFESTo data formats.

Enumerator
perplex
hefesto

Definition at line 550 of file grain_size.h.

Member Function Documentation

§ initialize()

template<int dim>

virtual void aspect::MaterialModel::GrainSize< dim >::initialize ( )

virtual

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

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

§ is_compressible()

template<int dim>

virtual bool aspect::MaterialModel::GrainSize< dim >::is_compressible ( ) const

virtual

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 contuity equation as $\nabla \cdot (\rho \mathbf u)=0$ (compressible Stokes) or as $\nabla \cdot \mathbf{u}=0$ (incompressible Stokes).

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

§ reference_viscosity()

template<int dim>

virtual double aspect::MaterialModel::GrainSize< dim >::reference_viscosity ( ) const

virtual

Return a reference value typical of the viscosities that appear in this model. This value is not actually used in the material description itself, but is used in scaling variables to the same numerical order of magnitude when solving linear systems. Specifically, the reference viscosity appears in the factor scaling the pressure against the velocity. It is also used in computing dimension-less quantities. You may want to take a look at the Kronbichler, Heister, Bangerth 2012 paper that describes the design of ASPECT for a description of this pressure scaling.

Note: The reference viscosity should take into account the complete constitutive relationship, defined as the scalar viscosity times the constitutive tensor. In most cases, the constitutive tensor will simply be the identity tensor (this is the default case), but this may become important for material models with anisotropic viscosities, if the constitutive tensor is not normalized.

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

§ evaluate()

template<int dim>

virtual void aspect::MaterialModel::GrainSize< dim >::evaluate	(	const typename Interface< dim >::MaterialModelInputs &	in,
		typename Interface< dim >::MaterialModelOutputs &	out
	)		const

virtual

§ declare_parameters()

template<int dim>

static void aspect::MaterialModel::GrainSize< dim >::declare_parameters ( ParameterHandler & prm )

static

Declare the parameters this class takes through input files.

§ parse_parameters()

template<int dim>

virtual void aspect::MaterialModel::GrainSize< dim >::parse_parameters ( ParameterHandler & prm )

virtual

Read the parameters this class declares from the parameter file.

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

§ create_additional_named_outputs()

template<int dim>

virtual void aspect::MaterialModel::GrainSize< dim >::create_additional_named_outputs ( MaterialModel::MaterialModelOutputs< dim > & outputs ) const

virtual

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 >.

§ enthalpy()

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::enthalpy	(	const double	temperature,
		const double	pressure,
		const std::vector< double > &	compositional_fields,
		const Point< dim > &	position
	)		const

Returns the enthalpy as calculated by HeFESTo.

§ enthalpy_derivative()

template<int dim>

std::array<std::pair<double, unsigned int>,2> aspect::MaterialModel::GrainSize< dim >::enthalpy_derivative ( const typename Interface< dim >::MaterialModelInputs & in ) const

Returns the cell-wise averaged enthalpy derivatives for the evaluate function and postprocessors. The function returns two pairs, the first one represents the temperature derivative, the second one the pressure derivative. The first member of each pair is the derivative, the second one the number of vertex combinations the function could use to compute the derivative. The second member is useful to handle the case no suitable combination of vertices could be found (e.g. if the temperature and pressure on all vertices of the current cell is identical.

§ viscosity()

template<int dim>

double aspect::MaterialModel::GrainSize< 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

protected

§ diffusion_viscosity()

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::diffusion_viscosity	(	const double	temperature,
		const double	pressure,
		const std::vector< double > &	compositional_fields,
		const SymmetricTensor< 2, dim > &	,
		const Point< dim > &	position
	)		const

protected

§ dislocation_viscosity()

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::dislocation_viscosity	(	const double	temperature,
		const double	pressure,
		const std::vector< double > &	compositional_fields,
		const SymmetricTensor< 2, dim > &	strain_rate,
		const Point< dim > &	position,
		const double	viscosity_guess = `0`
	)		const

protected

This function calculates the dislocation viscosity. For this purpose we need the dislocation component of the strain rate, which we can only compute by knowing the dislocation viscosity. Therefore, we iteratively solve for the dislocation viscosity and update the dislocation strain rate in each iteration using the new value obtained for the dislocation viscosity. The iteration is started with a dislocation viscosity calculated for the whole strain rate unless a guess for the viscosity is provided, which can reduce the number of iterations significantly.

§ dislocation_viscosity_fixed_strain_rate()

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::dislocation_viscosity_fixed_strain_rate	(	const double	temperature,
		const double	pressure,
		const std::vector< double > &	,
		const SymmetricTensor< 2, dim > &	dislocation_strain_rate,
		const Point< dim > &	position
	)		const

protected

This function calculates the dislocation viscosity for a given dislocation strain rate.

§ density()

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::density	(	const double	temperature,
		const double	pressure,
		const std::vector< double > &	compositional_fields,
		const Point< dim > &	position
	)		const

protected

§ compressibility()

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::compressibility	(	const double	temperature,
		const double	pressure,
		const std::vector< double > &	compositional_fields,
		const Point< dim > &	position
	)		const

protected

§ specific_heat()

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::specific_heat	(	const double	temperature,
		const double	pressure,
		const std::vector< double > &	compositional_fields,
		const Point< dim > &	position
	)		const

protected

§ thermal_expansion_coefficient()

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::thermal_expansion_coefficient	(	const double	temperature,
		const double	pressure,
		const std::vector< double > &	compositional_fields,
		const Point< dim > &	position
	)		const

protected

§ seismic_Vp()

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::seismic_Vp	(	const double	temperature,
		const double	pressure,
		const std::vector< double > &	compositional_fields,
		const Point< dim > &	position
	)		const

protected

Returns the p-wave velocity as calculated by HeFESTo.

§ seismic_Vs()

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::seismic_Vs	(	const double	temperature,
		const double	pressure,
		const std::vector< double > &	compositional_fields,
		const Point< dim > &	position
	)		const

protected

Returns the s-wave velocity as calculated by HeFESTo.

§ grain_size_change()

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::grain_size_change	(	const double	temperature,
		const double	pressure,
		const std::vector< double > &	compositional_fields,
		const SymmetricTensor< 2, dim > &	strain_rate,
		const Tensor< 1, dim > &	velocity,
		const Point< dim > &	position,
		const unsigned int	phase_index,
		const int	crossed_transition
	)		const

protected

Rate of grain size growth (Ostwald ripening) or reduction (due to dynamic recrystallization and phase transformations) in dependence on temperature, pressure, strain rate, mineral phase and creep regime. We use the grain size growth laws as for example described in Behn, M. D., Hirth, G., & Elsenbeck, J. R. (2009). Implications of grain size evolution on the seismic structure of the oceanic upper mantle. Earth and Planetary Science Letters, 282(1), 178-189.

For the rate of grain size reduction due to dynamic crystallization there is the choice between the paleowattmeter (Austins and Evans, 2007) and the paleopiezometer (Hall and Parmentier, 2003) as described in the parameter use_paleowattmeter.

§ phase_function()

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::phase_function	(	const Point< dim > &	position,
		const double	temperature,
		const double	pressure,
		const unsigned int	phase
	)		const

protected

Function that defines the phase transition interface (0 above, 1 below the phase transition).This is done individually for each transition and summed up in the end.

§ get_phase_index()

template<int dim>

unsigned int aspect::MaterialModel::GrainSize< dim >::get_phase_index	(	const Point< dim > &	position,
		const double	temperature,
		const double	pressure
	)		const

protected

Function that returns the phase for a given position, temperature, pressure and compositional field index.

§ convert_log_grain_size()

template<int dim>

void aspect::MaterialModel::GrainSize< dim >::convert_log_grain_size ( std::vector< double > & compositional_fields ) const

protected

Function that takes an object in the same format as in.composition as argument and converts the vector that corresponds to the grain size to its logarithms and limits the grain size to a global minimum. The input argument compositional_fields is modified in-place.

Member Data Documentation

§ reference_rho

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::reference_rho

protected

Definition at line 311 of file grain_size.h.

§ reference_T

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::reference_T

protected

Definition at line 312 of file grain_size.h.

§ eta

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::eta

protected

Definition at line 313 of file grain_size.h.

§ thermal_alpha

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::thermal_alpha

protected

Definition at line 314 of file grain_size.h.

§ reference_specific_heat

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::reference_specific_heat

protected

Definition at line 315 of file grain_size.h.

§ reference_compressibility

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::reference_compressibility

protected

The constant compressibility.

Definition at line 320 of file grain_size.h.

§ k_value

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::k_value

protected

The thermal conductivity.

Definition at line 325 of file grain_size.h.

§ grain_growth_activation_energy

template<int dim>

std::vector<double> aspect::MaterialModel::GrainSize< dim >::grain_growth_activation_energy

protected

Parameters controlling the grain size evolution.

Definition at line 330 of file grain_size.h.

§ grain_growth_activation_volume

template<int dim>

std::vector<double> aspect::MaterialModel::GrainSize< dim >::grain_growth_activation_volume

protected

Definition at line 331 of file grain_size.h.

§ grain_growth_rate_constant

template<int dim>

std::vector<double> aspect::MaterialModel::GrainSize< dim >::grain_growth_rate_constant

protected

Definition at line 332 of file grain_size.h.

§ grain_growth_exponent

template<int dim>

std::vector<double> aspect::MaterialModel::GrainSize< dim >::grain_growth_exponent

protected

Definition at line 333 of file grain_size.h.

§ minimum_grain_size

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::minimum_grain_size

protected

Definition at line 334 of file grain_size.h.

§ reciprocal_required_strain

template<int dim>

std::vector<double> aspect::MaterialModel::GrainSize< dim >::reciprocal_required_strain

protected

Definition at line 335 of file grain_size.h.

§ recrystallized_grain_size

template<int dim>

std::vector<double> aspect::MaterialModel::GrainSize< dim >::recrystallized_grain_size

protected

Definition at line 336 of file grain_size.h.

§ use_paleowattmeter

template<int dim>

bool aspect::MaterialModel::GrainSize< dim >::use_paleowattmeter

protected

Parameters controlling the dynamic grain recrystallization. (following paleowattmeter as described in Austin, N. J., & Evans, B. (2007). Paleowattmeters: A scaling relation for dynamically recrystallized grain size. Geology, 35(4), 343-346.). If this is set to false we use the approach of Hall, C. E., Parmentier, E. M. (2003). Influence of grain size evolution on convective instability. Geochemistry, Geophysics, Geosystems, 4(3).

Definition at line 347 of file grain_size.h.

§ grain_boundary_energy

template<int dim>

std::vector<double> aspect::MaterialModel::GrainSize< dim >::grain_boundary_energy

protected

Definition at line 348 of file grain_size.h.

§ boundary_area_change_work_fraction

template<int dim>

std::vector<double> aspect::MaterialModel::GrainSize< dim >::boundary_area_change_work_fraction

protected

Definition at line 349 of file grain_size.h.

§ geometric_constant

template<int dim>

std::vector<double> aspect::MaterialModel::GrainSize< dim >::geometric_constant

protected

Definition at line 350 of file grain_size.h.

§ dislocation_viscosity_iteration_threshold

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::dislocation_viscosity_iteration_threshold

protected

Parameters controlling the viscosity.

Definition at line 355 of file grain_size.h.

§ dislocation_viscosity_iteration_number

template<int dim>

unsigned int aspect::MaterialModel::GrainSize< dim >::dislocation_viscosity_iteration_number

protected

Definition at line 356 of file grain_size.h.

§ dislocation_creep_exponent

template<int dim>

std::vector<double> aspect::MaterialModel::GrainSize< dim >::dislocation_creep_exponent

protected

Definition at line 357 of file grain_size.h.

§ dislocation_activation_energy

template<int dim>

std::vector<double> aspect::MaterialModel::GrainSize< dim >::dislocation_activation_energy

protected

Definition at line 358 of file grain_size.h.

§ dislocation_activation_volume

template<int dim>

std::vector<double> aspect::MaterialModel::GrainSize< dim >::dislocation_activation_volume

protected

Definition at line 359 of file grain_size.h.

§ dislocation_creep_prefactor

template<int dim>

std::vector<double> aspect::MaterialModel::GrainSize< dim >::dislocation_creep_prefactor

protected

Definition at line 360 of file grain_size.h.

§ diffusion_creep_exponent

template<int dim>

std::vector<double> aspect::MaterialModel::GrainSize< dim >::diffusion_creep_exponent

protected

Definition at line 361 of file grain_size.h.

§ diffusion_activation_energy

template<int dim>

std::vector<double> aspect::MaterialModel::GrainSize< dim >::diffusion_activation_energy

protected

Definition at line 362 of file grain_size.h.

§ diffusion_activation_volume

template<int dim>

std::vector<double> aspect::MaterialModel::GrainSize< dim >::diffusion_activation_volume

protected

Definition at line 363 of file grain_size.h.

§ diffusion_creep_prefactor

template<int dim>

std::vector<double> aspect::MaterialModel::GrainSize< dim >::diffusion_creep_prefactor

protected

Definition at line 364 of file grain_size.h.

§ diffusion_creep_grain_size_exponent

template<int dim>

std::vector<double> aspect::MaterialModel::GrainSize< dim >::diffusion_creep_grain_size_exponent

protected

Definition at line 365 of file grain_size.h.

§ max_temperature_dependence_of_eta

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::max_temperature_dependence_of_eta

protected

Because of the nonlinear nature of this material model many parameters need to be kept within bounds to ensure stability of the solution. These bounds can be adjusted as input parameters.

Definition at line 372 of file grain_size.h.

§ min_eta

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::min_eta

protected

Definition at line 373 of file grain_size.h.

§ max_eta

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::max_eta

protected

Definition at line 374 of file grain_size.h.

§ min_specific_heat

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::min_specific_heat

protected

Definition at line 375 of file grain_size.h.

§ max_specific_heat

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::max_specific_heat

protected

Definition at line 376 of file grain_size.h.

§ min_thermal_expansivity

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::min_thermal_expansivity

protected

Definition at line 377 of file grain_size.h.

§ max_thermal_expansivity

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::max_thermal_expansivity

protected

Definition at line 378 of file grain_size.h.

§ max_latent_heat_substeps

template<int dim>

unsigned int aspect::MaterialModel::GrainSize< dim >::max_latent_heat_substeps

protected

Definition at line 379 of file grain_size.h.

§ min_grain_size

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::min_grain_size

protected

Definition at line 380 of file grain_size.h.

§ pv_grain_size_scaling

template<int dim>

double aspect::MaterialModel::GrainSize< dim >::pv_grain_size_scaling

protected

Definition at line 381 of file grain_size.h.

§ advect_log_grainsize

template<int dim>

bool aspect::MaterialModel::GrainSize< dim >::advect_log_grainsize

protected

Whether to advect the real grain size, or the logarithm of the grain size. The logarithm reduces jumps.

Definition at line 387 of file grain_size.h.

§ transition_depths

template<int dim>

std::vector<double> aspect::MaterialModel::GrainSize< dim >::transition_depths

protected

list of depth, width and Clapeyron slopes for the different phase transitions and in which phase they occur

Definition at line 527 of file grain_size.h.

§ transition_temperatures

template<int dim>

std::vector<double> aspect::MaterialModel::GrainSize< dim >::transition_temperatures

protected

Definition at line 528 of file grain_size.h.

§ transition_slopes

template<int dim>

std::vector<double> aspect::MaterialModel::GrainSize< dim >::transition_slopes

protected

Definition at line 529 of file grain_size.h.

§ transition_widths

template<int dim>

std::vector<double> aspect::MaterialModel::GrainSize< dim >::transition_widths

protected

Definition at line 530 of file grain_size.h.

§ datadirectory

template<int dim>

std::string aspect::MaterialModel::GrainSize< dim >::datadirectory

protected

The following variables are properties of the material files we read in.

Definition at line 537 of file grain_size.h.

§ material_file_names

template<int dim>

std::vector<std::string> aspect::MaterialModel::GrainSize< dim >::material_file_names

protected

Definition at line 538 of file grain_size.h.

§ derivatives_file_names

template<int dim>

std::vector<std::string> aspect::MaterialModel::GrainSize< dim >::derivatives_file_names

protected

Definition at line 539 of file grain_size.h.

§ n_material_data

template<int dim>

unsigned int aspect::MaterialModel::GrainSize< dim >::n_material_data

protected

Definition at line 540 of file grain_size.h.

§ use_table_properties

template<int dim>

bool aspect::MaterialModel::GrainSize< dim >::use_table_properties

protected

Definition at line 541 of file grain_size.h.

§ use_enthalpy

template<int dim>

bool aspect::MaterialModel::GrainSize< dim >::use_enthalpy

protected

Definition at line 542 of file grain_size.h.

§ use_bilinear_interpolation

template<int dim>

bool aspect::MaterialModel::GrainSize< dim >::use_bilinear_interpolation

protected

Definition at line 543 of file grain_size.h.

§ material_file_format

template<int dim>

enum aspect::MaterialModel::GrainSize::formats aspect::MaterialModel::GrainSize< dim >::material_file_format

protected

§ material_lookup

template<int dim>

std::vector<std::shared_ptr<MaterialModel::Lookup::MaterialLookup> > aspect::MaterialModel::GrainSize< dim >::material_lookup

protected

List of pointers to objects that read and process data we get from material data files. There is one pointer/object per compositional field provided.

Definition at line 561 of file grain_size.h.

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

/home/bob/source/include/aspect/material_model/grain_size.h

Public Member Functions

Protected Types

Protected Member Functions

Protected Attributes

Functions used in dealing with run-time parameters

Additional Inherited Members

Detailed Description

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

Member Enumeration Documentation

§ formats

Member Function Documentation

§ initialize()

§ is_compressible()

§ reference_viscosity()

§ evaluate()

§ declare_parameters()

§ parse_parameters()

§ create_additional_named_outputs()

§ enthalpy()

§ enthalpy_derivative()

§ viscosity()

§ diffusion_viscosity()

§ dislocation_viscosity()

§ dislocation_viscosity_fixed_strain_rate()

§ density()

§ compressibility()

§ specific_heat()

§ thermal_expansion_coefficient()

§ seismic_Vp()

§ seismic_Vs()

§ grain_size_change()

§ phase_function()

§ get_phase_index()

§ convert_log_grain_size()

Member Data Documentation

§ reference_rho

§ reference_T

§ eta

§ thermal_alpha

§ reference_specific_heat

§ reference_compressibility

§ k_value

§ grain_growth_activation_energy

§ grain_growth_activation_volume

§ grain_growth_rate_constant

§ grain_growth_exponent

§ minimum_grain_size

§ reciprocal_required_strain

§ recrystallized_grain_size

§ use_paleowattmeter

§ grain_boundary_energy

§ boundary_area_change_work_fraction

§ geometric_constant

§ dislocation_viscosity_iteration_threshold

§ dislocation_viscosity_iteration_number

§ dislocation_creep_exponent

§ dislocation_activation_energy

§ dislocation_activation_volume

§ dislocation_creep_prefactor

§ diffusion_creep_exponent

§ diffusion_activation_energy

§ diffusion_activation_volume

§ diffusion_creep_prefactor

§ diffusion_creep_grain_size_exponent

§ max_temperature_dependence_of_eta

§ min_eta

§ max_eta

§ min_specific_heat

§ max_specific_heat

§ min_thermal_expansivity

§ max_thermal_expansivity

§ max_latent_heat_substeps

§ min_grain_size

§ pv_grain_size_scaling

§ advect_log_grainsize

§ transition_depths

§ transition_temperatures

§ transition_slopes

§ transition_widths

§ datadirectory

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