Skip to main content
Version: Latest

Configuration parameters

All parameters accepted by DynEarthSol at source revision 1c7ef34, as printed by dynearthsol2d -h and dynearthsol3d -h. A parameter is written in its section of the input file; see Configuration file. Defaults that differ between 2D and 3D are shown for both.

Types: integer, real, yes/no, text, and list (bracketed values, one per material where the parameter is per material; a single value applies to all).

[injection]​

ParameterTypeDefaultDescription
enabledyes/nonoEnable scheduled point sources.
num_pointsinteger0Number of source points.
points_xlist[]Point coordinates; in 2D points_y is the legacy alias for points_z.
points_ylist[]Point coordinates; in 2D points_y is the legacy alias for points_z.
points_zlist[]Point coordinates; in 2D points_y is the legacy alias for points_z.
points_unittextmCoordinate unit: mm, cm, m or km.
rate_modeltextconstant_rateSource schedule: constant_rate or total_amount.
ratelist[0]Positive rate supplies fluid volume or heat; negative rate extracts.
total_amountlist[0]Total fluid volume or heat over the scheduled interval.
start_time_in_yrlist[0]Source start time in years.
end_time_in_yrlist[]Finite end times in years; alternative to duration.
duration_in_yrlist[]Positive schedule durations in years.
temperaturelist[]Temperature (K) of the injected fluid of each point; requires has_fluid_thermal_advection. An injecting node gains rho_f*c_f*Q*(T_in - T); extraction leaves at the local temperature. Unset: the fluid source carries no enthalpy and a heat source must be given separately.

[heat_injection]​

ParameterTypeDefaultDescription
enabledyes/nonoEnable scheduled point sources.
num_pointsinteger0Number of source points.
points_xlist[]Point coordinates; in 2D points_y is the legacy alias for points_z.
points_ylist[]Point coordinates; in 2D points_y is the legacy alias for points_z.
points_zlist[]Point coordinates; in 2D points_y is the legacy alias for points_z.
points_unittextmCoordinate unit: mm, cm, m or km.
rate_modeltextconstant_rateSource schedule: constant_rate or total_amount.
ratelist[0]Positive rate supplies fluid volume or heat; negative rate extracts.
total_amountlist[0]Total fluid volume or heat over the scheduled interval.
start_time_in_yrlist[0]Source start time in years.
end_time_in_yrlist[]Finite end times in years; alternative to duration.
duration_in_yrlist[]Positive schedule durations in years.

[sim]​

Model name, run length, output, checkpoints and restart.

ParameterTypeDefaultDescription
modelnametext–Prefix for the output files
max_stepsinteger–Max. number of time steps
max_time_in_yrreal–Max. time (in years)
output_step_intervalinteger–Output step interval
output_time_interval_in_yrreal–Output time interval (in years)
info_display_step_intervalinteger0Step interval for showing model status on screen. 0: use default (= 100 * mesh.quality_check_step_interval). >0: rounded up to a multiple of mesh.quality_check_step_interval.
has_runtime_info_displayyes/noyesPrint the .manifest's sections on screen at run start, one line each, [build] then [runtime]. On by default: it is the start-of-run report every run printed before this option. The .manifest is written regardless.
checkpoint_frame_intervalinteger10How frequent to write checkpoint file (used for restarting simulation)?
restarting_from_modelnametext–Prefix for the checkpoint and save files for restarting.
restarting_from_frameinteger–Which output frame to read for restarting?
is_restartingyes/nonoRestarting from previous checkpoint file?
has_initial_checkpointyes/noyesOutput checkpoint file at 0th step?
has_marker_outputyes/noyesOutput marker coordinate and material?
has_output_during_remeshingyes/nonoOutput immediately before and after remeshing?
is_outputting_averaged_fieldsyes/noyesOutput time-averaged (smoothed) field variables or not. These fields are: velocity, strain rate, and stress. no: output instantaneous fields. The velocity and strain-rate might oscillate temporally. yes: output field variables averaged over mesh.quality_check_step_interval time steps.
earthquake_output_step_intervalinteger50Output step interval while earthquake mode is active.
earthquake_start_factorreal5Earthquake start threshold factor: vmax > factor * max_vbc_val.
earthquake_end_factorreal2Earthquake end threshold factor: vmax < factor * max_vbc_val.
seismic_moment_calculate_outputyes/nonoIf true, the seismic moment, sum of 2 G V times the plastic-strain increment over all elements, is accumulated during earthquake mode and written with Mw at its end. In 2D V is the element area and M0 is per unit length out of the plane, without Mw.
hdf5_compression_levelinteger4HDF5 compression level (0-9). 0: no compression; 9: max. compression. A higher compression level could slow down the output speed.

[monitor]​

Point monitors written as CSV time series.

ParameterTypeDefaultDescription
enabledyes/nonoEnable point-based generic monitoring output?
step_intervalinteger10Monitoring output step interval.
num_pointsinteger0Number of monitoring query points.
points_xlist[]Monitoring x coordinates array '[x0, x1, ...]'.
points_ylist[]Monitoring y coordinates array '[y0, y1, ...]' (3D only; 2D legacy alias for monitor.points_z).
points_zlist[]Monitoring z coordinates array '[z0, z1, ...]' (2D second coordinate or 3D third coordinate).
points_unittextmUnit of monitor.points_x/z in 2D, or monitor.points_x/y/z in 3D: mm, cm, m, km.
point_typetextparticleEach point follows the material through deformation, remeshing and restart. particle: values interpolated at the point; grid: values of the node and element nearest it.
remesh_outputtextbeforeRows at a remesh, marked in the last CSV column, row. before: the state before each remesh (row 1) unless that step already has a regular row (row 0); both: also the remapped state after it (row 2).
output_prefixtextmonitorPrefix of monitoring output files.
write_headeryes/noyesWrite CSV header row for monitoring outputs?
output_coordyes/noyesOutput node coordinate columns.
output_velocityyes/noyesOutput node velocity columns.
output_forceyes/nonoOutput node force columns.
output_temperatureyes/nonoOutput node temperature.
output_pore_pressureyes/nonoOutput node pore pressure.
output_bcflagyes/nonoOutput node boundary-flag value.
output_stressyes/nonoOutput element stress components.
output_strainyes/nonoOutput element strain components.
output_strain_rateyes/nonoOutput element strain-rate components.
output_plastic_strainyes/nonoOutput element plastic strain.
output_plastic_strain_rateyes/nonoOutput element plastic strain-rate.
output_radiogenic_sourceyes/nonoOutput element radiogenic source.
output_densityyes/nonoOutput element density.
output_mesh_qualityyes/nonoOutput element mesh quality.
output_viscosityyes/nonoOutput element viscosity.
output_materialyes/nonoOutput element material index.
output_dynamic_frictionyes/nonoOutput dynamic friction value.
output_state_variableyes/nonoOutput state variable value.

[mesh]​

Domain size, mesh generation, resolution, quality checks and remeshing.

ParameterTypeDefaultDescription
meshing_optioninteger1How to create the new mesh? 1: rectangular box with roughly uniform resolution 2: rectangular box with rectangular zone of refined resolution 90: read the bounding polygon from a .poly file 91: same as 90, but the max. element size is normalized with resolution. 95: read the mesh from from a .exo file
meshing_elem_shapeinteger0Mesh layout. 0: unstructured triangles (2D) or tetrahedra (3D); 1: regular rectangular cells split into triangles/tetrahedra; 2: equilateral triangles (2D) or a regular tetrahedral layout (3D). All solver elements are simplices.
meshing_verbosityinteger-1Screen output of meshing and remeshing. -1: no stage log (default). 0: the stage log ([metric], [collapse], [freeze], [unfreeze], [require], [corner], [mmg], [restore], [GPU mem] lines: what a remesh re-sized, collapsed, froze, freed and restored) and the mesher's standard report. 1-3: Triangle/TetGen -V levels on top. Warnings print at every level.
meshing_sedimentyes/nonoRefine the elements with sediment marker during remeshing.
tetgen_optlevelinteger3Optimization level for tetgen. 0: no optimization; 1: multiple edge filps; 2: 1 & free vertex deletion; 3: 2 & new vertex insertion. High optimization level could slow down the speed of mesh generation. For 3D only.
xlengthrealrequiredLength of x (in meters)
ylengthrealrequiredLength of y (in meters), for 3D only
zlengthrealrequiredLength of z (in meters)
resolutionrealrequiredSpatial resolution (in meters)
smallest_sizereal0.01The size of smallest element relative to an element with typical resolution. It sets the tiny-element remesh trigger smallest_vol = smallest_size * sizefactor * resolution^NDIMS (sizefactor 0.433 in 2D, 0.118 in 3D: a unit-edge equilateral element's measure) and two lengths, hmin = smallest_size^(1/NDIMS) * resolution and min_dist = (smallest_size * sizefactor)^(1/NDIMS) * resolution. hmin is the Triangle/TetGen node-spacing floor (a remesh deletes interior nodes closer than hmin to a retained node), with MMG in 2D the boundary-segment length below which a remesh merges the segment's two nodes (never a domain corner), and the necking-stop distance of remeshing_option 1, 11 and 13 (see remeshing_option). With options 1, 11 and 13 a remesh removes the nodes off a restored boundary that lie past it or within min_dist of it, and option 2 the interior nodes within min_dist of the new bottom; with options 1 and 10-12 Triangle keeps a boundary node whose two segments are both longer than min_dist, and in 3D TetGen's boundary edge flips move a boundary by at most min_dist; at a receiving wall, option 13 gives the side profile to new material up to min_dist inland of the old wall. With MMG it also sets MMG's size floors (see mmg_remesh_defensive_tiny_ratio).
largest_sizereal30The size of largest element relative to an element with typical resolution, which also caps the coarse zone of a meshing_option = 2 mesh. With MMG it also sets the maximum edge length, hmax = largest_size^(1/NDIMS) * resolution
sediment_sizereal1The size threshold of the refined sediment elements
min_anglereal32Min. angle of all triangles (in degrees), for 2D only
max_steiner_factorreal30Cap on the number of Steiner points Triangle may insert while (re)meshing, expressed as a multiple of the number of input nodes (2D only). This bounds the pathological, non-terminating segment splitting that Triangle can enter when two boundary segments meet at a very small angle (e.g. a highly distorted mesh at extreme strain), which would otherwise spin forever and exhaust memory. The cap is far above any healthy remesh, so normal meshing is unaffected. Set <= 0 to disable the cap (Triangle default: unlimited).
min_tet_anglereal22Min. dihedral angle of all tetrahedra (in degrees), for 3D only
max_ratioreal2Max. radius / length ratio of all tetrahedra, for 3D only
refined_zonexlist[0.4, 0.6]Refining portion of xlength ([d0,d1]; 0<=d0<=d1<=1), for meshing_option=2 only
refined_zoneylist[0.4, 0.6]Refining portion of ylength ([d0,d1]; 0<=d0<=d1<=1), for meshing_option=2 only, for 3D only
refined_zonezlist[0.8, 1]Refined depth interval [d0,d1] as fractions of zlength measured downward from the top (0 <= d0 <= d1 <= 1); meshing_option=2 only.
poly_filenametextmesh.polyInput polygon filename for meshing_option=90 or 91. Triangle .poly format in 2D; TetGen .poly format in 3D. Region attributes select materials when ic.mattype_option=0. Point attributes, point boundary markers and holes are not supported. Also supply mesh.xlength, mesh.ylength and mesh.zlength.
exo_filenametextmesh.exoFilename of the input polygon, for meshing_option=95 only. Meshing software like Trelis is supposed to be used for creating a mesh in the ExodusII format. Limitation: Only box-like domains with six sides are supported. Users still need to provide these parameters: mesh.xlength, mesh.ylength, and mesh.zlength.
quality_check_step_intervalinteger100How often to check mesh quality?
min_qualityreal0.4Min. mesh quality before remeshing (between 0 and 1)
max_boundary_distortionreal0.25Max. distance of boundary distortion before remeshing (in unit of mesh.resolution).
remeshing_optioninteger0How to deal with the boundaries during remeshing? 0: no modification on any boundary. 1: move all bottom nodes to initial depth and delete the side-wall nodes left just above or below it; other boundaries are intact. 2: create a new bottom boundary at the initial depth, other boundaries are intact (2D only, not with MMG remeshing). 10: no modification on any boundary, except small boundary segments might get merged (in 3D with TetGen, see smallest_size). 11: move all bottom nodes to initial depth and delete the side-wall nodes left just above or below it; other boundaries are intact, except small boundary segments might get merged. 12: move all x0 (left) wall nodes to the x of the wall's top corner and delete the nodes left outside, other boundaries are intact. For a wall pushed over a fixed bottom with its push tapered toward it (vbc_x0 = 3 with bottom_shear_zone_thickness), whose foot lags its top. With MMG remeshing, 2D only. 13: move all bottom and side-wall nodes (left/right; also front/back in 3D) to initial dimensions, and give material entering through a side wall the structure recorded at that wall (its side profile). A wall receives while its nodes drift inward between remeshes (by any amount when its vbc at the remesh is inflow, else by more than min(1e-3, max_boundary_distortion) * resolution). It keeps the column (2D) or wall face (3D) recorded when it started receiving (at run start when its vbc is inflow, else at the first remesh at which it receives), and drops it when it neither receives nor has an inflow vbc. Incoming material gets the recorded temperature, layering, radiogenic source, coord0 reference and zero strain at its depth below the wall's top point less the rise surface processes gave it, and in 3D at its along-strike position (a point off the recorded face takes the values of the face's nearest point). A deposit on the wall top gets the profile top's values. Markers a remesh creates in an element at the wall take the layering at the element's centroid and time 0; in an element centred in the deposit, mattype_sediment and the time of a sediment marker of the element, else the remesh time. Temperatures are not re-conducted under a risen surface, so they can differ from the domain beside the wall by up to the near-surface temperature gradient times the rise. Requires MMG when meshing_elem_shape = 0: the restored wall accumulates sub-hmin elements that only MMG collapses. With MMG on an unstructured mesh, a Triangle/TetGen initial mesh first gets its restored-wall elements refined to ~resolution, whatever use_mmg_init says (in 3D under mattype_option 0 this can move a regional-attribute boundary inside the wall band), and every remesh caps the size target at every restored-wall node at resolution (see mmg_aniso_wall_ratio), so the walls can carry more elements than the cfg's sizes give. 14: restore selected reference-boundary components (2D unstructured meshes only; mesh.remeshing_reset_boundaries). On an unstructured mesh (meshing_elem_shape = 0), options 1, 11 and 13 stop the run at a remesh (exit 42) when a top-surface node is within smallest_size^(1/NDIMS) * resolution of the restored bottom, or below it: the domain has necked through.
num_remeshing_reset_boundariesinteger0Number of selected boundary-marker bits for remeshing_option=14.
remeshing_reset_boundarieslist[]Boundary-marker bits to restore, e.g. [1,16]. Single faces restore normal components; two selected faces restore their corner fully.
mmg_remesh_active_plstrainreal0.01Conservative MMG remeshing (always on with MMG): a remesh keeps quiet elements as they are (frozen) and rebuilds the rest. This key is the plastic-strain increment since the last remesh above which an element is refined: MMG may split it (not along an edge it shares with a frozen, MMG-required element) but keeps its existing nodes, so the band's plastic strain is carried verbatim. Distorted or tiny elements are repaired with node motion (see mmg_remesh_defensive_quality_ratio and mmg_remesh_defensive_tiny_ratio), and so is the mesh that restoring a boundary squashed or collapsed or that merging a short boundary segment (see smallest_size) reshaped. Elements far from their size target are freed (see mmg_remesh_size_recovery_ratio), as is the band beside a receiving or outward-drifting restored wall (remeshing_option 13). Boundary nodes stay pinned except the free-surface nodes a surface process moves by more than 1% of resolution per remesh interval (2D only, surface_process_option 1 or 102), the off-bottom nodes of unrestored side walls and slant boundaries, the nodes of repaired elements and the band nodes off an outward-drifting restored wall. Keep it > 0: at 0, incidental yielding makes quiet far-field elements splittable at every remesh. Default 0.01, heuristic: above the increment of incidental yielding, below a localizing band's increment over a remesh interval.
mmg_remesh_defensive_tiny_ratioreal1.5Gap, in element measure, between the tiny-element remesh trigger smallest_vol (see smallest_size) and the smallest elements MMG builds (usemmg=1, meshing_elem_shape = 0; remeshing and MMG-built initial meshes). MMG's minimum edge length is hmin * ratio^(1/NDIMS) (hmin: see smallest_size), so MMG aims to build every element at smallest_vol * ratio or more, which must shrink by this factor before it re-triggers, and a remesh rebuilds any element below smallest_vol * ratio. The ratio also sets MMG's metric floor one step higher, hmin * ratio^(2/NDIMS) (at most MMG's hmax), and the post-remesh quality gate at smallest_vol * sqrt(ratio). Must be >= 1 (at 1 a just-remeshed element re-triggers under any compression); a ratio at or above largest_size / smallest_size is capped just below it, with a warning. Default 1.5 (a 2/3 measure gap), heuristic.
mmg_remesh_defensive_quality_ratioreal1.5MMG remeshing repairs (unfreezes, with its nodes movable except where disjoint material bodies meet) every element of quality below min_quality * this ratio, so a marginal element is rebuilt before it crosses the min_quality remesh trigger instead of triggering another remesh a few steps later. The trigger itself stays at min_quality. Must be >= 1 (1: repair only below the trigger). Default 1.5, heuristic.
mmg_remesh_size_recovery_ratioreal1.4Size recovery in MMG remeshing. A quiet element (e.g. one that entered at ~resolution through a restored inflow wall and advected inland) is freed to coarsen when it is finer by more than this factor than the gradation envelope, the smallest size MMG's gradation (hgrad) allows there given every intentionally fine size target; an element at least 2x its own plastic-strain size target is freed to split. Neither frees an element refined for plastic-strain growth (mmg_remesh_active_plstrain), one on the top surface, one at a material interface (by its own and its neighbours' markers) or one within 4 rings of a restored wall that receives no material, and neither unpins a restored-wall or bottom node; the remesh log's '[unfreeze] size recovery' line counts the top-surface, interface and wall-band skips. On a moving mesh, a Triangle/TetGen initial mesh also gets the 2x split in its weak zone before any field exists, except on a top-surface node or a region boundary ('[weakzone]' log lines). 0 disables all three; otherwise must be > 1 (a margin against re-freeing the legal size transition). Default 1.4 ~ sqrt(2) in edge length (one 2D bisection level), heuristic.
remesh_deborah_minreal1During remeshing the element stress is a Deborah-number-weighted blend of the NN-remapped stress and the SPR recovery, De = Maxwell time / time since the last remesh. The weight is a smoothstep -- the cubic 3t^2 - 2t^3, flat at both ends -- in log10(De): high-De (cold, effectively elastic) elements keep the NN stress, preserving elastic stress memory; low-De (weak, viscous) elements take the SPR average, which suppresses element-scale noise. This sets the De at or below which the remeshed stress is purely the SPR recovery.
remesh_deborah_maxreal100De at or above which the remeshed stress is purely the NN-remapped stress. The default puts the two limits two decades apart, which keeps them clear of the De = 1 crossover while remesh intervals themselves vary by a factor of a few between events; widen it to blend more of the domain, narrow it to make the switch sharper. The window width is otherwise untuned.
is_discarding_internal_segmentsyes/noyesDiscard the initial mesh's internal segments (refined-zone box, .poly internal facets)? 'no' keeps them as Triangle/TetGen constraints across remeshes, but a remesh that deletes one of their nodes (tiny-element repair, node cleanup near a restored boundary) misroutes them, which can make the mesher fail or hang; in 3D with remeshing_option 1 or 10-12 the first remesh that deletes a boundary node drops them all. MMG remeshing (usemmg=1, meshing_elem_shape = 0) requires 'yes': MMG keeps no internal segment.
mmg_debuginteger0Run MMG remesher in debug mode? No:0; Yes:1
mmg_verboseinteger0Verbosity level of MMG remesher. For debugging, set a value greater than 4.
mmg_hausd_factorreal0.01Factor multiplied to param.mesh.resolution to set the Hausdorff distance between original and remeshed surfaces. At 0.01 MMG refines a sharply bent free surface down to its size floor and builds elements below the tiny-element trigger there, so the trigger fires at nearly every quality check: use 0.02-0.05 along a 3D fault scarp and 0.1 on the top/wall ridges next to restored side walls. MMG3D does not bound its top-surface edge swaps between pinned nodes by this distance.
mmg_init_coarsening_factorreal10Coarsening factor for the two-stage TetGen+MMG init mesh. TetGen creates a mesh with element volumes scaled by factor^NDIMS; MMG then refines to target resolution. Higher values = smaller coarse mesh = faster TetGen but more MMG work. Default: 10.
use_mmg_inityes/nonoUse two-stage TetGen+MMG initialization? Requires compilation with USEMMG. Set to yes for metric-aware refinement; no (default) uses plain triangle/tetgen init (MMG still refines its restored walls under remeshing_option 13 and, on a moving mesh, its weak zone: see mmg_remesh_size_recovery_ratio). Under mattype_option 0, which reads the regional attributes as mattypes, a boundary between them stays on the .poly line in 2D and can move by up to about half a coarse element in 3D (see mmg_init_coarsening_factor).
mmg_metric_refine_coeffreal5Plastic-strain sensitivity of the MMG remeshing metric: the target element volume is scaled by 1/(1 + coeff*plastic_strain), so the target edge length by that ratio^(1/NDIMS) (whether a node keeps its finest target: see mmg_metric_refine_recover). 0 disables plastic refinement from a fresh start (the metric floor, the surface-motion inflation of shrinking top elements and the option-13 restored-wall cap still apply). MMG starts from this target except at a node on a required edge (an edge of a frozen element or, in 2D, an option-13 material-interface edge) that belongs to no refined element (see mmg_remesh_active_plstrain): there it starts from the mean length of the required edges through the node, MMG's own rule. Larger values mesh a plastically strained zone finer, down to the metric floor (see mmg_remesh_defensive_tiny_ratio): a shear band can localize narrower, at more elements and, where an elastic, advection or diffusion limit sets dt, a shorter time step. Default 5.
mmg_metric_refine_recoveryes/nonono (default): each node keeps the finest plastic-strain size target (see mmg_metric_refine_coeff) it has had at a remesh, so a refined zone stays refined where the target coarsens, chiefly where plastic strain drops (the remap of rebuilt elements, the 2D top-element plastic-strain decay, a growing top element); the mesh can then hold more elements. Size recovery (mmg_remesh_size_recovery_ratio) measures against the kept size, and material entering through a restored side wall starts unrefined. yes: the target follows the current plastic strain. The record is checkpointed: with no, a restart that lowers mmg_metric_refine_coeff (even to 0) keeps the sizes recorded before it, and a restart that switches from yes to no holds from the last remesh's targets.
mmg_aniso_wall_ratioreal0Anisotropic MMG metric at inflow restored side walls (remeshing_option 13). 0 (default): off, isotropic. >= 1: aspect ratio; the inflow-wall elements are coarsened by this factor normal to the wall and kept fine along it, so the incoming column is carried by thin, wide elements. MMG's hmax (see largest_size) caps the aspect (~5.5 in 2D, ~3.1 in 3D at the default largest_size). Other values below 1 are rejected. Requires USEMMG.
vt_sizereal0.5Cell size of the virtual-topology marker grid (in unit of mesh.resolution), used by the serpentinization grid (mat.phase_change_option 3 with mat.has_serpentinization). 0.5 = half an element edge: the one-element-thick slab crust gets its own wet-crust-dominant cell row instead of averaging with the mantle above, while a cell nominally (elements of edge mesh.resolution) holds ~2.3 markers in 2D (~4.2 in 3D) at the default 4 per element; a refined mesh puts more in each cell. Heuristic, untuned. With serpentinization on it must be > 0, and mesh.resolution * mesh.vt_size must not exceed mat.serpentinization_thickness. The grid is rebuilt at each mesh.quality_check_step_interval and after each remesh.

[markers]​

Lagrangian markers that carry material identity.

ParameterTypeDefaultDescription
init_marker_optioninteger1How to generate markers? 1: randomly distributed markers. 2: regularly spaced markers.
markers_per_elementinteger4Number of markers per element. Used when init_marker_option=1.
init_marker_spacingreal0.3Spacing of markers (in unit of mesh.resolution). Used when init_marker_option=2. An element the grid misses gets min_num_markers_in_element (at least 1) markers of its initial material, with a warning.
min_num_markers_in_elementinteger3When the number of markers in an element is less than this number, a new marker will be replenished in the element.
replenishment_optioninteger2How to determine the mattype of replenished markers? 0: always set to 0 (fastest option). 1: by the probability of marker mattype of the element or surrounding elements. 2: same as the mattype of the nearest marker (slowest option). 12: if the element's surviving markers are all one mattype, use that mattype directly (deposit-time interpolated for mattype_sediment, as in option 2); otherwise fall back to option 2 (nearest marker). Exact in single-material elements. At a remesh, independently of this option, an element whose part inside the old mesh lies in one old element whose markers were all one mattype gets that mattype, and with remeshing_option 13 an element at a receiving wall gets the wall's recorded layering (see remeshing_option).
random_seedinteger1Random seed of marker position. If 0, the current time is used as the seed.

[control]​

Gravity, time stepping, mass scaling, damping, the PT solver, and heat and fluid transport.

ParameterTypeDefaultDescription
gravityreal10Magnitude of the gravity (in m/s^2)
characteristic_speedreal0Characteristic tectonic speed (in m/s). It is used to estimate the size of stable time step. If it is 0, its value is inferred from the imposed boundary velocity. Set it to other value if the imposed boundary velocity is 0 everywhere.
is_quasi_staticyes/noyesIs the simulation quasi-static or dynamic? If quasi-static, inertial scaling and strong damping is applied.
dt_fractionreal1Take dt as a fraction of max. stable time step size (0-1).
fixed_dtreal0Fixed dt size (in seconds). If 0, dt sized will be determined dynamically.
inertial_scalingreal100000Scaling factor for inertial (a large number)
damping_optioninteger1How to damp the elastic wave? 0: no damping. 1: damping/acceleration depends on force and direction of velocity. 2: damping depends on force. 3: damping/(weaker) acceleration depends on force and direction of velocity. 4: Rayleigh damping.
damping_factorreal0.8A factor for force damping (0-1)
ref_pressure_optioninteger0How to define reference pressure? 0: using density of the mat.mattype_ref-th material to compute lithostatic pressure. 1: computing reference pressure from the PREM model. 2: computing reference pressure from the PREM model, modified for continent. Any other value is rejected at startup.
is_using_mixed_stressyes/noyesIf use Nodal Mixed Discretization For Stress
surface_process_optioninteger0What kind of surface processes? 0: no surface processes. 1: using simple diffusion to modify surface topography. 2: using simple deposition. 11: using GoSPL landscape evolution model. 101: custom function. 102: using simple deposition and diffusion.
surface_diffusivityreal1e-06Standard diffusition coefficient of surface topography (m^2/s)
surf_diff_ratio_terrigreal1Ratio between terrigenous and standard Diffusition coefficients.
surf_diff_ratio_marinereal1Ratio between marine and standard Diffusition coefficients.
surf_depo_universalreal0Sedimentation rate of universal suspended deposite (in m/s).
surf_base_levelreal0Base level of surface processes (m); also the sea level used by bc.has_water_loading.
surface_process_gospl_config_filetextConfiguration file path for GoSPL surface processes (used with surface_process_option = 11).
gospl_coupling_frequencyinteger1Run GoSPL coupling every N DES steps (used when gospl_coupling_mode = steps).
gospl_coupling_interval_in_yrreal1000Run GoSPL coupling every T years (used when gospl_coupling_mode = time). E.g. 1000 = couple once per 1000 yr.
gospl_coupling_modetextstepsCoupling frequency mode: 'steps' (use gospl_coupling_frequency) or 'time' (use gospl_coupling_interval_in_yr).
gospl_velocity_couplingyes/noyesSend all three DES surface velocity components (vx, vy, vz) to GoSPL each coupling step. vz drives uplift/subsidence; vx/vy drive semi-Lagrangian horizontal advection of GoSPL topography.
gospl_mesh_resolutionreal-1GoSPL mesh node spacing in meters (default: -1 = auto-size based on DES surface nodes). Set to desired resolution for control over GoSPL grid density.
gospl_mesh_perturbationreal0.3Fraction of grid spacing to randomly perturb node positions (0-1). 0 = regular grid, 0.3 = moderate perturbation to avoid grid artifacts.
gospl_mesh_paddingreal0.1Fractional extension of the GoSPL mesh beyond the DES domain on each side (default: 0.1 = 10%). Keeps DES nodes in the interior of GoSPL's mesh, away from boundary artifacts.
terrig_sediment_diffusivityreal3.17e-06Submarine diffusion coefficient (=100 m^2/yr, Kaufman et al., 1991) (in m^2/s).
terrig_depth_coefficientreal0.0005Submarine diffusion coefficient decay (Kaufman et al., 1991) (in m^-1).
is_reporting_terrigenous_infoyes/nonoIf report surface terrigenous information.
hemipelagic_sedimentation_ratereal3.17e-11Hemipelagic sedimentation (Emmerich et al., 2009) (1 km/Myr ~= 3.17e-11 m/s)
hemipelagic_widthreal90Width of the productivity function (m)
hemipelagic_max_depthreal40Maximum accumulation bathymetry (m)
pelagic_sedimentation_ratereal1.585e-12Pelagic sedimentation rate (Emmerich et al., 2009) (0.05 km/Myr ~= 1.585e-12 m/s)
pelagic_increasing_widthreal30Width of the suface increasing zone (m)
terrig_sediment_volumereal1The volume of the sediment bring from continent source (in m^3/s). 5e7 ton/yr ~= 1 m^3/s
terrig_sediment_areareal3.17e-07The are of the sediment bring from continent source (=10 m^2/yr) (in m^2/s). Assuming the width of the channel is 50 km, 5e7 ton/yr ~= 2.e-5 m^2/s
has_thermal_pressurizationyes/nonoCouple thermal expansion to solid stress and fluid content; requires hydraulic and thermal diffusion.
has_shear_heatingyes/nonoConvert accepted viscous/plastic work to heat. Pending energy is deposited at the next physical thermal update, independently of changes in timestep; initial PT equilibration does not generate heat. All computed nonelastic work is converted (unit heat fraction).
has_fluid_thermal_advectionyes/nonoTransport heat with Darcy flow using combined rock/water heat capacity; requires hydraulics.
has_poroelastic_pressure_feedbackyes/noyesInclude mechanical volumetric/mean-stress changes in the hydraulic source; transport remains active when false.
has_thermal_diffusionyes/noyesDoes the model have thermal diffusion? If not, temperature is advected, but not diffused.
has_hydraulic_diffusionyes/nonoDoes the model have hydraulic diffusion? If not, pore pressure is advected, but not diffused.
hydraulic_content_modelinteger0Fluid content: 0 linear Biot/retention, 1 finite-density saturated mass balance with evolving Biot porosity.
has_hydration_processesyes/nonoDoes the model have hydration processes? It is required to model some types of phase changes.
hydration_migration_speedreal3e-09The upward migration speed of hydrous fluid (in m/s).
has_PTyes/nonoDoes the model have Pseudo-transient (PT) loop?
PT_use_running_scaleyes/nonoUse running physical initial-residual scale with a roundoff floor (epsilon=1e-6, C=1000)
PT_max_iterinteger5000Maximum iteration for PT loop
PT_relative_tolerancereal1e-06Relative tolerance on projected physical-force RMS, scaled by the first warm trial
PT_absolute_tolerancereal0Absolute projected-force RMS tolerance (N/m in 2D, N in 3D)
PT_optioninteger0PT iteration scheme. Both accept the same physical residual. 0: accelerated pseudo-transient relaxation (Rass et al. 2022), uses PT_CFL and PT_Re. 1: adaptive dynamic relaxation: Gershgorin fictitious mass and damping from a Rayleigh-quotient estimate of the lowest mode (Underwood 1983; Papadrakakis 1981).
PT_CFLreal0.25Pseudo-wave CFL factor for local dual-time relaxation (0 < CFL <= 0.5)
PT_Rereal14.9019Positive pseudo Reynolds number for dual-time relaxation
PT_stagnation_windowinteger500Warn once per solve after this many iterations without best-residual improvement; 0 disables warning
has_moving_meshyes/noyesDoes the model update mesh coordinates (Lagrangian)?
use_global_velocity_scalingyes/nonoUse the global maximum model velocity to scale both dt and pseudo-density/mass scaling.
mass_scaling_reference_speedtextshearElastic-speed ceiling used by global velocity scaling. It sets the floor of the fictitious density rho_fict = K / v_elastic^2. shear: sqrt(G/rho), giving rho_fict >= rho K/G (historical default). bulk : sqrt(K/rho), giving rho_fict >= rho and restoring physical density when the pseudo-wave speed reaches the bulk-wave ceiling.
rsf_slip_rate_projection_optioninteger0Velocity-dimensional rate supplied to the RSF update. 0: project the element velocity onto the maximum-shear direction inferred from stress (default; the historical behavior). 1: use V = 2 w eps_II from the total deviatoric strain rate, where w is the element's minimum altitude.
rsf_dtheta_maxreal0For adaptive stepping with the aging law and total-strain rate option 1, apply dt <= f D_c / V and dt <= f theta over all elements. The two bounds limit slip within one characteristic distance and fractional healing per step. f must be in [0, 2); 0 (default) disables this state-update limit.

[bc]​

Velocity, traction, thermal and hydraulic boundary conditions, and surface processes.

ParameterTypeDefaultDescription
tbc_x0integer0Thermal boundary: 0 insulated, 1 fixed temperature.
tbc_val_x0realnanFixed boundary temperature in K; defaults to surface_temperature (mantle_temperature at z0). It is applied at initialization, so a value that differs from the initial temperature is part of the initial state, not a thermal load; to heat a boundary at t > 0, restart with the new value.
tbc_x1integer0Thermal boundary: 0 insulated, 1 fixed temperature.
tbc_val_x1realnanFixed boundary temperature in K; defaults to surface_temperature (mantle_temperature at z0). It is applied at initialization, so a value that differs from the initial temperature is part of the initial state, not a thermal load; to heat a boundary at t > 0, restart with the new value.
tbc_y0integer0Thermal boundary: 0 insulated, 1 fixed temperature.
tbc_val_y0realnanFixed boundary temperature in K; defaults to surface_temperature (mantle_temperature at z0). It is applied at initialization, so a value that differs from the initial temperature is part of the initial state, not a thermal load; to heat a boundary at t > 0, restart with the new value.
tbc_y1integer0Thermal boundary: 0 insulated, 1 fixed temperature.
tbc_val_y1realnanFixed boundary temperature in K; defaults to surface_temperature (mantle_temperature at z0). It is applied at initialization, so a value that differs from the initial temperature is part of the initial state, not a thermal load; to heat a boundary at t > 0, restart with the new value.
tbc_z0integer0Thermal boundary: 0 insulated, 1 fixed temperature.
tbc_val_z0realnanFixed boundary temperature in K; defaults to surface_temperature (mantle_temperature at z0). It is applied at initialization, so a value that differs from the initial temperature is part of the initial state, not a thermal load; to heat a boundary at t > 0, restart with the new value.
tbc_z1integer1Thermal boundary: 0 insulated, 1 fixed temperature.
tbc_val_z1realnanFixed boundary temperature in K; defaults to surface_temperature (mantle_temperature at z0). It is applied at initialization, so a value that differs from the initial temperature is part of the initial state, not a thermal load; to heat a boundary at t > 0, restart with the new value.
surface_temperaturereal273Surface temperature (in Kelvin)
mantle_temperaturereal1600Mantle temperature (in Kelvin)
has_winkler_foundationyes/noyesUsing Winkler foundation for the bottom boundary?
winkler_delta_rhoreal0Excess density of the bottom Winkler foundation (in kg/m^3)
has_elastic_foundationyes/nonoUsing elastic foundation for the bottom boundary?
elastic_foundation_constantreal1e+11Elastic constant for elastic foundation.
has_water_loadingyes/noyesApplying water loading for top boundary that is below sea level?
sea_water_densityreal1030Density of the loading water (in kg/m^3). Used for the top-boundary water load and for the free-surface stress pin that must match it.
hbc_x0integer0Hydraulic boundary type. 0: no normal flow; 1: hold the initial nodal pressure; 2: prescribed bc.hbc_pressure entry (Pa), multiplied by the boundary schedule; 3: prescribed bc.hbc_flux entry (m/s, positive outward), multiplied by the boundary schedule. Lists use x0 x1 y0 y1 z0 z1 order; y sides apply only in 3D.
hbc_x1integer0Hydraulic boundary type. 0: no normal flow; 1: hold the initial nodal pressure; 2: prescribed bc.hbc_pressure entry (Pa), multiplied by the boundary schedule; 3: prescribed bc.hbc_flux entry (m/s, positive outward), multiplied by the boundary schedule. Lists use x0 x1 y0 y1 z0 z1 order; y sides apply only in 3D.
hbc_y0integer0Hydraulic boundary type. 0: no normal flow; 1: hold the initial nodal pressure; 2: prescribed bc.hbc_pressure entry (Pa), multiplied by the boundary schedule; 3: prescribed bc.hbc_flux entry (m/s, positive outward), multiplied by the boundary schedule. Lists use x0 x1 y0 y1 z0 z1 order; y sides apply only in 3D.
hbc_y1integer0Hydraulic boundary type. 0: no normal flow; 1: hold the initial nodal pressure; 2: prescribed bc.hbc_pressure entry (Pa), multiplied by the boundary schedule; 3: prescribed bc.hbc_flux entry (m/s, positive outward), multiplied by the boundary schedule. Lists use x0 x1 y0 y1 z0 z1 order; y sides apply only in 3D.
hbc_z0integer0Hydraulic boundary type. 0: no normal flow; 1: hold the initial nodal pressure; 2: prescribed bc.hbc_pressure entry (Pa), multiplied by the boundary schedule; 3: prescribed bc.hbc_flux entry (m/s, positive outward), multiplied by the boundary schedule. Lists use x0 x1 y0 y1 z0 z1 order; y sides apply only in 3D.
hbc_z1integer0Hydraulic boundary type. 0: no normal flow; 1: hold the initial nodal pressure; 2: prescribed bc.hbc_pressure entry (Pa), multiplied by the boundary schedule; 3: prescribed bc.hbc_flux entry (m/s, positive outward), multiplied by the boundary schedule. Lists use x0 x1 y0 y1 z0 z1 order; y sides apply only in 3D.
hbc_pressurelist[0,0,0,0,0,0]Pressure in Pa for hbc=2, ordered x0 x1 y0 y1 z0 z1.
hbc_fluxlist[0,0,0,0,0,0]Outward Darcy flux in m/s for hbc=3, ordered x0 x1 y0 y1 z0 z1.
num_hbc_scheduleinteger1Number of shared boundary schedule points.
hbc_schedule_time_in_yrlist[0]Boundary schedule times in years, nondecreasing; repeated times are steps.
hbc_schedule_ratiolist[1]Ratios multiplying prescribed pressure and flux.
num_wellsinteger0Number of vertical rate-controlled wells. Requires control.has_hydraulic_diffusion.
well_xlist[]x coordinate of each well (in m).
well_ylist[]y coordinate of each well (in m, 3D only).
well_z_toplist[]Top of each well screen (in m).
well_z_bottomlist[]Bottom of each well screen (in m), below its top.
well_ratelist[]Fluid volume extracted by each well at schedule ratio 1, spread uniformly over the screen: m^3/s in 3D, m^2/s per unit out-of-plane length in 2D. Negative injects.
num_well_scheduleinteger1Number of points in the well rate schedule.
well_schedule_time_in_yrlist[0]Non-decreasing well schedule times (in yr). A repeated time is a step.
well_schedule_ratiolist[1]Rate multiplier at each schedule time: linear in between, held outside. Each step applies its exact time average, so the volume pumped is independent of dt.
stress_bc_x0integer0Stress boundary type. 0: no added traction; 1: x normal-stress component; 2: y normal-stress component (3D only); 3: z normal-stress component; 4: facet-normal stress on any orientation. Use the corresponding bc.stress_val_* in Pa; tension is positive and compression negative.
stress_bc_x1integer0Stress boundary type. 0: no added traction; 1: x normal-stress component; 2: y normal-stress component (3D only); 3: z normal-stress component; 4: facet-normal stress on any orientation. Use the corresponding bc.stress_val_* in Pa; tension is positive and compression negative.
stress_bc_y0integer0Stress boundary type. 0: no added traction; 1: x normal-stress component; 2: y normal-stress component (3D only); 3: z normal-stress component; 4: facet-normal stress on any orientation. Use the corresponding bc.stress_val_* in Pa; tension is positive and compression negative.
stress_bc_y1integer0Stress boundary type. 0: no added traction; 1: x normal-stress component; 2: y normal-stress component (3D only); 3: z normal-stress component; 4: facet-normal stress on any orientation. Use the corresponding bc.stress_val_* in Pa; tension is positive and compression negative.
stress_bc_z0integer0Stress boundary type. 0: no added traction; 1: x normal-stress component; 2: y normal-stress component (3D only); 3: z normal-stress component; 4: facet-normal stress on any orientation. Use the corresponding bc.stress_val_* in Pa; tension is positive and compression negative.
stress_bc_z1integer0Stress boundary type. 0: no added traction; 1: x normal-stress component; 2: y normal-stress component (3D only); 3: z normal-stress component; 4: facet-normal stress on any orientation. Use the corresponding bc.stress_val_* in Pa; tension is positive and compression negative.
stress_val_x0real0Prescribed stress value (Pa): positive in tension, negative in compression; the corresponding bc.stress_bc_* selects the component or facet-normal direction.
stress_val_x1real0Prescribed stress value (Pa): positive in tension, negative in compression; the corresponding bc.stress_bc_* selects the component or facet-normal direction.
stress_val_y0real0Prescribed stress value (Pa): positive in tension, negative in compression; the corresponding bc.stress_bc_* selects the component or facet-normal direction.
stress_val_y1real0Prescribed stress value (Pa): positive in tension, negative in compression; the corresponding bc.stress_bc_* selects the component or facet-normal direction.
stress_val_z0real0Prescribed stress value (Pa): positive in tension, negative in compression; the corresponding bc.stress_bc_* selects the component or facet-normal direction.
stress_val_z1real0Prescribed stress value (Pa): positive in tension, negative in compression; the corresponding bc.stress_bc_* selects the component or facet-normal direction.
vbc_x0integer1Type of velocity boundary condition for the left/western side. Odd number indicates the normal component of the velocity is fixed. Possible type is 0: all velocity components free; 1: normal component fixed, shear components free; 2: normal component free, shear components fixed at 0; 3: normal component fixed, shear components fixed at 0; 4: normal component free, shear component (not z) fixed, z component fixed at 0, only in 3D; 5: normal component fixed at 0, shear component (not z) fixed, z component fixed at 0, only in 3D; 6: normal component fixed (bc.vbc_val_*), shear component (not z) fixed (bc.vbc_val_*_l), z component free; 7: normal component fixed, shear component (not z) fixed at 0, z component free, only in 3D; 11: horizontal normal component fixed, z component and horizontal shear component free, only in 3D; 13: horizontal normal component fixed, z component and horizontal shear component fixed at 0, only in 3D;
vbc_x1integer1Velocity boundary type; see bc.vbc_x0 for the type definitions and dimensional restrictions. The prescribed value is bc.vbc_val_x1.
vbc_val_x0real-1e-09Value of boundary condition for left/western side (if velocity, unit is m/s; if stress, unit is Pa)
vbc_val_x0_lreal0Lateral shear velocity for left/western side (used with bc type 6, unit is m/s)
vbc_val_division_x0_minreal1Ratio of first rate change division from the top to the right boundary width (for option = 8)
vbc_val_division_x0_maxreal1Ratio of second rate change division from the top to the right boundary width (for option = 8)
vbc_val_x0_ratio0real1Ratio of the velocity at the surface of the left boundary width (for option = 1 and 3)
vbc_val_x0_ratio1real1Ratio of the velocity at the vbc_val_division_x0_min of the left boundary width (for option = 1 and 3)
vbc_val_x0_ratio2real1Ratio of the velocity at the vbc_val_division_x1_max of the left boundary width (for option = 1 and 3)
vbc_val_x0_ratio3real1Ratio of the velocity at the bottom of the left boundary width (for option = 1 and 3)
num_vbc_period_x0integer1Number of points in the x0 velocity period table
num_vbc_period_x1integer1Number of points in the x1 velocity period table
vbc_period_x0_time_in_yrlist[1.e6]Times of the x0 velocity period table '[t0, t1, ...]' (num_vbc_period_x0 of them, in yr, non-decreasing): the ratio is linear between them and constant outside; repeat a time for a step
vbc_period_x1_time_in_yrlist[1.e6]Times of the x1 velocity period table (in yr), as for x0
vbc_period_x0_ratiolist[1.]Ratio of vbc_val_x0 at each time of the x0 period table '[r0, r1, r2, ...]'. It scales the normal velocity only: tangential values (types 4 and 5, vbc_val_x0_l) stay constant
vbc_period_x1_ratiolist[1.]Ratio of vbc_val_x1 at each time of the x1 period table, as for x0
vbc_val_x1real1e-09Value of boundary condition for the right/eastern side (if velocity, unit is m/s; if stress, unit is Pa)
vbc_val_x1_lreal0Lateral shear velocity for right/eastern side (used with bc type 6, unit is m/s)
vbc_val_division_x1_minreal1Ratio of first rate change division from the top to the right boundary width (for option = 8)
vbc_val_division_x1_maxreal1Ratio of second rate change division from the top to the right boundary width (for option = 8)
vbc_val_x1_ratio0real1Ratio of the velocity at the surface of the right boundary width (for option = 1 and 3)
vbc_val_x1_ratio1real1Ratio of the velocity at the vbc_val_division_x0_min of the right boundary width (for option = 1 and 3)
vbc_val_x1_ratio2real1Ratio of the velocity at the vbc_val_division_x1_max of the right boundary width (for option = 1 and 3)
vbc_val_x1_ratio3real1Ratio of the velocity at the bottom of the right boundary width (for option = 1 and 3)
vbc_y0integer0Velocity boundary type; see bc.vbc_x0 for the type definitions and dimensional restrictions. The prescribed value is bc.vbc_val_y0.
vbc_y1integer0Velocity boundary type; see bc.vbc_x0 for the type definitions and dimensional restrictions. The prescribed value is bc.vbc_val_y1.
vbc_val_y0real0Value of boundary condition for the southern side (if velocity, unit is m/s; if stress, unit is Pa)
vbc_val_y0_lreal0Lateral shear velocity for southern side (used with bc type 6, unit is m/s)
vbc_val_y1real0Value of boundary condition for the northern side (if velocity, unit is m/s; if stress, unit is Pa)
vbc_val_y1_lreal0Lateral shear velocity for northern side (used with bc type 6, unit is m/s)
num_vbc_period_y0integer1Number of points in the y0 velocity period table (3D only)
num_vbc_period_y1integer1Number of points in the y1 velocity period table (3D only)
vbc_period_y0_time_in_yrlist[1.e6]Times of the y0 velocity period table (in yr, 3D only), as for x0
vbc_period_y1_time_in_yrlist[1.e6]Times of the y1 velocity period table (in yr, 3D only), as for x0
vbc_period_y0_ratiolist[1.]Ratio of vbc_val_y0 at each time of the y0 period table (3D only), as for x0
vbc_period_y1_ratiolist[1.]Ratio of vbc_val_y1 at each time of the y1 period table (3D only), as for x0
vbc_z0integer0Bottom velocity boundary type. 0: all components free; 1: prescribed vertical velocity bc.vbc_val_z0, horizontal free; 2: vertical free, horizontal zero; 3: prescribed vertical velocity, horizontal zero; 4: prescribed x velocity and zero vertical velocity (2D only).
vbc_z1integer0Top velocity boundary type. 0: all components free; 1: prescribed vertical velocity bc.vbc_val_z1, horizontal free; 2: vertical free, horizontal zero; 3: prescribed vertical velocity, horizontal zero; 4: prescribed x velocity and zero vertical velocity (2D only); 8: rigid frictionless platen with one shared free vertical velocity; load it with bc.stress_bc_z1.
vbc_val_z0real0Value of boundary condition for the bottom side (if velocity, unit is m/s; if stress, unit is Pa)
vbc_val_z1real0Value of boundary condition for the top side (if velocity, unit is m/s; if stress, unit is Pa)
vbc_val_z1_loading_periodreal1.79769e+308Loading period for the velocity on the top side
vbc_n0integer1Type of boundary condition for slant boundary #0 (only type 1, 3, 11, 13 are supported).
vbc_val_n0real0Value of boundary condition for slant boundary #0 (if velocity, unit is m/s, outward normal direction is positive; if stress, unit is Pa)
vbc_n1integer1Type of boundary condition for slant boundary #1 (only type 1, 3, 11, 13 are supported).
vbc_val_n1real0Value of boundary condition for slant boundary #1 (if velocity, unit is m/s, outward normal direction is positive; if stress, unit is Pa)
vbc_n2integer1Type of boundary condition for slant boundary #2 (only type 1, 3, 11, 13 are supported).
vbc_val_n2real0Value of boundary condition for slant boundary #2 (if velocity, unit is m/s, outward normal direction is positive; if stress, unit is Pa)
vbc_n3integer1Type of boundary condition for slant boundary #3 (only type 1, 3, 11, 13 are supported).
vbc_val_n3real0Value of boundary condition for slant boundary #3 (if velocity, unit is m/s, outward normal direction is positive; if stress, unit is Pa)
bottom_shear_zone_thicknessreal0Thickness of the bottom shear zone for bc_x0 = 3 and ndims = 2, in m: the x0 wall velocity tapers linearly to 0 from this height above the bottom down to the bottom. 0 disables it.

[ic]​

Initial temperature, stress, weak zones and material layout.

ParameterTypeDefaultDescription
mattype_optioninteger0How to set the initial material type of markers? 0: marker's mattype is determined by regional attribute (currently can be modified only in the code or in a poly file). 1: marker's mattype is layered. 101: custom mattype.
num_mattype_layersinteger2Number of material layers
layer_mattypeslist[0,1]Material type of each material layer '[d0, d1, d2, ...]', d0<=d1<=d2...
mattype_layer_depthslist[0.5]Depths of the interfaces of each material layer '[d0, d1, d2, ...]', d0<=d1<=d2..., (in unit of zlength)
weakzone_optioninteger1How to set the initial weak zone? 0: no weak zone. 1: planar weak zone with specified azimuth, inclination, halfwidth, min/max depth range, and center location. 2: ellipsoidal weak zone with specified center location and semi-axes. 3: Gaussian distribution point weak zone with specified center location and standard deviation. 4: multiple planar segments; each segment uses the same parameters as option 1 but given as '[v0, v1, ...]' arrays.
is_restarting_weakzoneyes/nonoCreate a new weakzone when restarting?
weakzone_plstrainreal0.1Initial plastic strain in the weak zone
weakzone_azimuthreal0Azimuth angle (relative to +y axis) (in degree)
weakzone_inclinationreal90Inclination angle (relative to horizontal plane) (in degree)
weakzone_halfwidthreal1.5Half-width of the weak zone (in unit of mesh.resolution)
weakzone_y_minreal0Y-direction range (between 0 and 1, in unit of mesh.ylength)
weakzone_y_maxreal1Y-direction range (between 0 and 1, in unit of mesh.ylength)
weakzone_depth_minreal0Depth upper (shallower) range (between 0 and 1, in unit of mesh.zlength)
weakzone_depth_maxreal1Depth lower (deeper) range (between 0 and 1, in unit of mesh.zlength)
weakzone_xcenterreal0.5Location of weak zone center in x direction (between 0 and 1, in unit of mesh.xlength)
weakzone_ycenterreal0.5Location of weak zone center in y direction (between 0 and 1, in unit of mesh.ylength)
weakzone_zcenterreal0.5Location of weak zone center in z direction (between 0 and 1, in unit of mesh.zlength)
weakzone_xsemi_axisreal1000Length of weak zone semi-axis in x direction (in meters)
weakzone_ysemi_axisreal1000Length of weak zone semi-axis in y direction (in meters)
weakzone_zsemi_axisreal1000Length of weak zone semi-axis in z direction (in meters)
weakzone_standard_deviationreal1000Standard deviation of Gaussian weak zone (in meters). Used as point-Gaussian std dev (option 3) and as along-strike sigma (option 4).
weakzone_gaussian_amplitudereal0Amplitude of the Gaussian x-shift for weakzone_option=4 (in meters). The fault x-position is offset by A*exp(-(y-y0)^2/(2*sigma^2)) where A = weakzone_gaussian_amplitude and sigma = weakzone_standard_deviation.
weakzone_num_segmentsinteger1Number of planar segments for multi-segment weak zone (weakzone_option=5)
weakzone_segments_xcenterlist[0.5]X centers of each segment (between 0 and 1, in unit of mesh.xlength), '[v0, v1, ...]'
weakzone_segments_ycenterlist[0.5]Y centers of each segment (between 0 and 1, in unit of mesh.ylength), '[v0, v1, ...]' (3D only)
weakzone_segments_zcenterlist[0.5]Z centers of each segment (between 0 and 1, in unit of mesh.zlength), '[v0, v1, ...]'
weakzone_segments_azimuthlist[0]Azimuth angles for each segment (in degrees), '[v0, v1, ...]'
weakzone_segments_inclinationlist[90]Inclination angles for each segment (in degrees), '[v0, v1, ...]'
weakzone_segments_halfwidthlist[1.5]Half-widths for each segment (true perpendicular distance, in unit of mesh.resolution), '[v0, v1, ...]'
weakzone_segments_x_minlist[0]X lower bound for each segment (between 0 and 1, in unit of mesh.xlength), '[v0, v1, ...]'
weakzone_segments_x_maxlist[1]X upper bound for each segment (between 0 and 1, in unit of mesh.xlength), '[v0, v1, ...]'
weakzone_segments_depth_minlist[0]Depth upper (shallower) bound for each segment (between 0 and 1, in unit of mesh.zlength), '[v0, v1, ...]'
weakzone_segments_depth_maxlist[1]Depth lower (deeper) bound for each segment (between 0 and 1, in unit of mesh.zlength), '[v0, v1, ...]'
weakzone_segments_y_minlist[0]Y lower bound for each segment (between 0 and 1, in unit of mesh.ylength), '[v0, v1, ...]' (3D only)
weakzone_segments_y_maxlist[1]Y upper bound for each segment (between 0 and 1, in unit of mesh.ylength), '[v0, v1, ...]' (3D only)
temperature_optioninteger0How to set the initial temperature? 0: uniform half-space cooling. 1: continental thermal gradient. 2: equilibrium temperature for crustal radiogenic heating. 3: continental thermal gradient with adiabatic mantle. 4: uniform ic.temp_background plus a Gaussian anomaly. 5: linear conduction from bc.surface_temperature at the top to bc.mantle_temperature at the bottom (mesh.zlength), plus the same Gaussian anomaly. 90: temperature read from an external grid
oceanic_plate_age_in_yrreal6e+07Age of the oceanic plate (in years), used for the temperature profile on the plate.
num_radiogenic_heat_layerinteger1Number of radiogenic heat layers
radiogenic_heat_boundrylist[-1,-1]The layer boundry of radiogenic heating from the top to the bottom (depth -> positive, in meters). Using -1 to indicate the top and bottom of the model.
radiogenic_heat_mat_in_layerlist[0]The material type of radiogenic heating in each layer (one value: the same in every layer).
radiogenic_folding_depthreal10000Radiogenic folding depth (in meters), used for the temperature profile on the plate.
radiogenic_heating_of_crustreal1e-09Radiogenic heating of crust (in W/kg), used for the temperature profile on the plate.
continental_plate_age_in_yrreal1e+08Age of the continental plate (in years), used for the temperature profile on the plate.
radiogenic_crustal_thicknessreal30000Radiogenic crustal thickness (in meters), used for the temperature profile on the plate.
lithospheric_thicknessreal100000Lithospheric thickness (in meters), used for the temperature profile on the plate.
radiogenic_heat_dome_center_xreal0.5x of center of geothermal dome, used for the temperature profile on the plate.
radiogenic_heat_dome_center_yreal0.5y of center of geothermal dome, used for the temperature profile on the plate.
surface_heat_fluxreal0.07surface heat flux, used for the temperature profile on the plate.
radiogenic_heat_dome_amplitudereal0Dome amplitude, used for the temperature profile on the plate.
radiogenic_heat_dome_widthreal0Dome half width, used for the temperature profile on the plate.
radiogenic_heat_dome_width_yreal0Dome half width in y-axis, used for the temperature profile on the plate (3D). 0: Isotropic (uses radiogenic_heat_dome_width for both axes). >0: Specific width for y-axis (elliptical dome). <0: Infinite width; thermal profile is uniform along y-axis (ridge/hinge).
radiogenic_heat_dome_azimuthreal0Dome azimuth (rotation angle), used for the temperature profile on the plate (in degree) (3D).
temp_backgroundreal273Uniform background temperature in K for temperature_option=4.
temp_anomaly_amplitudereal0Gaussian temperature amplitude in K.
temp_anomaly_xcenterreal0Gaussian thermal anomaly x coordinate in m.
temp_anomaly_ycenterreal0Gaussian thermal anomaly y coordinate in m.
temp_anomaly_zcenterreal0Gaussian thermal anomaly z coordinate in m.
temp_anomaly_xsemi_axisreal1Positive Gaussian x scale in m.
temp_anomaly_ysemi_axisreal1Positive Gaussian y scale in m.
temp_anomaly_zsemi_axisreal1Positive Gaussian z scale in m.
Temp_filenametextThermal.datFilename of the input thermal field, for temperature_option=90. The file format is: <x-coord y-coord (if 3D) z-coord temperature>. Can be generated by COMSOL.
Nodes_filenametextCoord.datFilename of the mesh coordinates, for temperature_option=90. The nodes may be ordered differently with the thermal file. The file format is: <x-coord y-coord (if 3D) z-coord>. Can be generated by COMSOL.
Connectivity_filenametextConnectivity.datFilename of the mesh connectivity, for temperature_option = 90 only. The file format is: <#ofnode0 #ofnode1 #ofnode2 #ofnode3 (if 3D)>. Can be generated by COMSOL.
isostasy_adjustment_time_in_yrreal0Time for spinning up isostasy adjustment.
excess_pore_pressurereal0Initial excess_pore_pressure except for boundary.
pore_pressure_optioninteger0Initial pressure: 0 hydrostatic/excess, 1 linear x profile between prescribed pressure faces, 2 uniform.
pore_pressure_valuereal0Uniform initial pressure in Pa for pore_pressure_option=2.
water_table_zreal0Height of the initial hydrostatic water table (m): p = -rho_f*g*(z - water_table_z), negative (suction) above it. The default 0 is the original surface.
has_body_force_adjustmentyes/nonoConducting PT loop to get initial stress field from inital guess
initial_stress_optioninteger0How to initialize stress? 0: use the legacy gravity-dependent initialization. 1: prescribe a homogeneous absolute Cauchy stress tensor; requires gravity=0.
initial_stresslist2D: [0,0,0]
3D: [0,0,0,0,0,0]
Homogeneous absolute Cauchy stress [sxx,szz,sxz] in Pa; compression is negative. Plane strain initializes syy=(sxx+szz)/2.

[mat]​

Rheology and material properties. List values hold one entry per material.

ParameterTypeDefaultDescription
rheology_typetextrequiredType of rheology, either 'elastic', 'viscous' (experimental), 'maxwell', 'elasto-plastic', 'elasto-visco-plastic', 'elasto-plastic-rate-state-friction', or 'elasto-visco-plastic-rate-state-friction' (short '-rsf' aliases are also accepted)
is_plane_strainyes/nonoUse plane-strain constitutive updates in 2D (elastic and elasto-plastic paths).
phase_change_optioninteger0What kind of phase changes? 0: no phase changes. 1: simple rules of subduction-related phase changes. See simple_subduction() in phasechanges.cxx for more details. 3: subduction phase-change rule engine (see subduction_phase_changes() in phasechanges.cxx). A marker converts to a metamorphic product when it crosses a pressure-temperature reaction boundary (pressure: see mat.phase_change_pressure_option; depth: below the local surface; chlorite-out and the first two sediment steps read depth only); each transition activates only when its target mat.mattype_* is set to a distinct material and its switch is on (mat.has_eclogitization and mat.has_serpentinization default on, mat.has_hydrous_mantle_dehydration and mat.has_sediment_metamorphism off). Transitions: oceanic crust->eclogite (Hacker 2003), mantle<->serpentinite (Ulmer & Trommsdorff 1995; serpentinization also needs wet crust -- oceanic crust, sediment or sedimentary rock -- within mat.serpentinization_thickness below the marker, and no deeper than mat.serpentinization_max_depth), hydrous mantle->mantle (Grove 2009), and sediment->sedimentary rock->metasediment->schist (compaction uses geoflac's unsourced thresholds, the next step Montanez & Crossey 2017, the last Wei 2004). 101: custom phase changes (custom_phase_change() in phasechanges.cxx).
phase_change_pressure_optioninteger0The pressure the mat.phase_change_option 3 rules read (options 1 and 101 always use ref_pressure()). 0: the mean stress of the marker's element, compression positive, in 2D the in-plane mean. Tectonic over- and underpressure move the reaction boundaries. 1: the reference pressure, ref_pressure() (control.ref_pressure_option), at the marker's depth below the local surface. The phase diagrams are drawn for a lithostat, and geoflac reads one.
num_materialsinteger1Number of material types
mattype_refinteger0Index of reference material. For compute_dt(), compute_mass() and ref_pressure()
mattype_mantleinteger0Index of mantle material. For continental thermal gradient. With mat.phase_change_option 3: what serpentinizes above the slab and what serpentinite and hydrous mantle dehydrate to; no rule may start from it, and it must be set in the cfg when option 3 reads it.
mattype_depleted_mantleinteger0Index of depleted mantle material. Unused: no phase change reads it.
mattype_partial_melting_mantleinteger0Index of partial melting mantle material. Unused: no phase change reads it.
mattype_continental_crustinteger-1Index of continental crust. Read only by the continental geotherm (ic.temperature_option 1), which needs it in [0, mat.num_materials). Default -1 (unset).
mattype_oceanic_crustinteger-1Index of oceanic crust. Read only by mat.phase_change_option 3: the source of the eclogite rule (with mat.has_eclogitization) and wet crust for the serpentinization grid (with mat.has_serpentinization); either needs it in [0, mat.num_materials). Default -1 (unset).
mattype_serpentiniteinteger-1Index of serpentinite material, for mat.phase_change_option 3 with mat.has_serpentinization: what mantle above the slab turns into, and the source of serpentinite->mantle dehydration. Default -1 (unset); with serpentinization on it must be in [0, mat.num_materials) and distinct from mattype_mantle and the wet-crust materials (mattype_oceanic_crust, mattype_sediment, and mattype_sediment_rock when set).
mattype_eclogiteinteger-1Index of eclogite material. For the mat.phase_change_option 3 rule engine: oceanic-crust markers past the basalt->eclogite P-T boundary (Hacker 2003) convert to this. Default -1 (unset); must be set while mat.has_eclogitization is on.
mattype_hydrous_mantleinteger-1Index of hydrous (chlorite-bearing) mantle material. For mat.phase_change_option 3: dehydrates to mattype_mantle above the chlorite-out boundary (Grove et al. 2009). Default -1 (unset); must be set while mat.has_hydrous_mantle_dehydration is on.
mattype_sediment_rockinteger-1Index of consolidated sedimentary-rock material. For mat.phase_change_option 3: mattype_sediment compacts to this, which then metamorphoses to mattype_metasediment; when set, it is also wet crust for the serpentinization grid. Default -1 (unset); must be set while mat.has_sediment_metamorphism is on.
mattype_metasedimentinteger-1Index of metamorphic-sediment material. For mat.phase_change_option 3: mattype_sediment_rock -> this -> mattype_schist. Default -1 (unset); must be set while mat.has_sediment_metamorphism is on.
mattype_schistinteger-1Index of schist material. For mat.phase_change_option 3: mattype_metasediment dehydrates to this (Wei et al. 2004). Default -1 (unset); must be set while mat.has_sediment_metamorphism is on.
mattype_sedimentinteger0Index of sediment material. Should be the same as mattype['sediment'] in 2vtk.py for sediment time convertion. With mat.phase_change_option 3: wet crust for the serpentinization grid (with mat.has_serpentinization) and the source of the sediment chain (with mat.has_sediment_metamorphism); with either it must be set in the cfg.
mattype_mor_extrusioninteger0Index of mid-ocean-ridge extrusion material. Unused: no phase change reads it.
mattype_asthenosphereinteger0Index of asthenosphere.
max_viscosityreal1e+24Max. value of viscosity (in Pa.s)
min_viscosityreal1e+18Min. value of viscosity (in Pa.s)
max_tensionreal1e+09Max. value of tensile stress (in Pa)
max_thermal_diffusivityreal5e-06Max. value of thermal diffusivity (in m^2/s)
convert_rate_oceanic_crustreal1e-13Converting rate from melting to oceanic crust. Unused: no phase change reads it.
serpentinization_thicknessreal10000Thickness (in m) of the mantle layer above wet crust (oceanic crust, sediment or sedimentary rock) that turns into serpentinite (mat.phase_change_option is 3 with mat.has_serpentinization). Counted in whole background-grid cells below the marker's own cell (cell size mesh.resolution * mesh.vt_size), down to a wet-crust-dominant cell (mat.wet_crust_fraction_threshold), so the effective reach differs from it by up to two cells, and the thickness must be positive and at least one cell. Default 10e3: heuristic, untuned.
serpentinization_wet_crust_marginreal-1Horizontal margin (in m) for the serpentinization wet-crust-below test. When >= 0, a wet-crust-dominant grid cell triggers conversion only if the marker's horizontal position lies within the cell's wet-crust extent (recorded per cell at grid build) widened by this margin -- suppressing the column-quantization false positive at a slab bend, where a cell is wet-crust-dominant from wet crust up to a whole cell size away horizontally. < 0 (default) disables: whole-column behavior.
serpentinization_max_depthreal150000mat.phase_change_option 3 with mat.has_serpentinization: no mantle deeper than this (in m below the local free surface) serpentinizes. It also ends the serpentinization grid, at this depth plus mat.serpentinization_thickness and one cell. Must be positive. Default 150e3, heuristic, untuned: slab dehydration, the water source, is essentially complete by ~150 km, shallower than the antigorite stability field's cold-slab extrapolation (> 200 km at 500 C).
wet_crust_fraction_thresholdreal0.5mat.phase_change_option 3 with mat.has_serpentinization: a serpentinization grid cell is wet-crust-dominant, so it can serpentinize the mantle above it, when more than this fraction of its markers is wet crust. In [0, 1). A cell holds markers.markers_per_element times (cell / element measure) markers, nominally ~2.3 in 2D and ~4.2 in 3D at mesh.vt_size 0.5, so at 0.5 a two-marker cell needs both. Default 0.5, untuned: geoflac's 0.8 (of an element, with no source) leaves out the cell that straddles the slab top and cuts the serpentinite band of examples/tectonics/subduction.cfg by more than half.
has_serpentinizationyes/noyesmat.phase_change_option 3: enable mantle<->serpentinite (mantle above the slab serpentinizes inside the antigorite stability field; serpentinite above 550 C outside it dehydrates back to mantle). Default on. Needs mattype_serpentinite and mattype_oceanic_crust, and mattype_sediment set in the cfg. Off: no serpentinization grid is built, and the checks on its inputs are skipped: mattype_mantle, mattype_serpentinite and the wet-crust materials distinct, mattype_serpentinite in range and set, mattype_sediment set, serpentinization_thickness positive and at least one grid cell, mesh.vt_size positive. mattype_mantle and mattype_sediment stay range-checked with the other base material indices, and the rule checks still run (see the other has_* switches); every key an active rule reads must be set in the cfg.
has_eclogitizationyes/noyesmat.phase_change_option 3: enable oceanic crust->eclogite (Hacker 2003). Default on. Needs mattype_oceanic_crust and mattype_eclogite set, distinct, and not mattype_mantle, and mattype_sediment different from mattype_oceanic_crust (deposits would turn into eclogite). Like every has_* switch, no two active rules may start from one material.
has_hydrous_mantle_dehydrationyes/nonomat.phase_change_option 3: enable hydrous (chlorite) mantle->mantle dehydration (Grove 2009). Default off. Needs mattype_hydrous_mantle.
has_sediment_metamorphismyes/nonomat.phase_change_option 3: enable the sediment chain sediment->sedimentary rock->metasediment->schist (compaction uses geoflac's unsourced thresholds, the next step Montanez & Crossey 2017, the last Wei 2004). Default off. Needs mattype_sediment_rock / mattype_metasediment / mattype_schist.
rho0list[3210]Density of the materials at 0 Pa and 273 K '[d0, d1, d2, ...]' (in kg/m^3)
alphalist[3e-5]Volumetic thermal expansion of the materials '[d0, d1, d2, ...]' (in 1/Kelvin)
bulk_moduluslist[128.2e9]Bulk modulus of the materials '[d0, d1, d2, ...]' (in Pa)
shear_moduluslist[80.5e9]Shear modulus of the materials '[d0, d1, d2, ...]' (in Pa)
visc_exponentlist[3.05]Exponents of non-linear viscosity of the materials'[d0, d1, d2, ...]'
visc_coefficientlist[1.25e-1]Pre-exponent coefficient of non-linear viscosity of the materials '[d0, d1, d2, ...]'
visc_activation_energylist[3.76e5]Activation energy of non-linear viscosity of the materials '[d0, d1, d2, ...]' (in J/mol)
visc_activation_volumelist[0.e-6]Activation volume of non-linear viscosity of the materials '[d0, d1, d2, ...]' (in m^3/mol)
heat_capacitylist[1e3]Heat capacity (isobaric) of the materials '[d0, d1, d2, ...]' (in J/kg/Kelvin)
therm_condlist[3]Thermal conductivity of the materials '[d0, d1, d2, ...]' (in W/m/Kelvin)
radiogenic_heat_prodlist[0]Radiogenic heat production rate of the materials '[d0, d1, d2, ...]' (in W/kg)Only for initial temperature condition
pls0list[0]Plastic strain of the materials where weakening starts '[d0, d1, d2, ...]' (no unit)
pls1list[0.1]Plastic strain of the materials where weakening saturates '[d0, d1, d2, ...]' (no unit)
cohesion0list[4e7]Cohesion of the materials when weakening starts '[d0, d1, d2, ...]' (in Pa)
cohesion1list[4e6]Cohesion of the materials when weakening saturates '[d0, d1, d2, ...]' (in Pa)
friction_angle0list[30]Friction angle of the materials when weakening starts '[d0, d1, d2, ...]' (in degree)
friction_angle1list[5]Friction angle of the materials when weakening saturates '[d0, d1, d2, ...]' (in degree)
dilation_angle0list[0]Dilation angle of the materials when weakening starts '[d0, d1, d2, ...]' (in degree)
dilation_angle1list[0]Dilation angle of the materials when weakening saturates '[d0, d1, d2, ...]' (in degree)
porosity_modelinteger0Porosity: 0 fixed, 1 Eulerian Biot volume/grain-pressure evolution.
permeability_modelinteger0Permeability: 0 fixed, 1 Kozeny-Carman, 2 power law from current porosity.
permeability_exponentlist[3]Positive dimensionless exponent n in k=k0*(phi/phi0)^n for permeability_model=2. Material exponents are averaged by marker count.
pore_healing_timelist[0]Reference recovery time of plastic pore dilation (s); 0 disables recovery. Requires porosity_model=1.
pore_healing_temperaturelist[293]Reference absolute temperature for pore recovery (K).
pore_healing_energylist[0]Nonnegative activation energy for pore recovery (J/mol); tau=tau0*(T/T0)*exp(E/R*(1/T-1/T0)).
porositylist[0.0]Porosity of the materials '[d0, d1, d2, ...]' (no unit)
hydraulic_permlist[1e-14]Intrinsic permeability of the materials '[d0, d1, d2, ...]' (m^2)
matrix_storagelist[0]Immobile matrix reservoir storage per bulk volume in 1/Pa.
matrix_exchangelist[0]Explicit exchange coefficient between transport and matrix pressure in 1/(Pa s).
permeability_tensorlist[1,1,1,0,0,0]Dimensionless SPD permeability tensor [xx,yy,zz,xy,xz,yz], multiplying hydraulic_perm.
fluid_rho0list[1000]Reference fluid density for Darcy gravity and saturated mixture weight '[d0, d1, d2, ...]' (kg/m^3)
fluid_heat_capacitylist[4180]Fluid heat capacity '[d0, d1, ...]' in J/kg/K, for groundwater heat transport.
derive_biot_coeff_from_bulk_moduliyes/nonoUse biot_coeff=1-bulk_modulus/bulk_modulus_s with finite positive ordered moduli.
fluid_alphalist[2.07e-4]Thermal expansivity of the fluids at 0 Pa and 293 K '[d0, d1, d2, ...]' (in K^-1)
fluid_bulk_moduluslist[2.17e9]Bulk modulus of the fluids at 0 Pa and 293 K '[d0, d1, d2, ...]' (in Pa)
fluid_visclist[1.002e-3]Dynamic viscosity of the fluids at 0 Pa and 293 K '[d0, d1, d2, ...]' (in Pa s).
biot_coefflist[1.0]Biot-Willis coefficient (HM coupling coeff) '[d0, d1, d2, ...]' (no unit)
bulk_modulus_slist[37e9]Bulk modulus of the solid grains or minerals '[d0, d1, d2, ...]' (Pa)
retention_modellist[0]Retention law of the materials '[m0, m1, ...]': 0 saturated, 1 van Genuchten-Mualem, 2 Brooks-Corey-Burdine, 3 Gardner exponential.
retention_alphalist[1e-4]Retention alpha of the materials '[d0, d1, ...]' (1/Pa); 1/alpha is the Brooks-Corey air-entry pressure.
retention_nlist[2]Retention exponent '[d0, d1, ...]': van Genuchten n > 1, or the Brooks-Corey pore-size index > 0. Unused by Gardner.
residual_saturationlist[0]Residual saturation of the materials '[d0, d1, ...]', 0 <= Sr < 1.
direct_alist[0.020]rate-and-state friction parameter a '[d0, d1, d2, ...]' (-)
evolution_blist[0.025]rate-and-state friction parameter b '[d0, d1, d2, ...]' (-)
characteristic_velocitylist[1e-6]rate-and-state friction parameter V0 '[d0, d1, d2, ...]' (-)
characteristic_distancelist[4e-3]rate-and-state friction parameter Dc '[d0, d1, d2, ...]' (-)
state_var_modelinteger0State variable evolution model for rate-and-state friction. 0: steady-state friction (no state evolution), 1: aging law, 2: slip law.

[debug]​

Diagnostic output.

ParameterTypeDefaultDescription
dtyes/nonoPrint all dt criteria