From 670a797def698b18de1a33ef357cf610698014c9 Mon Sep 17 00:00:00 2001 From: Timo Heister Date: Fri, 1 Dec 2023 16:05:50 -0500 Subject: [PATCH] update parameters --- doc/parameter_view/parameters.xml | 1750 ++++++++--------- doc/sphinx/parameters/Postprocess.md | 2 +- .../user/extending/images/plugin_graph.svg | 4 +- 3 files changed, 878 insertions(+), 878 deletions(-) diff --git a/doc/parameter_view/parameters.xml b/doc/parameter_view/parameters.xml index 7c4556db5d9..784163861d9 100644 --- a/doc/parameter_view/parameters.xml +++ b/doc/parameter_view/parameters.xml @@ -83,7 +83,7 @@ The number of space dimensions you want to run this program in. ASPECT can run i The end time of the simulation. The default value is a number so that when converted from years to seconds it is approximately equal to the largest number representable in floating point arithmetic. For all practical purposes, this equals infinity. Units: Years if the 'Use years in output instead of seconds' parameter is set; seconds otherwise. -357 +358 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -3941,7 +3941,7 @@ In 3d, inner and outer indicators are treated as in 2d. If the opening angle is X coordinate of box origin. Units: \si{\meter}. -964 +974 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -3958,7 +3958,7 @@ X coordinate of box origin. Units: \si{\meter}. Y coordinate of box origin. Units: \si{\meter}. -965 +975 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -3975,7 +3975,7 @@ Y coordinate of box origin. Units: \si{\meter}. Z coordinate of box origin. This value is ignored if the simulation is in 2d. Units: \si{\meter}. -966 +976 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -3992,7 +3992,7 @@ Z coordinate of box origin. This value is ignored if the simulation is in 2d. Un Extent of the box in x-direction. Units: \si{\meter}. -961 +971 [Double 0...MAX_DOUBLE (inclusive)] @@ -4009,7 +4009,7 @@ false Whether the box should be periodic in X direction -970 +980 [Bool] @@ -4026,7 +4026,7 @@ Whether the box should be periodic in X direction Number of cells in X direction. -967 +977 [Integer range 1...2147483647 (inclusive)] @@ -4043,7 +4043,7 @@ Number of cells in X direction. Extent of the box in y-direction. Units: \si{\meter}. -962 +972 [Double 0...MAX_DOUBLE (inclusive)] @@ -4060,7 +4060,7 @@ false Whether the box should be periodic in Y direction -971 +981 [Bool] @@ -4077,7 +4077,7 @@ Whether the box should be periodic in Y direction Number of cells in Y direction. -968 +978 [Integer range 1...2147483647 (inclusive)] @@ -4094,7 +4094,7 @@ Number of cells in Y direction. Extent of the box in z-direction. This value is ignored if the simulation is in 2d. Units: \si{\meter}. -963 +973 [Double 0...MAX_DOUBLE (inclusive)] @@ -4111,7 +4111,7 @@ false Whether the box should be periodic in Z direction -972 +982 [Bool] @@ -4128,7 +4128,7 @@ Whether the box should be periodic in Z direction Number of cells in Z direction. -969 +979 [Integer range 1...2147483647 (inclusive)] @@ -4147,7 +4147,7 @@ Number of cells in Z direction. X coordinate of box origin. Units: \si{\meter}. -925 +934 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -4164,7 +4164,7 @@ X coordinate of box origin. Units: \si{\meter}. Y coordinate of box origin. Units: \si{\meter}. -926 +935 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -4181,7 +4181,7 @@ Y coordinate of box origin. Units: \si{\meter}. Z coordinate of box origin. This value is ignored if the simulation is in 2d. Units: \si{\meter}. -927 +936 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -4198,7 +4198,7 @@ Z coordinate of box origin. This value is ignored if the simulation is in 2d. Un The thickness of the lithosphere used to create additional boundary indicators to set specific boundary conditions for the lithosphere. -921 +930 [Double 0...MAX_DOUBLE (inclusive)] @@ -4215,7 +4215,7 @@ true Whether to make the grid by gluing together two boxes, or just use one chunk to make the grid. Using two grids glued together is a safer option, since it forces the boundary conditions to be always applied to the same depth, but using one grid allows for a more flexible usage of the adaptive refinement. Note that if there is no cell boundary exactly on the boundary between the lithosphere and the mantle, the velocity boundary will not be exactly at that depth. Therefore, using a merged grid is generally recommended over using one grid.When using one grid, the parameter for lower repetitions is used and the upper repetitions are ignored. -938 +947 [Bool] @@ -4232,7 +4232,7 @@ Whether to make the grid by gluing together two boxes, or just use one chunk to Extent of the box in x-direction. Units: \si{\meter}. -922 +931 [Double 0...MAX_DOUBLE (inclusive)] @@ -4249,7 +4249,7 @@ false Whether the box should be periodic in X direction. -933 +942 [Bool] @@ -4266,7 +4266,7 @@ false Whether the box should be periodic in X direction in the lithosphere. -936 +945 [Bool] @@ -4283,7 +4283,7 @@ Whether the box should be periodic in X direction in the lithosphere. Number of cells in X direction of the lower box. The same number of repetitions will be used in the upper box. -928 +937 [Integer range 1...2147483647 (inclusive)] @@ -4300,7 +4300,7 @@ Number of cells in X direction of the lower box. The same number of repetitions Extent of the box in y-direction. Units: \si{\meter}. -923 +932 [Double 0...MAX_DOUBLE (inclusive)] @@ -4317,7 +4317,7 @@ false Whether the box should be periodic in Y direction. -934 +943 [Bool] @@ -4334,7 +4334,7 @@ false Whether the box should be periodic in Y direction in the lithosphere. This value is ignored if the simulation is in 2d. -937 +946 [Bool] @@ -4351,7 +4351,7 @@ Whether the box should be periodic in Y direction in the lithosphere. This value Number of cells in Y direction of the lower box. If the simulation is in 3d, the same number of repetitions will be used in the upper box. -929 +938 [Integer range 1...2147483647 (inclusive)] @@ -4368,7 +4368,7 @@ Number of cells in Y direction of the lower box. If the simulation is in 3d, the Number of cells in Y direction in the lithosphere. This value is ignored if the simulation is in 3d. -931 +940 [Integer range 1...2147483647 (inclusive)] @@ -4385,7 +4385,7 @@ Number of cells in Y direction in the lithosphere. This value is ignored if the Extent of the box in z-direction. This value is ignored if the simulation is in 2d. Units: \si{\meter}. -924 +933 [Double 0...MAX_DOUBLE (inclusive)] @@ -4402,7 +4402,7 @@ false Whether the box should be periodic in Z direction. This value is ignored if the simulation is in 2d. -935 +944 [Bool] @@ -4419,7 +4419,7 @@ Whether the box should be periodic in Z direction. This value is ignored if the Number of cells in Z direction of the lower box. This value is ignored if the simulation is in 2d. -930 +939 [Integer range 1...2147483647 (inclusive)] @@ -4436,7 +4436,7 @@ Number of cells in Z direction of the lower box. This value is ignored if the si Number of cells in Z direction in the lithosphere. This value is ignored if the simulation is in 2d. -932 +941 [Integer range 1...2147483647 (inclusive)] @@ -4455,7 +4455,7 @@ Number of cells in Z direction in the lithosphere. This value is ignored if the Radius at the bottom surface of the chunk. Units: \si{\meter}. -973 +983 [Double 0...MAX_DOUBLE (inclusive)] @@ -4472,7 +4472,7 @@ Radius at the bottom surface of the chunk. Units: \si{\meter}. Maximum latitude of the chunk. This value is ignored if the simulation is in 2d. Units: degrees. -978 +988 [Double -90...90 (inclusive)] @@ -4489,7 +4489,7 @@ Maximum latitude of the chunk. This value is ignored if the simulation is in 2d. Maximum longitude of the chunk. Units: degrees. -976 +986 [Double -180...360 (inclusive)] @@ -4506,7 +4506,7 @@ Maximum longitude of the chunk. Units: degrees. Minimum latitude of the chunk. This value is ignored if the simulation is in 2d. Units: degrees. -977 +987 [Double -90...90 (inclusive)] @@ -4523,7 +4523,7 @@ Minimum latitude of the chunk. This value is ignored if the simulation is in 2d. Minimum longitude of the chunk. Units: degrees. -975 +985 [Double -180...360 (inclusive)] @@ -4540,7 +4540,7 @@ Minimum longitude of the chunk. Units: degrees. Radius at the top surface of the chunk. Units: \si{\meter}. -974 +984 [Double 0...MAX_DOUBLE (inclusive)] @@ -4557,7 +4557,7 @@ Radius at the top surface of the chunk. Units: \si{\meter}. Number of cells in latitude. This value is ignored if the simulation is in 2d -981 +991 [Integer range 1...2147483647 (inclusive)] @@ -4574,7 +4574,7 @@ Number of cells in latitude. This value is ignored if the simulation is in 2d Number of cells in longitude. -980 +990 [Integer range 1...2147483647 (inclusive)] @@ -4591,7 +4591,7 @@ Number of cells in longitude. Number of cells in radius. -979 +989 [Integer range 1...2147483647 (inclusive)] @@ -4610,7 +4610,7 @@ Number of cells in radius. Radius at the bottom surface of the chunk. Units: \si{\meter}. -939 +948 [Double 0...MAX_DOUBLE (inclusive)] @@ -4627,7 +4627,7 @@ Radius at the bottom surface of the chunk. Units: \si{\meter}. Maximum latitude of the chunk. This value is ignored if the simulation is in 2d. Units: degrees. -945 +954 [Double -90...90 (inclusive)] @@ -4644,7 +4644,7 @@ Maximum latitude of the chunk. This value is ignored if the simulation is in 2d. Maximum longitude of the chunk. Units: degrees. -943 +952 [Double -180...360 (inclusive)] @@ -4661,7 +4661,7 @@ Maximum longitude of the chunk. Units: degrees. Radius at the top surface of the lower chunk, where it merges with the upper chunk. Units: \si{\meter}. -941 +950 [Double 0...MAX_DOUBLE (inclusive)] @@ -4678,7 +4678,7 @@ Radius at the top surface of the lower chunk, where it merges with the upper chu Minimum latitude of the chunk. This value is ignored if the simulation is in 2d. Units: degrees. -944 +953 [Double -90...90 (inclusive)] @@ -4695,7 +4695,7 @@ Minimum latitude of the chunk. This value is ignored if the simulation is in 2d. Minimum longitude of the chunk. Units: degrees. -942 +951 [Double -180...360 (inclusive)] @@ -4712,7 +4712,7 @@ Minimum longitude of the chunk. Units: degrees. Radius at the top surface of the chunk. Units: \si{\meter}. -940 +949 [Double 0...MAX_DOUBLE (inclusive)] @@ -4729,7 +4729,7 @@ Radius at the top surface of the chunk. Units: \si{\meter}. Number of cells in radial direction for the lower chunk. -947 +956 [Integer range 1...2147483647 (inclusive)] @@ -4746,7 +4746,7 @@ Number of cells in radial direction for the lower chunk. Number of cells in latitude. This value is ignored if the simulation is in 2d -949 +958 [Integer range 1...2147483647 (inclusive)] @@ -4763,7 +4763,7 @@ Number of cells in latitude. This value is ignored if the simulation is in 2d Number of cells in longitude. -948 +957 [Integer range 1...2147483647 (inclusive)] @@ -4780,7 +4780,7 @@ Number of cells in longitude. Number of cells in radial direction for the upper chunk. -946 +955 [Integer range 1...2147483647 (inclusive)] @@ -4797,7 +4797,7 @@ true Whether to make the grid by gluing together two boxes, or just use one chunk to make the grid. Using two grids glued together is a safer option, since it forces the boundary conditions to be always applied to the same depth, but using one grid allows for a more flexible usage of the adaptive refinement. Note that if there is no cell boundary exactly on the boundary between the lithosphere and the mantle, the velocity boundary will not be exactly at that depth. Therefore, using a merged grid is generally recommended over using one grid. When using one grid, the parameter for lower repetitions is used and the upper repetitions are ignored. -950 +959 [Bool] @@ -4816,7 +4816,7 @@ Whether to make the grid by gluing together two boxes, or just use one chunk to Bottom depth of model region. -986 +964 [Double 0...MAX_DOUBLE (inclusive)] @@ -4833,7 +4833,7 @@ Bottom depth of model region. The number of subdivisions of the coarse (initial) mesh in depth. -991 +969 [Integer range 0...2147483647 (inclusive)] @@ -4850,7 +4850,7 @@ The number of subdivisions of the coarse (initial) mesh in depth. The number of subdivisions of the coarse (initial) mesh in the East-West direction. -989 +967 [Integer range 0...2147483647 (inclusive)] @@ -4867,7 +4867,7 @@ The number of subdivisions of the coarse (initial) mesh in the East-West directi Eccentricity of the ellipsoid. Zero is a perfect sphere, default (8.1819190842622e-2) is WGS84. -988 +966 [Double 0...MAX_DOUBLE (inclusive)] @@ -4880,7 +4880,7 @@ Eccentricity of the ellipsoid. Zero is a perfect sphere, default (8.181919084262 Longitude:latitude in degrees of the North-East corner point of model region.The North-East direction is positive. If one of the three corners is not provided the missing corner value will be calculated so all faces are parallel. -982 +960 [Anything] @@ -4893,7 +4893,7 @@ Longitude:latitude in degrees of the North-East corner point of model region.The Longitude:latitude in degrees of the North-West corner point of model region. The North-East direction is positive. If one of the three corners is not provided the missing corner value will be calculated so all faces are parallel. -983 +961 [Anything] @@ -4910,7 +4910,7 @@ Longitude:latitude in degrees of the North-West corner point of model region. Th The number of subdivisions of the coarse (initial) mesh in the North-South direction. -990 +968 [Integer range 0...2147483647 (inclusive)] @@ -4923,7 +4923,7 @@ The number of subdivisions of the coarse (initial) mesh in the North-South direc Longitude:latitude in degrees of the South-East corner point of model region. The North-East direction is positive. If one of the three corners is not provided the missing corner value will be calculated so all faces are parallel. -985 +963 [Anything] @@ -4936,7 +4936,7 @@ Longitude:latitude in degrees of the South-East corner point of model region. Th Longitude:latitude in degrees of the South-West corner point of model region. The North-East direction is positive. If one of the three corners is not provided the missing corner value will be calculated so all faces are parallel. -984 +962 [Anything] @@ -4953,7 +4953,7 @@ Longitude:latitude in degrees of the South-West corner point of model region. Th The semi-major axis (a) of an ellipsoid. This is the radius for a sphere (eccentricity=0). Default WGS84 semi-major axis. -987 +965 [Double 0...MAX_DOUBLE (inclusive)] @@ -5154,7 +5154,7 @@ Set the topography height and the polygon which should be set to that height. Th Radius of the sphere. Units: \si{\meter}. -951 +970 [Double 0...MAX_DOUBLE (inclusive)] @@ -5177,7 +5177,7 @@ In 3d, the number of cells is computed differently and does not have an easy int In either case, this parameter is ignored unless the opening angle of the domain is 360 degrees. This parameter is also ignored when using a custom mesh subdivision scheme. -959 +928 [Integer range 0...2147483647 (inclusive)] @@ -5194,7 +5194,7 @@ none Choose how the spherical shell mesh is generated. By default, a coarse mesh is generated with respect to the inner and outer radius, and an initial number of cells along circumference. In the other cases, a surface mesh is first generated and refined as desired, before it is extruded radially following the specified subdivision scheme. -952 +921 [Selection none|list of radial values|number of slices ] @@ -5211,7 +5211,7 @@ Choose how the spherical shell mesh is generated. By default, a coarse mesh is g Initial lateral refinement for the custom mesh subdivision schemes.The number of refinement steps performed on the initial coarse surface mesh, before the surface is extruded radially. This parameter allows the user more control over the ratio between radial and lateral refinement of the mesh. -955 +924 [Integer range 0...2147483647 (inclusive)] @@ -5232,7 +5232,7 @@ The default value of 3,481,000 m equals the radius of a sphere with equal volume ::: -956 +925 [Double 0...MAX_DOUBLE (inclusive)] @@ -5245,7 +5245,7 @@ The default value of 3,481,000 m equals the radius of a sphere with equal volume List of radial values for the custom mesh scheme. Units: $\si{m}$. A list of radial values subdivides the spherical shell at specified radii. The list must be strictly ascending, and the first value must be greater than the inner radius while the last must be less than the outer radius. -953 +922 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -5262,7 +5262,7 @@ List of radial values for the custom mesh scheme. Units: $\si{m}$. A list of rad Number of slices for the custom mesh subdivision scheme. The number of slices subdivides the spherical shell into N slices of equal thickness. Must be greater than 0. -954 +923 [Integer range 1...2147483647 (inclusive)] @@ -5279,7 +5279,7 @@ Number of slices for the custom mesh subdivision scheme. The number of slices su Opening angle in degrees of the section of the shell that we want to build. The only opening angles that are allowed for this geometry are 90, 180, and 360 in 2d; and 90 and 360 in 3d. Units: degrees. -958 +927 [Double 0...360 (inclusive)] @@ -5300,7 +5300,7 @@ The default value of 6,336,000 m equals the radius of a sphere with equal volume ::: -957 +926 [Double 0...MAX_DOUBLE (inclusive)] @@ -5317,7 +5317,7 @@ false Whether the shell should be periodic in the phi direction. -960 +929 [Bool] @@ -5367,7 +5367,7 @@ $ASPECT_SOURCE_DIR/data/gravity-model/ The name of a directory that contains the model data. This path may either be absolute (if starting with a `/') or relative to the current directory. The path may also include the special text `$ASPECT_SOURCE_DIR' which will be interpreted as the path in which the ASPECT source files were located when ASPECT was compiled. This interpretation allows, for example, to reference files located in the `data/' subdirectory of ASPECT. -1003 +1004 [DirectoryName] @@ -5384,7 +5384,7 @@ prem.txt The file name of the model data. -1004 +1005 [Anything] @@ -5401,7 +5401,7 @@ The file name of the model data. Scalar factor, which is applied to the model data. You might want to use this to scale the input to a reference model. Another way to use this factor is to convert units of the input files. For instance, if you provide velocities in cm/yr set this factor to 0.01. -1005 +1006 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -5418,7 +5418,7 @@ Sometimes it is convenient to use symbolic constants in the expression that desc A typical example would be to set this runtime parameter to `pi=3.1415926536' and then use `pi' in the expression of the actual formula. (That said, for convenience this class actually defines both `pi' and `Pi' by default, but you get the idea.) -1008 +1009 [Anything] @@ -5437,7 +5437,7 @@ The formula that denotes the function you want to evaluate for particular values If the function you are describing represents a vector-valued function with multiple components, then separate the expressions for individual components by a semicolon. -1007 +1008 [Anything] @@ -5454,7 +5454,7 @@ x,y,t The names of the variables as they will be used in the function, separated by commas. By default, the names of variables at which the function will be evaluated are `x' (in 1d), `x,y' (in 2d) or `x,y,z' (in 3d) for spatial coordinates and `t' for time. You can then use these variable names in your function expression and they will be replaced by the values of these variables at which the function is currently evaluated. However, you can also choose a different set of names for the independent variables at which to evaluate your function expression. For example, if you work in spherical coordinates, you may wish to set this input parameter to `r,phi,theta,t' and then use these variable names in your function expression. -1006 +1007 [Anything] @@ -5473,7 +5473,7 @@ The names of the variables as they will be used in the function, separated by co Magnitude of the gravity vector in $m/s^2$. For positive values the direction is radially inward towards the center of the earth. -1009 +1010 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -5492,7 +5492,7 @@ Magnitude of the gravity vector in $m/s^2$. For positive values the direction is Magnitude of the radial gravity vector at the bottom of the domain. `Bottom' means themaximum depth in the chosen geometry, and for example represents the core-mantle boundary in the case of the `spherical shell' geometry model, and the center in the case of the `sphere' geometry model. Units: \si{\meter\per\second\squared}. -1011 +1012 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -5509,7 +5509,7 @@ Magnitude of the radial gravity vector at the bottom of the domain. `Bottom&apos Magnitude of the radial gravity vector at the surface of the domain. Units: \si{\meter\per\second\squared}. -1010 +1011 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -5528,7 +5528,7 @@ Magnitude of the radial gravity vector at the surface of the domain. Units: \si{ Value of the gravity vector in $m/s^2$ directed along negative y (2d) or z (3d) axis (if the magnitude is positive. -1012 +1003 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -5594,7 +5594,7 @@ false A flag indicating whether the adiabatic heating should be simplified from $\alpha T (\mathbf u \cdot \nabla p)$ to $ \alpha \rho T (\mathbf u \cdot \mathbf g) $. -910 +912 [Bool] @@ -5613,7 +5613,7 @@ false A flag indicating whether the adiabatic heating should be simplified from $\alpha T (\mathbf u \cdot \nabla p)$ to $ \alpha \rho T (\mathbf u \cdot \mathbf g) $. -911 +913 [Bool] @@ -5632,7 +5632,7 @@ A flag indicating whether the adiabatic heating should be simplified from $\alph List of heat production per unit volume values for background and compositional fields, for a total of N+1 values, where the first value corresponds to the background material, and N is the number of compositional fields. Units: \si{\watt\per\meter\cubed}. -912 +914 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -5649,7 +5649,7 @@ List of heat production per unit volume values for background and compositional A list of integers with as many entries as compositional fields plus one. The first entry corresponds to the background material, each following entry corresponds to a particular compositional field. If the entry for a field is '1' this field is considered during the computation of volume fractions, if it is '0' the field is ignored. This is useful if some compositional fields are used to track properties like finite strain that should not contribute to heat production. The first entry determines whether the background field contributes to heat production or not (essentially similar to setting its 'Compositional heating values' to zero, but included for consistency in the length of the input lists). -913 +915 [List of <[Integer range 0...1 (inclusive)]> of length 0...4294967295 (inclusive)] @@ -5668,7 +5668,7 @@ A list of integers with as many entries as compositional fields plus one. The fi The specific rate of heating due to radioactive decay (or other bulk sources you may want to describe). This parameter corresponds to the variable $H$ in the temperature equation stated in the manual, and the heating term is $ ho H$. Units: W/kg. -914 +916 [Double 0...MAX_DOUBLE (inclusive)] @@ -5685,7 +5685,7 @@ Sometimes it is convenient to use symbolic constants in the expression that desc A typical example would be to set this runtime parameter to `pi=3.1415926536' and then use `pi' in the expression of the actual formula. (That said, for convenience this class actually defines both `pi' and `Pi' by default, but you get the idea.) -917 +919 [Anything] @@ -5704,7 +5704,7 @@ The formula that denotes the function you want to evaluate for particular values If the function you are describing represents a vector-valued function with multiple components, then separate the expressions for individual components by a semicolon. -916 +918 [Anything] @@ -5721,7 +5721,7 @@ x,y,t The names of the variables as they will be used in the function, separated by commas. By default, the names of variables at which the function will be evaluated are `x' (in 1d), `x,y' (in 2d) or `x,y,z' (in 3d) for spatial coordinates and `t' for time. You can then use these variable names in your function expression and they will be replaced by the values of these variables at which the function is currently evaluated. However, you can also choose a different set of names for the independent variables at which to evaluate your function expression. For example, if you work in spherical coordinates, you may wish to set this input parameter to `r,phi,theta,t' and then use these variable names in your function expression. -915 +917 [Anything] @@ -5740,7 +5740,7 @@ The names of the variables as they will be used in the function, separated by co The entropy change for the phase transition from solid to melt. Units: \si{\joule\per\kelvin\per\kilogram}. -918 +899 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -5757,7 +5757,7 @@ false Instead of using the entropy change given in the 'Melting entropy change' query the EnthalpyAdditionalOutputs in the material model to compute the entropy change for the phase transition from solid to melt.Units: $J/(kg K)$. -919 +900 [Bool] @@ -5776,7 +5776,7 @@ Instead of using the entropy change given in the 'Melting entropy change&ap Which composition field should be treated as crust -906 +908 [Integer range 0...2147483647 (inclusive)] @@ -5793,7 +5793,7 @@ false Whether crust defined by composition or depth -904 +906 [Bool] @@ -5810,7 +5810,7 @@ Whether crust defined by composition or depth Depth of the crust when crust if defined by depth. Units: \si{\meter}. -905 +907 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -5823,7 +5823,7 @@ Depth of the crust when crust if defined by depth. Units: \si{\meter}. Half decay times. Units: (Seconds), or (Years) if set `use years instead of seconds'. -901 +903 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -5836,7 +5836,7 @@ Half decay times. Units: (Seconds), or (Years) if set `use years instead of seco Heating rates of different elements (W/kg) -900 +902 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -5849,7 +5849,7 @@ Heating rates of different elements (W/kg) Initial concentrations of different elements (ppm) -902 +904 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -5862,7 +5862,7 @@ Initial concentrations of different elements (ppm) Initial concentrations of different elements (ppm) -903 +905 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -5879,7 +5879,7 @@ Initial concentrations of different elements (ppm) Number of radioactive elements -899 +901 [Integer range 0...2147483647 (inclusive)] @@ -5898,7 +5898,7 @@ Number of radioactive elements Cohesion for maximum shear stress that should be used for the computation of shear heating. It can be useful to limit the shear stress in models where velocities are prescribed, and actual stresses in the Earth would be lower than the stresses introduced by the boundary conditions. Only used if 'Limit stress contribution to shear heating' is true. Units: Pa. -908 +910 [Double 0...MAX_DOUBLE (inclusive)] @@ -5915,7 +5915,7 @@ Cohesion for maximum shear stress that should be used for the computation of she Friction angle for maximum shear stress that should be used for the computation of shear heating. It can be useful to limit the shear stress in models where velocities are prescribed, and actual stresses in the Earth would be lower than the stresses introduced by the boundary conditions. Only used if 'Limit stress contribution to shear heating' is true. Units: none. -909 +911 [Double 0...MAX_DOUBLE (inclusive)] @@ -5932,7 +5932,7 @@ false In models with prescribed boundary velocities, stresses can become unrealistically large. Using these large stresses when calculating the amount of shear heating would then lead to an unreasonable increase in temperature. This parameter indicates if the stress being used to compute the amount of shear heating should be limited based on a Drucker-Prager yield criterion with the cohesion given by the 'Cohesion for maximum shear stress' parameter and the friction angle given by the 'Friction angle for maximum shear stress' parameter. -907 +909 [Bool] @@ -6053,7 +6053,7 @@ $ASPECT_SOURCE_DIR/data/initial-composition/ascii-data/test/ The name of a directory that contains the model data. This path may either be absolute (if starting with a `/') or relative to the current directory. The path may also include the special text `$ASPECT_SOURCE_DIR' which will be interpreted as the path in which the ASPECT source files were located when ASPECT was compiled. This interpretation allows, for example, to reference files located in the `data/' subdirectory of ASPECT. -1145 +1149 [DirectoryName] @@ -6070,7 +6070,7 @@ initial_composition_top_mantle_box_3d.txt The file name of the model data. -1143 +1147 [Anything] @@ -6087,7 +6087,7 @@ initial_composition_top_mantle_box_3d.txt The file names of the model data (comma separated). -1146 +1150 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -6104,7 +6104,7 @@ The file names of the model data (comma separated). Point that determines the plane in which the 2d slice lies in. This variable is only used if 'Slice dataset in 2d plane' is true. The slice will go through this point, the point defined by the parameter 'Second point on slice', and the center of the model domain. After the rotation, this first point will lie along the (0,1,0) axis of the coordinate system. The coordinates of the point have to be given in Cartesian coordinates. -1140 +1144 [Anything] @@ -6121,7 +6121,7 @@ linear Method to interpolate between layer boundaries. Select from piecewise constant or linear. Piecewise constant takes the value from the nearest layer boundary above the data point. The linear option interpolates linearly between layer boundaries. Above and below the domain given by the layer boundaries, the values aregiven by the top and bottom layer boundary. -1147 +1151 [Selection piecewise constant|linear ] @@ -6138,7 +6138,7 @@ Method to interpolate between layer boundaries. Select from piecewise constant o Scalar factor, which is applied to the model data. You might want to use this to scale the input to a reference model. Another way to use this factor is to convert units of the input files. For instance, if you provide velocities in cm/yr set this factor to 0.01. -1144 +1148 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -6155,7 +6155,7 @@ Scalar factor, which is applied to the model data. You might want to use this to Second point that determines the plane in which the 2d slice lies in. This variable is only used if 'Slice dataset in 2d plane' is true. The slice will go through this point, the point defined by the parameter 'First point on slice', and the center of the model domain. The coordinates of the point have to be given in Cartesian coordinates. -1141 +1145 [Anything] @@ -6172,7 +6172,7 @@ false Whether to use a 2d data slice of a 3d data file or the entire data file. Slicing a 3d dataset is only supported for 2d models. -1139 +1143 [Bool] @@ -6191,7 +6191,7 @@ $ASPECT_SOURCE_DIR/data/material-model/entropy-table/pyrtable/ The path to the model data. The path may also include the special text '$ASPECT_SOURCE_DIR' which will be interpreted as the path in which the ASPECT source files were located when ASPECT was compiled. This interpretation allows, for example, to reference files located in the `data/' subdirectory of ASPECT. -1148 +1152 [DirectoryName] @@ -6208,7 +6208,7 @@ material_table_temperature_pressure.txt The file name of the material data. -1149 +1153 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -6227,7 +6227,7 @@ cartesian A selection that determines the assumed coordinate system for the function variables. Allowed values are `cartesian', `spherical', and `depth'. `spherical' coordinates are interpreted as r,phi or r,phi,theta in 2d/3d respectively with theta being the polar angle. `depth' will create a function, in which only the first parameter is non-zero, which is interpreted to be the depth of the point. -1150 +1131 [Selection cartesian|spherical|depth ] @@ -6242,7 +6242,7 @@ Sometimes it is convenient to use symbolic constants in the expression that desc A typical example would be to set this runtime parameter to `pi=3.1415926536' and then use `pi' in the expression of the actual formula. (That said, for convenience this class actually defines both `pi' and `Pi' by default, but you get the idea.) -1153 +1134 [Anything] @@ -6261,7 +6261,7 @@ The formula that denotes the function you want to evaluate for particular values If the function you are describing represents a vector-valued function with multiple components, then separate the expressions for individual components by a semicolon. -1152 +1133 [Anything] @@ -6278,7 +6278,7 @@ x,y,t The names of the variables as they will be used in the function, separated by commas. By default, the names of variables at which the function will be evaluated are `x' (in 1d), `x,y' (in 2d) or `x,y,z' (in 3d) for spatial coordinates and `t' for time. You can then use these variable names in your function expression and they will be replaced by the values of these variables at which the function is currently evaluated. However, you can also choose a different set of names for the independent variables at which to evaluate your function expression. For example, if you work in spherical coordinates, you may wish to set this input parameter to `r,phi,theta,t' and then use these variable names in your function expression. -1151 +1132 [Anything] @@ -6297,7 +6297,7 @@ $ASPECT_SOURCE_DIR/data/initial-composition/slab-model/ The name of a directory that contains the model data. This path may either be absolute (if starting with a `/') or relative to the current directory. The path may also include the special text `$ASPECT_SOURCE_DIR' which will be interpreted as the path in which the ASPECT source files were located when ASPECT was compiled. This interpretation allows, for example, to reference files located in the `data/' subdirectory of ASPECT. -1131 +1135 [DirectoryName] @@ -6314,7 +6314,7 @@ shell_3d.txt The file name of the model data. Provide file in format: (File name).\%s, where \%s is a string specifying the boundary of the model according to the names of the boundary indicators (of the chosen geometry model). -1134 +1138 [Anything] @@ -6331,7 +6331,7 @@ The file name of the model data. Provide file in format: (File name).\%s, where Scalar factor, which is applied to the model data. You might want to use this to scale the input to a reference model. Another way to use this factor is to convert units of the input files. For instance, if you provide velocities in cm/yr set this factor to 0.01. -1133 +1137 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -6346,7 +6346,7 @@ Scalar factor, which is applied to the model data. You might want to use this to A list of names of compositional fields for which to determine the initial composition using the World Builder. As World Builder evaluations can be expensive, this parameter allows to only evaluate the fields that are relevant. This plugin returns 0.0 for all compositions that are not selected in the list. By default the list is empty and the world builder is evaluated for all compositional fields. -1135 +1139 [Anything] @@ -6516,7 +6516,7 @@ Make sure the top and bottom temperatures of the lithosphere agree with temperat The age of the lower thermal boundary layer, used for the calculation of the half-space cooling model temperature. Units: years if the 'Use years in output instead of seconds' parameter is set; seconds otherwise. -1107 +1113 [Double 0...MAX_DOUBLE (inclusive)] @@ -6533,7 +6533,7 @@ The age of the lower thermal boundary layer, used for the calculation of the hal The age of the upper thermal boundary layer, used for the calculation of the half-space cooling model temperature. Units: years if the 'Use years in output instead of seconds' parameter is set; seconds otherwise. -1106 +1112 [Double 0...MAX_DOUBLE (inclusive)] @@ -6550,7 +6550,7 @@ The age of the upper thermal boundary layer, used for the calculation of the hal The amplitude (in K) of the initial spherical temperature perturbation at the bottom of the model domain. This perturbation will be added to the adiabatic temperature profile, but not to the bottom thermal boundary layer. Instead, the maximum of the perturbation and the bottom boundary layer temperature will be used. -1109 +1115 [Double 0...MAX_DOUBLE (inclusive)] @@ -6567,7 +6567,7 @@ half-space cooling Whether to use the half space cooling model or the plate cooling model -1113 +1119 [Selection half-space cooling|plate cooling ] @@ -6584,7 +6584,7 @@ $ASPECT_SOURCE_DIR/data/initial-temperature/adiabatic/ The name of a directory that contains the model data. This path may either be absolute (if starting with a `/') or relative to the current directory. The path may also include the special text `$ASPECT_SOURCE_DIR' which will be interpreted as the path in which the ASPECT source files were located when ASPECT was compiled. This interpretation allows, for example, to reference files located in the `data/' subdirectory of ASPECT. -1103 +1109 [DirectoryName] @@ -6601,7 +6601,7 @@ adiabatic.txt The file name of the model data. -1104 +1110 [Anything] @@ -6618,7 +6618,7 @@ The file name of the model data. Thickness of the lithosphere for plate cooling model. \si{\m} -1114 +1120 [Double 0...MAX_DOUBLE (inclusive)] @@ -6635,7 +6635,7 @@ center Where the initial temperature perturbation should be placed. If `center' is given, then the perturbation will be centered along a `midpoint' of some sort of the bottom boundary. For example, in the case of a box geometry, this is the center of the bottom face; in the case of a spherical shell geometry, it is along the inner surface halfway between the bounding radial lines. -1110 +1116 [Selection center ] @@ -6652,7 +6652,7 @@ Where the initial temperature perturbation should be placed. If `center' is The Radius (in m) of the initial spherical temperature perturbation at the bottom of the model domain. -1108 +1114 [Double 0...MAX_DOUBLE (inclusive)] @@ -6669,7 +6669,7 @@ The Radius (in m) of the initial spherical temperature perturbation at the botto Scalar factor, which is applied to the model data. You might want to use this to scale the input to a reference model. Another way to use this factor is to convert units of the input files. For instance, if you provide velocities in cm/yr set this factor to 0.01. -1105 +1111 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -6688,7 +6688,7 @@ If this value is larger than 0, the initial temperature profile will not be adia The function object in the Function subsection represents the compositional fields that will be used as a reference profile for calculating the thermal diffusivity. This function is one-dimensional and depends only on depth. The format of this functions follows the syntax understood by the muparser library, see {ref}\`sec:run-aspect:parameters-overview:muparser-format\`. -1111 +1117 [Double 0...MAX_DOUBLE (inclusive)] @@ -6705,7 +6705,7 @@ constant How to define the age of the top thermal boundary layer. Options are: 'constant' for a constant age specified by the parameter 'Age top boundary layer'; 'function' for an analytical function describing the age as specified in the subsection 'Age function'; and 'ascii data' to use an 'ascii data' file specified by the parameter 'Data file name'. -1112 +1118 [Selection constant|function|ascii data ] @@ -6723,7 +6723,7 @@ cartesian A selection that determines the assumed coordinate system for the function variables. Allowed values are `cartesian', `spherical', and `depth'. `spherical' coordinates are interpreted as r,phi or r,phi,theta in 2d/3d respectively with theta being the polar angle. `depth' will create a function, in which only the first parameter is non-zero, which is interpreted to be the depth of the point. -1118 +1124 [Selection cartesian|spherical ] @@ -6738,7 +6738,7 @@ Sometimes it is convenient to use symbolic constants in the expression that desc A typical example would be to set this runtime parameter to `pi=3.1415926536' and then use `pi' in the expression of the actual formula. (That said, for convenience this class actually defines both `pi' and `Pi' by default, but you get the idea.) -1121 +1127 [Anything] @@ -6757,7 +6757,7 @@ The formula that denotes the function you want to evaluate for particular values If the function you are describing represents a vector-valued function with multiple components, then separate the expressions for individual components by a semicolon. -1120 +1126 [Anything] @@ -6774,7 +6774,7 @@ x,y,t The names of the variables as they will be used in the function, separated by commas. By default, the names of variables at which the function will be evaluated are `x' (in 1d), `x,y' (in 2d) or `x,y,z' (in 3d) for spatial coordinates and `t' for time. You can then use these variable names in your function expression and they will be replaced by the values of these variables at which the function is currently evaluated. However, you can also choose a different set of names for the independent variables at which to evaluate your function expression. For example, if you work in spherical coordinates, you may wish to set this input parameter to `r,phi,theta,t' and then use these variable names in your function expression. -1119 +1125 [Anything] @@ -6791,7 +6791,7 @@ Sometimes it is convenient to use symbolic constants in the expression that desc A typical example would be to set this runtime parameter to `pi=3.1415926536' and then use `pi' in the expression of the actual formula. (That said, for convenience this class actually defines both `pi' and `Pi' by default, but you get the idea.) -1117 +1123 [Anything] @@ -6810,7 +6810,7 @@ The formula that denotes the function you want to evaluate for particular values If the function you are describing represents a vector-valued function with multiple components, then separate the expressions for individual components by a semicolon. -1116 +1122 [Anything] @@ -6827,7 +6827,7 @@ x,t The names of the variables as they will be used in the function, separated by commas. By default, the names of variables at which the function will be evaluated are `x' (in 1d), `x,y' (in 2d) or `x,y,z' (in 3d) for spatial coordinates and `t' for time. You can then use these variable names in your function expression and they will be replaced by the values of these variables at which the function is currently evaluated. However, you can also choose a different set of names for the independent variables at which to evaluate your function expression. For example, if you work in spherical coordinates, you may wish to set this input parameter to `r,phi,theta,t' and then use these variable names in your function expression. -1115 +1121 [Anything] @@ -6847,7 +6847,7 @@ The names of the variables as they will be used in the function, separated by co The value of the adiabatic temperature gradient. Units: \si{\kelvin\per\meter}. -1127 +1043 [Double 0...MAX_DOUBLE (inclusive)] @@ -6864,7 +6864,7 @@ $ASPECT_SOURCE_DIR/data/initial-temperature/adiabatic-boundary/ The name of a directory that contains the model data. This path may either be absolute (if starting with a `/') or relative to the current directory. The path may also include the special text `$ASPECT_SOURCE_DIR' which will be interpreted as the path in which the ASPECT source files were located when ASPECT was compiled. This interpretation allows, for example, to reference files located in the `data/' subdirectory of ASPECT. -1122 +1038 [DirectoryName] @@ -6881,7 +6881,7 @@ adiabatic_boundary.txt The file name of the model data. -1123 +1039 [Anything] @@ -6898,7 +6898,7 @@ The file name of the model data. The value of the isothermal boundary temperature. Units: \si{\kelvin}. -1125 +1041 [Double 0...MAX_DOUBLE (inclusive)] @@ -6915,7 +6915,7 @@ The value of the isothermal boundary temperature. Units: \si{\kelvin}. Scalar factor, which is applied to the model data. You might want to use this to scale the input to a reference model. Another way to use this factor is to convert units of the input files. For instance, if you provide velocities in cm/yr set this factor to 0.01. -1124 +1040 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -6932,7 +6932,7 @@ Scalar factor, which is applied to the model data. You might want to use this to The value of the surface temperature. Units: \si{\kelvin}. -1126 +1042 [Double 0...MAX_DOUBLE (inclusive)] @@ -6951,7 +6951,7 @@ $ASPECT_SOURCE_DIR/data/initial-temperature/ascii-data/test/ The name of a directory that contains the model data. This path may either be absolute (if starting with a `/') or relative to the current directory. The path may also include the special text `$ASPECT_SOURCE_DIR' which will be interpreted as the path in which the ASPECT source files were located when ASPECT was compiled. This interpretation allows, for example, to reference files located in the `data/' subdirectory of ASPECT. -1047 +1053 [DirectoryName] @@ -6968,7 +6968,7 @@ initial_isotherm_500K_box_3d.txt The file name of the model data. -1045 +1051 [Anything] @@ -6985,7 +6985,7 @@ initial_isotherm_500K_box_3d.txt The file names of the model data (comma separated). -1048 +1054 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -7002,7 +7002,7 @@ The file names of the model data (comma separated). Point that determines the plane in which the 2d slice lies in. This variable is only used if 'Slice dataset in 2d plane' is true. The slice will go through this point, the point defined by the parameter 'Second point on slice', and the center of the model domain. After the rotation, this first point will lie along the (0,1,0) axis of the coordinate system. The coordinates of the point have to be given in Cartesian coordinates. -1042 +1048 [Anything] @@ -7019,7 +7019,7 @@ linear Method to interpolate between layer boundaries. Select from piecewise constant or linear. Piecewise constant takes the value from the nearest layer boundary above the data point. The linear option interpolates linearly between layer boundaries. Above and below the domain given by the layer boundaries, the values aregiven by the top and bottom layer boundary. -1049 +1055 [Selection piecewise constant|linear ] @@ -7036,7 +7036,7 @@ Method to interpolate between layer boundaries. Select from piecewise constant o Scalar factor, which is applied to the model data. You might want to use this to scale the input to a reference model. Another way to use this factor is to convert units of the input files. For instance, if you provide velocities in cm/yr set this factor to 0.01. -1046 +1052 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -7053,7 +7053,7 @@ Scalar factor, which is applied to the model data. You might want to use this to Second point that determines the plane in which the 2d slice lies in. This variable is only used if 'Slice dataset in 2d plane' is true. The slice will go through this point, the point defined by the parameter 'First point on slice', and the center of the model domain. The coordinates of the point have to be given in Cartesian coordinates. -1043 +1049 [Anything] @@ -7070,7 +7070,7 @@ false Whether to use a 2d data slice of a 3d data file or the entire data file. Slicing a 3d dataset is only supported for 2d models. -1041 +1047 [Bool] @@ -7089,7 +7089,7 @@ $ASPECT_SOURCE_DIR/data/initial-temperature/ascii-profile/tests/ The name of a directory that contains the model data. This path may either be absolute (if starting with a `/') or relative to the current directory. The path may also include the special text `$ASPECT_SOURCE_DIR' which will be interpreted as the path in which the ASPECT source files were located when ASPECT was compiled. This interpretation allows, for example, to reference files located in the `data/' subdirectory of ASPECT. -1050 +1056 [DirectoryName] @@ -7106,7 +7106,7 @@ simple_test.txt The file name of the model data. -1051 +1057 [Anything] @@ -7123,7 +7123,7 @@ The file name of the model data. Scalar factor, which is applied to the model data. You might want to use this to scale the input to a reference model. Another way to use this factor is to convert units of the input files. For instance, if you provide velocities in cm/yr set this factor to 0.01. -1052 +1058 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -7142,7 +7142,7 @@ Scalar factor, which is applied to the model data. You might want to use this to List of the 3 thicknesses of the lithospheric layers 'upper\_crust', 'lower\_crust' and 'mantle\_lithosphere'. If only one thickness is given, then the same thickness is used for all layers. Units: \si{meter}. -1061 +1067 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -7159,7 +7159,7 @@ List of the 3 thicknesses of the lithospheric layers 'upper\_crust', & The value of the isotherm that is assumed at the Lithosphere-Asthenosphere boundary. Units: \si{\kelvin}. -1063 +1069 [Double 0...MAX_DOUBLE (inclusive)] @@ -7176,7 +7176,7 @@ The value of the isotherm that is assumed at the Lithosphere-Asthenosphere bound The value of the surface temperature. Units: \si{\kelvin}. -1062 +1068 [Double 0...MAX_DOUBLE (inclusive)] @@ -7195,7 +7195,7 @@ cartesian A selection that determines the assumed coordinate system for the function variables. Allowed values are `cartesian', `spherical', and `depth'. `spherical' coordinates are interpreted as r,phi or r,phi,theta in 2d/3d respectively with theta being the polar angle. `depth' will create a function, in which only the first parameter is non-zero, which is interpreted to be the depth of the point. -1064 +1070 [Selection cartesian|spherical|depth ] @@ -7210,7 +7210,7 @@ Sometimes it is convenient to use symbolic constants in the expression that desc A typical example would be to set this runtime parameter to `pi=3.1415926536' and then use `pi' in the expression of the actual formula. (That said, for convenience this class actually defines both `pi' and `Pi' by default, but you get the idea.) -1067 +1073 [Anything] @@ -7229,7 +7229,7 @@ The formula that denotes the function you want to evaluate for particular values If the function you are describing represents a vector-valued function with multiple components, then separate the expressions for individual components by a semicolon. -1066 +1072 [Anything] @@ -7246,7 +7246,7 @@ x,y,t The names of the variables as they will be used in the function, separated by commas. By default, the names of variables at which the function will be evaluated are `x' (in 1d), `x,y' (in 2d) or `x,y,z' (in 3d) for spatial coordinates and `t' for time. You can then use these variable names in your function expression and they will be replaced by the values of these variables at which the function is currently evaluated. However, you can also choose a different set of names for the independent variables at which to evaluate your function expression. For example, if you work in spherical coordinates, you may wish to set this input parameter to `r,phi,theta,t' and then use these variable names in your function expression. -1065 +1071 [Anything] @@ -7265,7 +7265,7 @@ The names of the variables as they will be used in the function, separated by co Doubled first lateral wave number of the harmonic perturbation. Equals the spherical harmonic degree in 3d spherical shells. In all other cases one equals half of a sine period over the model domain. This allows for single up-/downswings. Negative numbers reverse the sign of the perturbation but are not allowed for the spherical harmonic case. -1069 +1075 [Integer range -2147483648...2147483647 (inclusive)] @@ -7282,7 +7282,7 @@ Doubled first lateral wave number of the harmonic perturbation. Equals the spher Doubled second lateral wave number of the harmonic perturbation. Equals the spherical harmonic order in 3d spherical shells. In all other cases one equals half of a sine period over the model domain. This allows for single up-/downswings. Negative numbers reverse the sign of the perturbation. -1070 +1076 [Integer range -2147483648...2147483647 (inclusive)] @@ -7299,7 +7299,7 @@ Doubled second lateral wave number of the harmonic perturbation. Equals the sphe The magnitude of the Harmonic perturbation. -1071 +1077 [Double 0...MAX_DOUBLE (inclusive)] @@ -7316,7 +7316,7 @@ The magnitude of the Harmonic perturbation. The reference temperature that is perturbed by the harmonic function. Only used in incompressible models. -1072 +1078 [Double 0...MAX_DOUBLE (inclusive)] @@ -7333,7 +7333,7 @@ The reference temperature that is perturbed by the harmonic function. Only used Doubled radial wave number of the harmonic perturbation. One equals half of a sine period over the model domain. This allows for single up-/downswings. Negative numbers reverse the sign of the perturbation. -1068 +1074 [Integer range -2147483648...2147483647 (inclusive)] @@ -7352,7 +7352,7 @@ Doubled radial wave number of the harmonic perturbation. One equals half of a s The background temperature for the temperature field. -1056 +1062 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -7369,7 +7369,7 @@ The background temperature for the temperature field. The X coordinate for the center of the shape. -1058 +1064 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -7386,7 +7386,7 @@ The X coordinate for the center of the shape. The Y coordinate for the center of the shape. -1059 +1065 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -7403,7 +7403,7 @@ The Y coordinate for the center of the shape. The Z coordinate for the center of the shape. This is only necessary for three-dimensional fields. -1060 +1066 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -7420,7 +7420,7 @@ constant The gradient of the inclusion to be generated. -1054 +1060 [Selection gaussian|linear|constant ] @@ -7437,7 +7437,7 @@ circle The shape of the inclusion to be generated. -1053 +1059 [Selection square|circle ] @@ -7454,7 +7454,7 @@ The shape of the inclusion to be generated. The temperature of the inclusion shape. This is only the true temperature in the case of the constant gradient. In all other cases, it gives one endpoint of the temperature gradient for the shape. -1057 +1063 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -7471,7 +7471,7 @@ The temperature of the inclusion shape. This is only the true temperature in the The radius of the inclusion to be generated. For shapes with no radius (e.g. square), this will be the width, and for shapes with no width, this gives a general guideline for the size of the shape. -1055 +1061 [Double 0...MAX_DOUBLE (inclusive)] @@ -7736,7 +7736,7 @@ $ASPECT_SOURCE_DIR/data/initial-temperature/S40RTS/ The path to the model data. -1073 +1079 [DirectoryName] @@ -7753,7 +7753,7 @@ S40RTS.sph The file name of the spherical harmonics coefficients from Ritsema et al. -1074 +1080 [Anything] @@ -7770,7 +7770,7 @@ The file name of the spherical harmonics coefficients from Ritsema et al. The maximum order the users specify when reading the data file of spherical harmonic coefficients, which must be smaller than the maximum order the data file stored. This parameter will be used only if 'Specify a lower maximum order' is set to true. -1084 +1090 [Integer range 0...2147483647 (inclusive)] @@ -7787,7 +7787,7 @@ The maximum order the users specify when reading the data file of spherical harm The reference temperature that is perturbed by the spherical harmonic functions. Only used in incompressible models. -1081 +1087 [Double 0...MAX_DOUBLE (inclusive)] @@ -7804,7 +7804,7 @@ true Option to remove the degree zero component from the perturbation, which will ensure that the laterally averaged temperature for a fixed depth is equal to the background temperature. -1080 +1086 [Bool] @@ -7821,7 +7821,7 @@ Option to remove the degree zero component from the perturbation, which will ens This will set the heterogeneity prescribed by S20RTS or S40RTS to zero down to the specified depth (in meters). Note that your resolution has to be adequate to capture this cutoff. For example if you specify a depth of 660km, but your closest spherical depth layers are only at 500km and 750km (due to a coarse resolution) it will only zero out heterogeneities down to 500km. Similar caution has to be taken when using adaptive meshing. -1082 +1088 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -7838,7 +7838,7 @@ false Option to use a lower maximum order when reading the data file of spherical harmonic coefficients. This is probably used for the faster tests or when the users only want to see the spherical harmonic pattern up to a certain order. -1083 +1089 [Bool] @@ -7855,7 +7855,7 @@ Spline_knots.txt The file name of the spline knot locations from Ritsema et al. -1075 +1081 [Anything] @@ -7872,7 +7872,7 @@ The file name of the spline knot locations from Ritsema et al. The value of the thermal expansion coefficient $\beta$. Units: \si{\per\kelvin}. -1078 +1084 [Double 0...MAX_DOUBLE (inclusive)] @@ -7889,7 +7889,7 @@ false Option to take the thermal expansion coefficient from the material model instead of from what is specified in this section. -1079 +1085 [Bool] @@ -7906,7 +7906,7 @@ Option to take the thermal expansion coefficient from the material model instead This parameter specifies how the perturbation in shear wave velocity as prescribed by S20RTS or S40RTS is scaled into a density perturbation. See the general description of this model for more detailed information. -1077 +1083 [Double 0...MAX_DOUBLE (inclusive)] @@ -7923,7 +7923,7 @@ constant Method that is used to specify how the vs-to-density scaling varies with depth. -1076 +1082 [Selection file|constant ] @@ -7941,7 +7941,7 @@ $ASPECT_SOURCE_DIR/data/initial-temperature/S40RTS/ The name of a directory that contains the model data. This path may either be absolute (if starting with a `/') or relative to the current directory. The path may also include the special text `$ASPECT_SOURCE_DIR' which will be interpreted as the path in which the ASPECT source files were located when ASPECT was compiled. This interpretation allows, for example, to reference files located in the `data/' subdirectory of ASPECT. -1085 +1091 [DirectoryName] @@ -7958,7 +7958,7 @@ vs_to_density_Steinberger.txt The file name of the model data. -1086 +1092 [Anything] @@ -7975,7 +7975,7 @@ The file name of the model data. Scalar factor, which is applied to the model data. You might want to use this to scale the input to a reference model. Another way to use this factor is to convert units of the input files. For instance, if you provide velocities in cm/yr set this factor to 0.01. -1087 +1093 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -7995,7 +7995,7 @@ $ASPECT_SOURCE_DIR/data/initial-temperature/SAVANI/ The path to the model data. -1088 +1094 [DirectoryName] @@ -8012,7 +8012,7 @@ savani.dlnvs.60.m.ab The file name of the spherical harmonics coefficients from Auer et al. -1089 +1095 [Anything] @@ -8029,7 +8029,7 @@ The file name of the spherical harmonics coefficients from Auer et al. The maximum order the users specify when reading the data file of spherical harmonic coefficients, which must be smaller than the maximum order the data file stored. This parameter will be used only if 'Specify a lower maximum order' is set to true. -1099 +1105 [Integer range 0...2147483647 (inclusive)] @@ -8046,7 +8046,7 @@ The maximum order the users specify when reading the data file of spherical harm The reference temperature that is perturbed by the spherical harmonic functions. Only used in incompressible models. -1096 +1102 [Double 0...MAX_DOUBLE (inclusive)] @@ -8063,7 +8063,7 @@ true Option to remove the degree zero component from the perturbation, which will ensure that the laterally averaged temperature for a fixed depth is equal to the background temperature. -1095 +1101 [Bool] @@ -8080,7 +8080,7 @@ Option to remove the degree zero component from the perturbation, which will ens This will set the heterogeneity prescribed by SAVANI to zero down to the specified depth (in meters). Note that your resolution has to be adequate to capture this cutoff. For example if you specify a depth of 660km, but your closest spherical depth layers are only at 500km and 750km (due to a coarse resolution) it will only zero out heterogeneities down to 500km. Similar caution has to be taken when using adaptive meshing. -1097 +1103 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -8097,7 +8097,7 @@ false Option to use a lower maximum order when reading the data file of spherical harmonic coefficients. This is probably used for the faster tests or when the users only want to see the spherical harmonic pattern up to a certain order. -1098 +1104 [Bool] @@ -8114,7 +8114,7 @@ Spline_knots.txt The file name of the spline knots taken from the 28 spherical layers of SAVANI tomography model. -1090 +1096 [Anything] @@ -8131,7 +8131,7 @@ The file name of the spline knots taken from the 28 spherical layers of SAVANI t The value of the thermal expansion coefficient $\beta$. Units: \si{\per\kelvin}. -1093 +1099 [Double 0...MAX_DOUBLE (inclusive)] @@ -8148,7 +8148,7 @@ false Option to take the thermal expansion coefficient from the material model instead of from what is specified in this section. -1094 +1100 [Bool] @@ -8165,7 +8165,7 @@ Option to take the thermal expansion coefficient from the material model instead This parameter specifies how the perturbation in shear wave velocity as prescribed by SAVANI is scaled into a density perturbation. See the general description of this model for more detailed information. -1092 +1098 [Double 0...MAX_DOUBLE (inclusive)] @@ -8182,7 +8182,7 @@ constant Method that is used to specify how the vs-to-density scaling varies with depth. -1091 +1097 [Selection file|constant ] @@ -8200,7 +8200,7 @@ $ASPECT_SOURCE_DIR/data/initial-temperature/S40RTS/ The name of a directory that contains the model data. This path may either be absolute (if starting with a `/') or relative to the current directory. The path may also include the special text `$ASPECT_SOURCE_DIR' which will be interpreted as the path in which the ASPECT source files were located when ASPECT was compiled. This interpretation allows, for example, to reference files located in the `data/' subdirectory of ASPECT. -1100 +1106 [DirectoryName] @@ -8217,7 +8217,7 @@ vs_to_density_Steinberger.txt The file name of the model data. -1101 +1107 [Anything] @@ -8234,7 +8234,7 @@ The file name of the model data. Scalar factor, which is applied to the model data. You might want to use this to scale the input to a reference model. Another way to use this factor is to convert units of the input files. For instance, if you provide velocities in cm/yr set this factor to 0.01. -1102 +1108 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -8629,7 +8629,7 @@ Viscous stress may also be limited by a non-linear stress limiter that has a for Reference conductivity -889 +789 [Double 0...MAX_DOUBLE (inclusive)] @@ -8646,7 +8646,7 @@ Reference conductivity The temperature dependence of viscosity. Dimensionless exponent. -892 +792 [Double 0...MAX_DOUBLE (inclusive)] @@ -8663,7 +8663,7 @@ The temperature dependence of viscosity. Dimensionless exponent. A list of depths where the viscosity changes. Values must monotonically increase. Units: \si{\meter}. -893 +793 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -8680,7 +8680,7 @@ false Whether to use the TALA instead of the ALA approximation. -891 +791 [Bool] @@ -8697,7 +8697,7 @@ Whether to use the TALA instead of the ALA approximation. Viscosity -890 +790 [Double 0...MAX_DOUBLE (inclusive)] @@ -8714,7 +8714,7 @@ Viscosity A list of prefactors for the viscosity that determine the viscosity profile. Each prefactor is applied in a depth range specified by the list of `Transition depths', i.e. the first prefactor is applied above the first transition depth, the second one between the first and second transition depth, and so on. To compute the viscosity profile, this prefactor is multiplied by the reference viscosity specified through the parameter `Viscosity'. List must have one more entry than Transition depths. Units: non-dimensional. -894 +794 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -8732,7 +8732,7 @@ $ASPECT_SOURCE_DIR/data/adiabatic-conditions/ascii-data/ The name of a directory that contains the model data. This path may either be absolute (if starting with a `/') or relative to the current directory. The path may also include the special text `$ASPECT_SOURCE_DIR' which will be interpreted as the path in which the ASPECT source files were located when ASPECT was compiled. This interpretation allows, for example, to reference files located in the `data/' subdirectory of ASPECT. -895 +795 [DirectoryName] @@ -8745,7 +8745,7 @@ The name of a directory that contains the model data. This path may either be ab The file name of the model data. -896 +796 [Anything] @@ -8762,7 +8762,7 @@ The file name of the model data. Scalar factor, which is applied to the model data. You might want to use this to scale the input to a reference model. Another way to use this factor is to convert units of the input files. For instance, if you provide velocities in cm/yr set this factor to 0.01. -897 +797 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -8782,7 +8782,7 @@ none Choose the averaging operation to use. -790 +799 [Selection none|arithmetic average|harmonic average|geometric average|pick largest|log average|nwd arithmetic average|nwd harmonic average|nwd geometric average ] @@ -8799,7 +8799,7 @@ simple The name of a material model that will be modified by an averaging operation. Valid values for this parameter are the names of models that are also valid for the ``Material models/Model name'' parameter. See the documentation for that for more information. -789 +798 [Selection Steinberger|ascii reference profile|averaging|compositing|composition reaction|depth dependent|diffusion dislocation|drucker prager|entropy model|grain size|latent heat|latent heat melt|melt boukare|melt global|melt simple|modified tait|multicomponent|multicomponent compressible|nondimensional|perplex lookup|prescribed viscosity|replace lithosphere viscosity|simple|simple compressible|simpler|visco plastic|viscoelastic ] @@ -8816,7 +8816,7 @@ The name of a material model that will be modified by an averaging operation. Va The limit normalized distance between 0 and 1 where the bell shape becomes zero. See the manual for a more information. -791 +800 [Double 0...MAX_DOUBLE (inclusive)] @@ -8835,7 +8835,7 @@ unspecified Material model to use for Compressibility. Valid values for this parameter are the names of models that are also valid for the ``Material models/Model name'' parameter. See the documentation for that for more information. -792 +801 [Selection Steinberger|ascii reference profile|averaging|compositing|composition reaction|depth dependent|diffusion dislocation|drucker prager|entropy model|grain size|latent heat|latent heat melt|melt boukare|melt global|melt simple|modified tait|multicomponent|multicomponent compressible|nondimensional|perplex lookup|prescribed viscosity|replace lithosphere viscosity|simple|simple compressible|simpler|visco plastic|viscoelastic|unspecified ] @@ -8852,7 +8852,7 @@ unspecified Material model to use for Density. Valid values for this parameter are the names of models that are also valid for the ``Material models/Model name'' parameter. See the documentation for that for more information. -793 +802 [Selection Steinberger|ascii reference profile|averaging|compositing|composition reaction|depth dependent|diffusion dislocation|drucker prager|entropy model|grain size|latent heat|latent heat melt|melt boukare|melt global|melt simple|modified tait|multicomponent|multicomponent compressible|nondimensional|perplex lookup|prescribed viscosity|replace lithosphere viscosity|simple|simple compressible|simpler|visco plastic|viscoelastic|unspecified ] @@ -8869,7 +8869,7 @@ unspecified Material model to use for Entropy derivative pressure. Valid values for this parameter are the names of models that are also valid for the ``Material models/Model name'' parameter. See the documentation for that for more information. -794 +803 [Selection Steinberger|ascii reference profile|averaging|compositing|composition reaction|depth dependent|diffusion dislocation|drucker prager|entropy model|grain size|latent heat|latent heat melt|melt boukare|melt global|melt simple|modified tait|multicomponent|multicomponent compressible|nondimensional|perplex lookup|prescribed viscosity|replace lithosphere viscosity|simple|simple compressible|simpler|visco plastic|viscoelastic|unspecified ] @@ -8886,7 +8886,7 @@ unspecified Material model to use for Entropy derivative temperature. Valid values for this parameter are the names of models that are also valid for the ``Material models/Model name'' parameter. See the documentation for that for more information. -795 +804 [Selection Steinberger|ascii reference profile|averaging|compositing|composition reaction|depth dependent|diffusion dislocation|drucker prager|entropy model|grain size|latent heat|latent heat melt|melt boukare|melt global|melt simple|modified tait|multicomponent|multicomponent compressible|nondimensional|perplex lookup|prescribed viscosity|replace lithosphere viscosity|simple|simple compressible|simpler|visco plastic|viscoelastic|unspecified ] @@ -8903,7 +8903,7 @@ unspecified Material model to use for Reaction terms. Valid values for this parameter are the names of models that are also valid for the ``Material models/Model name'' parameter. See the documentation for that for more information. -796 +805 [Selection Steinberger|ascii reference profile|averaging|compositing|composition reaction|depth dependent|diffusion dislocation|drucker prager|entropy model|grain size|latent heat|latent heat melt|melt boukare|melt global|melt simple|modified tait|multicomponent|multicomponent compressible|nondimensional|perplex lookup|prescribed viscosity|replace lithosphere viscosity|simple|simple compressible|simpler|visco plastic|viscoelastic|unspecified ] @@ -8920,7 +8920,7 @@ unspecified Material model to use for Specific heat. Valid values for this parameter are the names of models that are also valid for the ``Material models/Model name'' parameter. See the documentation for that for more information. -797 +806 [Selection Steinberger|ascii reference profile|averaging|compositing|composition reaction|depth dependent|diffusion dislocation|drucker prager|entropy model|grain size|latent heat|latent heat melt|melt boukare|melt global|melt simple|modified tait|multicomponent|multicomponent compressible|nondimensional|perplex lookup|prescribed viscosity|replace lithosphere viscosity|simple|simple compressible|simpler|visco plastic|viscoelastic|unspecified ] @@ -8937,7 +8937,7 @@ unspecified Material model to use for Thermal conductivity. Valid values for this parameter are the names of models that are also valid for the ``Material models/Model name'' parameter. See the documentation for that for more information. -798 +807 [Selection Steinberger|ascii reference profile|averaging|compositing|composition reaction|depth dependent|diffusion dislocation|drucker prager|entropy model|grain size|latent heat|latent heat melt|melt boukare|melt global|melt simple|modified tait|multicomponent|multicomponent compressible|nondimensional|perplex lookup|prescribed viscosity|replace lithosphere viscosity|simple|simple compressible|simpler|visco plastic|viscoelastic|unspecified ] @@ -8954,7 +8954,7 @@ unspecified Material model to use for Thermal expansion coefficient. Valid values for this parameter are the names of models that are also valid for the ``Material models/Model name'' parameter. See the documentation for that for more information. -799 +808 [Selection Steinberger|ascii reference profile|averaging|compositing|composition reaction|depth dependent|diffusion dislocation|drucker prager|entropy model|grain size|latent heat|latent heat melt|melt boukare|melt global|melt simple|modified tait|multicomponent|multicomponent compressible|nondimensional|perplex lookup|prescribed viscosity|replace lithosphere viscosity|simple|simple compressible|simpler|visco plastic|viscoelastic|unspecified ] @@ -8971,7 +8971,7 @@ unspecified Material model to use for Viscosity. Valid values for this parameter are the names of models that are also valid for the ``Material models/Model name'' parameter. See the documentation for that for more information. -800 +809 [Selection Steinberger|ascii reference profile|averaging|compositing|composition reaction|depth dependent|diffusion dislocation|drucker prager|entropy model|grain size|latent heat|latent heat melt|melt boukare|melt global|melt simple|modified tait|multicomponent|multicomponent compressible|nondimensional|perplex lookup|prescribed viscosity|replace lithosphere viscosity|simple|simple compressible|simpler|visco plastic|viscoelastic|unspecified ] @@ -8990,7 +8990,7 @@ Material model to use for Viscosity. Valid values for this parameter are the nam A linear dependency of viscosity on the first compositional field. Dimensionless prefactor. With a value of 1.0 (the default) the viscosity does not depend on the composition. -809 +818 [Double 0...MAX_DOUBLE (inclusive)] @@ -9007,7 +9007,7 @@ A linear dependency of viscosity on the first compositional field. Dimensionless A linear dependency of viscosity on the second compositional field. Dimensionless prefactor. With a value of 1.0 (the default) the viscosity does not depend on the composition. -810 +819 [Double 0...MAX_DOUBLE (inclusive)] @@ -9024,7 +9024,7 @@ A linear dependency of viscosity on the second compositional field. Dimensionles If compositional fields are used, then one would frequently want to make the density depend on these fields. In this simple material model, we make the following assumptions: if no compositional fields are used in the current simulation, then the density is simply the usual one with its linear dependence on the temperature. If there are compositional fields, then the material model determines how many of them influence the density. The composition-dependence adds a term of the kind $+\Delta \rho \; c_1(\mathbf x)$. This parameter describes the value of $\Delta \rho$. Units: \si{\kilogram\per\meter\cubed}/unit change in composition. -805 +814 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -9041,7 +9041,7 @@ If compositional fields are used, then one would frequently want to make the den If compositional fields are used, then one would frequently want to make the density depend on these fields. In this simple material model, we make the following assumptions: if no compositional fields are used in the current simulation, then the density is simply the usual one with its linear dependence on the temperature. If there are compositional fields, then the material model determines how many of them influence the density. The composition-dependence adds a term of the kind $+\Delta \rho \; c_2(\mathbf x)$. This parameter describes the value of $\Delta \rho$. Units: \si{\kilogram\per\meter\cubed}/unit change in composition. -806 +815 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -9058,7 +9058,7 @@ If compositional fields are used, then one would frequently want to make the den Above this depth the compositional fields react: The first field gets converted to the second field. Units: \si{\meter}. -813 +822 [Double 0...MAX_DOUBLE (inclusive)] @@ -9075,7 +9075,7 @@ Above this depth the compositional fields react: The first field gets converted Reference density $\rho_0$. Units: \si{\kilogram\per\meter\cubed}. -801 +810 [Double 0...MAX_DOUBLE (inclusive)] @@ -9092,7 +9092,7 @@ Reference density $\rho_0$. Units: \si{\kilogram\per\meter\cubed}. The value of the specific heat $C_p$. Units: \si{\joule\per\kelvin\per\kilogram}. -803 +812 [Double 0...MAX_DOUBLE (inclusive)] @@ -9109,7 +9109,7 @@ The value of the specific heat $C_p$. Units: \si{\joule\per\kelvin\per\kilogram} The reference temperature $T_0$. Units: \si{\kelvin}. -807 +816 [Double 0...MAX_DOUBLE (inclusive)] @@ -9126,7 +9126,7 @@ The reference temperature $T_0$. Units: \si{\kelvin}. The value of the thermal conductivity $k$. Units: \si{\watt\per\meter\per\kelvin}. -812 +821 [Double 0...MAX_DOUBLE (inclusive)] @@ -9143,7 +9143,7 @@ The value of the thermal conductivity $k$. Units: \si{\watt\per\meter\per\kelvin The value of the thermal expansion coefficient $\alpha$. Units: \si{\per\kelvin}. -804 +813 [Double 0...MAX_DOUBLE (inclusive)] @@ -9160,7 +9160,7 @@ The value of the thermal expansion coefficient $\alpha$. Units: \si{\per\kelvin} The temperature dependence of viscosity. Dimensionless exponent. -811 +820 [Double 0...MAX_DOUBLE (inclusive)] @@ -9177,7 +9177,7 @@ The temperature dependence of viscosity. Dimensionless exponent. The value of the constant viscosity. Units: \si{\kilogram\per\meter\per\second}. -808 +817 [Double 0...MAX_DOUBLE (inclusive)] @@ -9196,7 +9196,7 @@ simple The name of a material model that will be modified by a depth dependent viscosity. Valid values for this parameter are the names of models that are also valid for the ``Material models/Model name'' parameter. See the documentation for that for more information. -817 +826 [Selection Steinberger|ascii reference profile|averaging|compositing|composition reaction|depth dependent|diffusion dislocation|drucker prager|entropy model|grain size|latent heat|latent heat melt|melt boukare|melt global|melt simple|modified tait|multicomponent|multicomponent compressible|nondimensional|perplex lookup|prescribed viscosity|replace lithosphere viscosity|simple|simple compressible|simpler|visco plastic|viscoelastic ] @@ -9213,7 +9213,7 @@ $ASPECT_SOURCE_DIR/data/material-model/rheology/ The name of a directory that contains the model data. This path may either be absolute (if starting with a `/') or relative to the current directory. The path may also include the special text `$ASPECT_SOURCE_DIR' which will be interpreted as the path in which the ASPECT source files were located when ASPECT was compiled. This interpretation allows, for example, to reference files located in the `data/' subdirectory of ASPECT. -814 +823 [DirectoryName] @@ -9230,7 +9230,7 @@ ascii_depth_profile.txt The file name of the model data. -815 +824 [Anything] @@ -9247,7 +9247,7 @@ None Method that is used to specify how the viscosity should vary with depth. -818 +827 [Selection Function|File|List|None ] @@ -9260,7 +9260,7 @@ Method that is used to specify how the viscosity should vary with depth. A comma-separated list of depth values for use with the ``List'' ``Depth dependence method''. The list must be provided in order of increasing depth, and the last value must be greater than or equal to the maximal depth of the model. The depth list is interpreted as a layered viscosity structure and the depth values specify the maximum depths of each layer. -819 +828 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -9277,7 +9277,7 @@ A comma-separated list of depth values for use with the ``List'' ``Dep The value of the constant reference viscosity $\eta_r$ that is used to scale the non-dimensional depth-dependent viscosity prefactor. Units: \si{\pascal\second}. -821 +830 [Double 0...MAX_DOUBLE (inclusive)] @@ -9294,7 +9294,7 @@ The value of the constant reference viscosity $\eta_r$ that is used to scale the Scalar factor, which is applied to the model data. You might want to use this to scale the input to a reference model. Another way to use this factor is to convert units of the input files. For instance, if you provide velocities in cm/yr set this factor to 0.01. -816 +825 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -9315,7 +9315,7 @@ false A comma-separated list of viscosity values, corresponding to the depth values provided in ``Depth list''. The number of viscosity values specified here must be the same as the number of depths provided in ``Depth list''. -820 +829 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -9331,7 +9331,7 @@ Sometimes it is convenient to use symbolic constants in the expression that desc A typical example would be to set this runtime parameter to `pi=3.1415926536' and then use `pi' in the expression of the actual formula. (That said, for convenience this class actually defines both `pi' and `Pi' by default, but you get the idea.) -824 +833 [Anything] @@ -9346,7 +9346,7 @@ A typical example would be to set this runtime parameter to `pi=3.1415926536&apo -825 +834 [Anything] @@ -9363,7 +9363,7 @@ x,t The names of the variables as they will be used in the function, separated by commas. By default, the names of variables at which the function will be evaluated are `x' (in 1d), `x,y' (in 2d) or `x,y,z' (in 3d) for spatial coordinates and `t' for time. You can then use these variable names in your function expression and they will be replaced by the values of these variables at which the function is currently evaluated. However, you can also choose a different set of names for the independent variables at which to evaluate your function expression. For example, if you work in spherical coordinates, you may wish to set this input parameter to `r,phi,theta,t' and then use these variable names in your function expression. -822 +831 [Anything] @@ -9383,7 +9383,7 @@ $ASPECT_SOURCE_DIR/data/material-model/rheology/ The name of a directory that contains the model data. This path may either be absolute (if starting with a `/') or relative to the current directory. The path may also include the special text `$ASPECT_SOURCE_DIR' which will be interpreted as the path in which the ASPECT source files were located when ASPECT was compiled. This interpretation allows, for example, to reference files located in the `data/' subdirectory of ASPECT. -886 +895 [DirectoryName] @@ -9400,7 +9400,7 @@ ascii_depth_profile.txt The file name of the model data. -887 +896 [Anything] @@ -9417,7 +9417,7 @@ The file name of the model data. Scalar factor, which is applied to the model data. You might want to use this to scale the input to a reference model. Another way to use this factor is to convert units of the input files. For instance, if you provide velocities in cm/yr set this factor to 0.01. -888 +897 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -9436,7 +9436,7 @@ Scalar factor, which is applied to the model data. You might want to use this to List of activation energies, $E_a$, for background material and compositional fields, for a total of N+1 values, where N is the number of compositional fields. If only one value is given, then all use the same value. Units: \si{\joule\per\mole}. -850 +859 [Anything] @@ -9453,7 +9453,7 @@ List of activation energies, $E_a$, for background material and compositional fi List of activation energies, $E_a$, for background material and compositional fields, for a total of N+1 values, where N is the number of compositional fields. If only one value is given, then all use the same value. Units: \si{\joule\per\mole}. -855 +864 [Anything] @@ -9470,7 +9470,7 @@ List of activation energies, $E_a$, for background material and compositional fi List of activation volumes, $V_a$, for background material and compositional fields, for a total of N+1 values, where N is the number of compositional fields. If only one value is given, then all use the same value. Units: \si{\meter\cubed\per\mole}. -851 +860 [Anything] @@ -9487,7 +9487,7 @@ List of activation volumes, $V_a$, for background material and compositional fie List of activation volumes, $V_a$, for background material and compositional fields, for a total of N+1 values, where N is the number of compositional fields. If only one value is given, then all use the same value. Units: \si{\meter\cubed\per\mole}. -856 +865 [Anything] @@ -9504,7 +9504,7 @@ List of activation volumes, $V_a$, for background material and compositional fie List of densities, $\rho$, for background mantle and compositional fields, for a total of N+1 values, where N is the number of compositional fields. If only one value is given, then all use the same value. Units: \si{\kilogram\per\meter\cubed}. -835 +844 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -9521,7 +9521,7 @@ List of densities, $\rho$, for background mantle and compositional fields, for a Scaling coefficient for effective viscosity. -830 +839 [Double 0...MAX_DOUBLE (inclusive)] @@ -9538,7 +9538,7 @@ Scaling coefficient for effective viscosity. Units: \si{\meter}. -852 +861 [Double 0...MAX_DOUBLE (inclusive)] @@ -9555,7 +9555,7 @@ Units: \si{\meter}. List of grain size exponents, $m_{\text{diffusion}}$, for background material and compositional fields, for a total of N+1 values, where N is the number of compositional fields. If only one value is given, then all use the same value. Units: None. -849 +858 [Anything] @@ -9572,7 +9572,7 @@ List of grain size exponents, $m_{\text{diffusion}}$, for background material an The value of the specific heat $C_p$. Units: \si{\joule\per\kelvin\per\kilogram}. -834 +843 [Double 0...MAX_DOUBLE (inclusive)] @@ -9589,7 +9589,7 @@ The value of the specific heat $C_p$. Units: \si{\joule\per\kelvin\per\kilogram} Maximum number of iterations to find the correct diffusion/dislocation strain rate ratio. -832 +841 [Integer range 0...2147483647 (inclusive)] @@ -9606,7 +9606,7 @@ Maximum number of iterations to find the correct diffusion/dislocation strain ra Upper cutoff for effective viscosity. Units: \si{\pascal\second}. -829 +838 [Double 0...MAX_DOUBLE (inclusive)] @@ -9623,7 +9623,7 @@ Upper cutoff for effective viscosity. Units: \si{\pascal\second}. Stabilizes strain dependent viscosity. Units: \si{\per\second}. -827 +836 [Double 0...MAX_DOUBLE (inclusive)] @@ -9640,7 +9640,7 @@ Stabilizes strain dependent viscosity. Units: \si{\per\second}. Lower cutoff for effective viscosity. Units: \si{\pascal\second}. -828 +837 [Double 0...MAX_DOUBLE (inclusive)] @@ -9657,7 +9657,7 @@ Lower cutoff for effective viscosity. Units: \si{\pascal\second}. List of viscosity prefactors, $A$, for background material and compositional fields, for a total of N+1 values, where N is the number of compositional fields. If only one value is given, then all use the same value. Units: \si{\per\pascal\meter}$^{m_{\text{diffusion}}}$\si{\per\second}. -847 +856 [Anything] @@ -9674,7 +9674,7 @@ List of viscosity prefactors, $A$, for background material and compositional fie List of viscosity prefactors, $A$, for background material and compositional fields, for a total of N+1 values, where N is the number of compositional fields. If only one value is given, then all use the same value. Units: \si{\pascal}$^{-n_{\text{dislocation}}}$ \si{\per\second}. -853 +862 [Anything] @@ -9691,7 +9691,7 @@ List of viscosity prefactors, $A$, for background material and compositional fie For calculating density by thermal expansivity. Units: \si{\kelvin}. -826 +835 [Double 0...MAX_DOUBLE (inclusive)] @@ -9708,7 +9708,7 @@ For calculating density by thermal expansivity. Units: \si{\kelvin}. Tolerance for determining the correct stress and viscosity from the strain rate by internal iteration. The tolerance is expressed as the difference between the natural logarithm of the input strain rate and the strain rate at the current iteration. This determines that strain rate is correctly partitioned between diffusion and dislocation creep assuming that both mechanisms experience the same stress. -831 +840 [Double 0...MAX_DOUBLE (inclusive)] @@ -9725,7 +9725,7 @@ Tolerance for determining the correct stress and viscosity from the strain rate List of stress exponents, $n_{\text{diffusion}}$, for background mantle and compositional fields, for a total of N+1 values, where N is the number of compositional fields. The stress exponent for diffusion creep is almost always equal to one. If only one value is given, then all use the same value. Units: None. -848 +857 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -9742,7 +9742,7 @@ List of stress exponents, $n_{\text{diffusion}}$, for background mantle and comp List of stress exponents, $n_{\text{dislocation}}$, for background material and compositional fields, for a total of N+1 values, where N is the number of compositional fields. If only one value is given, then all use the same value. Units: None. -854 +863 [Anything] @@ -9759,7 +9759,7 @@ List of stress exponents, $n_{\text{dislocation}}$, for background material and Units: \si{\meter\squared\per\second}. -833 +842 [Double 0...MAX_DOUBLE (inclusive)] @@ -9776,7 +9776,7 @@ Units: \si{\meter\squared\per\second}. List of thermal expansivities for background mantle and compositional fields, for a total of N+1 values, where N is the number of compositional fields. If only one value is given, then all use the same value. Units: \si{\per\kelvin}. -836 +845 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -9793,7 +9793,7 @@ harmonic When more than one compositional field is present at a point with different viscosities, we need to come up with an average viscosity at that point. Select a weighted harmonic, arithmetic, geometric, or maximum composition. -837 +846 [Selection arithmetic|harmonic|geometric|maximum composition ] @@ -9812,7 +9812,7 @@ When more than one compositional field is present at a point with different visc Reference density $\rho_0$. Units: \si{\kilogram\per\meter\cubed}. -857 +866 [Double 0...MAX_DOUBLE (inclusive)] @@ -9829,7 +9829,7 @@ Reference density $\rho_0$. Units: \si{\kilogram\per\meter\cubed}. The value of the specific heat $C_p$. Units: \si{\joule\per\kelvin\per\kilogram}. -859 +868 [Double 0...MAX_DOUBLE (inclusive)] @@ -9846,7 +9846,7 @@ The value of the specific heat $C_p$. Units: \si{\joule\per\kelvin\per\kilogram} The reference temperature $T_0$. The reference temperature is used in the density calculation. Units: \si{\kelvin}. -861 +870 [Double 0...MAX_DOUBLE (inclusive)] @@ -9863,7 +9863,7 @@ The reference temperature $T_0$. The reference temperature is used in the densit The value of the thermal conductivity $k$. Units: \si{\watt\per\meter\per\kelvin}. -862 +871 [Double 0...MAX_DOUBLE (inclusive)] @@ -9880,7 +9880,7 @@ The value of the thermal conductivity $k$. Units: \si{\watt\per\meter\per\kelvin The value of the thermal expansion coefficient $\alpha$. Units: \si{\per\kelvin}. -860 +869 [Double 0...MAX_DOUBLE (inclusive)] @@ -9898,7 +9898,7 @@ The value of the thermal expansion coefficient $\alpha$. Units: \si{\per\kelvin} The value of the angle of internal friction $\phi$. For a value of zero, in 2d the von Mises criterion is retrieved. Angles higher than 30 degrees are harder to solve numerically. Units: degrees. -866 +875 [Double 0...MAX_DOUBLE (inclusive)] @@ -9915,7 +9915,7 @@ The value of the angle of internal friction $\phi$. For a value of zero, in 2d t The value of the cohesion $C$. Units: \si{\pascal}. -867 +876 [Double 0...MAX_DOUBLE (inclusive)] @@ -9932,7 +9932,7 @@ The value of the cohesion $C$. Units: \si{\pascal}. The value of the maximum viscosity cutoff $\eta_max$. Units: \si{\pascal\second}. -864 +873 [Double 0...MAX_DOUBLE (inclusive)] @@ -9949,7 +9949,7 @@ The value of the maximum viscosity cutoff $\eta_max$. Units: \si{\pascal\second} The value of the minimum viscosity cutoff $\eta_min$. Units: \si{\pascal\second}. -863 +872 [Double 0...MAX_DOUBLE (inclusive)] @@ -9966,7 +9966,7 @@ The value of the minimum viscosity cutoff $\eta_min$. Units: \si{\pascal\second} The value of the initial strain rate prescribed during the first nonlinear iteration $\dot{\epsilon}_ref$. Units: \si{\per\second}. -865 +874 [Double 0...MAX_DOUBLE (inclusive)] @@ -9986,7 +9986,7 @@ The value of the initial strain rate prescribed during the first nonlinear itera List of angles of internal friction, $\phi$, for background material and compositional fields, for a total of N+1 values, where N is the number of compositional fields. For a value of zero, in 2D the von Mises criterion is retrieved. Angles higher than 30 degrees are harder to solve numerically. Units: degrees. -875 +884 [Anything] @@ -10003,7 +10003,7 @@ List of angles of internal friction, $\phi$, for background material and composi List of cohesions, $C$, for background material and compositional fields, for a total of N+1 values, where N is the number of compositional fields. The extremely large default cohesion value (1e20 Pa) prevents the viscous stress from exceeding the yield stress. Units: \si{\pascal}. -876 +885 [Anything] @@ -10020,7 +10020,7 @@ $ASPECT_SOURCE_DIR/data/material-model/entropy-table/opxtable/ The path to the model data. The path may also include the special text '$ASPECT_SOURCE_DIR' which will be interpreted as the path in which the ASPECT source files were located when ASPECT was compiled. This interpretation allows, for example, to reference files located in the `data/' subdirectory of ASPECT. -868 +877 [DirectoryName] @@ -10037,7 +10037,7 @@ temp-viscosity-prefactor.txt The file name of the lateral viscosity prefactor. -871 +880 [Anything] @@ -10054,7 +10054,7 @@ material_table.txt The file name of the material data. -869 +878 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -10071,7 +10071,7 @@ The file name of the material data. The relative cutoff value for lateral viscosity variations caused by temperature deviations. The viscosity may vary laterally by this factor squared. -874 +883 [Double 0...MAX_DOUBLE (inclusive)] @@ -10088,7 +10088,7 @@ The relative cutoff value for lateral viscosity variations caused by temperature The maximum thermal conductivity that is allowed in the model. Larger values will be cut off. -885 +894 [Double 0...MAX_DOUBLE (inclusive)] @@ -10105,7 +10105,7 @@ The maximum thermal conductivity that is allowed in the model. Larger values wil The maximum viscosity that is allowed in the viscosity calculation. Larger values will be cut off. -873 +882 [Double 0...MAX_DOUBLE (inclusive)] @@ -10122,7 +10122,7 @@ The maximum viscosity that is allowed in the viscosity calculation. Larger value The minimum viscosity that is allowed in the viscosity calculation. Smaller values will be cut off. -872 +881 [Double 0...MAX_DOUBLE (inclusive)] @@ -10139,7 +10139,7 @@ The minimum viscosity that is allowed in the viscosity calculation. Smaller valu A list of values that determine the linear scaling of the thermal conductivity with the pressure in the 'p-T-dependent' thermal conductivity formulation. Units: \si{\watt\per\meter\per\kelvin\per\pascal}. -881 +890 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10156,7 +10156,7 @@ A list of values that determine the linear scaling of the thermal conductivity w A list of values of reference temperatures used to determine the temperature-dependence of the thermal conductivity in the 'p-T-dependent' thermal conductivity formulation. Units: \si{\kelvin}. -882 +891 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10173,7 +10173,7 @@ A list of values of reference temperatures used to determine the temperature-dep A list of base values of the thermal conductivity for each of the horizontal layers in the 'p-T-dependent' thermal conductivity formulation. Pressure- and temperature-dependence will be appliedon top of this base value, according to the parameters 'Pressure dependencies of thermal conductivity' and 'Reference temperatures for thermal conductivity'. Units: \si{\watt\per\meter\per\kelvin} -880 +889 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10192,7 +10192,7 @@ The viscosity that is used in this model. Units: \si{\pascal\second} -870 +879 [Double 0...MAX_DOUBLE (inclusive)] @@ -10209,7 +10209,7 @@ Units: \si{\pascal\second} A list of values that indicate how a given layer in the conductivity formulation should take into account the effects of saturation on the temperature-dependence of the thermal conducitivity. This factor is multiplied with a saturation function based on the theory of Roufosse and Klemens, 1974. A value of 1 reproduces the formulation of Stackhouse et al. (2015), a value of 0 reproduces the formulation of Tosi et al., (2013). Units: none. -884 +893 [List of <[Double 0...1 (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10226,7 +10226,7 @@ A list of values that indicate how a given layer in the conductivity formulation The value of the thermal conductivity $k$. Units: \si{\watt\per\meter\per\kelvin}. -877 +886 [Double 0...MAX_DOUBLE (inclusive)] @@ -10243,7 +10243,7 @@ The value of the thermal conductivity $k$. Units: \si{\watt\per\meter\per\kelvin A list of exponents in the temperature-dependent term of the 'p-T-dependent' thermal conductivity formulation. Note that this exponent is not used (and should have a value of 1) in the formulation of Stackhouse et al. (2015). Units: none. -883 +892 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10260,7 +10260,7 @@ constant Which law should be used to compute the thermal conductivity. The 'constant' law uses a constant value for the thermal conductivity. The 'p-T-dependent' formulation uses equations from Stackhouse et al. (2015): First-principles calculations of the lattice thermal conductivity of the lower mantle (https://doi.org/10.1016/j.epsl.2015.06.050), and Tosi et al. (2013): Mantle dynamics with pressure- and temperature-dependent thermal expansivity and conductivity (https://doi.org/10.1016/j.pepi.2013.02.004) to compute the thermal conductivity in dependence of temperature and pressure. The thermal conductivity parameter sets can be chosen in such a way that either the Stackhouse or the Tosi relations are used. The conductivity description can consist of several layers with different sets of parameters. Note that the Stackhouse parametrization is only valid for the lower mantle (bridgmanite). -878 +887 [Selection constant|p-T-dependent ] @@ -10277,7 +10277,7 @@ Which law should be used to compute the thermal conductivity. The 'constant A list of depth values that indicate where the transitions between the different conductivity parameter sets should occur in the 'p-T-dependent' Thermal conductivity formulation (in most cases, this will be the depths of major mantle phase transitions). Units: \si{\meter}. -879 +888 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10296,7 +10296,7 @@ false This parameter determines whether to advect the logarithm of the grain size or the grain size itself. The equation and the physics are the same, but for problems with high grain size gradients it might be preferable to advect the logarithm. -719 +752 [Bool] @@ -10313,7 +10313,7 @@ This parameter determines whether to advect the logarithm of the grain size or t The average specific grain boundary energy $\gamma$. List must have one more entry than the Phase transition depths. Units: \si{\joule\per\meter\squared}. -695 +728 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10330,7 +10330,7 @@ true This parameter determines whether to use bilinear interpolation to compute material properties (slower but more accurate). -726 +759 [Bool] @@ -10347,7 +10347,7 @@ $ASPECT_SOURCE_DIR/data/material-model/steinberger/ The path to the model data. The path may also include the special text '$ASPECT_SOURCE_DIR' which will be interpreted as the path in which the ASPECT source files were located when ASPECT was compiled. This interpretation allows, for example, to reference files located in the 'data/' subdirectory of ASPECT. -720 +753 [DirectoryName] @@ -10360,7 +10360,7 @@ The path to the model data. The path may also include the special text '$AS The file names of the enthalpy derivatives data. List with as many components as active compositional fields (material data is assumed to be in order with the ordering of the fields). -722 +755 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -10377,7 +10377,7 @@ The file names of the enthalpy derivatives data. List with as many components as The activation energy for diffusion creep $E_{diff}$. List must have one more entry than the Phase transition depths. Units: \si{\joule\per\mole}. -705 +738 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10394,7 +10394,7 @@ The activation energy for diffusion creep $E_{diff}$. List must have one more en The activation volume for diffusion creep $V_{diff}$. List must have one more entry than the Phase transition depths. Units: \si{\meter\cubed\per\mole}. -706 +739 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10411,7 +10411,7 @@ The activation volume for diffusion creep $V_{diff}$. List must have one more en The power-law exponent $n_{diff}$ for diffusion creep. List must have one more entry than the Phase transition depths. Units: none. -704 +737 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10428,7 +10428,7 @@ The power-law exponent $n_{diff}$ for diffusion creep. List must have one more e The diffusion creep grain size exponent $p_{diff}$ that determines the dependence of viscosity on grain size. List must have one more entry than the Phase transition depths. Units: none. -708 +741 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10445,7 +10445,7 @@ The diffusion creep grain size exponent $p_{diff}$ that determines the dependenc The prefactor for the diffusion creep law $A_{diff}$. List must have one more entry than the Phase transition depths. Units: \si{\meter}$^{p_{diff}}$\si{\pascal}$^{-n_{diff}}$\si{\per\second}. -707 +740 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10462,7 +10462,7 @@ The prefactor for the diffusion creep law $A_{diff}$. List must have one more en The activation energy for dislocation creep $E_{dis}$. List must have one more entry than the Phase transition depths. Units: \si{\joule\per\mole}. -701 +734 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10479,7 +10479,7 @@ The activation energy for dislocation creep $E_{dis}$. List must have one more e The activation volume for dislocation creep $V_{dis}$. List must have one more entry than the Phase transition depths. Units: \si{\meter\cubed\per\mole}. -702 +735 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10496,7 +10496,7 @@ The activation volume for dislocation creep $V_{dis}$. List must have one more e The power-law exponent $n_{dis}$ for dislocation creep. List must have one more entry than the Phase transition depths. Units: none. -700 +733 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10513,7 +10513,7 @@ The power-law exponent $n_{dis}$ for dislocation creep. List must have one more The prefactor for the dislocation creep law $A_{dis}$. List must have one more entry than the Phase transition depths. Units: \si{\pascal}$^{-n_{dis}}$\si{\per\second}. -703 +736 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10530,7 +10530,7 @@ The prefactor for the dislocation creep law $A_{dis}$. List must have one more e We need to perform an iteration inside the computation of the dislocation viscosity, because it depends on the dislocation strain rate, which depends on the dislocation viscosity itself. This number determines the maximum number of iterations that are performed. -699 +732 [Integer range 0...2147483647 (inclusive)] @@ -10547,7 +10547,7 @@ We need to perform an iteration inside the computation of the dislocation viscos We need to perform an iteration inside the computation of the dislocation viscosity, because it depends on the dislocation strain rate, which depends on the dislocation viscosity itself. This number determines the termination accuracy, i.e. if the dislocation viscosity changes by less than this factor we terminate the iteration. -698 +731 [Double 0...MAX_DOUBLE (inclusive)] @@ -10564,7 +10564,7 @@ We need to perform an iteration inside the computation of the dislocation viscos The geometric constant $c$ used in the paleowattmeter grain size reduction law. List must have one more entry than the Phase transition depths. Units: none. -697 +730 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10581,7 +10581,7 @@ The geometric constant $c$ used in the paleowattmeter grain size reduction law. The activation energy for grain growth $E_g$. List must have one more entry than the Phase transition depths. Units: \si{\joule\per\mole}. -685 +718 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10598,7 +10598,7 @@ The activation energy for grain growth $E_g$. List must have one more entry than The activation volume for grain growth $V_g$. List must have one more entry than the Phase transition depths. Units: \si{\meter\cubed\per\mole}. -686 +719 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10615,7 +10615,7 @@ The activation volume for grain growth $V_g$. List must have one more entry than The exponent of the grain growth law $p_g$. This is an experimentally determined grain growth constant. List must have one more entry than the Phase transition depths. Units: none. -687 +720 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10632,7 +10632,7 @@ The exponent of the grain growth law $p_g$. This is an experimentally determined The prefactor for the Ostwald ripening grain growth law $G_0$. This is dependent on water content, which is assumed to be 50 H/$10^6$ Si for the default value. List must have one more entry than the Phase transition depths. Units: \si{\meter}$^{p_g}$\si{\per\second}. -688 +721 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10649,7 +10649,7 @@ paleowattmeter A flag indicating whether the material model should use the paleowattmeter approach of Austin and Evans (2007) for grain size reduction in the dislocation creep regime, the paleopiezometer approach from Hall and Parmetier (2003), or the pinned grain damage approach from Mulyukova and Bercovici (2018). -693 +726 [Selection paleowattmeter|paleopiezometer|pinned grain damage ] @@ -10666,7 +10666,7 @@ A flag indicating whether the material model should use the paleowattmeter appro A scaling factor for the grain size in the lower mantle. In models where the high grain size contrast between the upper and lower mantle causes numerical problems, the grain size in the lower mantle can be scaled to a larger value, simultaneously scaling the viscosity prefactors and grain growth parameters to keep the same physical behavior. Differences to the original formulation only occur when material with a smaller grain size than the recrystallization grain size cross the upper-lower mantle boundary. The real grain size can be obtained by dividing the model grain size by this value. Units: none. -718 +751 [Double 0...MAX_DOUBLE (inclusive)] @@ -10683,7 +10683,7 @@ perplex The material file format to be read in the property tables. -724 +757 [Selection perplex|hefesto ] @@ -10700,7 +10700,7 @@ pyr-ringwood88.txt The file names of the material data. List with as many components as active compositional fields (material data is assumed to be in order with the ordering of the fields). -721 +754 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -10717,7 +10717,7 @@ The file names of the material data. List with as many components as active comp The maximum number of substeps over the temperature pressure range to calculate the averaged enthalpy gradient over a cell. -716 +749 [Integer range 1...2147483647 (inclusive)] @@ -10734,7 +10734,7 @@ The maximum number of substeps over the temperature pressure range to calculate The maximum specific heat that is allowed in the whole model domain. Units: J/kg/K. -713 +746 [Double 0...MAX_DOUBLE (inclusive)] @@ -10751,7 +10751,7 @@ The maximum specific heat that is allowed in the whole model domain. Units: J/kg The factor by which viscosity at adiabatic temperature and ambient temperature are allowed to differ (a value of x means that the viscosity can be x times higher or x times lower compared to the value at adiabatic temperature. This parameter is introduced to limit local viscosity contrasts, but still allow for a widely varying viscosity over the whole mantle range. Units: none. -709 +742 [Double 0...MAX_DOUBLE (inclusive)] @@ -10768,7 +10768,7 @@ The factor by which viscosity at adiabatic temperature and ambient temperature a The maximum thermal expansivity that is allowed in the whole model domain. Units: 1/K. -715 +748 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -10785,7 +10785,7 @@ The maximum thermal expansivity that is allowed in the whole model domain. Units The maximum viscosity that is allowed in the whole model domain. Units: Pa \, s. -711 +744 [Double 0...MAX_DOUBLE (inclusive)] @@ -10802,7 +10802,7 @@ The maximum viscosity that is allowed in the whole model domain. Units: Pa \, s. The minimum grain size that is used for the material model. This parameter is introduced to limit local viscosity contrasts, but still allows for a widely varying viscosity over the whole mantle range. Units: \si{\meter}. -717 +750 [Double 0...MAX_DOUBLE (inclusive)] @@ -10819,7 +10819,7 @@ The minimum grain size that is used for the material model. This parameter is in The minimum specific heat that is allowed in the whole model domain. Units: J/kg/K. -712 +745 [Double 0...MAX_DOUBLE (inclusive)] @@ -10836,7 +10836,7 @@ The minimum specific heat that is allowed in the whole model domain. Units: J/kg The minimum thermal expansivity that is allowed in the whole model domain. Units: 1/K. -714 +747 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -10853,7 +10853,7 @@ The minimum thermal expansivity that is allowed in the whole model domain. Units The minimum viscosity that is allowed in the whole model domain. Units: Pa \, s. -710 +743 [Double 0...MAX_DOUBLE (inclusive)] @@ -10866,7 +10866,7 @@ The minimum viscosity that is allowed in the whole model domain. Units: Pa \, s. A list of Clapeyron slopes for each phase transition. A positive Clapeyron slope indicates that the phase transition will occur in a greater depth, if the temperature is higher than the one given in Phase transition temperatures and in a smaller depth, if the temperature is smaller than the one given in Phase transition temperatures. For negative slopes the other way round. List must have the same number of entries as Phase transition depths. Units: \si{\pascal\per\kelvin}. -684 +717 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10879,7 +10879,7 @@ A list of Clapeyron slopes for each phase transition. A positive Clapeyron slope A list of depths where phase transitions occur. Values must monotonically increase. Units: \si{\meter}. -681 +714 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10892,7 +10892,7 @@ A list of depths where phase transitions occur. Values must monotonically increa A list of temperatures where phase transitions occur. Higher or lower temperatures lead to phase transition occurring in smaller or greater depths than given in Phase transition depths, depending on the Clapeyron slope given in Phase transition Clapeyron slopes. List must have the same number of entries as Phase transition depths. Units: \si{\kelvin}. -682 +715 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10905,7 +10905,7 @@ A list of temperatures where phase transitions occur. Higher or lower temperatur A list of widths for each phase transition. This is only use to specify the region where the recrystallized grain size is assigned after material has crossed a phase transition and should accordingly be chosen similar to the maximum cell width expected at the phase transition.List must have the same number of entries as Phase transition depths. Units: \si{\meter}. -683 +716 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10922,7 +10922,7 @@ A list of widths for each phase transition. This is only use to specify the regi The volume fraction of one of the phases in the two-phase damage model of Bercovici and Ricard (2012). The volume fraction of the other phase can be simply calculated by subtracting from one. This parameter is only used in the pinned state grain damage formulation.Units: none. -692 +725 [Double 0...1 (inclusive)] @@ -10939,7 +10939,7 @@ The volume fraction of one of the phases in the two-phase damage model of Bercov This parameter ($\lambda$) gives an estimate of the strain necessary to achieve a new grain size. List must have one more entry than the Phase transition depths. -690 +723 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10952,7 +10952,7 @@ This parameter ($\lambda$) gives an estimate of the strain necessary to achieve The grain size $d_{ph}$ to that a phase will be reduced to when crossing a phase transition. When set to zero, grain size will not be reduced. List must have the same number of entries as Phase transition depths. Units: \si{\meter}. -691 +724 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10969,7 +10969,7 @@ The grain size $d_{ph}$ to that a phase will be reduced to when crossing a phase The value of the reference compressibility. Units: \si{\per\pascal}. -680 +713 [Double 0...MAX_DOUBLE (inclusive)] @@ -10986,7 +10986,7 @@ The value of the reference compressibility. Units: \si{\per\pascal}. The reference density $\rho_0$. Units: \si{\kilogram\per\meter\cubed}. -674 +707 [Double 0...MAX_DOUBLE (inclusive)] @@ -11003,7 +11003,7 @@ The reference density $\rho_0$. Units: \si{\kilogram\per\meter\cubed}. The value of the specific heat $cp$. Units: \si{\joule\per\kelvin\per\kilogram}. -678 +711 [Double 0...MAX_DOUBLE (inclusive)] @@ -11020,7 +11020,7 @@ The value of the specific heat $cp$. Units: \si{\joule\per\kelvin\per\kilogram}. The reference temperature $T_0$. Units: \si{\kelvin}. -675 +708 [Double 0...MAX_DOUBLE (inclusive)] @@ -11037,7 +11037,7 @@ The reference temperature $T_0$. Units: \si{\kelvin}. The value of the thermal conductivity $k$. Units: \si{\watt\per\meter\per\kelvin}. -677 +710 [Double 0...MAX_DOUBLE (inclusive)] @@ -11054,7 +11054,7 @@ The value of the thermal conductivity $k$. Units: \si{\watt\per\meter\per\kelvin The value of the thermal expansion coefficient $\alpha$. Units: \si{\per\kelvin}. -679 +712 [Double 0...MAX_DOUBLE (inclusive)] @@ -11071,7 +11071,7 @@ true This parameter determines whether to use the enthalpy to calculate the thermal expansivity and specific heat (if true) or use the thermal expansivity and specific heat values from the material properties table directly (if false). -725 +758 [Bool] @@ -11088,7 +11088,7 @@ default A flag indicating whether the computation should use the paleowattmeter approach of Austin and Evans (2007) for grain size reduction in the dislocation creep regime (if true) or the paleopiezometer approach from Hall and Parmetier (2003) (if false). This parameter has been removed. Use 'Grain size evolution formulation' instead. -694 +727 [Selection true|false|default ] @@ -11105,7 +11105,7 @@ false This parameter determines whether to use the table properties also for density, thermal expansivity and specific heat. If false the properties are generated as in the simple compressible plugin. -723 +756 [Bool] @@ -11122,7 +11122,7 @@ This parameter determines whether to use the table properties also for density, The value of the constant viscosity. Units: \si{\pascal\second}. -676 +709 [Double 0...MAX_DOUBLE (inclusive)] @@ -11139,7 +11139,7 @@ The value of the constant viscosity. Units: \si{\pascal\second}. The fraction $\chi$ of work done by dislocation creep to change the grain boundary area. List must have one more entry than the Phase transition depths. Units: \si{\joule\per\meter\squared}. -696 +729 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -11157,7 +11157,7 @@ The fraction $\chi$ of work done by dislocation creep to change the grain bounda This parameter determines the variability in how much shear heating is partitioned into grain damage. A higher value suggests a wider temperature range over which the partitioning coefficient is high. -731 +764 [Double 0...MAX_DOUBLE (inclusive)] @@ -11174,7 +11174,7 @@ This parameter determines the variability in how much shear heating is partition This parameter determines the maximum value of the partitioning coefficient, which governs the amount of shear heating partitioned into grain damage in the pinned state limit. -730 +763 [Double 0...1 (inclusive)] @@ -11191,7 +11191,7 @@ This parameter determines the maximum value of the partitioning coefficient, whi This parameter determines the minimum value of the partitioning coefficient, which governs the amount of shear heating partitioned into grain damage in the pinned state limit. -729 +762 [Double 0...1 (inclusive)] @@ -11208,7 +11208,7 @@ This parameter determines the minimum value of the partitioning coefficient, whi This parameter determines the temperature at which the computed coefficient of shear energy partitioned into grain damage is maximum. This is used in the pinned state limit of the grain size evolution. One choice of this parameter is the surface temperature of the seafloor, see Mulyukova and Bercovici (2018) for details. -728 +761 [Double 0...MAX_DOUBLE (inclusive)] @@ -11225,7 +11225,7 @@ This parameter determines the temperature at which the computed coefficient of s This parameter determines the temperature at which the computed coefficient of shear energy partitioned into grain damage is minimum. This is used in the pinned state limit of the grain size evolution. One choice of this parameter is the mantle temperature at the ridge axis, see Mulyukova and Bercovici (2018) for details. -727 +760 [Double 0...MAX_DOUBLE (inclusive)] @@ -11245,7 +11245,7 @@ This parameter determines the temperature at which the computed coefficient of s A linear dependency of viscosity on composition. Dimensionless prefactor. -735 +768 [Double 0...MAX_DOUBLE (inclusive)] @@ -11262,7 +11262,7 @@ A linear dependency of viscosity on composition. Dimensionless prefactor. The value of the compressibility $\kappa$. Units: \si{\per\pascal}. -740 +773 [Double 0...MAX_DOUBLE (inclusive)] @@ -11275,7 +11275,7 @@ The value of the compressibility $\kappa$. Units: \si{\per\pascal}. A list of phases, which correspond to the Phase transition density jumps. The density jumps occur only in the phase that is given by this phase value. 0 stands for the 1st compositional fields, 1 for the second compositional field and -1 for none of them. List must have the same number of entries as Phase transition depths. Units: \si{\pascal\per\kelvin}. -743 +776 [List of <[Integer range 0...2147483647 (inclusive)]> of length 0...4294967295 (inclusive)] @@ -11292,7 +11292,7 @@ true Whether to list phase transitions by depth or pressure. If this parameter is true, then the input file will use Phase transitions depths and Phase transition widths to define the phase transition. If it is false, the parameter file will read in phase transition data from Phase transition pressures and Phase transition pressure widths. -751 +784 [Bool] @@ -11309,7 +11309,7 @@ Whether to list phase transitions by depth or pressure. If this parameter is tru If compositional fields are used, then one would frequently want to make the density depend on these fields. In this simple material model, we make the following assumptions: if no compositional fields are used in the current simulation, then the density is simply the usual one with its linear dependence on the temperature. If there are compositional fields, then the density only depends on the first one in such a way that the density has an additional term of the kind $+\Delta \rho \; c_1(\mathbf x)$. This parameter describes the value of $\Delta \rho$. Units: \si{\kilogram\per\meter\cubed}/unit change in composition. -741 +774 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -11326,7 +11326,7 @@ If compositional fields are used, then one would frequently want to make the den Limit for the maximum viscosity in the model. Units: Pa \, s. -746 +779 [Double 0...MAX_DOUBLE (inclusive)] @@ -11343,7 +11343,7 @@ Limit for the maximum viscosity in the model. Units: Pa \, s. Limit for the minimum viscosity in the model. Units: Pa \, s. -745 +778 [Double 0...MAX_DOUBLE (inclusive)] @@ -11356,7 +11356,7 @@ Limit for the minimum viscosity in the model. Units: Pa \, s. A list of Clapeyron slopes for each phase transition. A positive Clapeyron slope indicates that the phase transition will occur in a greater depth, if the temperature is higher than the one given in Phase transition temperatures and in a smaller depth, if the temperature is smaller than the one given in Phase transition temperatures. For negative slopes the other way round. List must have the same number of entries as Phase transition depths. Units: \si{\pascal\per\kelvin}. -755 +788 [Anything] @@ -11369,7 +11369,7 @@ A list of Clapeyron slopes for each phase transition. A positive Clapeyron slope A list of density jumps at each phase transition. A positive value means that the density increases with depth. The corresponding entry in Corresponding phase for density jump determines if the density jump occurs in peridotite, eclogite or none of them.List must have the same number of entries as Phase transition depths. Units: \si{\kilogram\per\meter\cubed}. -742 +775 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -11382,7 +11382,7 @@ A list of density jumps at each phase transition. A positive value means that th A list of depths where phase transitions occur. Values must monotonically increase. Units: \si{\meter}. -747 +780 [Anything] @@ -11395,7 +11395,7 @@ A list of depths where phase transitions occur. Values must monotonically increa A list of widths for each phase transition, in terms of pressure. The phase functions are scaled with these values, leading to a jump between phases for a value of zero and a gradual transition for larger values. List must have the same number of entries as Phase transition pressures. Define transition by depth instead of pressure must be set to false to use this parameter. Units: \si{\pascal}. -750 +783 [Anything] @@ -11408,7 +11408,7 @@ A list of widths for each phase transition, in terms of pressure. The phase func A list of pressures where phase transitions occur. Values must monotonically increase. Define transition by depth instead of pressure must be set to false to use this parameter. Units: \si{\pascal}. -749 +782 [Anything] @@ -11425,7 +11425,7 @@ A list of pressures where phase transitions occur. Values must monotonically inc A list of lower temperature limits for each phase transition. Below this temperature the respective phase transition is deactivated. The default value means there is no lower limit for any phase transition. List must have the same number of entries as Phase transition depths. When the optional temperature limits are applied, the user has to be careful about the consistency between adjacent phases. Phase transitions should be continuous in pressure-temperature space. We recommend producing a phase diagram with simple model setups to check the implementation as a starting point.Units: \si{\kelvin}. -754 +787 [Anything] @@ -11442,7 +11442,7 @@ A list of lower temperature limits for each phase transition. Below this tempera A list of upper temperature limits for each phase transition. Above this temperature the respective phase transition is deactivated. The default value means there is no upper limit for any phase transitions. List must have the same number of entries as Phase transition depths. When the optional temperature limits are applied, the user has to be careful about the consistency between adjacent phases. Phase transitions should be continuous in pressure-temperature space. We recommend producing a phase diagram with simple model setups to check the implementation as a starting point.Units: \si{\kelvin}. -753 +786 [Anything] @@ -11455,7 +11455,7 @@ A list of upper temperature limits for each phase transition. Above this tempera A list of temperatures where phase transitions occur. Higher or lower temperatures lead to phase transition occurring in smaller or greater depths than given in Phase transition depths, depending on the Clapeyron slope given in Phase transition Clapeyron slopes. List must have the same number of entries as Phase transition depths. Units: \si{\kelvin}. -752 +785 [Anything] @@ -11468,7 +11468,7 @@ A list of temperatures where phase transitions occur. Higher or lower temperatur A list of widths for each phase transition, in terms of depth. The phase functions are scaled with these values, leading to a jump between phases for a value of zero and a gradual transition for larger values. List must have the same number of entries as Phase transition depths. Units: \si{\meter}. -748 +781 [Anything] @@ -11485,7 +11485,7 @@ A list of widths for each phase transition, in terms of depth. The phase functio Reference density $\rho_0$. Units: \si{\kilogram\per\meter\cubed}. -732 +765 [Double 0...MAX_DOUBLE (inclusive)] @@ -11502,7 +11502,7 @@ Reference density $\rho_0$. Units: \si{\kilogram\per\meter\cubed}. The value of the specific heat $C_p$. Units: \si{\joule\per\kelvin\per\kilogram}. -738 +771 [Double 0...MAX_DOUBLE (inclusive)] @@ -11519,7 +11519,7 @@ The value of the specific heat $C_p$. Units: \si{\joule\per\kelvin\per\kilogram} The reference temperature $T_0$. Units: \si{\kelvin}. -733 +766 [Double 0...MAX_DOUBLE (inclusive)] @@ -11536,7 +11536,7 @@ The reference temperature $T_0$. Units: \si{\kelvin}. The value of the thermal conductivity $k$. Units: \si{\watt\per\meter\per\kelvin}. -737 +770 [Double 0...MAX_DOUBLE (inclusive)] @@ -11553,7 +11553,7 @@ The value of the thermal conductivity $k$. Units: \si{\watt\per\meter\per\kelvin The value of the thermal expansion coefficient $\beta$. Units: \si{\per\kelvin}. -739 +772 [Double 0...MAX_DOUBLE (inclusive)] @@ -11570,7 +11570,7 @@ The value of the thermal expansion coefficient $\beta$. Units: \si{\per\kelvin}. The temperature dependence of viscosity. Dimensionless exponent. -736 +769 [Double 0...MAX_DOUBLE (inclusive)] @@ -11587,7 +11587,7 @@ The temperature dependence of viscosity. Dimensionless exponent. The value of the constant viscosity. Units: \si{\pascal\second}. -734 +767 [Double 0...MAX_DOUBLE (inclusive)] @@ -11600,7 +11600,7 @@ The value of the constant viscosity. Units: \si{\pascal\second}. A list of prefactors for the viscosity for each phase. The reference viscosity will be multiplied by this factor to get the corresponding viscosity for each phase. List must have one more entry than Phase transition depths. Units: non-dimensional. -744 +777 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -11619,7 +11619,7 @@ A list of prefactors for the viscosity for each phase. The reference viscosity w Constant parameter in the quadratic function that approximates the solidus of peridotite. Units: \si{\degreeCelsius}. -767 +554 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -11636,7 +11636,7 @@ Constant parameter in the quadratic function that approximates the solidus of pe Prefactor of the linear pressure term in the quadratic function that approximates the solidus of peridotite. Units: \si{\degreeCelsius\per\pascal}. -768 +555 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -11653,7 +11653,7 @@ Prefactor of the linear pressure term in the quadratic function that approximate Prefactor of the quadratic pressure term in the quadratic function that approximates the solidus of peridotite. Units: \si{\degreeCelsius\per\pascal\squared}. -769 +556 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -11670,7 +11670,7 @@ Prefactor of the quadratic pressure term in the quadratic function that approxim Constant parameter in the quadratic function that approximates the lherzolite liquidus used for calculating the fraction of peridotite-derived melt. Units: \si{\degreeCelsius}. -770 +557 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -11687,7 +11687,7 @@ Constant parameter in the quadratic function that approximates the lherzolite li Prefactor of the linear pressure term in the quadratic function that approximates the lherzolite liquidus used for calculating the fraction of peridotite-derived melt. Units: \si{\degreeCelsius\per\pascal}. -771 +558 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -11704,7 +11704,7 @@ Prefactor of the linear pressure term in the quadratic function that approximate Prefactor of the quadratic pressure term in the quadratic function that approximates the lherzolite liquidus used for calculating the fraction of peridotite-derived melt. Units: \si{\degreeCelsius\per\pascal\squared}. -772 +559 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -11721,7 +11721,7 @@ Prefactor of the quadratic pressure term in the quadratic function that approxim Constant parameter in the quadratic function that approximates the liquidus of peridotite. Units: \si{\degreeCelsius}. -773 +560 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -11738,7 +11738,7 @@ Constant parameter in the quadratic function that approximates the liquidus of p Prefactor of the linear pressure term in the quadratic function that approximates the liquidus of peridotite. Units: \si{\degreeCelsius\per\pascal}. -774 +561 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -11755,7 +11755,7 @@ Prefactor of the linear pressure term in the quadratic function that approximate Prefactor of the quadratic pressure term in the quadratic function that approximates the liquidus of peridotite. Units: \si{\degreeCelsius\per\pascal\squared}. -775 +562 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -11772,7 +11772,7 @@ Prefactor of the quadratic pressure term in the quadratic function that approxim A linear dependency of viscosity on composition. Dimensionless prefactor. -759 +546 [Double 0...MAX_DOUBLE (inclusive)] @@ -11789,7 +11789,7 @@ A linear dependency of viscosity on composition. Dimensionless prefactor. The value of the compressibility $\kappa$. Units: \si{\per\pascal}. -765 +552 [Double 0...MAX_DOUBLE (inclusive)] @@ -11806,7 +11806,7 @@ The value of the compressibility $\kappa$. Units: \si{\per\pascal}. Constant parameter in the quadratic function that approximates the solidus of pyroxenite. Units: \si{\degreeCelsius}. -781 +568 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -11823,7 +11823,7 @@ Constant parameter in the quadratic function that approximates the solidus of py Prefactor of the linear pressure term in the quadratic function that approximates the solidus of pyroxenite. Note that this factor is different from the value given in Sobolev, 2011, because they use the potential temperature whereas we use the absolute temperature. Units: \si{\degreeCelsius\per\pascal}. -782 +569 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -11840,7 +11840,7 @@ Prefactor of the linear pressure term in the quadratic function that approximate Prefactor of the quadratic pressure term in the quadratic function that approximates the solidus of pyroxenite. Units: \si{\degreeCelsius\per\pascal\squared}. -783 +570 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -11857,7 +11857,7 @@ Prefactor of the quadratic pressure term in the quadratic function that approxim If compositional fields are used, then one would frequently want to make the density depend on these fields. In this simple material model, we make the following assumptions: if no compositional fields are used in the current simulation, then the density is simply the usual one with its linear dependence on the temperature. If there are compositional fields, then the density only depends on the first one in such a way that the density has an additional term of the kind $+\Delta \rho \; c_1(\mathbf x)$. This parameter describes the value of $\Delta \rho$. Units: \si{\kilogram\per\meter\cubed}/unit change in composition. -766 +553 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -11874,7 +11874,7 @@ If compositional fields are used, then one would frequently want to make the den Prefactor of the linear depletion term in the quadratic function that approximates the melt fraction of pyroxenite. Units: \si{\degreeCelsius\per\pascal}. -784 +571 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -11891,7 +11891,7 @@ Prefactor of the linear depletion term in the quadratic function that approximat Prefactor of the quadratic depletion term in the quadratic function that approximates the melt fraction of pyroxenite. Units: \si{\degreeCelsius\per\pascal\squared}. -785 +572 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -11908,7 +11908,7 @@ Prefactor of the quadratic depletion term in the quadratic function that approxi Mass fraction of clinopyroxene in the peridotite to be molten. Units: non-dimensional. -780 +567 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -11925,7 +11925,7 @@ Mass fraction of clinopyroxene in the peridotite to be molten. Units: non-dimens Maximum melt fraction of pyroxenite in this parameterization. At higher temperatures peridotite begins to melt. -787 +574 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -11942,7 +11942,7 @@ Maximum melt fraction of pyroxenite in this parameterization. At higher temperat The entropy change for the phase transition from solid to melt of peridotite. Units: \si{\joule\per\kelvin\per\kilogram}. -779 +566 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -11959,7 +11959,7 @@ The entropy change for the phase transition from solid to melt of peridotite. Un The entropy change for the phase transition from solid to melt of pyroxenite. Units: \si{\joule\per\kelvin\per\kilogram}. -786 +573 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -11976,7 +11976,7 @@ The entropy change for the phase transition from solid to melt of pyroxenite. Un Reference density $\rho_0$. Units: \si{\kilogram\per\meter\cubed}. -756 +543 [Double 0...MAX_DOUBLE (inclusive)] @@ -11993,7 +11993,7 @@ Reference density $\rho_0$. Units: \si{\kilogram\per\meter\cubed}. The value of the specific heat $C_p$. Units: \si{\joule\per\kelvin\per\kilogram}. -762 +549 [Double 0...MAX_DOUBLE (inclusive)] @@ -12010,7 +12010,7 @@ The value of the specific heat $C_p$. Units: \si{\joule\per\kelvin\per\kilogram} The reference temperature $T_0$. Units: \si{\kelvin}. -757 +544 [Double 0...MAX_DOUBLE (inclusive)] @@ -12027,7 +12027,7 @@ The reference temperature $T_0$. Units: \si{\kelvin}. The relative density of melt compared to the solid material. This means, the density change upon melting is this parameter times the density of solid material.Units: non-dimensional. -788 +575 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12044,7 +12044,7 @@ The relative density of melt compared to the solid material. This means, the den The value of the thermal conductivity $k$. Units: \si{\watt\per\meter\per\kelvin}. -761 +548 [Double 0...MAX_DOUBLE (inclusive)] @@ -12061,7 +12061,7 @@ The value of the thermal conductivity $k$. Units: \si{\watt\per\meter\per\kelvin The value of the thermal expansion coefficient $\alpha_s$. Units: \si{\per\kelvin}. -763 +550 [Double 0...MAX_DOUBLE (inclusive)] @@ -12078,7 +12078,7 @@ The value of the thermal expansion coefficient $\alpha_s$. Units: \si{\per\kelvi The value of the thermal expansion coefficient $\alpha_f$. Units: \si{\per\kelvin}. -764 +551 [Double 0...MAX_DOUBLE (inclusive)] @@ -12095,7 +12095,7 @@ The value of the thermal expansion coefficient $\alpha_f$. Units: \si{\per\kelvi The temperature dependence of viscosity. Dimensionless exponent. -760 +547 [Double 0...MAX_DOUBLE (inclusive)] @@ -12112,7 +12112,7 @@ The temperature dependence of viscosity. Dimensionless exponent. The value of the constant viscosity. Units: \si{\pascal\second}. -758 +545 [Double 0...MAX_DOUBLE (inclusive)] @@ -12129,7 +12129,7 @@ The value of the constant viscosity. Units: \si{\pascal\second}. Exponent of the melting temperature in the melt fraction calculation. Units: non-dimensional. -778 +565 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12146,7 +12146,7 @@ Exponent of the melting temperature in the melt fraction calculation. Units: non Constant in the linear function that approximates the clinopyroxene reaction coefficient. Units: non-dimensional. -776 +563 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12163,7 +12163,7 @@ Constant in the linear function that approximates the clinopyroxene reaction coe Prefactor of the linear pressure term in the linear function that approximates the clinopyroxene reaction coefficient. Units: \si{\per\pascal}. -777 +564 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12182,7 +12182,7 @@ Prefactor of the linear pressure term in the linear function that approximates t List of Einstein temperatures for each different endmember.Units: K. -561 +601 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -12199,7 +12199,7 @@ FeSiO3_bridgmanite, MgSiO3_bridgmanite, FeO_periclase, MgO_periclase, FeO_melt, Names of the endmember components used in the equation of state and the melting model, and whose parameters are determined by the other input parameters of this material model. The order the parameters are given in has to be the same as the order the endmember names are given in. Units: none. -552 +592 [List of <[MultipleSelection MgSiO3_bridgmanite|FeSiO3_bridgmanite|MgO_periclase|FeO_periclase|MgO_melt|FeO_melt|SiO2_melt ]> of length 0...4294967295 (inclusive)] @@ -12216,7 +12216,7 @@ solid, solid, solid, solid, melt, melt, melt States of the endmember components used in the equation of state and the melting model. For each endmember, this list has to define if they belong to the melt or to the solid. The order the states are given in has to be the same as the order the 'Endmember names' are given in. Units: none. -553 +593 [List of <[MultipleSelection solid|melt ]> of length 0...4294967295 (inclusive)] @@ -12233,7 +12233,7 @@ States of the endmember components used in the equation of state and the melting The porosity dependence of the viscosity. Units: dimensionless. -539 +579 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12250,7 +12250,7 @@ The porosity dependence of the viscosity. Units: dimensionless. The melting temperature of one of the components in the melting model, the Fe mantle endmember.Units: K. -546 +586 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12267,7 +12267,7 @@ The melting temperature of one of the components in the melting model, the Fe ma The number of moles of Fe atoms mixing on a pseudosite in the mantle lattice, This is needed because we use an empirical model fitting the full Boukare model, and can be changed to reflect partition coefficients from other sources.Units: none. -548 +588 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12284,7 +12284,7 @@ The number of moles of Fe atoms mixing on a pseudosite in the mantle lattice, Th The pressure derivative of the bulk modulus at the reference temperature and reference pressure for each different endmember component.Units: none. -559 +599 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -12301,7 +12301,7 @@ true Whether to include melting and freezing (according to a simplified linear melting approximation in the model (if true), or not (if false). -544 +584 [Bool] @@ -12318,7 +12318,7 @@ Whether to include melting and freezing (according to a simplified linear meltin The first of three coefficients that are used to compute the specific heat capacities for each different endmember at the reference temperature and reference pressure. This coefficient describes the linear part of the temperature dependence. Units: J/kg/K/K. -565 +605 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -12337,7 +12337,7 @@ In case the operator splitting scheme is used, the porosity field can not be set Also note that the melting time scale has to be larger than or equal to the reaction time step used in the operator splitting scheme, otherwise reactions can not be computed. If the model does not use operator splitting, this parameter is not used. Units: yr or s, depending on the ``Use years in output instead of seconds'' parameter. -545 +585 [Double 0...MAX_DOUBLE (inclusive)] @@ -12354,7 +12354,7 @@ Also note that the melting time scale has to be larger than or equal to the reac The melting temperature of one of the components in the melting model, the Mg mantle endmember.Units: K. -547 +587 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12371,7 +12371,7 @@ The melting temperature of one of the components in the melting model, the Mg ma The number of moles of Mg atoms mixing on a pseudosite in the mantle lattice, This is needed because we use an empirical model fitting the full Boukare model, and can be changed to reflect partition coefficients from other sources.Units: none. -549 +589 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12388,7 +12388,7 @@ The number of moles of Mg atoms mixing on a pseudosite in the mantle lattice, Th Molar masses of the different endmembersUnits: kg/mol. -554 +594 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -12405,7 +12405,7 @@ Molar masses of the different endmembersUnits: kg/mol. Number of atoms per in the formula of each endmember.Units: none. -555 +595 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -12422,7 +12422,7 @@ Number of atoms per in the formula of each endmember.Units: none. List of bulk moduli for each different endmember at the reference temperature and reference pressure.Units: Pa. -558 +598 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -12439,7 +12439,7 @@ List of bulk moduli for each different endmember at the reference temperature an The value of the constant bulk viscosity $\xi_0$ of the solid matrix. This viscosity may be modified by both temperature and porosity dependencies. Units: $Pa \, s$. -537 +577 [Double 0...MAX_DOUBLE (inclusive)] @@ -12456,7 +12456,7 @@ The value of the constant bulk viscosity $\xi_0$ of the solid matrix. This visco List of enthalpies at the reference temperature and reference pressure for each different endmember component.Units: J/mol. -562 +602 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -12473,7 +12473,7 @@ List of enthalpies at the reference temperature and reference pressure for each List of entropies at the reference temperature and reference pressure for each different endmember component.Units: J/K/mol. -563 +603 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -12490,7 +12490,7 @@ List of entropies at the reference temperature and reference pressure for each d The value of the constant melt viscosity $\eta_f$. Units: $Pa \, s$. -538 +578 [Double 0...MAX_DOUBLE (inclusive)] @@ -12507,7 +12507,7 @@ The value of the constant melt viscosity $\eta_f$. Units: $Pa \, s$. Reference permeability of the solid host rock.Units: $m^2$. -543 +583 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12524,7 +12524,7 @@ Reference permeability of the solid host rock.Units: $m^2$. Reference pressure used to compute the material propertiesof the different endmember components.Units: Pa. -551 +591 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12541,7 +12541,7 @@ Reference pressure used to compute the material propertiesof the different endme The value of the constant viscosity $\eta_0$ of the solid matrix. This viscosity may be modified by both temperature and porosity dependencies. Units: $Pa \, s$. -536 +576 [Double 0...MAX_DOUBLE (inclusive)] @@ -12558,7 +12558,7 @@ The value of the constant viscosity $\eta_0$ of the solid matrix. This viscosity List of specific heat capacities for each different endmember at the reference temperature and reference pressure.Units: J/kg/K. -564 +604 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -12575,7 +12575,7 @@ List of specific heat capacities for each different endmember at the reference t Reference temperature used to compute the material propertiesof the different endmember components.Units: K. -550 +590 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12592,7 +12592,7 @@ Reference temperature used to compute the material propertiesof the different en List of thermal expansivities for each different endmember at the reference temperature and reference pressure.Units: 1/K. -557 +597 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -12609,7 +12609,7 @@ List of thermal expansivities for each different endmember at the reference temp Reference volumes of the different endmembers.Units: $m^3$. -556 +596 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -12626,7 +12626,7 @@ Reference volumes of the different endmembers.Units: $m^3$. The second of three coefficients that are used to compute the specific heat capacities for each different endmember at the reference temperature and reference pressure. This coefficient describes the part of the temperature dependence that scales as the inverse of the square of the temperature. Units: J K/kg. -566 +606 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -12643,7 +12643,7 @@ The second of three coefficients that are used to compute the specific heat capa The second pressure derivative of the bulk modulus at the reference temperature and reference pressure for each different endmember component.Units: 1/Pa. -560 +600 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -12660,7 +12660,7 @@ The second pressure derivative of the bulk modulus at the reference temperature The temperature dependence of the bulk viscosity. Dimensionless exponent. See the general documentation of this model for a formula that states the dependence of the viscosity on this factor, which is called $\beta$ there. -541 +581 [Double 0...MAX_DOUBLE (inclusive)] @@ -12677,7 +12677,7 @@ The temperature dependence of the bulk viscosity. Dimensionless exponent. See th The value of the thermal conductivity $k$. Units: $W/m/K$. -542 +582 [Double 0...MAX_DOUBLE (inclusive)] @@ -12694,7 +12694,7 @@ The value of the thermal conductivity $k$. Units: $W/m/K$. The temperature dependence of the shear viscosity. Dimensionless exponent. See the general documentation of this model for a formula that states the dependence of the viscosity on this factor, which is called $\beta$ there. -540 +580 [Double 0...MAX_DOUBLE (inclusive)] @@ -12711,7 +12711,7 @@ The temperature dependence of the shear viscosity. Dimensionless exponent. See t The third of three coefficients that are used to compute the specific heat capacities for each different endmember at the reference temperature and reference pressure. This coefficient describes the part of the temperature dependence that scales as the inverse of the square root of the temperatureUnits: J/kg/sqrt(K). -567 +607 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -12730,7 +12730,7 @@ The third of three coefficients that are used to compute the specific heat capac The density contrast between material with a depletion of 1 and a depletion of zero. Negative values indicate lower densities of depleted material. Depletion is indicated by the compositional field with the name peridotite. Not used if this field does not exist in the model. Units: \si{\kilogram\per\meter\cubed}. -581 +621 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12747,7 +12747,7 @@ The density contrast between material with a depletion of 1 and a depletion of z The solidus temperature change for a depletion of 100\%. For positive values, the solidus gets increased for a positive peridotite field (depletion) and lowered for a negative peridotite field (enrichment). Scaling with depletion is linear. Only active when fractional melting is used. Units: \si{\kelvin}. -583 +623 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12764,7 +12764,7 @@ The solidus temperature change for a depletion of 100\%. For positive values, th $\alpha_F$: exponential dependency of viscosity on the depletion field $F$ (called peridotite). Dimensionless factor. With a value of 0.0 (the default) the viscosity does not depend on the depletion. The effective viscosity increasedue to depletion is defined as $exp( \alpha_F * F)$. Rationale: melting dehydrates the source rock by removing most of the volatiles,and makes it stronger. Hirth and Kohlstedt (1996) report typical values around a factor 100 to 1000 viscosity contrast between wet and dry rocks, although some experimental studies report a smaller (factor 10) contrast (e.g. Fei et al., 2013). -590 +630 [Double 0...MAX_DOUBLE (inclusive)] @@ -12781,7 +12781,7 @@ $\alpha_F$: exponential dependency of viscosity on the depletion field $F$ (call The porosity dependence of the viscosity. Units: dimensionless. -574 +614 [Double 0...MAX_DOUBLE (inclusive)] @@ -12798,7 +12798,7 @@ true Whether to include melting and freezing (according to a simplified linear melting approximation in the model (if true), or not (if false). -588 +628 [Bool] @@ -12815,7 +12815,7 @@ Whether to include melting and freezing (according to a simplified linear meltin $\Delta \eta_{F,max}$: maximum depletion strengthening of viscosity. Rationale: melting dehydrates the source rock by removing most of the volatiles,and makes it stronger. Hirth and Kohlstedt (1996) report typical values around a factor 100 to 1000 viscosity contrast between wet and dry rocks, although some experimental studies report a smaller (factor 10) contrast (e.g. Fei et al., 2013). -591 +631 [Double 0...MAX_DOUBLE (inclusive)] @@ -12832,7 +12832,7 @@ $\Delta \eta_{F,max}$: maximum depletion strengthening of viscosity. Rationale: The value of the pressure derivative of the melt bulk modulus. Units: None. -587 +627 [Double 0...MAX_DOUBLE (inclusive)] @@ -12849,7 +12849,7 @@ The value of the pressure derivative of the melt bulk modulus. Units: None. The value of the compressibility of the melt. Units: \si{\per\pascal}. -586 +626 [Double 0...MAX_DOUBLE (inclusive)] @@ -12868,7 +12868,7 @@ In case the operator splitting scheme is used, the porosity field can not be set Also note that the melting time scale has to be larger than or equal to the reaction time step used in the operator splitting scheme, otherwise reactions can not be computed. If the model does not use operator splitting, this parameter is not used. Units: yr or s, depending on the ``Use years in output instead of seconds'' parameter. -589 +629 [Double 0...MAX_DOUBLE (inclusive)] @@ -12885,7 +12885,7 @@ Also note that the melting time scale has to be larger than or equal to the reac The linear solidus temperature change with pressure. For positive values, the solidus gets increased for positive pressures. Units: \si{\per\pascal}. -584 +624 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12902,7 +12902,7 @@ The linear solidus temperature change with pressure. For positive values, the so The value of the constant bulk viscosity $\xi_0$ of the solid matrix. This viscosity may be modified by both temperature and porosity dependencies. Units: \si{\pascal\second}. -572 +612 [Double 0...MAX_DOUBLE (inclusive)] @@ -12919,7 +12919,7 @@ The value of the constant bulk viscosity $\xi_0$ of the solid matrix. This visco Reference density of the melt/fluid$\rho_{f,0}$. Units: \si{\kilogram\per\meter\cubed}. -569 +609 [Double 0...MAX_DOUBLE (inclusive)] @@ -12936,7 +12936,7 @@ Reference density of the melt/fluid$\rho_{f,0}$. Units: \si{\kilogram\per\meter\ The value of the constant melt viscosity $\eta_f$. Units: \si{\pascal\second}. -573 +613 [Double 0...MAX_DOUBLE (inclusive)] @@ -12953,7 +12953,7 @@ The value of the constant melt viscosity $\eta_f$. Units: \si{\pascal\second}. Reference permeability of the solid host rock.Units: \si{\meter\squared}. -580 +620 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12970,7 +12970,7 @@ Reference permeability of the solid host rock.Units: \si{\meter\squared}. The value of the constant viscosity $\eta_0$ of the solid matrix. This viscosity may be modified by both temperature and porosity dependencies. Units: \si{\pascal\second}. -571 +611 [Double 0...MAX_DOUBLE (inclusive)] @@ -12987,7 +12987,7 @@ The value of the constant viscosity $\eta_0$ of the solid matrix. This viscosity Reference density of the solid $\rho_{s,0}$. Units: \si{\kilogram\per\meter\cubed}. -568 +608 [Double 0...MAX_DOUBLE (inclusive)] @@ -13004,7 +13004,7 @@ Reference density of the solid $\rho_{s,0}$. Units: \si{\kilogram\per\meter\cube The value of the specific heat $C_p$. Units: \si{\joule\per\kelvin\per\kilogram}. -578 +618 [Double 0...MAX_DOUBLE (inclusive)] @@ -13021,7 +13021,7 @@ The value of the specific heat $C_p$. Units: \si{\joule\per\kelvin\per\kilogram} The reference temperature $T_0$. The reference temperature is used in both the density and viscosity formulas. Units: \si{\kelvin}. -570 +610 [Double 0...MAX_DOUBLE (inclusive)] @@ -13038,7 +13038,7 @@ The reference temperature $T_0$. The reference temperature is used in both the d The value of the compressibility of the solid matrix. Units: \si{\per\pascal}. -585 +625 [Double 0...MAX_DOUBLE (inclusive)] @@ -13055,7 +13055,7 @@ The value of the compressibility of the solid matrix. Units: \si{\per\pascal}. Solidus for a pressure of zero. Units: \si{\kelvin}. -582 +622 [Double 0...MAX_DOUBLE (inclusive)] @@ -13072,7 +13072,7 @@ Solidus for a pressure of zero. Units: \si{\kelvin}. The temperature dependence of the bulk viscosity. Dimensionless exponent. See the general documentation of this model for a formula that states the dependence of the viscosity on this factor, which is called $\beta$ there. -576 +616 [Double 0...MAX_DOUBLE (inclusive)] @@ -13089,7 +13089,7 @@ The temperature dependence of the bulk viscosity. Dimensionless exponent. See th The value of the thermal conductivity $k$. Units: \si{\watt\per\meter\per\kelvin}. -577 +617 [Double 0...MAX_DOUBLE (inclusive)] @@ -13106,7 +13106,7 @@ The value of the thermal conductivity $k$. Units: \si{\watt\per\meter\per\kelvin The value of the thermal expansion coefficient $\beta$. Units: \si{\per\kelvin}. -579 +619 [Double 0...MAX_DOUBLE (inclusive)] @@ -13123,7 +13123,7 @@ The value of the thermal expansion coefficient $\beta$. Units: \si{\per\kelvin}. The temperature dependence of the shear viscosity. Dimensionless exponent. See the general documentation of this model for a formula that states the dependence of the viscosity on this factor, which is called $\beta$ there. -575 +615 [Double 0...MAX_DOUBLE (inclusive)] @@ -13142,7 +13142,7 @@ The temperature dependence of the shear viscosity. Dimensionless exponent. See t Constant parameter in the quadratic function that approximates the solidus of peridotite. Units: \si{\degreeCelsius}. -615 +655 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13159,7 +13159,7 @@ Constant parameter in the quadratic function that approximates the solidus of pe Prefactor of the linear pressure term in the quadratic function that approximates the solidus of peridotite. Units: \si{\degreeCelsius\per\pascal}. -616 +656 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13176,7 +13176,7 @@ Prefactor of the linear pressure term in the quadratic function that approximate Prefactor of the quadratic pressure term in the quadratic function that approximates the solidus of peridotite. Units: \si{\degreeCelsius\per\pascal\squared}. -617 +657 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13193,7 +13193,7 @@ Prefactor of the quadratic pressure term in the quadratic function that approxim Constant parameter in the quadratic function that approximates the lherzolite liquidus used for calculating the fraction of peridotite-derived melt. Units: \si{\degreeCelsius}. -618 +658 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13210,7 +13210,7 @@ Constant parameter in the quadratic function that approximates the lherzolite li Prefactor of the linear pressure term in the quadratic function that approximates the lherzolite liquidus used for calculating the fraction of peridotite-derived melt. Units: \si{\degreeCelsius\per\pascal}. -619 +659 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13227,7 +13227,7 @@ Prefactor of the linear pressure term in the quadratic function that approximate Prefactor of the quadratic pressure term in the quadratic function that approximates the lherzolite liquidus used for calculating the fraction of peridotite-derived melt. Units: \si{\degreeCelsius\per\pascal\squared}. -620 +660 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13244,7 +13244,7 @@ Prefactor of the quadratic pressure term in the quadratic function that approxim Constant parameter in the quadratic function that approximates the liquidus of peridotite. Units: \si{\degreeCelsius}. -621 +661 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13261,7 +13261,7 @@ Constant parameter in the quadratic function that approximates the liquidus of p Prefactor of the linear pressure term in the quadratic function that approximates the liquidus of peridotite. Units: \si{\degreeCelsius\per\pascal}. -622 +662 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13278,7 +13278,7 @@ Prefactor of the linear pressure term in the quadratic function that approximate Prefactor of the quadratic pressure term in the quadratic function that approximates the liquidus of peridotite. Units: \si{\degreeCelsius\per\pascal\squared}. -623 +663 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13295,7 +13295,7 @@ Prefactor of the quadratic pressure term in the quadratic function that approxim The density contrast between material with a depletion of 1 and a depletion of zero. Negative values indicate lower densities of depleted material. Depletion is indicated by the compositional field with the name peridotite. Not used if this field does not exist in the model. Units: \si{\kilogram\per\meter\cubed}. -613 +653 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13312,7 +13312,7 @@ The density contrast between material with a depletion of 1 and a depletion of z The solidus temperature change for a depletion of 100\%. For positive values, the solidus gets increased for a positive peridotite field (depletion) and lowered for a negative peridotite field (enrichment). Scaling with depletion is linear. Only active when fractional melting is used. Units: \si{\kelvin}. -614 +654 [Double 0...MAX_DOUBLE (inclusive)] @@ -13329,7 +13329,7 @@ The solidus temperature change for a depletion of 100\%. For positive values, th The porosity dependence of the viscosity. Units: dimensionless. -598 +638 [Double 0...MAX_DOUBLE (inclusive)] @@ -13346,7 +13346,7 @@ The porosity dependence of the viscosity. Units: dimensionless. Freezing rate of melt when in subsolidus regions. If this parameter is set to a number larger than 0.0, it specifies the fraction of melt that will freeze per year (or per second, depending on the ``Use years in output instead of seconds'' parameter), as soon as the porosity exceeds the equilibrium melt fraction, and the equilibrium melt fraction falls below the depletion. In this case, melt will freeze according to the given rate until one of those conditions is not fulfilled anymore. The reasoning behind this is that there should not be more melt present than the equilibrium melt fraction, as melt production decreases with increasing depletion, but the freezing process of melt also reduces the depletion by the same amount, and as soon as the depletion falls below the equilibrium melt fraction, we expect that material should melt again (no matter how much melt is present). This is quite a simplification and not a realistic freezing parameterization, but without tracking the melt composition, there is no way to compute freezing rates accurately. If this parameter is set to zero, no freezing will occur. Note that freezing can never be faster than determined by the ``Melting time scale for operator splitting''. The product of the ``Freezing rate'' and the ``Melting time scale for operator splitting'' defines how fast freezing occurs with respect to melting (if the product is 0.5, melting will occur twice as fast as freezing). Units: 1/yr or 1/s, depending on the ``Use years in output instead of seconds'' parameter. -611 +651 [Double 0...MAX_DOUBLE (inclusive)] @@ -13363,7 +13363,7 @@ Freezing rate of melt when in subsolidus regions. If this parameter is set to a Mass fraction of clinopyroxene in the peridotite to be molten. Units: non-dimensional. -628 +668 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13380,7 +13380,7 @@ Mass fraction of clinopyroxene in the peridotite to be molten. Units: non-dimens The value of the pressure derivative of the melt bulk modulus. Units: None. -608 +648 [Double 0...MAX_DOUBLE (inclusive)] @@ -13397,7 +13397,7 @@ The value of the pressure derivative of the melt bulk modulus. Units: None. The value of the compressibility of the melt. Units: \si{\per\pascal}. -607 +647 [Double 0...MAX_DOUBLE (inclusive)] @@ -13414,7 +13414,7 @@ The value of the compressibility of the melt. Units: \si{\per\pascal}. Depth above that melt will be extracted from the model, which is done by a negative reaction term proportional to the porosity field. Units: \si{\meter}. -605 +645 [Double 0...MAX_DOUBLE (inclusive)] @@ -13433,7 +13433,7 @@ Because the operator splitting scheme is used, the porosity field can not be set Also note that the melting time scale has to be larger than or equal to the reaction time step used in the operator splitting scheme, otherwise reactions can not be computed. Units: yr or s, depending on the ``Use years in output instead of seconds'' parameter. -612 +652 [Double 0...MAX_DOUBLE (inclusive)] @@ -13450,7 +13450,7 @@ Also note that the melting time scale has to be larger than or equal to the reac The entropy change for the phase transition from solid to melt of peridotite. Units: \si{\joule\per\kelvin\per\kilogram}. -627 +667 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13467,7 +13467,7 @@ The entropy change for the phase transition from solid to melt of peridotite. Un The value of the constant bulk viscosity $\xi_0$ of the solid matrix. This viscosity may be modified by both temperature and porosity dependencies. Units: \si{\pascal\second}. -596 +636 [Double 0...MAX_DOUBLE (inclusive)] @@ -13484,7 +13484,7 @@ The value of the constant bulk viscosity $\xi_0$ of the solid matrix. This visco Reference density of the melt/fluid$\rho_{f,0}$. Units: \si{\kilogram\per\meter\cubed}. -593 +633 [Double 0...MAX_DOUBLE (inclusive)] @@ -13501,7 +13501,7 @@ Reference density of the melt/fluid$\rho_{f,0}$. Units: \si{\kilogram\per\meter\ The value of the constant melt viscosity $\eta_f$. Units: \si{\pascal\second}. -597 +637 [Double 0...MAX_DOUBLE (inclusive)] @@ -13518,7 +13518,7 @@ The value of the constant melt viscosity $\eta_f$. Units: \si{\pascal\second}. Reference permeability of the solid host rock.Units: \si{\meter\squared}. -604 +644 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13535,7 +13535,7 @@ Reference permeability of the solid host rock.Units: \si{\meter\squared}. The value of the constant viscosity $\eta_0$ of the solid matrix. This viscosity may be modified by both temperature and porosity dependencies. Units: \si{\pascal\second}. -595 +635 [Double 0...MAX_DOUBLE (inclusive)] @@ -13552,7 +13552,7 @@ The value of the constant viscosity $\eta_0$ of the solid matrix. This viscosity Reference density of the solid $\rho_{s,0}$. Units: \si{\kilogram\per\meter\cubed}. -592 +632 [Double 0...MAX_DOUBLE (inclusive)] @@ -13569,7 +13569,7 @@ Reference density of the solid $\rho_{s,0}$. Units: \si{\kilogram\per\meter\cube The value of the specific heat $C_p$. Units: \si{\joule\per\kelvin\per\kilogram}. -602 +642 [Double 0...MAX_DOUBLE (inclusive)] @@ -13586,7 +13586,7 @@ The value of the specific heat $C_p$. Units: \si{\joule\per\kelvin\per\kilogram} The reference temperature $T_0$. The reference temperature is used in both the density and viscosity formulas. Units: \si{\kelvin}. -594 +634 [Double 0...MAX_DOUBLE (inclusive)] @@ -13603,7 +13603,7 @@ The reference temperature $T_0$. The reference temperature is used in both the d The value of the compressibility of the solid matrix. Units: \si{\per\pascal}. -606 +646 [Double 0...MAX_DOUBLE (inclusive)] @@ -13620,7 +13620,7 @@ The value of the compressibility of the solid matrix. Units: \si{\per\pascal}. The temperature dependence of the bulk viscosity. Dimensionless exponent. See the general documentation of this model for a formula that states the dependence of the viscosity on this factor, which is called $\beta$ there. -600 +640 [Double 0...MAX_DOUBLE (inclusive)] @@ -13637,7 +13637,7 @@ The temperature dependence of the bulk viscosity. Dimensionless exponent. See th The value of the thermal conductivity $k$. Units: \si{\watt\per\meter\per\kelvin}. -601 +641 [Double 0...MAX_DOUBLE (inclusive)] @@ -13654,7 +13654,7 @@ The value of the thermal conductivity $k$. Units: \si{\watt\per\meter\per\kelvin The value of the thermal expansion coefficient $\beta$. Units: \si{\per\kelvin}. -603 +643 [Double 0...MAX_DOUBLE (inclusive)] @@ -13671,7 +13671,7 @@ The value of the thermal expansion coefficient $\beta$. Units: \si{\per\kelvin}. The temperature dependence of the shear viscosity. Dimensionless exponent. See the general documentation of this model for a formula that states the dependence of the viscosity on this factor, which is called $\beta$ there. -599 +639 [Double 0...MAX_DOUBLE (inclusive)] @@ -13690,7 +13690,7 @@ If fractional melting should be used (if true), including a solidus change based Note that melt does not freeze unless the 'Freezing rate' parameter is set to a value larger than 0. -610 +650 [Bool] @@ -13707,7 +13707,7 @@ false If the compressibility should be used everywhere in the code (if true), changing the volume of material when the density changes, or only in the momentum conservation and advection equations (if false). -609 +649 [Bool] @@ -13724,7 +13724,7 @@ If the compressibility should be used everywhere in the code (if true), changing Exponent of the melting temperature in the melt fraction calculation. Units: non-dimensional. -626 +666 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13741,7 +13741,7 @@ Exponent of the melting temperature in the melt fraction calculation. Units: non Constant in the linear function that approximates the clinopyroxene reaction coefficient. Units: non-dimensional. -624 +664 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13758,7 +13758,7 @@ Constant in the linear function that approximates the clinopyroxene reaction coe Prefactor of the linear pressure term in the linear function that approximates the clinopyroxene reaction coefficient. Units: \si{\per\pascal}. -625 +665 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13777,7 +13777,7 @@ Prefactor of the linear pressure term in the linear function that approximates t The Einstein temperature at the reference pressure and temperature. Units: \si{\kelvin}. -635 +675 [Double 0...MAX_DOUBLE (inclusive)] @@ -13794,7 +13794,7 @@ The Einstein temperature at the reference pressure and temperature. Units: \si{\ The value of the first pressure derivative of the isothermal bulk modulus at the reference pressure and temperature. Units: None. -633 +673 [Double 0...MAX_DOUBLE (inclusive)] @@ -13811,7 +13811,7 @@ The value of the first pressure derivative of the isothermal bulk modulus at the The density at the reference pressure and temperature. Units: \si{\kilogram\per\meter\cubed}. -631 +671 [Double 0...MAX_DOUBLE (inclusive)] @@ -13828,7 +13828,7 @@ The density at the reference pressure and temperature. Units: \si{\kilogram\per\ The isothermal bulk modulus at the reference pressure and temperature. Units: \si{\pascal}. -632 +672 [Double 0...MAX_DOUBLE (inclusive)] @@ -13845,7 +13845,7 @@ The isothermal bulk modulus at the reference pressure and temperature. Units: \s Reference pressure $P_0$. Units: \si{\pascal}. -629 +669 [Double 0...MAX_DOUBLE (inclusive)] @@ -13862,7 +13862,7 @@ Reference pressure $P_0$. Units: \si{\pascal}. Reference temperature $T_0$. Units: \si{\kelvin}. -630 +670 [Double 0...MAX_DOUBLE (inclusive)] @@ -13879,7 +13879,7 @@ Reference temperature $T_0$. Units: \si{\kelvin}. The thermal expansion coefficient at the reference pressure and temperature. Units: \si{\per\kelvin}. -634 +674 [Double 0...MAX_DOUBLE (inclusive)] @@ -13896,7 +13896,7 @@ The thermal expansion coefficient at the reference pressure and temperature. Uni The value of the constant thermal conductivity $k$. Units: \si{\watt\per\meter\per\kelvin}. -637 +677 [Double 0...MAX_DOUBLE (inclusive)] @@ -13913,7 +13913,7 @@ The value of the constant thermal conductivity $k$. Units: \si{\watt\per\meter\p The value of the constant viscosity $\eta_0$. Units: \si{\pascal\second}. -636 +676 [Double 0...MAX_DOUBLE (inclusive)] @@ -13929,7 +13929,7 @@ Sometimes it is convenient to use symbolic constants in the expression that desc A typical example would be to set this runtime parameter to `pi=3.1415926536' and then use `pi' in the expression of the actual formula. (That said, for convenience this class actually defines both `pi' and `Pi' by default, but you get the idea.) -640 +680 [Anything] @@ -13944,7 +13944,7 @@ A typical example would be to set this runtime parameter to `pi=3.1415926536&apo -641 +681 [Anything] @@ -13961,7 +13961,7 @@ x,t The names of the variables as they will be used in the function, separated by commas. By default, the names of variables at which the function will be evaluated are `x' (in 1d), `x,y' (in 2d) or `x,y,z' (in 3d) for spatial coordinates and `t' for time. You can then use these variable names in your function expression and they will be replaced by the values of these variables at which the function is currently evaluated. However, you can also choose a different set of names for the independent variables at which to evaluate your function expression. For example, if you work in spherical coordinates, you may wish to set this input parameter to `r,phi,theta,t' and then use these variable names in your function expression. -638 +678 [Anything] @@ -13981,7 +13981,7 @@ The names of the variables as they will be used in the function, separated by co List of densities for background mantle and compositional fields,for a total of N+M+1 values, where N is the number of compositional fields and M is the number of phases. If only one value is given, then all use the same value. Units: \si{\kilogram\per\meter\cubed}. -643 +683 [Anything] @@ -13998,7 +13998,7 @@ List of densities for background mantle and compositional fields,for a total of List of specific heats $C_p$ for background mantle and compositional fields,for a total of N+M+1 values, where N is the number of compositional fields and M is the number of phases. If only one value is given, then all use the same value. Units: \si{\joule\per\kelvin\per\kilogram}. -645 +685 [Anything] @@ -14015,7 +14015,7 @@ List of specific heats $C_p$ for background mantle and compositional fields,for The reference temperature $T_0$. Units: \si{\kelvin}. -646 +686 [Double 0...MAX_DOUBLE (inclusive)] @@ -14040,7 +14040,7 @@ false List of thermal conductivities for background mantle and compositional fields,for a total of N+1 values, where N is the number of compositional fields.If only one value is given, then all use the same value. Units: \si{\watt\per\meter\per\kelvin}. -648 +688 [Anything] @@ -14057,7 +14057,7 @@ List of thermal conductivities for background mantle and compositional fields,fo List of thermal expansivities for background mantle and compositional fields,for a total of N+M+1 values, where N is the number of compositional fields and M is the number of phases. If only one value is given, then all use the same value. Units: \si{\per\kelvin}. -644 +684 [Anything] @@ -14074,7 +14074,7 @@ List of thermal expansivities for background mantle and compositional fields,for List of viscosities for background mantle and compositional fields,for a total of N+1 values, where N is the number of compositional fields.If only one value is given, then all use the same value. Units: \si{\pascal\second}. -647 +687 [Anything] @@ -14091,7 +14091,7 @@ harmonic When more than one compositional field is present at a point with different viscosities, we need to come up with an average viscosity at that point. Select a weighted harmonic, arithmetic, geometric, or maximum composition. -649 +689 [Selection arithmetic|harmonic|geometric|maximum composition ] @@ -14110,7 +14110,7 @@ When more than one compositional field is present at a point with different visc List of isochoric specific heats $C_v$ for background mantle and compositional fields,for a total of N+1 values, where N is the number of compositional fields.If only one value is given, then all use the same value. Units: \si{\joule\per\kelvin\per\kilogram}. -655 +695 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -14127,7 +14127,7 @@ List of isochoric specific heats $C_v$ for background mantle and compositional f List of isothermal pressure derivatives of the bulk moduli for background mantle and compositional fields,for a total of N+1 values, where N is the number of compositional fields.If only one value is given, then all use the same value. Units: []. -653 +693 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -14144,7 +14144,7 @@ List of isothermal pressure derivatives of the bulk moduli for background mantle List of densities for background mantle and compositional fields,for a total of N+1 values, where N is the number of compositional fields.If only one value is given, then all use the same value. Units: \si{\kilogram\per\meter\cubed}. -651 +691 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -14161,7 +14161,7 @@ List of densities for background mantle and compositional fields,for a total of List of isothermal compressibilities for background mantle and compositional fields,for a total of N+1 values, where N is the number of compositional fields.If only one value is given, then all use the same value. Units: \si{\per\pascal}. -652 +692 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -14178,7 +14178,7 @@ List of isothermal compressibilities for background mantle and compositional fie List of reference temperatures $T_0$ for background mantle and compositional fields,for a total of N+1 values, where N is the number of compositional fields.If only one value is given, then all use the same value. Units: \si{\kelvin}. -650 +690 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -14195,7 +14195,7 @@ List of reference temperatures $T_0$ for background mantle and compositional fie List of thermal expansivities for background mantle and compositional fields,for a total of N+1 values, where N is the number of compositional fields.If only one value is given, then all use the same value. Units: \si{\per\kelvin}. -654 +694 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -14212,7 +14212,7 @@ List of thermal expansivities for background mantle and compositional fields,for List of thermal conductivities for background mantle and compositional fields,for a total of N+1 values, where N is the number of compositional fields.If only one value is given, then all use the same value. Units: \si{\watt\per\meter\per\kelvin}. -657 +697 [Anything] @@ -14229,7 +14229,7 @@ List of thermal conductivities for background mantle and compositional fields,fo List of viscosities for background mantle and compositional fields,for a total of N+1 values, where N is the number of compositional fields.If only one value is given, then all use the same value. Units: \si{\pascal\second}. -656 +696 [Anything] @@ -14246,7 +14246,7 @@ harmonic When more than one compositional field is present at a point with different viscosities, we need to come up with an average viscosity at that point. Select a weighted harmonic, arithmetic, geometric, or maximum composition. -658 +698 [Selection arithmetic|harmonic|geometric|maximum composition ] @@ -14265,7 +14265,7 @@ When more than one compositional field is present at a point with different visc Dissipation number. Pick 0.0 for incompressible computations. -661 +701 [Double 0...MAX_DOUBLE (inclusive)] @@ -14282,7 +14282,7 @@ Dissipation number. Pick 0.0 for incompressible computations. Rayleigh number Ra -660 +700 [Double 0...MAX_DOUBLE (inclusive)] @@ -14299,7 +14299,7 @@ Rayleigh number Ra Reference density $\rho_0$. Units: \si{\kilogram\per\meter\cubed}. -659 +699 [Double 0...MAX_DOUBLE (inclusive)] @@ -14316,7 +14316,7 @@ Reference density $\rho_0$. Units: \si{\kilogram\per\meter\cubed}. The value of the specific heat $C_p$. Units: \si{\joule\per\kelvin\per\kilogram}. -663 +703 [Double 0...MAX_DOUBLE (inclusive)] @@ -14333,7 +14333,7 @@ false Whether to use the TALA instead of the ALA approximation. -666 +706 [Bool] @@ -14350,7 +14350,7 @@ Whether to use the TALA instead of the ALA approximation. Exponential depth prefactor for viscosity. -665 +705 [Double 0...MAX_DOUBLE (inclusive)] @@ -14367,7 +14367,7 @@ Exponential depth prefactor for viscosity. Exponential temperature prefactor for viscosity. -664 +704 [Double 0...MAX_DOUBLE (inclusive)] @@ -14384,7 +14384,7 @@ Exponential temperature prefactor for viscosity. Grueneisen parameter -662 +702 [Double 0...MAX_DOUBLE (inclusive)] @@ -14403,7 +14403,7 @@ Grueneisen parameter The value of the maximum pressure used to query PerpleX. Units: \si{\pascal}. -673 +529 [Double 0...MAX_DOUBLE (inclusive)] @@ -14420,7 +14420,7 @@ The value of the maximum pressure used to query PerpleX. Units: \si{\pascal}. The value of the maximum temperature used to query PerpleX. Units: \si{\kelvin}. -671 +527 [Double 0...MAX_DOUBLE (inclusive)] @@ -14437,7 +14437,7 @@ The value of the maximum temperature used to query PerpleX. Units: \si{\kelvin}. The value of the minimum pressure used to query PerpleX. Units: \si{\pascal}. -672 +528 [Double 0...MAX_DOUBLE (inclusive)] @@ -14454,7 +14454,7 @@ The value of the minimum pressure used to query PerpleX. Units: \si{\pascal}. The value of the minimum temperature used to query PerpleX. Units: \si{\kelvin}. -670 +526 [Double 0...MAX_DOUBLE (inclusive)] @@ -14471,7 +14471,7 @@ rock.dat The name of the PerpleX input file (should end with .dat). -667 +523 [Anything] @@ -14488,7 +14488,7 @@ The name of the PerpleX input file (should end with .dat). The value of the thermal conductivity $k$. Units: \si{\watt\per\meter\per\kelvin}. -669 +525 [Double 0...MAX_DOUBLE (inclusive)] @@ -14505,7 +14505,7 @@ The value of the thermal conductivity $k$. Units: \si{\watt\per\meter\per\kelvin The value of the viscosity $\eta$. Units: \si{\pascal\second}. -668 +524 [Double 0...MAX_DOUBLE (inclusive)] @@ -14524,7 +14524,7 @@ simple The name of a material model that will be modified by the prescribed viscosity material model. Valid values for this parameter are the names of models that are also valid for the ``Material models/Model name'' parameter. See the documentation for that for more information. -523 +530 [Selection Steinberger|ascii reference profile|averaging|compositing|composition reaction|depth dependent|diffusion dislocation|drucker prager|entropy model|grain size|latent heat|latent heat melt|melt boukare|melt global|melt simple|modified tait|multicomponent|multicomponent compressible|nondimensional|perplex lookup|prescribed viscosity|replace lithosphere viscosity|simple|simple compressible|simpler|visco plastic|viscoelastic ] @@ -14540,7 +14540,7 @@ Sometimes it is convenient to use symbolic constants in the expression that desc A typical example would be to set this runtime parameter to `pi=3.1415926536' and then use `pi' in the expression of the actual formula. (That said, for convenience this class actually defines both `pi' and `Pi' by default, but you get the idea.) -526 +533 [Anything] @@ -14559,7 +14559,7 @@ The formula that denotes the function you want to evaluate for particular values If the function you are describing represents a vector-valued function with multiple components, then separate the expressions for individual components by a semicolon. -525 +532 [Anything] @@ -14576,7 +14576,7 @@ x,y,t The names of the variables as they will be used in the function, separated by commas. By default, the names of variables at which the function will be evaluated are `x' (in 1d), `x,y' (in 2d) or `x,y,z' (in 3d) for spatial coordinates and `t' for time. You can then use these variable names in your function expression and they will be replaced by the values of these variables at which the function is currently evaluated. However, you can also choose a different set of names for the independent variables at which to evaluate your function expression. For example, if you work in spherical coordinates, you may wish to set this input parameter to `r,phi,theta,t' and then use these variable names in your function expression. -524 +531 [Anything] @@ -14593,7 +14593,7 @@ Sometimes it is convenient to use symbolic constants in the expression that desc A typical example would be to set this runtime parameter to `pi=3.1415926536' and then use `pi' in the expression of the actual formula. (That said, for convenience this class actually defines both `pi' and `Pi' by default, but you get the idea.) -529 +536 [Anything] @@ -14612,7 +14612,7 @@ The formula that denotes the function you want to evaluate for particular values If the function you are describing represents a vector-valued function with multiple components, then separate the expressions for individual components by a semicolon. -528 +535 [Anything] @@ -14629,7 +14629,7 @@ x,y,t The names of the variables as they will be used in the function, separated by commas. By default, the names of variables at which the function will be evaluated are `x' (in 1d), `x,y' (in 2d) or `x,y,z' (in 3d) for spatial coordinates and `t' for time. You can then use these variable names in your function expression and they will be replaced by the values of these variables at which the function is currently evaluated. However, you can also choose a different set of names for the independent variables at which to evaluate your function expression. For example, if you work in spherical coordinates, you may wish to set this input parameter to `r,phi,theta,t' and then use these variable names in your function expression. -527 +534 [Anything] @@ -14649,7 +14649,7 @@ simple The name of a material model that will be modified by a replacingthe viscosity in the lithosphere by a constant value. Valid values for this parameter are the names of models that are also valid for the ``Material models/Model name'' parameter. See the documentation for more information. -530 +537 [Selection Steinberger|ascii reference profile|averaging|compositing|composition reaction|depth dependent|diffusion dislocation|drucker prager|entropy model|grain size|latent heat|latent heat melt|melt boukare|melt global|melt simple|modified tait|multicomponent|multicomponent compressible|nondimensional|perplex lookup|prescribed viscosity|replace lithosphere viscosity|simple|simple compressible|simpler|visco plastic|viscoelastic ] @@ -14666,7 +14666,7 @@ $ASPECT_SOURCE_DIR/data/initial-temperature/lithosphere-mask/ The path to the LAB depth data file -534 +541 [DirectoryName] @@ -14683,7 +14683,7 @@ Value Method that is used to specify the depth of the lithosphere-asthenosphere boundary. -532 +539 [Selection File|Value ] @@ -14700,7 +14700,7 @@ LAB_CAM2016.txt File from which the lithosphere-asthenosphere boundary depth data is read. -535 +542 [FileName (Type: input)] @@ -14717,7 +14717,7 @@ File from which the lithosphere-asthenosphere boundary depth data is read. The viscosity within lithosphere, applied abovethe maximum lithosphere depth. -531 +538 [Double 0...MAX_DOUBLE (inclusive)] @@ -14734,7 +14734,7 @@ The viscosity within lithosphere, applied abovethe maximum lithosphere depth. Units: \si{\meter}.The maximum depth of the lithosphere. The model will be NaNs below this depth. -533 +540 [Double 0...MAX_DOUBLE (inclusive)] @@ -14753,7 +14753,7 @@ Units: \si{\meter}.The maximum depth of the lithosphere. The model will be NaNs The value of the reference compressibility. Units: \si{\per\pascal}. -382 +394 [Double 0...MAX_DOUBLE (inclusive)] @@ -14770,7 +14770,7 @@ The value of the reference compressibility. Units: \si{\per\pascal}. Reference density $\rho_0$. Units: \si{\kilogram\per\meter\cubed}. -378 +390 [Double 0...MAX_DOUBLE (inclusive)] @@ -14787,7 +14787,7 @@ Reference density $\rho_0$. Units: \si{\kilogram\per\meter\cubed}. The value of the specific heat $C_p$. Units: \si{\joule\per\kelvin\per\kilogram}. -380 +392 [Double 0...MAX_DOUBLE (inclusive)] @@ -14804,7 +14804,7 @@ The value of the specific heat $C_p$. Units: \si{\joule\per\kelvin\per\kilogram} The value of the thermal conductivity $k$. Units: \si{\watt\per\meter\per\kelvin}. -379 +391 [Double 0...MAX_DOUBLE (inclusive)] @@ -14821,7 +14821,7 @@ The value of the thermal conductivity $k$. Units: \si{\watt\per\meter\per\kelvin The value of the thermal expansion coefficient $\alpha$. Units: \si{\per\kelvin}. -381 +393 [Double 0...MAX_DOUBLE (inclusive)] @@ -14838,7 +14838,7 @@ The value of the thermal expansion coefficient $\alpha$. Units: \si{\per\kelvin} The value of the viscosity $\eta$. Units: \si{\pascal\second}. -383 +395 [Double 0...MAX_DOUBLE (inclusive)] @@ -14857,7 +14857,7 @@ The value of the viscosity $\eta$. Units: \si{\pascal\second}. A linear dependency of viscosity on the first compositional field. Dimensionless prefactor. With a value of 1.0 (the default) the viscosity does not depend on the composition. See the general documentation of this model for a formula that states the dependence of the viscosity on this factor, which is called $\xi$ there. -518 +385 [Double 0...MAX_DOUBLE (inclusive)] @@ -14874,7 +14874,7 @@ A linear dependency of viscosity on the first compositional field. Dimensionless If compositional fields are used, then one would frequently want to make the density depend on these fields. In this simple material model, we make the following assumptions: if no compositional fields are used in the current simulation, then the density is simply the usual one with its linear dependence on the temperature. If there are compositional fields, then the material model determines how many of them influence the density. The composition-dependence adds a term of the kind $+\Delta \rho \; c_1(\mathbf x)$. This parameter describes the value of $\Delta \rho$. Units: \si{\kilogram\per\meter\cubed}/unit change in composition. -515 +382 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -14891,7 +14891,7 @@ If compositional fields are used, then one would frequently want to make the den The maximum value of the viscosity prefactor associated with temperature dependence. -520 +387 [Double 0...MAX_DOUBLE (inclusive)] @@ -14908,7 +14908,7 @@ The maximum value of the viscosity prefactor associated with temperature depende The minimum value of the viscosity prefactor associated with temperature dependence. -521 +388 [Double 0...MAX_DOUBLE (inclusive)] @@ -14925,7 +14925,7 @@ The minimum value of the viscosity prefactor associated with temperature depende Reference density $\rho_0$. Units: \si{\kilogram\per\meter\cubed}. -511 +378 [Double 0...MAX_DOUBLE (inclusive)] @@ -14942,7 +14942,7 @@ Reference density $\rho_0$. Units: \si{\kilogram\per\meter\cubed}. The value of the specific heat $C_p$. Units: \si{\joule\per\kelvin\per\kilogram}. -513 +380 [Double 0...MAX_DOUBLE (inclusive)] @@ -14959,7 +14959,7 @@ The value of the specific heat $C_p$. Units: \si{\joule\per\kelvin\per\kilogram} The reference temperature $T_0$. The reference temperature is used in both the density and viscosity formulas. Units: \si{\kelvin}. -516 +383 [Double 0...MAX_DOUBLE (inclusive)] @@ -14976,7 +14976,7 @@ The reference temperature $T_0$. The reference temperature is used in both the d The value of the thermal conductivity $k$. Units: \si{\watt\per\meter\per\kelvin}. -522 +389 [Double 0...MAX_DOUBLE (inclusive)] @@ -14993,7 +14993,7 @@ The value of the thermal conductivity $k$. Units: \si{\watt\per\meter\per\kelvin The value of the thermal expansion coefficient $\alpha$. Units: \si{\per\kelvin}. -514 +381 [Double 0...MAX_DOUBLE (inclusive)] @@ -15010,7 +15010,7 @@ The value of the thermal expansion coefficient $\alpha$. Units: \si{\per\kelvin} The temperature dependence of viscosity. Dimensionless exponent. See the general documentation of this model for a formula that states the dependence of the viscosity on this factor, which is called $\beta$ there. -519 +386 [Double 0...MAX_DOUBLE (inclusive)] @@ -15027,7 +15027,7 @@ The temperature dependence of viscosity. Dimensionless exponent. See the general The value of the constant viscosity $\eta_0$. This viscosity may be modified by both temperature and compositional dependencies. Units: \si{\pascal\second}. -517 +384 [Double 0...MAX_DOUBLE (inclusive)] @@ -15046,7 +15046,7 @@ The value of the constant viscosity $\eta_0$. This viscosity may be modified by Reference density $\rho_0$. Units: \si{\kilogram\per\meter\cubed}. -384 +396 [Double 0...MAX_DOUBLE (inclusive)] @@ -15063,7 +15063,7 @@ Reference density $\rho_0$. Units: \si{\kilogram\per\meter\cubed}. The value of the specific heat $C_p$. Units: \si{\joule\per\kelvin\per\kilogram}. -386 +398 [Double 0...MAX_DOUBLE (inclusive)] @@ -15080,7 +15080,7 @@ The value of the specific heat $C_p$. Units: \si{\joule\per\kelvin\per\kilogram} The reference temperature $T_0$. The reference temperature is used in both the density and viscosity formulas. Units: \si{\kelvin}. -385 +397 [Double 0...MAX_DOUBLE (inclusive)] @@ -15097,7 +15097,7 @@ The reference temperature $T_0$. The reference temperature is used in both the d The value of the thermal conductivity $k$. Units: \si{\watt\per\meter\per\kelvin}. -388 +400 [Double 0...MAX_DOUBLE (inclusive)] @@ -15114,7 +15114,7 @@ The value of the thermal conductivity $k$. Units: \si{\watt\per\meter\per\kelvin The value of the thermal expansion coefficient $\alpha$. Units: \si{\per\kelvin}. -387 +399 [Double 0...MAX_DOUBLE (inclusive)] @@ -15131,7 +15131,7 @@ The value of the thermal expansion coefficient $\alpha$. Units: \si{\per\kelvin} The value of the viscosity $\eta$. Units: \si{\pascal\second}. -389 +401 [Double 0...MAX_DOUBLE (inclusive)] @@ -15150,7 +15150,7 @@ true Whether to use bilinear interpolation to compute material properties (slower but more accurate). -413 +425 [Bool] @@ -15167,7 +15167,7 @@ Whether to use bilinear interpolation to compute material properties (slower but List of N prefactors that are used to modify the reference viscosity, where N is either equal to one or the number of chemical components in the simulation. If only one value is given, then all components use the same value. Units: \si{\pascal\second}. -398 +410 [Anything] @@ -15184,7 +15184,7 @@ $ASPECT_SOURCE_DIR/data/material-model/steinberger/ The path to the model data. The path may also include the special text '$ASPECT_SOURCE_DIR' which will be interpreted as the path in which the ASPECT source files were located when ASPECT was compiled. This interpretation allows, for example, to reference files located in the `data/' subdirectory of ASPECT. -409 +421 [DirectoryName] @@ -15197,7 +15197,7 @@ The path to the model data. The path may also include the special text '$AS The file names of the enthalpy derivatives data. List with as many components as active compositional fields (material data is assumed to be in order with the ordering of the fields). -411 +423 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -15214,7 +15214,7 @@ false Whether to include latent heat effects in the calculation of thermal expansivity and specific heat. If true, ASPECT follows the approach of Nakagawa et al. 2009, using pressure and temperature derivatives of the enthalpy to calculate the thermal expansivity and specific heat. If false, ASPECT uses the thermal expansivity and specific heat values from the material properties table. -414 +426 [Bool] @@ -15231,7 +15231,7 @@ temp-viscosity-prefactor.txt The file name of the lateral viscosity data. -392 +404 [Anything] @@ -15248,7 +15248,7 @@ perplex The material file format to be read in the property tables. -412 +424 [Selection perplex|hefesto ] @@ -15265,7 +15265,7 @@ pyr-ringwood88.txt The file names of the material data (material data is assumed to be in order with the ordering of the compositional fields). Note that there are three options on how many files need to be listed here: 1. If only one file is provided, it is used for the whole model domain, and compositional fields are ignored. 2. If there is one more file name than the number of compositional fields, then the first file is assumed to define a `background composition' that is modified by the compositional fields. If there are exactly as many files as compositional fields, the fields are assumed to represent the fractions of different materials and the average property is computed as a sum of the value of the compositional field times the material property of that field. -410 +422 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -15282,7 +15282,7 @@ The file names of the material data (material data is assumed to be in order wit The maximum number of substeps over the temperature pressure range to calculate the averaged enthalpy gradient over a cell. -415 +427 [Integer range 1...2147483647 (inclusive)] @@ -15299,7 +15299,7 @@ The maximum number of substeps over the temperature pressure range to calculate The relative cutoff value for lateral viscosity variations caused by temperature deviations. The viscosity may vary laterally by this factor squared. -397 +409 [Double 0...MAX_DOUBLE (inclusive)] @@ -15316,7 +15316,7 @@ The relative cutoff value for lateral viscosity variations caused by temperature The maximum thermal conductivity that is allowed in the model. Larger values will be cut off. -408 +420 [Double 0...MAX_DOUBLE (inclusive)] @@ -15333,7 +15333,7 @@ The maximum thermal conductivity that is allowed in the model. Larger values wil The maximum viscosity that is allowed in the viscosity calculation. Larger values will be cut off. -396 +408 [Double 0...MAX_DOUBLE (inclusive)] @@ -15350,7 +15350,7 @@ The maximum viscosity that is allowed in the viscosity calculation. Larger value The minimum viscosity that is allowed in the viscosity calculation. Smaller values will be cut off. -395 +407 [Double 0...MAX_DOUBLE (inclusive)] @@ -15367,7 +15367,7 @@ The minimum viscosity that is allowed in the viscosity calculation. Smaller valu Number of bands to compute laterally averaged temperature within. -394 +406 [Integer range 1...2147483647 (inclusive)] @@ -15384,7 +15384,7 @@ Number of bands to compute laterally averaged temperature within. A list of values that determine the linear scaling of the thermal conductivity with the pressure in the 'p-T-dependent' Thermal conductivity formulation. Units: \si{\watt\per\meter\per\kelvin\per\pascal}. -404 +416 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -15401,7 +15401,7 @@ radial-visc.txt The file name of the radial viscosity data. -391 +403 [Anything] @@ -15418,7 +15418,7 @@ The file name of the radial viscosity data. A list of values of reference temperatures used to determine the temperature-dependence of the thermal conductivity in the 'p-T-dependent' Thermal conductivity formulation. Units: \si{\kelvin}. -405 +417 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -15435,7 +15435,7 @@ A list of values of reference temperatures used to determine the temperature-dep A list of base values of the thermal conductivity for each of the horizontal layers in the 'p-T-dependent' Thermal conductivity formulation. Pressure- and temperature-dependence will be appliedon top of this base value, according to the parameters 'Pressure dependencies of thermal conductivity' and 'Reference temperatures for thermal conductivity'. Units: \si{\watt\per\meter\per\kelvin} -403 +415 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -15452,7 +15452,7 @@ A list of base values of the thermal conductivity for each of the horizontal lay A list of values that indicate how a given layer in the conductivity formulation should take into account the effects of saturation on the temperature-dependence of the thermal conducitivity. This factor is multiplied with a saturation function based on the theory of Roufosse and Klemens, 1974. A value of 1 reproduces the formulation of Stackhouse et al. (2015), a value of 0 reproduces the formulation of Tosi et al., (2013). Units: none. -407 +419 [List of <[Double 0...1 (inclusive)]> of length 0...4294967295 (inclusive)] @@ -15469,7 +15469,7 @@ A list of values that indicate how a given layer in the conductivity formulation The value of the thermal conductivity $k$. Only used in case the 'constant' Thermal conductivity formulation is selected. Units: \si{\watt\per\meter\per\kelvin}. -400 +412 [Double 0...MAX_DOUBLE (inclusive)] @@ -15486,7 +15486,7 @@ The value of the thermal conductivity $k$. Only used in case the 'constant& A list of exponents in the temperature-dependent term of the 'p-T-dependent' Thermal conductivity formulation. Note that this exponent is not used (and should have a value of 1) in the formulation of Stackhouse et al. (2015). Units: none. -406 +418 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -15503,7 +15503,7 @@ constant Which law should be used to compute the thermal conductivity. The 'constant' law uses a constant value for the thermal conductivity. The 'p-T-dependent' formulation uses equations from Stackhouse et al. (2015): First-principles calculations of the lattice thermal conductivity of the lower mantle (https://doi.org/10.1016/j.epsl.2015.06.050), and Tosi et al. (2013): Mantle dynamics with pressure- and temperature-dependent thermal expansivity and conductivity (https://doi.org/10.1016/j.pepi.2013.02.004) to compute the thermal conductivity in dependence of temperature and pressure. The thermal conductivity parameter sets can be chosen in such a way that either the Stackhouse or the Tosi relations are used. The conductivity description can consist of several layers with different sets of parameters. Note that the Stackhouse parametrization is only valid for the lower mantle (bridgmanite). -401 +413 [Selection constant|p-T-dependent ] @@ -15520,7 +15520,7 @@ Which law should be used to compute the thermal conductivity. The 'constant A list of depth values that indicate where the transitions between the different conductivity parameter sets should occur in the 'p-T-dependent' Thermal conductivity formulation (in most cases, this will be the depths of major mantle phase transitions). Units: \si{\meter}. -402 +414 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -15537,7 +15537,7 @@ true Whether to use the laterally averaged temperature instead of the adiabatic temperature as reference for the viscosity calculation. This ensures that the laterally averaged viscosities remain more or less constant over the model runtime. This behavior might or might not be desired. -393 +405 [Bool] @@ -15554,7 +15554,7 @@ harmonic Method to average viscosities over multiple compositional fields. One of arithmetic, harmonic, geometric or maximum composition. -399 +411 [Selection arithmetic|harmonic|geometric|maximum composition ] @@ -15573,7 +15573,7 @@ Method to average viscosities over multiple compositional fields. One of arithme List of activation energies, $E$, for background material and compositional fields, for a total of N+1 values, where N is the number of compositional fields. If only one value is given, then all use the same value. Units: \si{\joule\per\mole}. -479 +491 [Anything] @@ -15590,7 +15590,7 @@ List of activation energies, $E$, for background material and compositional fiel List of activation energies, $E_a$, for background material and compositional fields, for a total of N+1 values, where N is the number of compositional fields. If only one value is given, then all use the same value. Units: \si{\joule\per\mole}. -465 +477 [Anything] @@ -15607,7 +15607,7 @@ List of activation energies, $E_a$, for background material and compositional fi List of activation energies, $E_a$, for background material and compositional fields, for a total of N+1 values, where N is the number of compositional fields. If only one value is given, then all use the same value. Units: \si{\joule\per\mole}. -470 +482 [Anything] @@ -15624,7 +15624,7 @@ List of activation energies, $E_a$, for background material and compositional fi List of activation volumes, $V$, for background material and compositional fields, for a total of N+1 values, where N is the number of compositional fields. If only one value is given, then all use the same value. Units: \si{\meter\cubed\per\mole}. -480 +492 [Anything] @@ -15641,7 +15641,7 @@ List of activation volumes, $V$, for background material and compositional field List of activation volumes, $V_a$, for background material and compositional fields, for a total of N+1 values, where N is the number of compositional fields. If only one value is given, then all use the same value. Units: \si{\meter\cubed\per\mole}. -466 +478 [Anything] @@ -15658,7 +15658,7 @@ List of activation volumes, $V_a$, for background material and compositional fie List of activation volumes, $V_a$, for background material and compositional fields, for a total of N+1 values, where N is the number of compositional fields. If only one value is given, then all use the same value. Units: \si{\meter\cubed\per\mole}. -471 +483 [Anything] @@ -15675,7 +15675,7 @@ List of activation volumes, $V_a$, for background material and compositional fie Add an adiabatic temperature gradient to the temperature used in the flow law so that the activation volume is consistent with what one would use in a earth-like (compressible) model. Default is set so this is off. Note that this is a linear approximation of the real adiabatic gradient, which is okay for the upper mantle, but is not really accurate for the lower mantle. Using a pressure gradient of 32436 Pa/m, then a value of 0.3 K/km = 0.0003 K/m = 9.24e-09 K/Pa gives an earth-like adiabat.Units: \si{\kelvin\per\pascal}. -495 +507 [Double 0...MAX_DOUBLE (inclusive)] @@ -15692,7 +15692,7 @@ false Whether to allow negative pressures to be used in the computation of plastic yield stresses and viscosities. Setting this parameter to true may be advantageous in models without gravity where the dynamic stresses are much higher than the lithostatic pressure. If false, the minimum pressure in the plasticity formulation will be set to zero. -460 +472 [Bool] @@ -15709,7 +15709,7 @@ Whether to allow negative pressures to be used in the computation of plastic yie List of angles of internal friction, $\phi$, for background material and compositional fields, for a total of N+1 values, where N is the number of compositional fields. For a value of zero, in 2d the von Mises criterion is retrieved. Angles higher than 30 degrees are harder to solve numerically. Units: degrees. -489 +501 [Anything] @@ -15726,7 +15726,7 @@ false Whether the cutoff stresses for Peierls creep are used as the minimum stresses in the Peierls rheology -486 +498 [Bool] @@ -15743,7 +15743,7 @@ Whether the cutoff stresses for Peierls creep are used as the minimum stresses i List of cohesion strain weakening factors for background material and compositional fields, for a total of N+1 values, where N is the number of compositional fields. If only one value is given, then all use the same value. Units: None. -432 +444 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -15760,7 +15760,7 @@ List of cohesion strain weakening factors for background material and compositio List of cohesions, $C$, for background material and compositional fields, for a total of N+1 values, where N is the number of compositional fields. The extremely large default cohesion value (1e20 Pa) prevents the viscous stress from exceeding the yield stress. Units: \si{\pascal}. -490 +502 [Anything] @@ -15777,7 +15777,7 @@ List of cohesions, $C$, for background material and compositional fields, for a List of constant viscosity prefactors (i.e., multiplicative factors) for background material and compositional fields, for a total of N+1 where N is the number of compositional fields. Units: none. -488 +500 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -15794,7 +15794,7 @@ List of constant viscosity prefactors (i.e., multiplicative factors) for backgro List of the Stress thresholds below which the strain rate is solved for as a quadratic function of stress to aid with convergence when stress exponent n=0. Units: \si{\pascal} -485 +497 [Anything] @@ -15811,7 +15811,7 @@ false Whether to directly define thermal conductivities for each compositional field instead of calculating the values through the specified thermal diffusivities, densities, and heat capacities. -497 +509 [Bool] @@ -15828,7 +15828,7 @@ true Whether to list phase transitions by depth or pressure. If this parameter is true, then the input file will use Phase transitions depths and Phase transition widths to define the phase transition. If it is false, the parameter file will read in phase transition data from Phase transition pressures and Phase transition pressure widths. -420 +432 [Bool] @@ -15845,7 +15845,7 @@ Whether to list phase transitions by depth or pressure. If this parameter is tru List of densities for background mantle and compositional fields,for a total of N+M+1 values, where N is the number of compositional fields and M is the number of phases. If only one value is given, then all use the same value. Units: \si{\kilogram\per\meter\cubed}. -426 +438 [Anything] @@ -15862,7 +15862,7 @@ List of densities for background mantle and compositional fields,for a total of List of dynamic angles of internal friction, $\phi$, for background material and compositional fields, for a total of N$+$1 values, where N is the number of compositional fields. Dynamic angles of friction are used as the current friction angle when the effective strain rate is well above the 'dynamic characteristic strain rate'. Units: \si{\degree}. -442 +454 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -15879,7 +15879,7 @@ List of dynamic angles of internal friction, $\phi$, for background material and The characteristic strain rate value at which the angle of friction is equal to $\mu = (\mu_s+\mu_d)/2$. When the effective strain rate is very high, the dynamic angle of friction is taken, when it is very low, the static angle of internal friction is used. Around the dynamic characteristic strain rate, there is a smooth gradient from the static to the dynamic angle of internal friction. Units: \si{\per\second}. -441 +453 [Double 0...MAX_DOUBLE (inclusive)] @@ -15896,7 +15896,7 @@ The characteristic strain rate value at which the angle of friction is equal to An exponential factor in the equation for the calculation of the friction angle when a static and a dynamic angle of internal friction are specified. A factor of 1 returns the equation to Equation (13) in \cite{van_dinther_seismic_2013}. A factor between 0 and 1 makes the curve of the friction angle vs. the strain rate smoother, while a factor $>$ 1 makes the change between static and dynamic friction angle more steplike. Units: none. -443 +455 [Double 0...MAX_DOUBLE (inclusive)] @@ -15913,7 +15913,7 @@ An exponential factor in the equation for the calculation of the friction angle Viscosity of a viscous damper that acts in parallel with the elastic element to stabilize behavior. Units: \si{\pascal\second} -452 +464 [Double 0...MAX_DOUBLE (inclusive)] @@ -15930,7 +15930,7 @@ Viscosity of a viscous damper that acts in parallel with the elastic element to List of elastic shear moduli, $G$, for background material and compositional fields, for a total of N+1 values, where N is the number of compositional fields. The default value of 75 GPa is representative of mantle rocks. Units: Pa. -448 +460 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -15947,7 +15947,7 @@ List of elastic shear moduli, $G$, for background material and compositional fie List of strain weakening interval final strains for the cohesion and friction angle parameters of the background material and compositional fields, for a total of N+1 values, where N is the number of compositional fields. If only one value is given, then all use the same value. Units: None. -431 +443 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -15964,7 +15964,7 @@ List of strain weakening interval final strains for the cohesion and friction an List of strain weakening interval final strains for the diffusion and dislocation prefactor parameters of the background material and compositional fields, for a total of N+1 values, where N is the number of compositional fields. If only one value is given, then all use the same value. Units: None. -435 +447 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -15981,7 +15981,7 @@ List of strain weakening interval final strains for the diffusion and dislocatio The fixed elastic time step $dte$. Units: years if the 'Use years in output instead of seconds' parameter is set; seconds otherwise. -450 +462 [Double 0...MAX_DOUBLE (inclusive)] @@ -16004,7 +16004,7 @@ Whether to make the friction angle dependent on strain rate or not. This rheolog \item ``function'': Specify the friction angle as a function of space and time for each compositional field. -440 +452 [Selection none|dynamic friction|function ] @@ -16021,7 +16021,7 @@ Whether to make the friction angle dependent on strain rate or not. This rheolog List of friction strain weakening factors for background material and compositional fields, for a total of N+1 values, where N is the number of compositional fields. If only one value is given, then all use the same value. Units: None. -433 +445 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -16038,7 +16038,7 @@ List of friction strain weakening factors for background material and compositio Units: \si{\meter}. -467 +479 [Double 0...MAX_DOUBLE (inclusive)] @@ -16055,7 +16055,7 @@ Units: \si{\meter}. List of grain size exponents, $m_{\text{diffusion}}$, for background material and compositional fields, for a total of N+1 values, where N is the number of compositional fields. If only one value is given, then all use the same value. Units: None. -464 +476 [Anything] @@ -16072,7 +16072,7 @@ List of grain size exponents, $m_{\text{diffusion}}$, for background material an List of specific heats $C_p$ for background mantle and compositional fields,for a total of N+M+1 values, where N is the number of compositional fields and M is the number of phases. If only one value is given, then all use the same value. Units: \si{\joule\per\kelvin\per\kilogram}. -428 +440 [Anything] @@ -16089,7 +16089,7 @@ false Whether to include Peierls creep in the rheological formulation. -487 +499 [Bool] @@ -16106,7 +16106,7 @@ Whether to include Peierls creep in the rheological formulation. Maximum number of iterations to find the correct Peierls strain rate. -476 +488 [Integer range 0...2147483647 (inclusive)] @@ -16123,7 +16123,7 @@ Maximum number of iterations to find the correct Peierls strain rate. Upper cutoff for effective viscosity. Units: \si{\pascal\second}. List with as many components as active compositional fields (material data is assumed to be in order with the ordering of the fields). -456 +468 [Anything] @@ -16140,7 +16140,7 @@ Upper cutoff for effective viscosity. Units: \si{\pascal\second}. List with as m Limits the maximum value of the yield stress determined by the Drucker-Prager plasticity parameters. Default value is chosen so this is not automatically used. Values of 100e6--1000e6 $Pa$ have been used in previous models. Units: \si{\pascal}. -491 +503 [Double 0...MAX_DOUBLE (inclusive)] @@ -16157,7 +16157,7 @@ Limits the maximum value of the yield stress determined by the Drucker-Prager pl Stabilizes strain dependent viscosity. Units: \si{\per\second}. -453 +465 [Double 0...MAX_DOUBLE (inclusive)] @@ -16174,7 +16174,7 @@ Stabilizes strain dependent viscosity. Units: \si{\per\second}. Lower cutoff for effective viscosity. Units: \si{\pascal\second}. List with as many components as active compositional fields (material data is assumed to be in order with the ordering of the fields). -455 +467 [Anything] @@ -16191,7 +16191,7 @@ viscosity approximation Select what type of Peierls creep flow law to use. Currently, the available options are 'exact', which uses a Newton-Raphson iterative method to find the stress and then compute viscosity, and 'viscosity approximation', in which viscosity is an explicit function of the strain rate invariant, rather than stress. -474 +486 [Selection viscosity approximation|exact ] @@ -16208,7 +16208,7 @@ Select what type of Peierls creep flow law to use. Currently, the available opti List of fitting parameters $\gamma$ between stress $\sigma$ and the Peierls stress $\sigma_{\text{peierls}}$ for background material and compositional fields, for a total of N+1 values, where N is the number of compositional fields. If only one value is given, then all use the same value. Units: none -482 +494 [Anything] @@ -16225,7 +16225,7 @@ List of fitting parameters $\gamma$ between stress $\sigma$ and the Peierls stre List of the first Peierls creep glide parameters, $p$, for background and compositional fields for a total of N+1 values, where N is the number of compositional fields. If only one value is given, then all use the same value. Units: none -483 +495 [Anything] @@ -16242,7 +16242,7 @@ List of the first Peierls creep glide parameters, $p$, for background and compos List of the second Peierls creep glide parameters, $q$, for background and compositional fields for a total of N+1 values, where N is the number of compositional fields. If only one value is given, then all use the same value. Units: none -484 +496 [Anything] @@ -16259,7 +16259,7 @@ List of the second Peierls creep glide parameters, $q$, for background and compo Tolerance for the iterative solve to find the correct Peierls creep strain rate. -475 +487 [Double 0...MAX_DOUBLE (inclusive)] @@ -16276,7 +16276,7 @@ Tolerance for the iterative solve to find the correct Peierls creep strain rate. List of stress limits for Peierls creep $\sigma_{\text{peierls}}$ for background material and compositional fields, for a total of N+1 values, where N is the number of compositional fields. If only one value is given, then all use the same value. Units: \si{\pascal} -481 +493 [Anything] @@ -16289,7 +16289,7 @@ List of stress limits for Peierls creep $\sigma_{\text{peierls}}$ for background A list of Clapeyron slopes for each phase transition. A positive Clapeyron slope indicates that the phase transition will occur in a greater depth, if the temperature is higher than the one given in Phase transition temperatures and in a smaller depth, if the temperature is smaller than the one given in Phase transition temperatures. For negative slopes the other way round. List must have the same number of entries as Phase transition depths. Units: \si{\pascal\per\kelvin}. -424 +436 [Anything] @@ -16302,7 +16302,7 @@ A list of Clapeyron slopes for each phase transition. A positive Clapeyron slope A list of depths where phase transitions occur. Values must monotonically increase. Units: \si{\meter}. -416 +428 [Anything] @@ -16315,7 +16315,7 @@ A list of depths where phase transitions occur. Values must monotonically increa A list of widths for each phase transition, in terms of pressure. The phase functions are scaled with these values, leading to a jump between phases for a value of zero and a gradual transition for larger values. List must have the same number of entries as Phase transition pressures. Define transition by depth instead of pressure must be set to false to use this parameter. Units: \si{\pascal}. -419 +431 [Anything] @@ -16328,7 +16328,7 @@ A list of widths for each phase transition, in terms of pressure. The phase func A list of pressures where phase transitions occur. Values must monotonically increase. Define transition by depth instead of pressure must be set to false to use this parameter. Units: \si{\pascal}. -418 +430 [Anything] @@ -16345,7 +16345,7 @@ A list of pressures where phase transitions occur. Values must monotonically inc A list of lower temperature limits for each phase transition. Below this temperature the respective phase transition is deactivated. The default value means there is no lower limit for any phase transition. List must have the same number of entries as Phase transition depths. When the optional temperature limits are applied, the user has to be careful about the consistency between adjacent phases. Phase transitions should be continuous in pressure-temperature space. We recommend producing a phase diagram with simple model setups to check the implementation as a starting point.Units: \si{\kelvin}. -423 +435 [Anything] @@ -16362,7 +16362,7 @@ A list of lower temperature limits for each phase transition. Below this tempera A list of upper temperature limits for each phase transition. Above this temperature the respective phase transition is deactivated. The default value means there is no upper limit for any phase transitions. List must have the same number of entries as Phase transition depths. When the optional temperature limits are applied, the user has to be careful about the consistency between adjacent phases. Phase transitions should be continuous in pressure-temperature space. We recommend producing a phase diagram with simple model setups to check the implementation as a starting point.Units: \si{\kelvin}. -422 +434 [Anything] @@ -16375,7 +16375,7 @@ A list of upper temperature limits for each phase transition. Above this tempera A list of temperatures where phase transitions occur. Higher or lower temperatures lead to phase transition occurring in smaller or greater depths than given in Phase transition depths, depending on the Clapeyron slope given in Phase transition Clapeyron slopes. List must have the same number of entries as Phase transition depths. Units: \si{\kelvin}. -421 +433 [Anything] @@ -16388,7 +16388,7 @@ A list of temperatures where phase transitions occur. Higher or lower temperatur A list of widths for each phase transition, in terms of depth. The phase functions are scaled with these values, leading to a jump between phases for a value of zero and a gradual transition for larger values. List must have the same number of entries as Phase transition depths. Units: \si{\meter}. -417 +429 [Anything] @@ -16405,7 +16405,7 @@ A list of widths for each phase transition, in terms of depth. The phase functio Viscosity of the damper that acts in parallel with the plastic viscosity to produce mesh-independent behavior at sufficient resolutions. Units: \si{\pascal\second} -493 +505 [Double 0...MAX_DOUBLE (inclusive)] @@ -16422,7 +16422,7 @@ Viscosity of the damper that acts in parallel with the plastic viscosity to prod List of viscous strain weakening factors for background material and compositional fields, for a total of N+1 values, where N is the number of compositional fields. If only one value is given, then all use the same value. Units: None. -436 +448 [List of <[Double 0...1 (inclusive)]> of length 0...4294967295 (inclusive)] @@ -16439,7 +16439,7 @@ List of viscous strain weakening factors for background material and composition A viscosity prefactor for the viscosity approximation, for a total of N+1 values, where N is the number of compositional fields. If only one value is given, then all use the same value. Units: None -473 +485 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -16456,7 +16456,7 @@ A viscosity prefactor for the viscosity approximation, for a total of N+1 values List of viscosity prefactors, $A$, for background material and compositional fields, for a total of N+1 values, where N is the number of compositional fields. If only one value is given, then all use the same value. Units: \si{\pascal}$^{-n_{\text{peierls}}}$ \si{\per\second} -477 +489 [Anything] @@ -16473,7 +16473,7 @@ List of viscosity prefactors, $A$, for background material and compositional fie List of viscosity prefactors, $A$, for background material and compositional fields, for a total of N+1 values, where N is the number of compositional fields. If only one value is given, then all use the same value. Units: \si{\per\pascal\meter}$^{m_{\text{diffusion}}}$\si{\per\second}. -462 +474 [Anything] @@ -16490,7 +16490,7 @@ List of viscosity prefactors, $A$, for background material and compositional fie List of viscosity prefactors, $A$, for background material and compositional fields, for a total of N+1 values, where N is the number of compositional fields. If only one value is given, then all use the same value. Units: \si{\pascal}$^{-n_{\text{dislocation}}}$ \si{\per\second}. -468 +480 [Anything] @@ -16507,7 +16507,7 @@ List of viscosity prefactors, $A$, for background material and compositional fie Reference strain rate for first time step. Units: \si{\per\second}. -454 +466 [Double 0...MAX_DOUBLE (inclusive)] @@ -16524,7 +16524,7 @@ Reference strain rate for first time step. Units: \si{\per\second}. The reference temperature $T_0$. Units: \si{\kelvin}. -425 +437 [Double 0...MAX_DOUBLE (inclusive)] @@ -16549,7 +16549,7 @@ false A stabilization factor for the elastic stresses that influences how fast elastic stresses adjust to deformation. 1.0 is equivalent to no stabilization and may lead to oscillatory motion. Setting the factor to 2 avoids oscillations, but still enables an immediate elastic response. However, in complex models this can lead to problems of convergence, in which case the factor needs to be increased slightly. Setting the factor to infinity is equivalent to not applying elastic stresses at all. The factor is multiplied with the computational time step to create a time scale. -451 +463 [Double 1...MAX_DOUBLE (inclusive)] @@ -16566,7 +16566,7 @@ A stabilization factor for the elastic stresses that influences how fast elastic List of strain weakening interval initial strains for the cohesion and friction angle parameters of the background material and compositional fields, for a total of N+1 values, where N is the number of compositional fields. If only one value is given, then all use the same value. Units: None. -430 +442 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -16583,7 +16583,7 @@ List of strain weakening interval initial strains for the cohesion and friction List of strain weakening interval initial strains for the diffusion and dislocation prefactor parameters of the background material and compositional fields, for a total of N+1 values, where N is the number of compositional fields. If only one value is given, then all use the same value. Units: None. -434 +446 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -16604,7 +16604,7 @@ Whether to apply strain healing to plastic yielding and viscosity terms, and if \item ``temperature dependent'': Purely temperature dependent strain healing applied to plastic yielding and viscosity terms, similar to the temperature-dependent Frank Kamenetskii formulation, computes strain healing as removing strain as a function of temperature, time, and a user-defined healing rate and prefactor as done in Fuchs and Becker, 2019, for mantle convection -437 +449 [Selection no healing|temperature dependent ] @@ -16621,7 +16621,7 @@ Whether to apply strain healing to plastic yielding and viscosity terms, and if Prefactor for temperature dependent strain healing. Units: None -439 +451 [Double 0...MAX_DOUBLE (inclusive)] @@ -16638,7 +16638,7 @@ Prefactor for temperature dependent strain healing. Units: None Recovery rate prefactor for temperature dependent strain healing. Units: $1/s$ -438 +450 [Double 0...MAX_DOUBLE (inclusive)] @@ -16673,7 +16673,7 @@ Whether to apply strain weakening to viscosity, cohesion and internal angleof fr If a compositional field named 'noninitial\_plastic\_strain' is included in the parameter file, this field will automatically be excluded from from volume fraction calculation and track the cumulative plastic strain with the initial plastic strain values removed. -429 +441 [Selection none|finite strain tensor|total strain|plastic weakening with plastic strain only|plastic weakening with total strain only|plastic weakening with plastic strain and viscous weakening with viscous strain|viscous weakening with viscous strain only|default ] @@ -16690,7 +16690,7 @@ If a compositional field named 'noninitial\_plastic\_strain' is includ List of stress exponents, $n_{\text{peierls}}$, for background material and compositional fields, for a total of N+1 values, where N is the number of compositional fields. If only one value is given, then all use the same value. Units: None. -478 +490 [Anything] @@ -16707,7 +16707,7 @@ List of stress exponents, $n_{\text{peierls}}$, for background material and comp List of stress exponents, $n_{\text{diffusion}}$, for background mantle and compositional fields, for a total of N+1 values, where N is the number of compositional fields. The stress exponent for diffusion creep is almost always equal to one. If only one value is given, then all use the same value. Units: None. -463 +475 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -16724,7 +16724,7 @@ List of stress exponents, $n_{\text{diffusion}}$, for background mantle and comp List of stress exponents, $n_{\text{dislocation}}$, for background material and compositional fields, for a total of N+1 values, where N is the number of compositional fields. If only one value is given, then all use the same value. Units: None. -469 +481 [Anything] @@ -16741,7 +16741,7 @@ List of stress exponents, $n_{\text{dislocation}}$, for background material and List of stress limiter exponents, $n_{\text{lim}}$, for background material and compositional fields, for a total of N+1 values, where N is the number of compositional fields. Units: none. -494 +506 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -16758,7 +16758,7 @@ List of stress limiter exponents, $n_{\text{lim}}$, for background material and List of thermal conductivities, for background material and compositional fields, for a total of N+1 values, where N is the number of compositional fields. If only one value is given, then all use the same value. Units: \si{\watt\per\meter\per\kelvin}. -498 +510 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -16775,7 +16775,7 @@ List of thermal conductivities, for background material and compositional fields List of thermal diffusivities, for background material and compositional fields, for a total of N+1 values, where N is the number of compositional fields. If only one value is given, then all use the same value. Units: \si{\meter\squared\per\second}. -496 +508 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -16792,7 +16792,7 @@ List of thermal diffusivities, for background material and compositional fields, List of thermal expansivities for background mantle and compositional fields,for a total of N+M+1 values, where N is the number of compositional fields and M is the number of phases. If only one value is given, then all use the same value. Units: \si{\per\kelvin}. -427 +439 [Anything] @@ -16809,7 +16809,7 @@ false Whether to use the adiabatic pressure instead of the full pressure (default) when calculating creep (diffusion, dislocation, and peierls) viscosity. This may be helpful in models where the full pressure has an unusually large negative value arising from large negative dynamic pressure, resulting in solver convergence issue and in some cases a viscosity of zero. -461 +473 [Bool] @@ -16826,7 +16826,7 @@ unspecified Select whether the material time scale in the viscoelastic constitutive relationship uses the regular numerical time step or a separate fixed elastic time step throughout the model run. The fixed elastic time step is always used during the initial time step. If a fixed elastic time step is used throughout the model run, a stress averaging scheme is applied to account for differences with the numerical time step. An alternative approach is to limit the maximum time step size so that it is equal to the elastic time step. The default value of this parameter is 'unspecified', which throws an exception during runtime. In order for the model to run the user must select 'true' or 'false'. -449 +461 [Selection true|false|unspecified ] @@ -16843,7 +16843,7 @@ false Whether to use a plastic damper when computing the Drucker-Prager plastic viscosity. The damper acts to stabilize the plastic shear band width and remove associated mesh-dependent behavior at sufficient resolutions. -492 +504 [Bool] @@ -16860,7 +16860,7 @@ harmonic When more than one compositional field is present at a point with different viscosities, we need to come up with an average viscosity at that point. Select a weighted harmonic, arithmetic, geometric, or maximum composition. -457 +469 [Selection arithmetic|harmonic|geometric|maximum composition ] @@ -16877,7 +16877,7 @@ When more than one compositional field is present at a point with different visc An adjusted viscosity ratio, $E$, for the viscosity approximation, for a total of N+1 values, where N is the number of compositional fields. If only one value is given, then all use the same value. Units: None -472 +484 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -16894,7 +16894,7 @@ composite Select what type of viscosity law to use between diffusion, dislocation, frank kamenetskii, and composite options. Soon there will be an option to select a specific flow law for each assigned composition -458 +470 [Selection diffusion|dislocation|frank kamenetskii|composite ] @@ -16911,7 +16911,7 @@ drucker Select what type of yield mechanism to use between Drucker Prager and stress limiter options. -459 +471 [Selection drucker|limiter ] @@ -16929,7 +16929,7 @@ cartesian A selection that determines the assumed coordinate system for the function variables. Allowed values are `cartesian', `spherical', and `depth'. `spherical' coordinates are interpreted as r,phi or r,phi,theta in 2d/3d respectively with theta being the polar angle. `depth' will create a function, in which only the first parameter is non-zero, which is interpreted to be the depth of the point. -444 +456 [Selection cartesian|spherical|depth ] @@ -16944,7 +16944,7 @@ Sometimes it is convenient to use symbolic constants in the expression that desc A typical example would be to set this runtime parameter to `pi=3.1415926536' and then use `pi' in the expression of the actual formula. (That said, for convenience this class actually defines both `pi' and `Pi' by default, but you get the idea.) -447 +459 [Anything] @@ -16963,7 +16963,7 @@ The formula that denotes the function you want to evaluate for particular values If the function you are describing represents a vector-valued function with multiple components, then separate the expressions for individual components by a semicolon. -446 +458 [Anything] @@ -16980,7 +16980,7 @@ x,y,t The names of the variables as they will be used in the function, separated by commas. By default, the names of variables at which the function will be evaluated are `x' (in 1d), `x,y' (in 2d) or `x,y,z' (in 3d) for spatial coordinates and `t' for time. You can then use these variable names in your function expression and they will be replaced by the values of these variables at which the function is currently evaluated. However, you can also choose a different set of names for the independent variables at which to evaluate your function expression. For example, if you work in spherical coordinates, you may wish to set this input parameter to `r,phi,theta,t' and then use these variable names in your function expression. -445 +457 [Anything] @@ -17000,7 +17000,7 @@ The names of the variables as they will be used in the function, separated by co List of densities for background mantle and compositional fields,for a total of N+M+1 values, where N is the number of compositional fields and M is the number of phases. If only one value is given, then all use the same value. Units: \si{\kilogram\per\meter\cubed}. -500 +512 [Anything] @@ -17017,7 +17017,7 @@ List of densities for background mantle and compositional fields,for a total of Viscosity of a viscous damper that acts in parallel with the elastic element to stabilize behavior. Units: \si{\pascal\second} -507 +519 [Double 0...MAX_DOUBLE (inclusive)] @@ -17034,7 +17034,7 @@ Viscosity of a viscous damper that acts in parallel with the elastic element to List of elastic shear moduli, $G$, for background material and compositional fields, for a total of N+1 values, where N is the number of compositional fields. The default value of 75 GPa is representative of mantle rocks. Units: Pa. -503 +515 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -17051,7 +17051,7 @@ List of elastic shear moduli, $G$, for background material and compositional fie The fixed elastic time step $dte$. Units: years if the 'Use years in output instead of seconds' parameter is set; seconds otherwise. -505 +517 [Double 0...MAX_DOUBLE (inclusive)] @@ -17068,7 +17068,7 @@ The fixed elastic time step $dte$. Units: years if the 'Use years in output List of specific heats $C_p$ for background mantle and compositional fields,for a total of N+M+1 values, where N is the number of compositional fields and M is the number of phases. If only one value is given, then all use the same value. Units: \si{\joule\per\kelvin\per\kilogram}. -502 +514 [Anything] @@ -17085,7 +17085,7 @@ List of specific heats $C_p$ for background mantle and compositional fields,for The reference temperature $T_0$. Units: \si{\kelvin}. -499 +511 [Double 0...MAX_DOUBLE (inclusive)] @@ -17110,7 +17110,7 @@ false A stabilization factor for the elastic stresses that influences how fast elastic stresses adjust to deformation. 1.0 is equivalent to no stabilization and may lead to oscillatory motion. Setting the factor to 2 avoids oscillations, but still enables an immediate elastic response. However, in complex models this can lead to problems of convergence, in which case the factor needs to be increased slightly. Setting the factor to infinity is equivalent to not applying elastic stresses at all. The factor is multiplied with the computational time step to create a time scale. -506 +518 [Double 1...MAX_DOUBLE (inclusive)] @@ -17127,7 +17127,7 @@ A stabilization factor for the elastic stresses that influences how fast elastic List of thermal conductivities for background mantle and compositional fields, for a total of N+1 values, where N is the number of compositional fields. If only one value is given, then all use the same value. Units: \si{\watt\per\meter\per\kelvin}. -509 +521 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -17144,7 +17144,7 @@ List of thermal conductivities for background mantle and compositional fields, f List of thermal expansivities for background mantle and compositional fields,for a total of N+M+1 values, where N is the number of compositional fields and M is the number of phases. If only one value is given, then all use the same value. Units: \si{\per\kelvin}. -501 +513 [Anything] @@ -17161,7 +17161,7 @@ unspecified Select whether the material time scale in the viscoelastic constitutive relationship uses the regular numerical time step or a separate fixed elastic time step throughout the model run. The fixed elastic time step is always used during the initial time step. If a fixed elastic time step is used throughout the model run, a stress averaging scheme is applied to account for differences with the numerical time step. An alternative approach is to limit the maximum time step size so that it is equal to the elastic time step. The default value of this parameter is 'unspecified', which throws an exception during runtime. In order for the model to run the user must select 'true' or 'false'. -504 +516 [Selection true|false|unspecified ] @@ -17178,7 +17178,7 @@ Select whether the material time scale in the viscoelastic constitutive relation List of viscosities for background mantle and compositional fields, for a total of N+1 values, where N is the number of compositional fields. If only one value is given, then all use the same value. Units: \si{\pascal\second}. -508 +520 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -17195,7 +17195,7 @@ harmonic When more than one compositional field is present at a point with different viscosities, we need to come up with an average viscosity at that point. Select a weighted harmonic, arithmetic, geometric, or maximum composition. -510 +522 [Selection arithmetic|harmonic|geometric|maximum composition ] @@ -17345,7 +17345,7 @@ $ASPECT_SOURCE_DIR/data/geometry-model/initial-topography-model/ascii-data/test/ The name of a directory that contains the model data. This path may either be absolute (if starting with a `/') or relative to the current directory. The path may also include the special text `$ASPECT_SOURCE_DIR' which will be interpreted as the path in which the ASPECT source files were located when ASPECT was compiled. This interpretation allows, for example, to reference files located in the `data/' subdirectory of ASPECT. -124 +126 [DirectoryName] @@ -17362,7 +17362,7 @@ box_3d_%s.0.txt The file name of the model data. -125 +127 [Anything] @@ -17379,7 +17379,7 @@ The file name of the model data. Scalar factor, which is applied to the model data. You might want to use this to scale the input to a reference model. Another way to use this factor is to convert units of the input files. For instance, if you provide velocities in cm/yr set this factor to 0.01. -126 +128 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -17396,7 +17396,7 @@ Sometimes it is convenient to use symbolic constants in the expression that desc A typical example would be to set this runtime parameter to `pi=3.1415926536' and then use `pi' in the expression of the actual formula. (That said, for convenience this class actually defines both `pi' and `Pi' by default, but you get the idea.) -123 +125 [Anything] @@ -17415,7 +17415,7 @@ The formula that denotes the function you want to evaluate for particular values If the function you are describing represents a vector-valued function with multiple components, then separate the expressions for individual components by a semicolon. -122 +124 [Anything] @@ -17432,7 +17432,7 @@ x,y,t The names of the variables as they will be used in the function, separated by commas. By default, the names of variables at which the function will be evaluated are `x' (in 1d), `x,y' (in 2d) or `x,y,z' (in 3d) for spatial coordinates and `t' for time. You can then use these variable names in your function expression and they will be replaced by the values of these variables at which the function is currently evaluated. However, you can also choose a different set of names for the independent variables at which to evaluate your function expression. For example, if you work in spherical coordinates, you may wish to set this input parameter to `r,phi,theta,t' and then use these variable names in your function expression. -121 +123 [Anything] @@ -17451,7 +17451,7 @@ The names of the variables as they will be used in the function, separated by co The hillslope transport coefficient $\kappa$ used to diffuse the free surface, either as a stabilization step or to mimic erosional and depositional processes. Units: $\si{m^2/s}$. -127 +120 [Double 0...MAX_DOUBLE (inclusive)] @@ -17468,7 +17468,7 @@ The hillslope transport coefficient $\kappa$ used to diffuse the free surface, e The number of time steps between each application of diffusion. -128 +121 [Integer range 0...2147483647 (inclusive)] @@ -17504,7 +17504,7 @@ normal After each time step the free surface must be advected in the direction of the velocity field. Mass conservation requires that the mesh velocity is in the normal direction of the surface. However, for steep topography or large curvature, advection in the normal direction can become ill-conditioned, and instabilities in the mesh can form. Projection of the mesh velocity onto the local vertical direction can preserve the mesh quality better, but at the cost of slightly poorer mass conservation of the domain. -120 +122 [Selection normal|vertical ] @@ -17865,7 +17865,7 @@ A list of scaling factors by which every individual compositional field will be If the list of scaling factors given in this parameter is empty, then this indicates that they should all be chosen equal to 0. If the list is not empty then it needs to have as many entries as there are compositional fields. -351 +352 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -17882,7 +17882,7 @@ If the list of scaling factors given in this parameter is empty, then this indic A scaling factor for the artificial viscosity of the temperature equation. Use 0.0 to disable. -350 +351 [Double 0...MAX_DOUBLE (inclusive)] @@ -17899,7 +17899,7 @@ A comma separated list of names denoting those boundaries where there should be The names of the boundaries listed here can either be numbers (in which case they correspond to the numerical boundary indicators assigned by the geometry object), or they can correspond to any of the symbolic names the geometry object may have provided for each part of the boundary. You may want to compare this with the documentation of the geometry model you use in your model. -352 +353 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -17918,7 +17918,7 @@ The names of the boundaries listed here can either be numbers (in which case the The desired ratio between compaction length and size of the mesh cells, or, in other words, how many cells the mesh should (at least) have per compaction length. Every cell where this ratio is smaller than the value specified by this parameter (in places with fewer mesh cells per compaction length) is marked for refinement. -353 +354 [Double 0...MAX_DOUBLE (inclusive)] @@ -17935,7 +17935,7 @@ A list of scaling factors by which every individual compositional field will be If the list of scaling factors given in this parameter is empty, then this indicates that they should all be chosen equal to one. If the list is not empty then it needs to have as many entries as there are compositional fields. -354 +342 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -17952,7 +17952,7 @@ A list of scaling factors by which every individual compositional field gradient If the list of scaling factors given in this parameter is empty, then this indicates that they should all be chosen equal to one. If the list is not empty then it needs to have as many entries as there are compositional fields. -338 +343 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -17969,7 +17969,7 @@ A list of scaling factors by which every individual compositional field gradient If the list of scaling factors given in this parameter is empty, then this indicates that they should all be chosen equal to one. If the list is not empty then it needs to have as many entries as there are compositional fields. -339 +344 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -17984,7 +17984,7 @@ If the list of scaling factors given in this parameter is empty, then this indic A list of thresholds that every individual compositional field will be evaluated against. -340 +345 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -18001,7 +18001,7 @@ A list of isosurfaces separated by semi-colons (;). Each isosurface entry consis The first two entries for each isosurface, describing the minimum and maximum grid levels, can be two numbers or contain one of the key values 'min' and 'max'. This indicates the key will be replaced with the global minimum and maximum refinement levels. The 'min' and 'max' keys also accept adding values to be added or subtracted from them respectively. This is done by adding a '+' or '-' and a number behind them (e.g. min+2 or max-1). Note that you can't subtract a value from a minimum value or add a value to the maximum value. If, for example, `max-4` drops below the minimum or `min+4` goes above the maximum, it will simply use the global minimum and maximum values respectively. The same holds for any mesh refinement level below the global minimum or above the global maximum. -341 +346 [Anything] @@ -18020,7 +18020,7 @@ depth A selection that determines the assumed coordinate system for the function variables. Allowed values are `depth', `cartesian' and `spherical'. `depth' will create a function, in which only the first variable is non-zero, which is interpreted to be the depth of the point. `spherical' coordinates are interpreted as r,phi or r,phi,theta in 2d/3d respectively with theta being the polar angle. -342 +347 [Selection depth|cartesian|spherical ] @@ -18035,7 +18035,7 @@ Sometimes it is convenient to use symbolic constants in the expression that desc A typical example would be to set this runtime parameter to `pi=3.1415926536' and then use `pi' in the expression of the actual formula. (That said, for convenience this class actually defines both `pi' and `Pi' by default, but you get the idea.) -345 +350 [Anything] @@ -18054,7 +18054,7 @@ The formula that denotes the function you want to evaluate for particular values If the function you are describing represents a vector-valued function with multiple components, then separate the expressions for individual components by a semicolon. -344 +349 [Anything] @@ -18071,7 +18071,7 @@ x,y,t The names of the variables as they will be used in the function, separated by commas. By default, the names of variables at which the function will be evaluated are `x' (in 1d), `x,y' (in 2d) or `x,y,z' (in 3d) for spatial coordinates and `t' for time. You can then use these variable names in your function expression and they will be replaced by the values of these variables at which the function is currently evaluated. However, you can also choose a different set of names for the independent variables at which to evaluate your function expression. For example, if you work in spherical coordinates, you may wish to set this input parameter to `r,phi,theta,t' and then use these variable names in your function expression. -343 +348 [Anything] @@ -18090,7 +18090,7 @@ depth A selection that determines the assumed coordinate system for the function variables. Allowed values are `depth', `cartesian' and `spherical'. `depth' will create a function, in which only the first variable is non-zero, which is interpreted to be the depth of the point. `spherical' coordinates are interpreted as r,phi or r,phi,theta in 2d/3d respectively with theta being the polar angle. -346 +336 [Selection depth|cartesian|spherical ] @@ -18105,7 +18105,7 @@ Sometimes it is convenient to use symbolic constants in the expression that desc A typical example would be to set this runtime parameter to `pi=3.1415926536' and then use `pi' in the expression of the actual formula. (That said, for convenience this class actually defines both `pi' and `Pi' by default, but you get the idea.) -349 +339 [Anything] @@ -18124,7 +18124,7 @@ The formula that denotes the function you want to evaluate for particular values If the function you are describing represents a vector-valued function with multiple components, then separate the expressions for individual components by a semicolon. -348 +338 [Anything] @@ -18141,7 +18141,7 @@ x,y,t The names of the variables as they will be used in the function, separated by commas. By default, the names of variables at which the function will be evaluated are `x' (in 1d), `x,y' (in 2d) or `x,y,z' (in 3d) for spatial coordinates and `t' for time. You can then use these variable names in your function expression and they will be replaced by the values of these variables at which the function is currently evaluated. However, you can also choose a different set of names for the independent variables at which to evaluate your function expression. For example, if you work in spherical coordinates, you may wish to set this input parameter to `r,phi,theta,t' and then use these variable names in your function expression. -347 +337 [Anything] @@ -18160,7 +18160,7 @@ absolute value What type of temperature anomaly should be considered when evaluating against the threshold: Only negative anomalies (negative only), only positive anomalies (positive only) or the absolute value of the nonadiabatic temperature. -337 +341 [Selection negative only|positive only|absolute value ] @@ -18177,7 +18177,7 @@ What type of temperature anomaly should be considered when evaluating against th A threshold that the nonadiabatic temperature will be evaluated against. Units: \si{\kelvin} -336 +340 [Double 0...MAX_DOUBLE (inclusive)] @@ -18578,7 +18578,7 @@ Select whether \aspect{} should terminate if the command returns a non-zero exit A list of names for each of the compositional fields that you want to compute the combined RMS velocity for. -289 +302 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -18597,7 +18597,7 @@ true Wether to compress the raw and weighted cpo data output files with zlib. -297 +310 [Bool] @@ -18614,7 +18614,7 @@ Wether to compress the raw and weighted cpo data output files with zlib. The seed used to generate random numbers. This will make sure that results are reproducable as long as the problem is run with the same amount of MPI processes. It is implemented as final seed = random number seed + MPI Rank. -292 +305 [Integer range 0...2147483647 (inclusive)] @@ -18627,7 +18627,7 @@ The seed used to generate random numbers. This will make sure that results are r On large clusters it can be advantageous to first write the output to a temporary file on a local file system and later move this file to a network file system. If this variable is set to a non-empty string it will be interpreted as a temporary storage location. -294 +307 [Anything] @@ -18646,7 +18646,7 @@ The time interval between each generation of output files. A value of zero indic Units: years if the 'Use years in output instead of seconds' parameter is set; seconds otherwise. -291 +304 [Double 0...MAX_DOUBLE (inclusive)] @@ -18663,7 +18663,7 @@ false File operations can potentially take a long time, blocking the progress of the rest of the model run. Setting this variable to `true' moves this process into background threads, while the rest of the model continues. -293 +306 [Bool] @@ -18681,7 +18681,7 @@ A list containing the what part of the random draw volume weighted particle cpo Note that the rotation matrix and Euler angles both contain the same information, but in a different format. Euler angles are recommended over the rotation matrix since they only require to write 3 values instead of 9. If the list is empty, this file will not be written. Furthermore, the entries will be written out in the order given, and if entries are entered muliple times, they will be written out multiple times. -296 +309 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -18699,7 +18699,7 @@ A list containing what particle cpo data needs to be written out after the parti Note that the rotation matrix and Euler angles both contain the same information, but in a different format. Euler angles are recommended over the rotation matrix since they only require to write 3 values instead of 9. If the list is empty, this file will not be written.Furthermore, the entries will be written out in the order given, and if entries are entered muliple times, they will be written out multiple times. -295 +308 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -18714,7 +18714,7 @@ Note that the rotation matrix and Euler angles both contain the same information The depth boundaries of zones within which we are to compute averages. By default this list is empty and we subdivide the entire domain into equidistant depth zones and compute averages within each of these zones. If this list is not empty it has to contain one more entry than the 'Number of zones' parameter, representing the upper and lower depth boundary of each zone. It is not necessary to cover the whole depth-range (i.e. you can select to only average in a single layer by choosing 2 arbitrary depths as the boundaries of that layer). -300 +313 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -18736,7 +18736,7 @@ List of options: all|temperature|composition|adiabatic temperature|adiabatic pressure|adiabatic density|adiabatic density derivative|velocity magnitude|sinking velocity|rising velocity|Vs|Vp|log viscosity|viscosity|vertical heat flux|vertical mass flux|composition mass -302 +315 [MultipleSelection all|temperature|composition|adiabatic temperature|adiabatic pressure|adiabatic density|adiabatic density derivative|velocity magnitude|sinking velocity|rising velocity|Vs|Vp|log viscosity|viscosity|vertical heat flux|vertical mass flux|composition mass ] @@ -18753,7 +18753,7 @@ all|temperature|composition|adiabatic temperature|adiabatic pressure|adiabatic d The number of zones in depth direction within which we are to compute averages. By default, we subdivide the entire domain into 10 depth zones and compute temperature and other averages within each of these zones. However, if you have a very coarse mesh, it may not make much sense to subdivide the domain into so many zones and you may wish to choose less than this default. It may also make computations slightly faster. On the other hand, if you have an extremely highly resolved mesh, choosing more zones might also make sense. -299 +312 [Integer range 1...2147483647 (inclusive)] @@ -18770,7 +18770,7 @@ gnuplot, txt A list of formats in which the output shall be produced. The format in which the output is generated also determines the extension of the file into which data is written. The list of possible output formats that can be given here is documented in the appendix of the manual where the current parameter is described. By default the output is written as gnuplot file (for plotting), and as a simple text file. -301 +314 [MultipleSelection none|dx|ucd|gnuplot|povray|eps|gmv|tecplot|tecplot_binary|vtk|vtu|hdf5|svg|deal.II intermediate|txt ] @@ -18787,7 +18787,7 @@ A list of formats in which the output shall be produced. The format in which the The time interval between each generation of graphical output files. A value of zero indicates that output should be generated in each time step. Units: years if the 'Use years in output instead of seconds' parameter is set; seconds otherwise. -298 +311 [Double 0...MAX_DOUBLE (inclusive)] @@ -18806,7 +18806,7 @@ false Output the excess entropy only instead the each entropy terms. -290 +303 [Bool] @@ -18825,7 +18825,7 @@ Output the excess entropy only instead the each entropy terms. Dynamic topography is calculated as the excess or lack of mass that is supported by mantle flow. This value depends on the density of material that is moved up or down, i.e. crustal rock, and the density of the material that is displaced (generally water or air). While the density of crustal rock is part of the material model, this parameter `Density above' allows the user to specify the density value of material that is displaced above the solid surface. By default this material is assumed to be air, with a density of 0. Units: \si{\kilogram\per\meter\cubed}. -303 +316 [Double 0...MAX_DOUBLE (inclusive)] @@ -18842,7 +18842,7 @@ Dynamic topography is calculated as the excess or lack of mass that is supported Dynamic topography is calculated as the excess or lack of mass that is supported by mantle flow. This value depends on the density of material that is moved up or down, i.e. mantle above CMB, and the density of the material that is displaced (generally outer core material). While the density of mantle rock is part of the material model, this parameter `Density below' allows the user to specify the density value of material that is displaced below the solid surface. By default this material is assumed to be outer core material with a density of 9900. Units: \si{\kilogram\per\meter\cubed}. -304 +317 [Double 0...MAX_DOUBLE (inclusive)] @@ -18859,7 +18859,7 @@ true Whether to output a file containing the bottom (i.e., CMB) dynamic topography. -306 +319 [Bool] @@ -18876,7 +18876,7 @@ true Whether to output a file containing the surface dynamic topography. -305 +318 [Bool] @@ -18935,7 +18935,7 @@ false The density value above the surface boundary. -313 +275 [Double 0...MAX_DOUBLE (inclusive)] @@ -18952,7 +18952,7 @@ The density value above the surface boundary. The density value below the CMB boundary. -314 +276 [Double 0...MAX_DOUBLE (inclusive)] @@ -18969,7 +18969,7 @@ true Option to include the contribution from CMB topography on geoid. The default is true. -309 +271 [Bool] @@ -18986,7 +18986,7 @@ true Option to include the contribution from surface topography on geoid. The default is true. -308 +270 [Bool] @@ -19003,7 +19003,7 @@ true Option to include the contribution from dynamic topography on geoid. The default is true. -307 +269 [Bool] @@ -19020,7 +19020,7 @@ Option to include the contribution from dynamic topography on geoid. The default This parameter can be a random positive integer. However, the value normally should not exceed the maximum degree of the initial perturbed temperature field. For example, if the initial temperature uses S40RTS, the maximum degree should not be larger than 40. -310 +272 [Integer range 0...2147483647 (inclusive)] @@ -19037,7 +19037,7 @@ This parameter can be a random positive integer. However, the value normally sho This parameter normally is set to 2 since the perturbed gravitational potential at degree 1 always vanishes in a reference frame with the planetary center of mass same as the center of figure. -311 +273 [Integer range 0...2147483647 (inclusive)] @@ -19054,7 +19054,7 @@ false Option to output the spherical harmonic coefficients of the CMB topography contribution to the maximum degree. The default is false. -317 +279 [Bool] @@ -19071,7 +19071,7 @@ false Option to output the geoid anomaly in geographical coordinates (latitude and longitude). The default is false, so postprocess will output the data in geocentric coordinates (x,y,z) as normally. -312 +274 [Bool] @@ -19088,7 +19088,7 @@ false Option to output the spherical harmonic coefficients of the density anomaly contribution to the maximum degree. The default is false. -318 +280 [Bool] @@ -19105,7 +19105,7 @@ false Option to output the spherical harmonic coefficients of the geoid anomaly up to the maximum degree. The default is false, so postprocess will only output the geoid anomaly in grid format. -315 +277 [Bool] @@ -19122,7 +19122,7 @@ false Option to output the free-air gravity anomaly up to the maximum degree. The unit of the output is in SI, hence $m/s^2$ ($1mgal = 10^-5 m/s^2$). The default is false. -319 +281 [Bool] @@ -19139,7 +19139,7 @@ false Option to output the spherical harmonic coefficients of the surface topography contribution to the maximum degree. The default is false. -316 +278 [Bool] @@ -19158,7 +19158,7 @@ false Whether to put every nonlinear iteration into a separate line in the statistics file (if true), or to output only one line per time step that contains the total number of iterations of the Stokes and advection linear system solver. -269 +282 [Bool] @@ -19173,7 +19173,7 @@ Whether to put every nonlinear iteration into a separate line in the statistics Parameter for the list of points sampling scheme: List of satellite latitude coordinates. -286 +299 [List of <[Double -90...90 (inclusive)]> of length 0...4294967295 (inclusive)] @@ -19186,7 +19186,7 @@ Parameter for the list of points sampling scheme: List of satellite latitude coo Parameter for the list of points sampling scheme: List of satellite longitude coordinates. -285 +298 [List of <[Double -180...180 (inclusive)]> of length 0...4294967295 (inclusive)] @@ -19199,7 +19199,7 @@ Parameter for the list of points sampling scheme: List of satellite longitude co Parameter for the list of points sampling scheme: List of satellite radius coordinates. Just specify one radius if all points values have the same radius. If not, make sure there are as many radius as longitude and latitude -284 +297 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -19216,7 +19216,7 @@ Parameter for the list of points sampling scheme: List of satellite radius coord Parameter for the uniform distribution sampling scheme: Gravity may be calculated for a sets of points along the latitude between a minimum and maximum latitude. -281 +294 [Double -90...90 (inclusive)] @@ -19233,7 +19233,7 @@ Parameter for the uniform distribution sampling scheme: Gravity may be calculate Parameter for the uniform distribution sampling scheme: Gravity may be calculated for a sets of points along the longitude between a minimum and maximum longitude. -280 +293 [Double -180...180 (inclusive)] @@ -19250,7 +19250,7 @@ Parameter for the uniform distribution sampling scheme: Gravity may be calculate Parameter for the map sampling scheme: Maximum radius can be defined in or outside the model. -277 +290 [Double 0...MAX_DOUBLE (inclusive)] @@ -19267,7 +19267,7 @@ Parameter for the map sampling scheme: Maximum radius can be defined in or outsi Parameter for the uniform distribution sampling scheme: Gravity may be calculated for a sets of points along the latitude between a minimum and maximum latitude. -279 +292 [Double -90...90 (inclusive)] @@ -19284,7 +19284,7 @@ Parameter for the uniform distribution sampling scheme: Gravity may be calculate Parameter for the uniform distribution sampling scheme: Gravity may be calculated for a sets of points along the longitude between a minimum and maximum longitude. -278 +291 [Double -180...180 (inclusive)] @@ -19301,7 +19301,7 @@ Parameter for the uniform distribution sampling scheme: Gravity may be calculate Parameter for the map sampling scheme: Minimum radius may be defined in or outside the model. Prescribe a minimum radius for a sampling coverage at a specific height. -276 +289 [Double 0...MAX_DOUBLE (inclusive)] @@ -19318,7 +19318,7 @@ Parameter for the map sampling scheme: Minimum radius may be defined in or outsi Parameter for the fibonacci spiral sampling scheme: This specifies the desired number of satellites per radius layer. The default value is 200. Note that sampling becomes more uniform with increasing number of satellites -271 +284 [Integer range 0...2147483647 (inclusive)] @@ -19335,7 +19335,7 @@ Parameter for the fibonacci spiral sampling scheme: This specifies the desired n Parameter for the map sampling scheme: This specifies the number of points along the latitude (e.g. gravity map) between a minimum and maximum latitude. -275 +288 [Integer range 0...2147483647 (inclusive)] @@ -19352,7 +19352,7 @@ Parameter for the map sampling scheme: This specifies the number of points along Parameter for the map sampling scheme: This specifies the number of points along the longitude (e.g. gravity map) between a minimum and maximum longitude. -274 +287 [Integer range 0...2147483647 (inclusive)] @@ -19369,7 +19369,7 @@ Parameter for the map sampling scheme: This specifies the number of points along Parameter for the map sampling scheme: This specifies the number of points along the radius (e.g. depth profile) between a minimum and maximum radius. -273 +286 [Integer range 0...2147483647 (inclusive)] @@ -19386,7 +19386,7 @@ Parameter for the map sampling scheme: This specifies the number of points along Set the precision of gravity acceleration, potential and gradients in the gravity output and statistics file. -283 +296 [Integer range 1...2147483647 (inclusive)] @@ -19403,7 +19403,7 @@ Set the precision of gravity acceleration, potential and gradients in the gravit Quadrature degree increase over the velocity element degree may be required when gravity is calculated near the surface or inside the model. An increase in the quadrature element adds accuracy to the gravity solution from noise due to the model grid. -272 +285 [Integer range -1...2147483647 (inclusive)] @@ -19420,7 +19420,7 @@ Quadrature degree increase over the velocity element degree may be required when Gravity anomalies may be computed using density anomalies relative to a reference density. -282 +295 [Double 0...MAX_DOUBLE (inclusive)] @@ -19437,7 +19437,7 @@ map Choose the sampling scheme. By default, the map produces a grid of equally angled points between a minimum and maximum radius, longitude, and latitude. A list of points contains the specific coordinates of the satellites. The fibonacci spiral sampling scheme produces a uniformly distributed map on the surface of sphere defined by a minimum and/or maximum radius. -270 +283 [Selection map|list|list of points|fibonacci spiral ] @@ -19454,7 +19454,7 @@ Choose the sampling scheme. By default, the map produces a grid of equally angle The time interval between each generation of gravity output files. A value of 0 indicates that output should be generated in each time step. Units: years if the 'Use years in output instead of seconds' parameter is set; seconds otherwise. -287 +300 [Double 0...MAX_DOUBLE (inclusive)] @@ -19471,7 +19471,7 @@ The time interval between each generation of gravity output files. A value of 0 The maximum number of time steps between each generation of gravity output files. -288 +301 [Integer range 0...2147483647 (inclusive)] @@ -19509,7 +19509,7 @@ false By default, every cell needs to contain particles to use this interpolator plugin. If this parameter is set to true, cells are allowed to have no particles. In case both the current cell and its neighbors are empty, the interpolator will return 0 for the current cell's properties. -227 +229 [Bool] @@ -19731,7 +19731,7 @@ VTU file output supports grouping files from several CPUs into a given number of Total number of particles to create (not per processor or per element). The number is parsed as a floating point number (so that one can specify, for example, '1e4' particles) but it is interpreted as an integer, of course. -219 +216 [Double 0...MAX_DOUBLE (inclusive)] @@ -20231,7 +20231,7 @@ $ASPECT_SOURCE_DIR/data/particle/generator/ascii/ The name of a directory that contains the particle data. This path may either be absolute (if starting with a '/') or relative to the current directory. The path may also include the special text '$ASPECT_SOURCE_DIR' which will be interpreted as the path in which the ASPECT source files were located when ASPECT was compiled. This interpretation allows, for example, to reference files located in the `data/' subdirectory of ASPECT. -211 +214 [DirectoryName] @@ -20248,7 +20248,7 @@ particle.dat The name of the particle file. -212 +215 [Anything] @@ -20265,7 +20265,7 @@ Sometimes it is convenient to use symbolic constants in the expression that desc A typical example would be to set this runtime parameter to `pi=3.1415926536' and then use `pi' in the expression of the actual formula. (That said, for convenience this class actually defines both `pi' and `Pi' by default, but you get the idea.) -216 +219 [Anything] @@ -20284,7 +20284,7 @@ The formula that denotes the function you want to evaluate for particular values If the function you are describing represents a vector-valued function with multiple components, then separate the expressions for individual components by a semicolon. -215 +218 [Anything] @@ -20335,7 +20335,7 @@ x,y,t The names of the variables as they will be used in the function, separated by commas. By default, the names of variables at which the function will be evaluated are `x' (in 1d), `x,y' (in 2d) or `x,y,z' (in 3d) for spatial coordinates and `t' for time. You can then use these variable names in your function expression and they will be replaced by the values of these variables at which the function is currently evaluated. However, you can also choose a different set of names for the independent variables at which to evaluate your function expression. For example, if you work in spherical coordinates, you may wish to set this input parameter to `r,phi,theta,t' and then use these variable names in your function expression. -214 +217 [Anything] @@ -20354,7 +20354,7 @@ The names of the variables as they will be used in the function, separated by co List of number of particles to create per cell and spatial dimension. The size of the list is the number of spatial dimensions. If only one value is given, then each spatial dimension is set to the same value. The list of numbers are parsed as a floating point number (so that one can specify, for example, '1e4' particles) but it is interpreted as an integer, of course. -192 +195 [List of <[Integer range 1...2147483647 (inclusive)]> of length 0...4294967295 (inclusive)] @@ -20373,7 +20373,7 @@ List of number of particles to create per cell and spatial dimension. The size o Maximum x coordinate for the region of particles. -195 +198 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -20390,7 +20390,7 @@ Maximum x coordinate for the region of particles. Maximum y coordinate for the region of particles. -197 +200 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -20407,7 +20407,7 @@ Maximum y coordinate for the region of particles. Maximum z coordinate for the region of particles. -199 +202 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -20424,7 +20424,7 @@ Maximum z coordinate for the region of particles. Minimum x coordinate for the region of particles. -194 +197 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -20441,7 +20441,7 @@ Minimum x coordinate for the region of particles. Minimum y coordinate for the region of particles. -196 +199 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -20458,7 +20458,7 @@ Minimum y coordinate for the region of particles. Minimum z coordinate for the region of particles. -198 +201 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -20477,7 +20477,7 @@ Minimum z coordinate for the region of particles. x coordinate for the center of the spherical region, where particles are generated. -201 +204 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -20494,7 +20494,7 @@ x coordinate for the center of the spherical region, where particles are generat y coordinate for the center of the spherical region, where particles are generated. -202 +205 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -20511,7 +20511,7 @@ y coordinate for the center of the spherical region, where particles are generat z coordinate for the center of the spherical region, where particles are generated. -203 +206 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -20528,7 +20528,7 @@ z coordinate for the center of the spherical region, where particles are generat Maximum latitude coordinate for the region of particles in degrees. Measured from the center position, and from the north pole. -209 +212 [Double 0...180 (inclusive)] @@ -20545,7 +20545,7 @@ Maximum latitude coordinate for the region of particles in degrees. Measured fro Maximum longitude coordinate for the region of particles in degrees. Measured from the center position. -207 +210 [Double -180...360 (inclusive)] @@ -20562,7 +20562,7 @@ Maximum longitude coordinate for the region of particles in degrees. Measured fr Maximum radial coordinate for the region of particles. Measured from the center position. -205 +208 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -20579,7 +20579,7 @@ Maximum radial coordinate for the region of particles. Measured from the center Minimum latitude coordinate for the region of particles in degrees. Measured from the center position, and from the north pole. -208 +211 [Double 0...180 (inclusive)] @@ -20596,7 +20596,7 @@ Minimum latitude coordinate for the region of particles in degrees. Measured fro Minimum longitude coordinate for the region of particles in degrees. Measured from the center position. -206 +209 [Double -180...360 (inclusive)] @@ -20613,7 +20613,7 @@ Minimum longitude coordinate for the region of particles in degrees. Measured fr Minimum radial coordinate for the region of particles. Measured from the center position. -204 +207 [Double 0...MAX_DOUBLE (inclusive)] @@ -20630,7 +20630,7 @@ Minimum radial coordinate for the region of particles. Measured from the center The number of radial shells of particles that will be generated around the central point. -210 +213 [Integer range 1...2147483647 (inclusive)] @@ -20672,7 +20672,7 @@ false Extends the range used by 'Use linear least squares limiter' by linearly interpolating values at cell boundaries from neighboring cells. If more than one value is given, it will be treated as a list with one component per particle property. Enabling 'Use boundary extrapolation' requires enabling 'Use linear least squares limiter'. -231 +226 [List of <[Bool]> of length 0...4294967295 (inclusive)] @@ -20689,7 +20689,7 @@ false Limit the interpolation of particle properties onto the cell, so that the value of each property is no smaller than its minimum and no larger than its maximum on the particles of each cell, and the average of neighboring cells. If more than one value is given, it will be treated as a list with one component per particle property. -230 +225 [List of <[Bool]> of length 0...4294967295 (inclusive)] @@ -20708,7 +20708,7 @@ false Extends the range used by 'Use quadratic least squares limiter' by linearly interpolating values at cell boundaries from neighboring cells. If more than one value is given, it will be treated as a list with one component per particle property. Enabling 'Use boundary extrapolation' requires enabling 'Use quadratic least squares limiter'. -229 +231 [List of <[Bool]> of length 0...4294967295 (inclusive)] @@ -20725,7 +20725,7 @@ true Limit the interpolation of particle properties onto the cell, so that the value of each property is no smaller than its minimum and no larger than its maximum on the particles of each cell, and the average of neighboring cells. If more than one value is given, it will be treated as a list with one component per particle property. -228 +230 [List of <[Bool]> of length 0...4294967295 (inclusive)] @@ -21197,7 +21197,7 @@ Physical units: None. Physical units: None. -`principal stress': A visualization output object that outputs the principal stress values and directions, i.e., the eigenvalues and eigenvectors of the stress tensor. The postprocessor can either operate on the full stress tensor or only on the deviatoric stress tensor, depending on what run-time parameters are set. +`principal stress': A visualization output object that outputs the principal stresses and directions, i.e., the eigenvalues and eigenvectors of the stress tensor. Wikipedia defines principal stresses as follows: At every point in a stressed body there are at least three planes, called principal planes, with normal vectors, called principal directions, where the corresponding stress vector is perpendicular to the plane, and where there are no normal shear stresses. The three stresses normal to these principal planes are called principal stresses. This postprocessor can either operate on the full stress tensor or only on the deviatoric stress tensor, depending on what run-time parameters are set. Physical units: \si{\pascal}. @@ -21507,7 +21507,7 @@ false A boolean flag that controls whether to output the heat flux map as a point wise value, or as a cell-wise averaged value. The point wise output is more accurate, but it currently omits prescribed heat flux values at boundaries and advective heat flux that is caused by velocities non-tangential to boundaries. If you do not use these two features it is recommended to switch this setting on to benefit from the increased output resolution. -174 +175 [Bool] @@ -21528,7 +21528,7 @@ A comma separated list of material properties that should be written whenever wr viscosity|density|thermal expansivity|specific heat|thermal conductivity|thermal diffusivity|compressibility|entropy derivative temperature|entropy derivative pressure|reaction terms|melt fraction -175 +176 [MultipleSelection viscosity|density|thermal expansivity|specific heat|thermal conductivity|thermal diffusivity|compressibility|entropy derivative temperature|entropy derivative pressure|reaction terms|melt fraction ] @@ -21547,7 +21547,7 @@ viscosity|density|thermal expansivity|specific heat|thermal conductivity|thermal Constant parameter in the quadratic function that approximates the solidus of peridotite. Units: \si{\degreeCelsius}. -151 +156 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -21564,7 +21564,7 @@ Constant parameter in the quadratic function that approximates the solidus of pe Prefactor of the linear pressure term in the quadratic function that approximates the solidus of peridotite. \si{\degreeCelsius\per\pascal}. -152 +157 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -21581,7 +21581,7 @@ Prefactor of the linear pressure term in the quadratic function that approximate Prefactor of the quadratic pressure term in the quadratic function that approximates the solidus of peridotite. \si{\degreeCelsius\per\pascal\squared}. -153 +158 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -21598,7 +21598,7 @@ Prefactor of the quadratic pressure term in the quadratic function that approxim Constant parameter in the quadratic function that approximates the lherzolite liquidus used for calculating the fraction of peridotite-derived melt. Units: \si{\degreeCelsius}. -154 +159 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -21615,7 +21615,7 @@ Constant parameter in the quadratic function that approximates the lherzolite li Prefactor of the linear pressure term in the quadratic function that approximates the lherzolite liquidus used for calculating the fraction of peridotite-derived melt. \si{\degreeCelsius\per\pascal}. -155 +160 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -21632,7 +21632,7 @@ Prefactor of the linear pressure term in the quadratic function that approximate Prefactor of the quadratic pressure term in the quadratic function that approximates the lherzolite liquidus used for calculating the fraction of peridotite-derived melt. \si{\degreeCelsius\per\pascal\squared}. -156 +161 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -21649,7 +21649,7 @@ Prefactor of the quadratic pressure term in the quadratic function that approxim Constant parameter in the quadratic function that approximates the liquidus of peridotite. Units: \si{\degreeCelsius}. -157 +162 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -21666,7 +21666,7 @@ Constant parameter in the quadratic function that approximates the liquidus of p Prefactor of the linear pressure term in the quadratic function that approximates the liquidus of peridotite. \si{\degreeCelsius\per\pascal}. -158 +163 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -21683,7 +21683,7 @@ Prefactor of the linear pressure term in the quadratic function that approximate Prefactor of the quadratic pressure term in the quadratic function that approximates the liquidus of peridotite. \si{\degreeCelsius\per\pascal\squared}. -159 +164 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -21700,7 +21700,7 @@ Prefactor of the quadratic pressure term in the quadratic function that approxim Constant parameter in the quadratic function that approximates the solidus of pyroxenite. Units: \si{\degreeCelsius}. -164 +169 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -21717,7 +21717,7 @@ Constant parameter in the quadratic function that approximates the solidus of py Prefactor of the linear pressure term in the quadratic function that approximates the solidus of pyroxenite. Note that this factor is different from the value given in Sobolev, 2011, because they use the potential temperature whereas we use the absolute temperature. \si{\degreeCelsius\per\pascal}. -165 +170 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -21734,7 +21734,7 @@ Prefactor of the linear pressure term in the quadratic function that approximate Prefactor of the quadratic pressure term in the quadratic function that approximates the solidus of pyroxenite. \si{\degreeCelsius\per\pascal\squared}. -166 +171 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -21751,7 +21751,7 @@ Prefactor of the quadratic pressure term in the quadratic function that approxim Prefactor of the linear depletion term in the quadratic function that approximates the melt fraction of pyroxenite. \si{\degreeCelsius\per\pascal}. -167 +172 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -21768,7 +21768,7 @@ Prefactor of the linear depletion term in the quadratic function that approximat Prefactor of the quadratic depletion term in the quadratic function that approximates the melt fraction of pyroxenite. \si{\degreeCelsius\per\pascal\squared}. -168 +173 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -21785,7 +21785,7 @@ Prefactor of the quadratic depletion term in the quadratic function that approxi Mass fraction of clinopyroxene in the peridotite to be molten. Units: non-dimensional. -163 +168 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -21802,7 +21802,7 @@ Mass fraction of clinopyroxene in the peridotite to be molten. Units: non-dimens Exponent of the melting temperature in the melt fraction calculation. Units: non-dimensional. -162 +167 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -21819,7 +21819,7 @@ Exponent of the melting temperature in the melt fraction calculation. Units: non Constant in the linear function that approximates the clinopyroxene reaction coefficient. Units: non-dimensional. -160 +165 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -21836,7 +21836,7 @@ Constant in the linear function that approximates the clinopyroxene reaction coe Prefactor of the linear pressure term in the linear function that approximates the clinopyroxene reaction coefficient. Units: \si{\per\pascal}. -161 +166 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -21857,7 +21857,7 @@ A comma separated list of melt properties that should be written whenever writin compaction viscosity|fluid viscosity|permeability|fluid density|fluid density gradient|is melt cell|darcy coefficient|darcy coefficient no cutoff|compaction length -176 +155 [MultipleSelection compaction viscosity|fluid viscosity|permeability|fluid density|fluid density gradient|is melt cell|darcy coefficient|darcy coefficient no cutoff|compaction length ] @@ -21876,7 +21876,7 @@ false Whether to use the deviatoric stress tensor instead of the full stress tensor to compute principal stress directions and values. -169 +174 [Bool] @@ -21984,7 +21984,7 @@ reference profile Scheme to compute the average velocity-depth profile. The reference profile option evaluates the conditions along the reference adiabat according to the material model. The lateral average option instead calculates a lateral average from subdivision of the mesh. The lateral average option may produce spurious results where there are sharp velocity changes. -172 +153 [Selection reference profile|lateral average ] @@ -22001,7 +22001,7 @@ Scheme to compute the average velocity-depth profile. The reference profile opti Number of depth slices used to define average seismic compressional wave velocities from which anomalies are calculated. Units: non-dimensional. -173 +154 [Integer range 1...2147483647 (inclusive)] @@ -22020,7 +22020,7 @@ reference profile Scheme to compute the average velocity-depth profile. The reference profile option evaluates the conditions along the reference adiabat according to the material model. The lateral average option instead calculates a lateral average from subdivision of the mesh. The lateral average option may produce spurious results where there are sharp velocity changes. -170 +151 [Selection reference profile|lateral average ] @@ -22037,7 +22037,7 @@ Scheme to compute the average velocity-depth profile. The reference profile opti Number of depth slices used to define average seismic shear wave velocities from which anomalies are calculated. Units: non-dimensional. -171 +152 [Integer range 1...2147483647 (inclusive)] @@ -22082,7 +22082,7 @@ $ASPECT_SOURCE_DIR/data/prescribed-stokes-solution/ The name of a directory that contains the model data. This path may either be absolute (if starting with a `/') or relative to the current directory. The path may also include the special text `$ASPECT_SOURCE_DIR' which will be interpreted as the path in which the ASPECT source files were located when ASPECT was compiled. This interpretation allows, for example, to reference files located in the `data/' subdirectory of ASPECT. -1170 +1155 [DirectoryName] @@ -22099,7 +22099,7 @@ box_2d.txt The file name of the model data. -1171 +1156 [Anything] @@ -22116,7 +22116,7 @@ The file name of the model data. Point that determines the plane in which the 2d slice lies in. This variable is only used if 'Slice dataset in 2d plane' is true. The slice will go through this point, the point defined by the parameter 'Second point on slice', and the center of the model domain. After the rotation, this first point will lie along the (0,1,0) axis of the coordinate system. The coordinates of the point have to be given in Cartesian coordinates. -1174 +1159 [Anything] @@ -22133,7 +22133,7 @@ Point that determines the plane in which the 2d slice lies in. This variable is Scalar factor, which is applied to the model data. You might want to use this to scale the input to a reference model. Another way to use this factor is to convert units of the input files. For instance, if you provide velocities in cm/yr set this factor to 0.01. -1172 +1157 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -22150,7 +22150,7 @@ Scalar factor, which is applied to the model data. You might want to use this to Second point that determines the plane in which the 2d slice lies in. This variable is only used if 'Slice dataset in 2d plane' is true. The slice will go through this point, the point defined by the parameter 'First point on slice', and the center of the model domain. The coordinates of the point have to be given in Cartesian coordinates. -1175 +1160 [Anything] @@ -22167,7 +22167,7 @@ false Whether to use a 2d data slice of a 3d data file or the entire data file. Slicing a 3d dataset is only supported for 2d models. -1173 +1158 [Bool] @@ -22184,7 +22184,7 @@ Sometimes it is convenient to use symbolic constants in the expression that desc A typical example would be to set this runtime parameter to `pi=3.1415926536' and then use `pi' in the expression of the actual formula. (That said, for convenience this class actually defines both `pi' and `Pi' by default, but you get the idea.) -1166 +1172 [Anything] @@ -22203,7 +22203,7 @@ The formula that denotes the function you want to evaluate for particular values If the function you are describing represents a vector-valued function with multiple components, then separate the expressions for individual components by a semicolon. -1165 +1171 [Anything] @@ -22220,7 +22220,7 @@ x,y,t The names of the variables as they will be used in the function, separated by commas. By default, the names of variables at which the function will be evaluated are `x' (in 1d), `x,y' (in 2d) or `x,y,z' (in 3d) for spatial coordinates and `t' for time. You can then use these variable names in your function expression and they will be replaced by the values of these variables at which the function is currently evaluated. However, you can also choose a different set of names for the independent variables at which to evaluate your function expression. For example, if you work in spherical coordinates, you may wish to set this input parameter to `r,phi,theta,t' and then use these variable names in your function expression. -1164 +1170 [Anything] @@ -22237,7 +22237,7 @@ Sometimes it is convenient to use symbolic constants in the expression that desc A typical example would be to set this runtime parameter to `pi=3.1415926536' and then use `pi' in the expression of the actual formula. (That said, for convenience this class actually defines both `pi' and `Pi' by default, but you get the idea.) -1163 +1169 [Anything] @@ -22256,7 +22256,7 @@ The formula that denotes the function you want to evaluate for particular values If the function you are describing represents a vector-valued function with multiple components, then separate the expressions for individual components by a semicolon. -1162 +1168 [Anything] @@ -22273,7 +22273,7 @@ x,y,t The names of the variables as they will be used in the function, separated by commas. By default, the names of variables at which the function will be evaluated are `x' (in 1d), `x,y' (in 2d) or `x,y,z' (in 3d) for spatial coordinates and `t' for time. You can then use these variable names in your function expression and they will be replaced by the values of these variables at which the function is currently evaluated. However, you can also choose a different set of names for the independent variables at which to evaluate your function expression. For example, if you work in spherical coordinates, you may wish to set this input parameter to `r,phi,theta,t' and then use these variable names in your function expression. -1161 +1167 [Anything] @@ -22290,7 +22290,7 @@ Sometimes it is convenient to use symbolic constants in the expression that desc A typical example would be to set this runtime parameter to `pi=3.1415926536' and then use `pi' in the expression of the actual formula. (That said, for convenience this class actually defines both `pi' and `Pi' by default, but you get the idea.) -1169 +1175 [Anything] @@ -22309,7 +22309,7 @@ The formula that denotes the function you want to evaluate for particular values If the function you are describing represents a vector-valued function with multiple components, then separate the expressions for individual components by a semicolon. -1168 +1174 [Anything] @@ -22326,7 +22326,7 @@ x,y,t The names of the variables as they will be used in the function, separated by commas. By default, the names of variables at which the function will be evaluated are `x' (in 1d), `x,y' (in 2d) or `x,y,z' (in 3d) for spatial coordinates and `t' for time. You can then use these variable names in your function expression and they will be replaced by the values of these variables at which the function is currently evaluated. However, you can also choose a different set of names for the independent variables at which to evaluate your function expression. For example, if you work in spherical coordinates, you may wish to set this input parameter to `r,phi,theta,t' and then use these variable names in your function expression. -1167 +1173 [Anything] @@ -22343,7 +22343,7 @@ Sometimes it is convenient to use symbolic constants in the expression that desc A typical example would be to set this runtime parameter to `pi=3.1415926536' and then use `pi' in the expression of the actual formula. (That said, for convenience this class actually defines both `pi' and `Pi' by default, but you get the idea.) -1160 +1166 [Anything] @@ -22362,7 +22362,7 @@ The formula that denotes the function you want to evaluate for particular values If the function you are describing represents a vector-valued function with multiple components, then separate the expressions for individual components by a semicolon. -1159 +1165 [Anything] @@ -22379,7 +22379,7 @@ x,y,t The names of the variables as they will be used in the function, separated by commas. By default, the names of variables at which the function will be evaluated are `x' (in 1d), `x,y' (in 2d) or `x,y,z' (in 3d) for spatial coordinates and `t' for time. You can then use these variable names in your function expression and they will be replaced by the values of these variables at which the function is currently evaluated. However, you can also choose a different set of names for the independent variables at which to evaluate your function expression. For example, if you work in spherical coordinates, you may wish to set this input parameter to `r,phi,theta,t' and then use these variable names in your function expression. -1158 +1164 [Anything] @@ -22396,7 +22396,7 @@ Sometimes it is convenient to use symbolic constants in the expression that desc A typical example would be to set this runtime parameter to `pi=3.1415926536' and then use `pi' in the expression of the actual formula. (That said, for convenience this class actually defines both `pi' and `Pi' by default, but you get the idea.) -1157 +1163 [Anything] @@ -22415,7 +22415,7 @@ The formula that denotes the function you want to evaluate for particular values If the function you are describing represents a vector-valued function with multiple components, then separate the expressions for individual components by a semicolon. -1156 +1162 [Anything] @@ -22432,7 +22432,7 @@ x,y,t The names of the variables as they will be used in the function, separated by commas. By default, the names of variables at which the function will be evaluated are `x' (in 1d), `x,y' (in 2d) or `x,y,z' (in 3d) for spatial coordinates and `t' for time. You can then use these variable names in your function expression and they will be replaced by the values of these variables at which the function is currently evaluated. However, you can also choose a different set of names for the independent variables at which to evaluate your function expression. For example, if you work in spherical coordinates, you may wish to set this input parameter to `r,phi,theta,t' and then use these variable names in your function expression. -1155 +1161 [Anything] @@ -23078,7 +23078,7 @@ Whether to checkpoint the simulation right before termination. Terminate the simulation once the specified timestep has been reached. -356 +357 [Integer range 0...2147483647 (inclusive)] @@ -23128,7 +23128,7 @@ The criterion considers the total heat flux over all boundaries listed by their The wall time of the simulation. Unit: hours. -358 +359 [Double 0...MAX_DOUBLE (inclusive)] @@ -23144,7 +23144,7 @@ A comma separated list of names denoting those boundaries that should be taken i The names of the boundaries listed here can either be numbers (in which case they correspond to the numerical boundary indicators assigned by the geometry object), or they can correspond to any of the symbolic names the geometry object may have provided for each part of the boundary. You may want to compare this with the documentation of the geometry model you use in your model. -361 +362 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -23161,7 +23161,7 @@ The names of the boundaries listed here can either be numbers (in which case the The maximum relative deviation of the heat flux in recent simulation time for the system to be considered in steady state. If the actual deviation is smaller than this number, then the simulation will be terminated. -359 +360 [Double 0...MAX_DOUBLE (inclusive)] @@ -23178,7 +23178,7 @@ The maximum relative deviation of the heat flux in recent simulation time for th The minimum length of simulation time that the system should be in steady state before termination. Note that if the time step size is similar to or larger than this value, the termination criterion will only have very few (in the most extreme case, just two) heat flux values to check. To ensure that a larger number of time steps are included in the check for steady state, this value should be much larger than the time step size. Units: years if the 'Use years in output instead of seconds' parameter is set; seconds otherwise. -360 +361 [Double 0...MAX_DOUBLE (inclusive)] @@ -23197,7 +23197,7 @@ The minimum length of simulation time that the system should be in steady state The maximum relative deviation of the temperature in recent simulation time for the system to be considered in steady state. If the actual deviation is smaller than this number, then the simulation will be terminated. -364 +365 [Double 0...MAX_DOUBLE (inclusive)] @@ -23214,7 +23214,7 @@ The maximum relative deviation of the temperature in recent simulation time for The minimum length of simulation time that the system should be in steady state before termination.Units: years if the 'Use years in output instead of seconds' parameter is set; seconds otherwise. -365 +366 [Double 0...MAX_DOUBLE (inclusive)] @@ -23233,7 +23233,7 @@ The minimum length of simulation time that the system should be in steady state The maximum relative deviation of the RMS in recent simulation time for the system to be considered in steady state. If the actual deviation is smaller than this number, then the simulation will be terminated. -362 +363 [Double 0...MAX_DOUBLE (inclusive)] @@ -23250,7 +23250,7 @@ The maximum relative deviation of the RMS in recent simulation time for the syst The minimum length of simulation time that the system should be in steady state before termination.Units: years if the 'Use years in output instead of seconds' parameter is set; seconds otherwise. -363 +364 [Double 0...MAX_DOUBLE (inclusive)] @@ -23269,7 +23269,7 @@ terminate-aspect The name of a file that, if it exists in the output directory (whose name is also specified in the input file) will lead to termination of the simulation. The file's location is chosen to be in the output directory, rather than in a generic location such as the ASPECT directory, so that one can run multiple simulations at the same time (which presumably write to different output directories) and can selectively terminate a particular one. -366 +356 [FileName (Type: input)] diff --git a/doc/sphinx/parameters/Postprocess.md b/doc/sphinx/parameters/Postprocess.md index 34498fa9861..2a7d485d297 100644 --- a/doc/sphinx/parameters/Postprocess.md +++ b/doc/sphinx/parameters/Postprocess.md @@ -1672,7 +1672,7 @@ Physical units: None. Physical units: None. -‘principal stress’: A visualization output object that outputs the principal stress values and directions, i.e., the eigenvalues and eigenvectors of the stress tensor. The postprocessor can either operate on the full stress tensor or only on the deviatoric stress tensor, depending on what run-time parameters are set. +‘principal stress’: A visualization output object that outputs the principal stresses and directions, i.e., the eigenvalues and eigenvectors of the stress tensor. Wikipedia defines principal stresses as follows: At every point in a stressed body there are at least three planes, called principal planes, with normal vectors, called principal directions, where the corresponding stress vector is perpendicular to the plane, and where there are no normal shear stresses. The three stresses normal to these principal planes are called principal stresses. This postprocessor can either operate on the full stress tensor or only on the deviatoric stress tensor, depending on what run-time parameters are set. Physical units: \si{\pascal}. diff --git a/doc/sphinx/user/extending/images/plugin_graph.svg b/doc/sphinx/user/extending/images/plugin_graph.svg index aa563b4bb5e..a2713d4c35f 100644 --- a/doc/sphinx/user/extending/images/plugin_graph.svg +++ b/doc/sphinx/user/extending/images/plugin_graph.svg @@ -1462,7 +1462,7 @@ SimulatorAccess->N6aspect14MeshRefinement23NonadiabaticTemperatureILi2EEE - + @@ -2202,7 +2202,7 @@ SimulatorAccess->N6aspect11Postprocess17HeatFluxDensitiesILi2EEE - +