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

Public Member Functions

bool is_compressible () const override
 
- Public Member Functions inherited from aspect::MaterialModel::MeltInterface< dim >
double p_c_scale (const MaterialModel::MaterialModelInputs< dim > &inputs, const MaterialModel::MaterialModelOutputs< dim > &outputs, const MeltHandler< dim > &melt_handler, const bool consider_is_melt_cell) const
 
- Public Member Functions inherited from aspect::MaterialModel::Interface< dim >
virtual ~Interface ()=default
 
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::ModelDependenceget_model_dependence () const
 
- 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
 
const Particle::World< dim > & get_particle_world () const
 
Particle::World< dim > & get_particle_world ()
 
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
 
- Public Member Functions inherited from aspect::MaterialModel::MeltFractionModel< dim >
virtual ~MeltFractionModel ()=default
 

Reference quantities

enum  ReactionScheme { no_reaction, zero_solubility, tian_approximation }
 
std::unique_ptr< MaterialModel::Interface< dim > > base_model
 
double reference_rho_f
 
double eta_f
 
double fluid_compressibility
 
double shear_to_bulk_viscosity_ratio
 
double reference_permeability
 
double alpha_phi
 
double fluid_reaction_time_scale
 
double tian_max_peridotite_water
 
double tian_max_gabbro_water
 
double tian_max_MORB_water
 
double tian_max_sediment_water
 
std::vector< double > LR_peridotite_poly_coeffs {-19.0609, 168.983, -630.032, 1281.84, -1543.14, 1111.88, -459.142, 95.4143, 1.97246}
 
std::vector< double > csat_peridotite_poly_coeffs {0.00115628, 2.42179}
 
std::vector< double > Td_peridotite_poly_coeffs {-15.4627, 94.9716, 636.603}
 
std::vector< double > LR_gabbro_poly_coeffs {-1.81745, 7.67198, -10.8507, 5.09329, 8.14519}
 
std::vector< double > csat_gabbro_poly_coeffs {-0.0176673, 0.0893044, 1.52732}
 
std::vector< double > Td_gabbro_poly_coeffs {-1.72277, 20.5898, 637.517}
 
std::vector< double > LR_MORB_poly_coeffs {-1.78177, 7.50871, -10.4840, 5.19725, 7.96365}
 
std::vector< double > csat_MORB_poly_coeffs {0.0102725, -0.115390, 0.324452, 1.41588}
 
std::vector< double > Td_MORB_poly_coeffs {-3.81280, 22.7809, 638.049}
 
std::vector< double > LR_sediment_poly_coeffs {-2.03283, 10.8186, -21.2119, 18.3351, -6.48711, 8.32459}
 
std::vector< double > csat_sediment_poly_coeffs {-0.150662, 0.301807, 1.01867}
 
std::vector< double > Td_sediment_poly_coeffs {2.83277, -24.7593, 85.9090, 524.898}
 
std::vector< std::vector< double > > devolatilization_enthalpy_changes
 
std::vector< std::vector< double > > water_mass_fractions
 
std::vector< std::vector< double > > devolatilization_onset_temperatures
 
enum aspect::MaterialModel::ReactiveFluidTransport::ReactionScheme fluid_solid_reaction_scheme
 
virtual double reference_darcy_coefficient () const override
 
std::vector< double > tian_equilibrium_bound_water_content (const MaterialModel::MaterialModelInputs< dim > &in, unsigned int q) const
 
virtual void melt_fractions (const MaterialModel::MaterialModelInputs< dim > &in, std::vector< double > &melt_fractions) const override
 
void initialize () override
 
void update () override
 
void evaluate (const typename Interface< dim >::MaterialModelInputs &in, typename Interface< dim >::MaterialModelOutputs &out) const override
 
void parse_parameters (ParameterHandler &prm) override
 
virtual void create_additional_named_outputs (MaterialModel::MaterialModelOutputs< dim > &out) const 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::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)
 
- Static Public Member Functions inherited from aspect::MaterialModel::MeltFractionModel< dim >
template<typename ModelType >
static bool is_melt_fraction_model (const ModelType &model_object)
 
template<typename ModelType >
static const MeltFractionModel< dim > & as_melt_fraction_model (const ModelType &model_object)
 
- Protected Attributes inherited from aspect::MaterialModel::Interface< dim >
NonlinearDependence::ModelDependence model_dependence
 

Detailed Description

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

A material model that simulates both fluid-rock interactions and the advection of fluids. It is designed to be composited with another material model that computes the solid material properties.

Definition at line 49 of file reactive_fluid_transport.h.

Member Enumeration Documentation

§ ReactionScheme

Enumeration for selecting which type of scheme to use for reactions between fluids and solids. The available reaction models are described below.

The no reaction model does not include any reactions between the solid and fluid phases. As a result, there is no exchange between the bound fluid and porosity compositional fields. However, the values of each field may vary through the model evolution through advection from their initial configurations.

The zero solubility model describes a scenario where the solid cannot accommodate any fluid (i.e., zero solubility). The fluid volume fraction in equilibrium with the solid at any point (stored in the melt_fractions vector) is equal to the sum of the bound fluid content and porosity, with the latter determined by the assigned initial porosity, fluid boundary conditions, and fluid transport through the model. Significantly, this reaction model is thus assuming that the bound water fraction is a volume fraction (i.e., since porosity is always a volume fraction). This latter assumption also requires the selected base model to be incompressible, as otherwise the advection equation would only be valid for mass and not volume fractions.

The tian approximation model implements parametrized phase diagrams from Tian et al., 2019 G3, https://doi.org/10.1029/2019GC008488 and calculates the fluid-solid reactions for four different rock types: sediments, MORB, gabbro and peridotite. This is achieved by calculating the maximum allowed bound water content for each composition at the current Pressure-Temperature conditions, and releasing bound water as free water if: (maximum bound water content < current bound water content) or incorporating free water (if present) into the solid phase as bound water: maximum bound water content > current bound water content This model requires that 4 compositional fields named after the 4 different rock types exist in the input file.

Enumerator
no_reaction 
zero_solubility 
tian_approximation 

Definition at line 232 of file reactive_fluid_transport.h.

Member Function Documentation

§ is_compressible()

template<int dim>
bool aspect::MaterialModel::ReactiveFluidTransport< 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).

Returns value from material model providing compressibility.

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

§ reference_darcy_coefficient()

template<int dim>
virtual double aspect::MaterialModel::ReactiveFluidTransport< dim >::reference_darcy_coefficient ( ) const
overridevirtual

Reference value for the Darcy coefficient, which is defined as permeability divided by fluid viscosity. Units: m^2/Pa/s.

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

§ tian_equilibrium_bound_water_content()

template<int dim>
std::vector<double> aspect::MaterialModel::ReactiveFluidTransport< dim >::tian_equilibrium_bound_water_content ( const MaterialModel::MaterialModelInputs< dim > &  in,
unsigned int  q 
) const

Compute the maximum allowed bound water content at the input pressure and temperature conditions. This is used to determine how free water interacts with the solid phase.

Parameters
inObject that contains the current conditions.
qunsigned int from 0-3 indexing which rock phase the equilbrium bound water content is being calculated for

§ melt_fractions()

template<int dim>
virtual void aspect::MaterialModel::ReactiveFluidTransport< dim >::melt_fractions ( const MaterialModel::MaterialModelInputs< dim > &  in,
std::vector< double > &  melt_fractions 
) const
overridevirtual

Compute the free fluid fraction that can be present in the material based on the fluid content of the material and the fluid solubility for the given input conditions. in and melt_fractions need to have the same size.

Parameters
inObject that contains the current conditions.
melt_fractionsVector of doubles that is filled with the allowable free fluid fraction for each given input conditions.

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

§ initialize()

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

Initialize the base model at the beginning of the model run Initialization function. This function is called once at the beginning of the program after parse_parameters is run and after the SimulatorAccess (if applicable) is initialized.

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

§ update()

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

Update the base model at the beginning of each timestep.

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

§ evaluate()

template<int dim>
void aspect::MaterialModel::ReactiveFluidTransport< dim >::evaluate ( const typename Interface< dim >::MaterialModelInputs in,
typename Interface< dim >::MaterialModelOutputs out 
) const
override

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

§ declare_parameters()

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

Declare the parameters this class takes through input files. The default implementation of this function does not describe any parameters. Consequently, derived classes do not have to overload this function if they do not take any runtime parameters.

§ parse_parameters()

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

Read the parameters this class declares from the parameter file. The default implementation of this function does not read any parameters. Consequently, derived classes do not have to overload this function if they do not take any runtime parameters.

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

§ create_additional_named_outputs()

template<int dim>
virtual void aspect::MaterialModel::ReactiveFluidTransport< dim >::create_additional_named_outputs ( MaterialModel::MaterialModelOutputs< dim > &  out) const
overridevirtual

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

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

Member Data Documentation

§ base_model

template<int dim>
std::unique_ptr<MaterialModel::Interface<dim> > aspect::MaterialModel::ReactiveFluidTransport< dim >::base_model
private

Pointer to the material model used as the base model

Definition at line 133 of file reactive_fluid_transport.h.

§ reference_rho_f

template<int dim>
double aspect::MaterialModel::ReactiveFluidTransport< dim >::reference_rho_f
private

Definition at line 138 of file reactive_fluid_transport.h.

§ eta_f

template<int dim>
double aspect::MaterialModel::ReactiveFluidTransport< dim >::eta_f
private

Definition at line 139 of file reactive_fluid_transport.h.

§ fluid_compressibility

template<int dim>
double aspect::MaterialModel::ReactiveFluidTransport< dim >::fluid_compressibility
private

Definition at line 140 of file reactive_fluid_transport.h.

§ shear_to_bulk_viscosity_ratio

template<int dim>
double aspect::MaterialModel::ReactiveFluidTransport< dim >::shear_to_bulk_viscosity_ratio
private

Definition at line 146 of file reactive_fluid_transport.h.

§ reference_permeability

template<int dim>
double aspect::MaterialModel::ReactiveFluidTransport< dim >::reference_permeability
private

Definition at line 147 of file reactive_fluid_transport.h.

§ alpha_phi

template<int dim>
double aspect::MaterialModel::ReactiveFluidTransport< dim >::alpha_phi
private

Definition at line 148 of file reactive_fluid_transport.h.

§ fluid_reaction_time_scale

template<int dim>
double aspect::MaterialModel::ReactiveFluidTransport< dim >::fluid_reaction_time_scale
private

Definition at line 151 of file reactive_fluid_transport.h.

§ tian_max_peridotite_water

template<int dim>
double aspect::MaterialModel::ReactiveFluidTransport< dim >::tian_max_peridotite_water
private

Definition at line 156 of file reactive_fluid_transport.h.

§ tian_max_gabbro_water

template<int dim>
double aspect::MaterialModel::ReactiveFluidTransport< dim >::tian_max_gabbro_water
private

Definition at line 157 of file reactive_fluid_transport.h.

§ tian_max_MORB_water

template<int dim>
double aspect::MaterialModel::ReactiveFluidTransport< dim >::tian_max_MORB_water
private

Definition at line 158 of file reactive_fluid_transport.h.

§ tian_max_sediment_water

template<int dim>
double aspect::MaterialModel::ReactiveFluidTransport< dim >::tian_max_sediment_water
private

Definition at line 159 of file reactive_fluid_transport.h.

§ LR_peridotite_poly_coeffs

template<int dim>
std::vector<double> aspect::MaterialModel::ReactiveFluidTransport< dim >::LR_peridotite_poly_coeffs {-19.0609, 168.983, -630.032, 1281.84, -1543.14, 1111.88, -459.142, 95.4143, 1.97246}
private

Definition at line 166 of file reactive_fluid_transport.h.

§ csat_peridotite_poly_coeffs

template<int dim>
std::vector<double> aspect::MaterialModel::ReactiveFluidTransport< dim >::csat_peridotite_poly_coeffs {0.00115628, 2.42179}
private

Definition at line 167 of file reactive_fluid_transport.h.

§ Td_peridotite_poly_coeffs

template<int dim>
std::vector<double> aspect::MaterialModel::ReactiveFluidTransport< dim >::Td_peridotite_poly_coeffs {-15.4627, 94.9716, 636.603}
private

Definition at line 168 of file reactive_fluid_transport.h.

§ LR_gabbro_poly_coeffs

template<int dim>
std::vector<double> aspect::MaterialModel::ReactiveFluidTransport< dim >::LR_gabbro_poly_coeffs {-1.81745, 7.67198, -10.8507, 5.09329, 8.14519}
private

Definition at line 170 of file reactive_fluid_transport.h.

§ csat_gabbro_poly_coeffs

template<int dim>
std::vector<double> aspect::MaterialModel::ReactiveFluidTransport< dim >::csat_gabbro_poly_coeffs {-0.0176673, 0.0893044, 1.52732}
private

Definition at line 171 of file reactive_fluid_transport.h.

§ Td_gabbro_poly_coeffs

template<int dim>
std::vector<double> aspect::MaterialModel::ReactiveFluidTransport< dim >::Td_gabbro_poly_coeffs {-1.72277, 20.5898, 637.517}
private

Definition at line 172 of file reactive_fluid_transport.h.

§ LR_MORB_poly_coeffs

template<int dim>
std::vector<double> aspect::MaterialModel::ReactiveFluidTransport< dim >::LR_MORB_poly_coeffs {-1.78177, 7.50871, -10.4840, 5.19725, 7.96365}
private

Definition at line 174 of file reactive_fluid_transport.h.

§ csat_MORB_poly_coeffs

template<int dim>
std::vector<double> aspect::MaterialModel::ReactiveFluidTransport< dim >::csat_MORB_poly_coeffs {0.0102725, -0.115390, 0.324452, 1.41588}
private

Definition at line 175 of file reactive_fluid_transport.h.

§ Td_MORB_poly_coeffs

template<int dim>
std::vector<double> aspect::MaterialModel::ReactiveFluidTransport< dim >::Td_MORB_poly_coeffs {-3.81280, 22.7809, 638.049}
private

Definition at line 176 of file reactive_fluid_transport.h.

§ LR_sediment_poly_coeffs

template<int dim>
std::vector<double> aspect::MaterialModel::ReactiveFluidTransport< dim >::LR_sediment_poly_coeffs {-2.03283, 10.8186, -21.2119, 18.3351, -6.48711, 8.32459}
private

Definition at line 178 of file reactive_fluid_transport.h.

§ csat_sediment_poly_coeffs

template<int dim>
std::vector<double> aspect::MaterialModel::ReactiveFluidTransport< dim >::csat_sediment_poly_coeffs {-0.150662, 0.301807, 1.01867}
private

Definition at line 179 of file reactive_fluid_transport.h.

§ Td_sediment_poly_coeffs

template<int dim>
std::vector<double> aspect::MaterialModel::ReactiveFluidTransport< dim >::Td_sediment_poly_coeffs {2.83277, -24.7593, 85.9090, 524.898}
private

Definition at line 180 of file reactive_fluid_transport.h.

§ devolatilization_enthalpy_changes

template<int dim>
std::vector<std::vector<double> > aspect::MaterialModel::ReactiveFluidTransport< dim >::devolatilization_enthalpy_changes
private

§ water_mass_fractions

template<int dim>
std::vector<std::vector<double> > aspect::MaterialModel::ReactiveFluidTransport< dim >::water_mass_fractions
private

§ devolatilization_onset_temperatures

template<int dim>
std::vector<std::vector<double> > aspect::MaterialModel::ReactiveFluidTransport< dim >::devolatilization_onset_temperatures
private

§ fluid_solid_reaction_scheme


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