Material Properties

The following docstring contains a list of material properties that can be defined for each material in material library files. See Material Collection Files for more details.

EarthBox.Markers.MarkerMaterials.MaterialsContainer.MaterialProperties.MaterialPropertiesState — Type

MaterialPropertiesState

Data structure for storing material properties state.

Fields

melting_params::MeltingParameters: Melting parameters
material_color::MaterialColor: Material color
density::Density: Density
dislocation_creep::DislocationCreep: Dislocation creep
diffusion_creep::DiffusionCreep: Diffusion creep
peierls_creep::PeierlsCreep: Peierls creep
temperature_dependent_viscosity::TemperatureDependentViscosity: Temperature dependent viscosity
blankenbach89_viscosity::Blankenbach89Viscosity: Blankenbach89 viscosity
shear_modulus::ShearModulus: Shear modulus
plasticity::Plasticity: Plasticity
flow_law::FlowLaw: Flow law
heat_capacity::HeatCapacity: Heat capacity
thermal_conductivity::ThermalConductivity: Thermal conductivity
radiogenic_heat_production::RadiogenicHeatProduction: Radiogenic heat production
compaction::Compaction: Compaction

Returns

MaterialPropertiesState: New MaterialPropertiesState parameter group with initialized values

List of Material Properties For Material Collection Files

For a given material in a material collection library file enter the name of the properties followed by a list containing value, units and description:

MaterialName:
    property_name_1: [value, units, description]
    property_name_2: [value, units, description]

Use the standard units defined below. A future version of EarthBox will support material property unit conversion.

The following properties can be entered for a given material:

MeltingParameters

itype_liquidus: Liquidus type ID
stype_liquidus: Liquidus type name
itype_solidus: Solidus type ID
stype_solidus: Solidus type name
latent_heat: Latent heat in J/kg

Density

standard_density: Standard density in kg/m^3
thermal_expansion: Thermal expansion coefficient in 1/K
compressibility: Compressibility in 1/Pa
melt_density: Melt density in kg/m^3

DislocationCreep

pre_exponential_dc: Pre-exponential factor for dislocation creep in 1/s/MPa^n
stress_exponent_n_dc: Stress exponent for dislocation creep
activation_energy_dc: Activation energy for dislocation creep in kJ/mol
activation_volume_dc: Activation volume for dislocation creep in J/MPa/mol

DiffusionCreep

pre_exponential_difc: Pre-exponential factor for diffusion creep in 1/s/MPa^n
activation_energy_difc: Activation energy for diffusion creep in kJ/mol
activation_volume_difc: Activation volume for diffusion creep in J/MPa/mol

PeierlsCreep

pre_exponential_pei: Pre-exponential factor for Peierls creep in s^-m1*MPa^-m2
stress_exponent_m1_pei: Stress exponent m1 for Peierls creep
stress_exponent_m2_pei: Stress exponent m2 for Peierls creep
peierls_stress: Peierls stress in MPa

TemperatureDependentViscosity

pre_exponential_td: Pre-exponential factor for temperature dependent viscosity in Pa.s
activation_energy_td: Activation energy for temperature dependent viscosity in kJ/mol

Blankenbach89Viscosity

viscosity_ref_blankenbach89: Reference viscosity for Blankenbach89 in Pa.s
b_term_blankenbach89: b term for Blankenbach89
c_term_blankenbach89: c term for Blankenbach89

ShearModulus

shear_modulus: Shear modulus in Pa

Plasticity

cohesion_initial: Initial cohesion in Pa
cohesion_final: Final cohesion in Pa
friction_angle_initial: Initial friction angle in degrees
friction_angle_final: Final friction angle in degrees
strain_initial: Initial strain
strain_final: Final strain
dilatation_angle: Dilatation angle in degrees

FlowLaw

flow_type: Flow law type
flow_stype: Flow law type name

HeatCapacity

heat_capacity: Heat capacity in J/kg/K

ThermalConductivity

thermal_conductivity_ref: Reference thermal conductivity in W/m/K
thermal_conductivity_a: Thermal conductivity parameter a in W/m

RadiogenicHeatProduction

radiogenic_heat_production: Radiogenic heat production in W/m^3

Compaction

porosity_initial: Initial porosity in fraction
porosity_decay_depth: Porosity decay depth in m

`stype_solidus`	`itype_solidus`	Description
`"NoMelting"`	-1	Negative one is used to signal a material without melting. This is the default value for itype_solidus.
`"SedimentGerya2010"`	0	Sediment solidus model from Gerya (2010) Table 17.2.
`"UprContCrustGerya2010"`	1	Upper continental crust solidus model from Gerya (2010) Table 17.2.
`"LwrContCrustGerya2010"`	2	Lower continental crust solidus model from Gerya (2010) Table 17.2.
`"DryMantleGerya2010"`	3	Dry mantle solidus model from Gerya (2010) Table 17.2.
`"PeridotiteKatz2003"`	4	Peridotite solidus model from Katz et al. (2003).
`"GabbroGerya2010"`	5	Gabbro solidus model from Gerya (2010) Table 17.2.
`"GabbroSchubert2013"`	6	Gabbro solidus model from Schubert et al. (2013)
`"GabbroGlacier"`	7	Gabbro solidus model that approximates the gabbro glacier model of Maclennan et al. (2004).