diff --git a/.readthedocs.yaml b/.readthedocs.yaml index e53111c9a2e..65cdfb6bd24 100644 --- a/.readthedocs.yaml +++ b/.readthedocs.yaml @@ -18,8 +18,7 @@ sphinx: # Optionally build your docs in additional formats such as PDF and ePub formats: - htmlzip -# TODO: reenable once the pdf errors are fixed -# - pdf + - pdf conda: environment: ./doc/sphinx/environment.yml diff --git a/contrib/utilities/jsontomarkdown.py b/contrib/utilities/jsontomarkdown.py index e27d43aa684..1eae0e8d906 100755 --- a/contrib/utilities/jsontomarkdown.py +++ b/contrib/utilities/jsontomarkdown.py @@ -106,7 +106,7 @@ def escape_doc_string(text) : # Finally escape some characters that have special meaning in markdown: tmp = re.sub(r'\[(.*)\]\(', - r'\[\1\](', + r'{\1}(', tmp) return tmp; diff --git a/doc/parameter_view/parameters.xml b/doc/parameter_view/parameters.xml index 7e872e23655..6a290651f06 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. -434 +436 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -447,7 +447,7 @@ Select one of the following models: `function': A model in which the adiabatic profile is specified by a user defined function. The supplied function has to contain temperature, pressure, and density as a function of depth in this order. -1420 +1426 [Selection ascii data|compute entropy profile|compute profile|function ] @@ -465,7 +465,7 @@ $ASPECT_SOURCE_DIR/tests/adiabatic-conditions/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. -1421 +1427 [DirectoryName] @@ -478,7 +478,7 @@ The name of a directory that contains the model data. This path may either be ab The file name of the model data. -1422 +1428 [Anything] @@ -495,7 +495,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. -1423 +1429 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -514,7 +514,7 @@ Scalar factor, which is applied to the model data. You might want to use this to The number of points we use to compute the adiabatic profile. The higher the number of points, the more accurate the downward integration from the adiabatic surface conditions will be. -1424 +1430 [Integer range 5...2147483647 (inclusive)] @@ -531,7 +531,7 @@ The number of points we use to compute the adiabatic profile. The higher the num The surface entropy for the profile. -1425 +1431 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -550,7 +550,7 @@ initial composition Select how the reference profile for composition is computed. This profile is used to evaluate the material model, when computing the pressure and temperature profile. -1429 +1435 [Selection initial composition|function ] @@ -565,7 +565,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.) -1428 +1434 [Anything] @@ -584,7 +584,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. -1427 +1433 [Anything] @@ -601,7 +601,7 @@ If the function you are describing represents a vector-valued function with mult The number of points we use to compute the adiabatic profile. The higher the number of points, the more accurate the downward integration from the adiabatic surface temperature will be. -1430 +1436 [Integer range 5...2147483647 (inclusive)] @@ -618,7 +618,7 @@ false Whether to use the 'Surface condition function' to determine surface conditions, or the 'Adiabatic surface temperature' and 'Surface pressure' parameters. If this is set to true the reference profile is updated every timestep. The function expression of the function should be independent of space, but can depend on time 't'. The function must return two components, the first one being reference surface pressure, the second one being reference surface temperature. -1431 +1437 [Bool] @@ -635,7 +635,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. -1426 +1432 [Anything] @@ -651,7 +651,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.) -1434 +1440 [Anything] @@ -670,7 +670,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. -1433 +1439 [Anything] @@ -687,7 +687,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. -1432 +1438 [Anything] @@ -705,7 +705,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.) -1437 +1443 [Anything] @@ -722,7 +722,7 @@ A typical example would be to set this runtime parameter to `pi=3.1415926536&apo Expression for the adiabatic temperature, pressure, and density separated by semicolons as a function of `depth'. -1438 +1444 [Anything] @@ -737,7 +737,7 @@ depth -1439 +1445 [Anything] @@ -761,7 +761,7 @@ Mathematically speaking, the compositional fields satisfy an advection equation A warning for models with melt transport: In models with fluid flow, some compositional fields (in particular the porosity) might be transported with the fluid velocity, and would need to set the constraints based on the fluid velocity. However, this is currently not possible, because we reuse the same matrix for all compositional fields, and therefore can not use different constraints for different fields. Consequently, we set this parameter to true by default in models where melt transport is enabled. Be aware that if you change this default setting, you will not use the melt velocity, but the solid velocity to determine on which parts of the boundaries there is outflow. -1393 +1399 [Selection true|false|false for models without melt ] @@ -778,7 +778,7 @@ The names of the boundaries listed here can either be numbers (in which case the This parameter only describes which boundaries have a fixed composition, but not what composition should hold on these boundaries. The latter piece of information needs to be implemented in a plugin in the BoundaryComposition group, unless an existing implementation in this group already provides what you want. -1392 +1398 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -811,7 +811,7 @@ Because this class simply takes what the initial composition had described, this `spherical constant': A model in which the composition is chosen constant on the inner and outer boundaries of a sphere, spherical shell, chunk or ellipsoidal chunk. Parameters are read from subsection 'Spherical constant'. -1389 +1395 [MultipleSelection ascii data|box|box with lithosphere boundary indicators|function|initial composition|spherical constant ] @@ -828,7 +828,7 @@ add A comma-separated list of operators that will be used to append the listed composition models onto the previous models. If only one operator is given, the same operator is applied to all models. -1390 +1396 [MultipleSelection add|subtract|minimum|maximum|replace if valid ] @@ -865,7 +865,7 @@ Because this class simply takes what the initial composition had described, this \textbf{Warning}: This parameter provides an old and deprecated way of specifying boundary composition models and shouldn't be used. Please use 'List of model names' instead. -1391 +1397 [Selection ascii data|box|box with lithosphere boundary indicators|function|initial composition|spherical constant|unspecified ] @@ -883,7 +883,7 @@ $ASPECT_SOURCE_DIR/data/boundary-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. -1394 +1400 [DirectoryName] @@ -900,7 +900,7 @@ box_2d_%s.%d.txt The file name of the model data. Provide file in format: (File name).\%s\%d, where \%s is a string specifying the boundary of the model according to the names of the boundary indicators (of the chosen geometry model), and \%d is any sprintf integer qualifier specifying the format of the current file number. -1397 +1403 [Anything] @@ -917,7 +917,7 @@ The file name of the model data. Provide file in format: (File name).\%s\%d, whe Time step between following data files. Depending on the setting of the global `Use years in output instead of seconds' flag in the input file, this number is either interpreted as seconds or as years. The default is one million, i.e., either one million seconds or one million years. -1398 +1404 [Double 0...MAX_DOUBLE (inclusive)] @@ -934,7 +934,7 @@ false In some cases the boundary files are not numbered in increasing but in decreasing order (e.g. `Ma BP'). If this flag is set to `True' the plugin will first load the file with the number `First data file number' and decrease the file number during the model run. -1401 +1407 [Bool] @@ -951,7 +951,7 @@ In some cases the boundary files are not numbered in increasing but in decreasin The `First data file model time' parameter has been deactivated and will be removed in a future release. Do not use this parameter and instead provide data files starting from the model start time. -1399 +1405 [Double 0...MAX_DOUBLE (inclusive)] @@ -968,7 +968,7 @@ The `First data file model time' parameter has been deactivated and will be Number of the first velocity file to be loaded when the model time is larger than `First velocity file model time'. -1400 +1406 [Integer range -2147483648...2147483647 (inclusive)] @@ -985,7 +985,7 @@ Number of the first velocity file to be loaded when the model time is larger tha 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. -1396 +1402 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -1000,7 +1000,7 @@ Scalar factor, which is applied to the model data. You might want to use this to A comma separated list of composition boundary values at the bottom boundary (at minimal $y$-value in 2d, or minimal $z$-value in 3d). This list must have as many entries as there are compositional fields. Units: none. -1404 +1410 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -1013,7 +1013,7 @@ A comma separated list of composition boundary values at the bottom boundary (at A comma separated list of composition boundary values at the left boundary (at minimal $x$-value). This list must have as many entries as there are compositional fields. Units: none. -1402 +1408 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -1026,7 +1026,7 @@ A comma separated list of composition boundary values at the left boundary (at m A comma separated list of composition boundary values at the right boundary (at maximal $x$-value). This list must have as many entries as there are compositional fields. Units: none. -1403 +1409 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -1039,7 +1039,7 @@ A comma separated list of composition boundary values at the right boundary (at A comma separated list of composition boundary values at the top boundary (at maximal $y$-value in 2d, or maximal $z$-value in 3d). This list must have as many entries as there are compositional fields. Units: none. -1405 +1411 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -1054,7 +1054,7 @@ A comma separated list of composition boundary values at the top boundary (at ma A comma separated list of composition boundary values at the bottom boundary (at minimal $y$-value in 2d, or minimal $z$-value in 3d). This list must have as many entries as there are compositional fields. Units: none. -1418 +1424 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -1067,7 +1067,7 @@ A comma separated list of composition boundary values at the bottom boundary (at A comma separated list of composition boundary values at the left boundary (at minimal $x$-value). This list must have as many entries as there are compositional fields. Units: none. -1414 +1420 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -1080,7 +1080,7 @@ A comma separated list of composition boundary values at the left boundary (at m A comma separated list of composition boundary values at the left boundary (at minimal $x$-value). This list must have as many entries as there are compositional fields. Units: none. -1416 +1422 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -1093,7 +1093,7 @@ A comma separated list of composition boundary values at the left boundary (at m A comma separated list of composition boundary values at the right boundary (at maximal $x$-value). This list must have as many entries as there are compositional fields. Units: none. -1415 +1421 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -1106,7 +1106,7 @@ A comma separated list of composition boundary values at the right boundary (at A comma separated list of composition boundary values at the right boundary (at maximal $x$-value). This list must have as many entries as there are compositional fields. Units: none. -1417 +1423 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -1119,7 +1119,7 @@ A comma separated list of composition boundary values at the right boundary (at A comma separated list of composition boundary values at the top boundary (at maximal $y$-value in 2d, or maximal $z$-value in 3d). This list must have as many entries as there are compositional fields. Units: none. -1419 +1425 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -1138,7 +1138,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. -1406 +1412 [Selection cartesian|spherical|depth ] @@ -1153,7 +1153,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.) -1409 +1415 [Anything] @@ -1172,7 +1172,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. -1408 +1414 [Anything] @@ -1189,7 +1189,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. -1407 +1413 [Anything] @@ -1208,7 +1208,7 @@ The names of the variables as they will be used in the function, separated by co Maximal composition. Units: none. -1411 +1417 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -1225,7 +1225,7 @@ Maximal composition. Units: none. Minimal composition. Units: none. -1410 +1416 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -1244,7 +1244,7 @@ Minimal composition. Units: none. A comma separated list of composition boundary values at the bottom boundary (at minimal radius). This list must have one entry or as many entries as there are compositional fields. Units: none. -1413 +1419 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -1261,7 +1261,7 @@ A comma separated list of composition boundary values at the bottom boundary (at A comma separated list of composition boundary values at the top boundary (at maximal radius). This list must have one entry or as many entries as there are compositional fields. Units: none. -1412 +1418 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -1350,7 +1350,7 @@ The formula you describe in the mentioned section is a scalar value for the heat The symbol $t$ indicating time that may appear in the formulas for the prescribed heat flux is interpreted as having units seconds unless the global parameter ``Use years in output instead of seconds'' has been set. -1483 +1489 [Selection function ] @@ -1368,7 +1368,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. -1484 +1490 [Selection cartesian|spherical|depth ] @@ -1383,7 +1383,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.) -1487 +1493 [Anything] @@ -1402,7 +1402,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. -1486 +1492 [Anything] @@ -1419,7 +1419,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. -1485 +1491 [Anything] @@ -1441,7 +1441,7 @@ When the temperature is fixed on a given boundary as determined by the list of & Mathematically speaking, the temperature satisfies an advection-diffusion equation. For this type of equation, one can prescribe the temperature even on outflow boundaries as long as the diffusion coefficient is nonzero. This would correspond to the ``true'' setting of this parameter, which is correspondingly the default. In practice, however, this would only make physical sense if the diffusion coefficient is actually quite large to prevent the creation of a boundary layer. In addition, if there is no diffusion, one can only impose Dirichlet boundary conditions (i.e., prescribe a fixed temperature value at the boundary) at those boundaries where material flows in. This would correspond to the ``false'' setting of this parameter. -1329 +1335 [Bool] @@ -1460,7 +1460,7 @@ The names of the boundaries listed here can either be numbers (in which case the This parameter only describes which boundaries have a fixed temperature, but not what temperature should hold on these boundaries. The latter piece of information needs to be implemented in a plugin in the BoundaryTemperature group, unless an existing implementation in this group already provides what you want. -1328 +1334 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -1501,7 +1501,7 @@ Because this class simply takes what the initial temperature had described, this `spherical constant': A model in which the temperature is chosen constant on the inner and outer boundaries of a spherical shell, ellipsoidal chunk or chunk. Parameters are read from subsection 'Spherical constant'. -1325 +1331 [MultipleSelection ascii data|box|box with lithosphere boundary indicators|constant|dynamic core|function|initial temperature|spherical constant ] @@ -1518,7 +1518,7 @@ add A comma-separated list of operators that will be used to append the listed temperature models onto the previous models. If only one operator is given, the same operator is applied to all models. -1326 +1332 [MultipleSelection add|subtract|minimum|maximum|replace if valid ] @@ -1561,7 +1561,7 @@ Because this class simply takes what the initial temperature had described, this \textbf{Warning}: This parameter provides an old and deprecated way of specifying boundary temperature models and shouldn't be used. Please use 'List of model names' instead. -1327 +1333 [Selection ascii data|box|box with lithosphere boundary indicators|constant|dynamic core|function|initial temperature|spherical constant|unspecified ] @@ -1579,7 +1579,7 @@ $ASPECT_SOURCE_DIR/data/boundary-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. -1340 +1346 [DirectoryName] @@ -1596,7 +1596,7 @@ box_2d_%s.%d.txt The file name of the model data. Provide file in format: (File name).\%s\%d, where \%s is a string specifying the boundary of the model according to the names of the boundary indicators (of the chosen geometry model), and \%d is any sprintf integer qualifier specifying the format of the current file number. -1343 +1349 [Anything] @@ -1613,7 +1613,7 @@ The file name of the model data. Provide file in format: (File name).\%s\%d, whe Time step between following data files. Depending on the setting of the global `Use years in output instead of seconds' flag in the input file, this number is either interpreted as seconds or as years. The default is one million, i.e., either one million seconds or one million years. -1344 +1350 [Double 0...MAX_DOUBLE (inclusive)] @@ -1630,7 +1630,7 @@ false In some cases the boundary files are not numbered in increasing but in decreasing order (e.g. `Ma BP'). If this flag is set to `True' the plugin will first load the file with the number `First data file number' and decrease the file number during the model run. -1347 +1353 [Bool] @@ -1647,7 +1647,7 @@ In some cases the boundary files are not numbered in increasing but in decreasin The `First data file model time' parameter has been deactivated and will be removed in a future release. Do not use this parameter and instead provide data files starting from the model start time. -1345 +1351 [Double 0...MAX_DOUBLE (inclusive)] @@ -1664,7 +1664,7 @@ The `First data file model time' parameter has been deactivated and will be Number of the first velocity file to be loaded when the model time is larger than `First velocity file model time'. -1346 +1352 [Integer range -2147483648...2147483647 (inclusive)] @@ -1681,7 +1681,7 @@ Number of the first velocity file to be loaded when the model time is larger tha 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. -1342 +1348 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -1700,7 +1700,7 @@ Scalar factor, which is applied to the model data. You might want to use this to Temperature at the bottom boundary (at minimal $z$-value). Units: \si{\kelvin}. -1350 +1356 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -1717,7 +1717,7 @@ Temperature at the bottom boundary (at minimal $z$-value). Units: \si{\kelvin}. Temperature at the left boundary (at minimal $x$-value). Units: \si{\kelvin}. -1348 +1354 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -1734,7 +1734,7 @@ Temperature at the left boundary (at minimal $x$-value). Units: \si{\kelvin}. Temperature at the right boundary (at maximal $x$-value). Units: \si{\kelvin}. -1349 +1355 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -1751,7 +1751,7 @@ Temperature at the right boundary (at maximal $x$-value). Units: \si{\kelvin}. Temperature at the top boundary (at maximal $x$-value). Units: \si{\kelvin}. -1351 +1357 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -1770,7 +1770,7 @@ Temperature at the top boundary (at maximal $x$-value). Units: \si{\kelvin}. Temperature at the bottom boundary (at minimal $z$-value). Units: \si{\kelvin}. -1336 +1342 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -1787,7 +1787,7 @@ Temperature at the bottom boundary (at minimal $z$-value). Units: \si{\kelvin}. Temperature at the left boundary (at minimal $x$-value). Units: \si{\kelvin}. -1334 +1340 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -1804,7 +1804,7 @@ Temperature at the left boundary (at minimal $x$-value). Units: \si{\kelvin}. Temperature at the additional left lithosphere boundary (specified by user in Geometry Model). Units: \si{\kelvin}. -1338 +1344 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -1821,7 +1821,7 @@ Temperature at the additional left lithosphere boundary (specified by user in Ge Temperature at the right boundary (at maximal $x$-value). Units: \si{\kelvin}. -1335 +1341 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -1838,7 +1838,7 @@ Temperature at the right boundary (at maximal $x$-value). Units: \si{\kelvin}. Temperature at the additional right lithosphere boundary (specified by user in Geometry Model). Units: \si{\kelvin}. -1339 +1345 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -1855,7 +1855,7 @@ Temperature at the additional right lithosphere boundary (specified by user in G Temperature at the top boundary (at maximal $x$-value). Units: \si{\kelvin}. -1337 +1343 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -1870,7 +1870,7 @@ Temperature at the top boundary (at maximal $x$-value). Units: \si{\kelvin}. A comma separated list of mappings between boundary indicators and the temperature associated with the boundary indicators. The format for this list is ``indicator1 : value1, indicator2 : value2, ...'', where each indicator is a valid boundary indicator (either a number or the symbolic name of a boundary as provided by the geometry model) and each value is the temperature of that boundary. -1352 +1358 [Map of <[Anything]>:<[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -1889,7 +1889,7 @@ A comma separated list of mappings between boundary indicators and the temperatu Core thermal expansivity. Units: \si{\per\kelvin}. -1366 +1372 [Double 0...MAX_DOUBLE (inclusive)] @@ -1906,7 +1906,7 @@ Core thermal expansivity. Units: \si{\per\kelvin}. Compositional expansion coefficient $Beta_c$. See \cite{NPB+04} for more details. -1369 +1375 [Double 0...MAX_DOUBLE (inclusive)] @@ -1923,7 +1923,7 @@ Compositional expansion coefficient $Beta_c$. See \cite{NPB+04} for more details Pressure at CMB. Units: \si{\pascal}. -1360 +1366 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -1940,7 +1940,7 @@ Pressure at CMB. Units: \si{\pascal}. Core heat conductivity $k_c$. Units: \si{\watt\per\meter\per\kelvin}. -1371 +1377 [Double 0...MAX_DOUBLE (inclusive)] @@ -1957,7 +1957,7 @@ Core heat conductivity $k_c$. Units: \si{\watt\per\meter\per\kelvin}. Density of the core. Units: \si{\kilogram\per\meter\cubed}. -1358 +1364 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -1974,7 +1974,7 @@ Density of the core. Units: \si{\kilogram\per\meter\cubed}. Heat capacity of the core. Units: \si{\joule\per\kelvin\per\kilogram}. -1363 +1369 [Double 0...MAX_DOUBLE (inclusive)] @@ -1991,7 +1991,7 @@ Heat capacity of the core. Units: \si{\joule\per\kelvin\per\kilogram}. Partition coefficient of the light element. -1370 +1376 [Double 0...1 (inclusive)] @@ -2008,7 +2008,7 @@ Partition coefficient of the light element. Gravitation acceleration at CMB. Units: \si{\meter\per\second\squared}. -1359 +1365 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -2025,7 +2025,7 @@ Gravitation acceleration at CMB. Units: \si{\meter\per\second\squared}. Initial light composition (eg. S,O) concentration in weight fraction. -1361 +1367 [Double 0...MAX_DOUBLE (inclusive)] @@ -2042,7 +2042,7 @@ Initial light composition (eg. S,O) concentration in weight fraction. Temperature at the inner boundary (core mantle boundary) at the beginning. Units: \si{\kelvin}. -1354 +1360 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -2059,7 +2059,7 @@ Temperature at the inner boundary (core mantle boundary) at the beginning. Units Core compressibility at zero pressure. See \cite{NPB+04} for more details. -1364 +1370 [Double 0...MAX_DOUBLE (inclusive)] @@ -2076,7 +2076,7 @@ Core compressibility at zero pressure. See \cite{NPB+04} for more details. The latent heat of core freeze. Units: \si{\joule\per\kilogram}. -1367 +1373 [Double 0...MAX_DOUBLE (inclusive)] @@ -2093,7 +2093,7 @@ The latent heat of core freeze. Units: \si{\joule\per\kilogram}. The max iterations for nonlinear core energy solver. -1362 +1368 [Integer range 0...2147483647 (inclusive)] @@ -2110,7 +2110,7 @@ The max iterations for nonlinear core energy solver. Temperature at the outer boundary (lithosphere water/air). Units: \si{\kelvin}. -1353 +1359 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -2127,7 +2127,7 @@ Temperature at the outer boundary (lithosphere water/air). Units: \si{\kelvin}. The heat of reaction. Units: \si{\joule\per\kilogram}. -1368 +1374 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -2144,7 +2144,7 @@ The heat of reaction. Units: \si{\joule\per\kilogram}. Core density at zero pressure. Units: \si{\kilogram\per\meter\cubed}. See \cite{NPB+04} for more details. -1365 +1371 [Double 0...MAX_DOUBLE (inclusive)] @@ -2161,7 +2161,7 @@ Core density at zero pressure. Units: \si{\kilogram\per\meter\cubed}. See \cite{ Initial inner core radius changing rate. Units: \si{\kilo\meter}/year. -1356 +1362 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -2178,7 +2178,7 @@ Initial inner core radius changing rate. Units: \si{\kilo\meter}/year. Initial CMB temperature changing rate. Units: \si{\kelvin}/year. -1355 +1361 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -2195,7 +2195,7 @@ Initial CMB temperature changing rate. Units: \si{\kelvin}/year. Initial light composition changing rate. Units: 1/year. -1357 +1363 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -2213,7 +2213,7 @@ true If melting curve dependent on composition. -1376 +1382 [Bool] @@ -2230,7 +2230,7 @@ If melting curve dependent on composition. Melting curve (\cite{NPB+04} eq. (40)) parameter Theta. -1375 +1381 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -2247,7 +2247,7 @@ Melting curve (\cite{NPB+04} eq. (40)) parameter Theta. Melting curve (\cite{NPB+04} eq. (40)) parameter Tm0. Units: \si{\kelvin}. -1372 +1378 [Double 0...MAX_DOUBLE (inclusive)] @@ -2264,7 +2264,7 @@ Melting curve (\cite{NPB+04} eq. (40)) parameter Tm0. Units: \si{\kelvin}. Melting curve (\cite{NPB+04} eq. (40)) parameter Tm1. Units: \si{\per\tera\pascal}. -1373 +1379 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -2281,7 +2281,7 @@ Melting curve (\cite{NPB+04} eq. (40)) parameter Tm1. Units: \si{\per\tera\pasca Melting curve (\cite{NPB+04} eq. (40)) parameter Tm2. Units: \si{\per\tera\pascal\squared}. -1374 +1380 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -2298,7 +2298,7 @@ false If using the Fe-FeS system solidus from Buono \& Walker (2011) instead. -1377 +1383 [Bool] @@ -2313,7 +2313,7 @@ If using the Fe-FeS system solidus from Buono \& Walker (2011) instead. Data file name for other energy source into the core. The 'other energy source' is used for external core energy source.For example if someone want to test the early lunar core powered by precession (Dwyer, C. A., et al. (2011). A long-lived lunar dynamo driven by continuous mechanical stirring. Nature 479(7372): 212-214.)Format [Time(Gyr) Energy rate(W)] -1382 +1388 [Anything] @@ -2328,7 +2328,7 @@ Data file name for other energy source into the core. The 'other energy sou Half decay times of different elements (Ga) -1380 +1386 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -2341,7 +2341,7 @@ Half decay times of different elements (Ga) Heating rates of different elements (W/kg) -1379 +1385 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -2354,7 +2354,7 @@ Heating rates of different elements (W/kg) Initial concentrations of different elements (ppm) -1381 +1387 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -2371,7 +2371,7 @@ Initial concentrations of different elements (ppm) Number of different radioactive heating elements in core -1378 +1384 [Integer range 0...2147483647 (inclusive)] @@ -2391,7 +2391,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. -1383 +1389 [Selection cartesian|spherical|depth ] @@ -2406,7 +2406,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.) -1386 +1392 [Anything] @@ -2425,7 +2425,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. -1385 +1391 [Anything] @@ -2442,7 +2442,7 @@ If the function you are describing represents a vector-valued function with mult Maximal temperature. Units: \si{\kelvin}. -1388 +1394 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -2459,7 +2459,7 @@ Maximal temperature. Units: \si{\kelvin}. Minimal temperature. Units: \si{\kelvin}. -1387 +1393 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -2476,7 +2476,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. -1384 +1390 [Anything] @@ -2495,7 +2495,7 @@ The names of the variables as they will be used in the function, separated by co Maximal temperature. Units: \si{\kelvin}. -1331 +1337 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -2512,7 +2512,7 @@ Maximal temperature. Units: \si{\kelvin}. Minimal temperature. Units: \si{\kelvin}. -1330 +1336 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -2531,7 +2531,7 @@ Minimal temperature. Units: \si{\kelvin}. Temperature at the inner boundary (core mantle boundary). Units: \si{\kelvin}. -1333 +1339 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -2548,7 +2548,7 @@ Temperature at the inner boundary (core mantle boundary). Units: \si{\kelvin}. Temperature at the outer boundary (lithosphere water/air). Units: \si{\kelvin}. -1332 +1338 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -2582,7 +2582,7 @@ Gravity is expected to point along the depth direction. `zero traction': Implementation of a model in which the boundary traction is zero. This is commonly referred to as an ``open boundary condition'', indicating that the material experiences no forces in response to what might exist on the other side of the boundary. However, this is only true in the case where hydrostatic pressure is not relevant. If hydrostatic pressure is not negligible, for example at the sides of a regional model, the material at the other side of the boundary does exceed a force, namely the force normal to the boundary induced by the hydrostatic pressure. -1467 +1473 [Map of <[Anything]>:<[Selection ascii data|function|initial lithostatic pressure|zero traction ]> of length 0...4294967295 (inclusive)] @@ -2600,7 +2600,7 @@ $ASPECT_SOURCE_DIR/data/boundary-traction/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. -1468 +1474 [DirectoryName] @@ -2617,7 +2617,7 @@ box_2d_%s.%d.txt The file name of the model data. Provide file in format: (File name).\%s\%d, where \%s is a string specifying the boundary of the model according to the names of the boundary indicators (of the chosen geometry model), and \%d is any sprintf integer qualifier specifying the format of the current file number. -1471 +1477 [Anything] @@ -2634,7 +2634,7 @@ The file name of the model data. Provide file in format: (File name).\%s\%d, whe Time step between following data files. Depending on the setting of the global `Use years in output instead of seconds' flag in the input file, this number is either interpreted as seconds or as years. The default is one million, i.e., either one million seconds or one million years. -1472 +1478 [Double 0...MAX_DOUBLE (inclusive)] @@ -2651,7 +2651,7 @@ false In some cases the boundary files are not numbered in increasing but in decreasing order (e.g. `Ma BP'). If this flag is set to `True' the plugin will first load the file with the number `First data file number' and decrease the file number during the model run. -1475 +1481 [Bool] @@ -2668,7 +2668,7 @@ In some cases the boundary files are not numbered in increasing but in decreasin The `First data file model time' parameter has been deactivated and will be removed in a future release. Do not use this parameter and instead provide data files starting from the model start time. -1473 +1479 [Double 0...MAX_DOUBLE (inclusive)] @@ -2685,7 +2685,7 @@ The `First data file model time' parameter has been deactivated and will be Number of the first velocity file to be loaded when the model time is larger than `First velocity file model time'. -1474 +1480 [Integer range -2147483648...2147483647 (inclusive)] @@ -2702,7 +2702,7 @@ Number of the first velocity file to be loaded when the model time is larger tha 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. -1470 +1476 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -2721,7 +2721,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. -1476 +1482 [Selection cartesian|spherical|depth ] @@ -2736,7 +2736,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.) -1480 +1486 [Anything] @@ -2755,7 +2755,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. -1479 +1485 [Anything] @@ -2772,7 +2772,7 @@ false Specify traction as $r$, $\phi$, and $\theta$ components instead of $x$, $y$, and $z$. Positive tractions point up, east, and north (in 3d) or out and clockwise (in 2d). This setting only makes sense for spherical geometries. -1477 +1483 [Bool] @@ -2789,7 +2789,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. -1478 +1484 [Anything] @@ -2808,7 +2808,7 @@ The names of the variables as they will be used in the function, separated by co The number of integration points over which we integrate the lithostatic pressure downwards. -1482 +1488 [Integer range 0...2147483647 (inclusive)] @@ -2821,7 +2821,7 @@ The number of integration points over which we integrate the lithostatic pressur The point where the pressure profile will be calculated. Cartesian coordinates $(x,y,z)$ when geometry is a box, otherwise enter radius, longitude, and in 3d latitude. Note that the coordinate related to the depth ($y$ in 2d Cartesian, $z$ in 3d Cartesian and radius in spherical coordinates) is not used. Units: \si{\meter} or degrees. -1481 +1487 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -2855,7 +2855,7 @@ Likewise, since the symbol $t$ indicating time may appear in the formulas for th `zero velocity': Implementation of a model in which the boundary velocity is zero. This is commonly referred to as a ``stick boundary condition'', indicating that the material ``sticks'' to the material on the other side of the boundary. -1440 +1446 [Map of <[Anything]>:<[Selection ascii data|function|gplates|zero velocity ]> of length 0...4294967295 (inclusive)] @@ -2870,7 +2870,7 @@ A comma separated list of names denoting those boundaries on which the velocity The names of the boundaries listed here can either by 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. -1442 +1448 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -2885,7 +2885,7 @@ A comma separated list of names denoting those boundaries on which the velocity The names of the boundaries listed here can either by 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. -1441 +1447 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -2903,7 +2903,7 @@ $ASPECT_SOURCE_DIR/data/boundary-velocity/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. -1443 +1449 [DirectoryName] @@ -2920,7 +2920,7 @@ box_2d_%s.%d.txt The file name of the model data. Provide file in format: (File name).\%s\%d, where \%s is a string specifying the boundary of the model according to the names of the boundary indicators (of the chosen geometry model), and \%d is any sprintf integer qualifier specifying the format of the current file number. -1446 +1452 [Anything] @@ -2937,7 +2937,7 @@ The file name of the model data. Provide file in format: (File name).\%s\%d, whe Time step between following data files. Depending on the setting of the global `Use years in output instead of seconds' flag in the input file, this number is either interpreted as seconds or as years. The default is one million, i.e., either one million seconds or one million years. -1447 +1453 [Double 0...MAX_DOUBLE (inclusive)] @@ -2954,7 +2954,7 @@ false In some cases the boundary files are not numbered in increasing but in decreasing order (e.g. `Ma BP'). If this flag is set to `True' the plugin will first load the file with the number `First data file number' and decrease the file number during the model run. -1450 +1456 [Bool] @@ -2971,7 +2971,7 @@ In some cases the boundary files are not numbered in increasing but in decreasin The `First data file model time' parameter has been deactivated and will be removed in a future release. Do not use this parameter and instead provide data files starting from the model start time. -1448 +1454 [Double 0...MAX_DOUBLE (inclusive)] @@ -2988,7 +2988,7 @@ The `First data file model time' parameter has been deactivated and will be Number of the first velocity file to be loaded when the model time is larger than `First velocity file model time'. -1449 +1455 [Integer range -2147483648...2147483647 (inclusive)] @@ -3005,7 +3005,7 @@ Number of the first velocity file to be loaded when the model time is larger tha 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. -1445 +1451 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -3022,7 +3022,7 @@ false Specify velocity as r, phi, and theta components instead of x, y, and z. Positive velocities point up, east, and north (in 3d) or out and clockwise (in 2d). This setting only makes sense for spherical geometries. -1451 +1457 [Bool] @@ -3041,7 +3041,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. -1452 +1458 [Selection cartesian|spherical|depth ] @@ -3056,7 +3056,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.) -1456 +1462 [Anything] @@ -3075,7 +3075,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. -1455 +1461 [Anything] @@ -3092,7 +3092,7 @@ false Specify velocity as $r$, $\phi$, and $\theta$ components instead of $x$, $y$, and $z$. Positive velocities point up, east, and north (in 3d) or out and clockwise (in 2d). This setting only makes sense for spherical geometries. -1453 +1459 [Bool] @@ -3109,7 +3109,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. -1454 +1460 [Anything] @@ -3128,7 +3128,7 @@ $ASPECT_SOURCE_DIR/data/boundary-velocity/gplates/ 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. -1457 +1463 [DirectoryName] @@ -3145,7 +3145,7 @@ The name of a directory that contains the model data. This path may either be ab Time step between following velocity files. Depending on the setting of the global 'Use years in output instead of seconds' flag in the input file, this number is either interpreted as seconds or as years. The default is one million, i.e., either one million seconds or one million years. -1462 +1468 [Double 0...MAX_DOUBLE (inclusive)] @@ -3162,7 +3162,7 @@ false In some cases the boundary files are not numbered in increasing but in decreasing order (e.g. 'Ma BP'). If this flag is set to 'True' the plugin will first load the file with the number 'First velocity file number' and decrease the file number during the model run. -1461 +1467 [Bool] @@ -3179,7 +3179,7 @@ In some cases the boundary files are not numbered in increasing but in decreasin Time from which on the velocity file with number 'First velocity file number' is used as boundary condition. Previous to this time, a no-slip boundary condition is assumed. Depending on the setting of the global 'Use years in output instead of seconds' flag in the input file, this number is either interpreted as seconds or as years. -1459 +1465 [Double 0...MAX_DOUBLE (inclusive)] @@ -3196,7 +3196,7 @@ Time from which on the velocity file with number 'First velocity file numbe Number of the first velocity file to be loaded when the model time is larger than 'First velocity file model time'. -1460 +1466 [Integer range -2147483648...2147483647 (inclusive)] @@ -3213,7 +3213,7 @@ Number of the first velocity file to be loaded when the model time is larger tha Determines the depth of the lithosphere, so that the GPlates velocities can be applied at the sides of the model as well as at the surface. -1466 +1472 [Double 0...MAX_DOUBLE (inclusive)] @@ -3230,7 +3230,7 @@ Determines the depth of the lithosphere, so that the GPlates velocities can be a Point that determines the plane in which a 2d model lies in. Has to be in the format `a,b' where a and b are theta (polar angle) and phi in radians. This value is not utilized in 3d geometries, and can therefore be set to the default or any user-defined quantity. -1464 +1470 [Anything] @@ -3247,7 +3247,7 @@ Point that determines the plane in which a 2d model lies in. Has to be in the fo Point that determines the plane in which a 2d model lies in. Has to be in the format `a,b' where a and b are theta (polar angle) and phi in radians. This value is not utilized in 3d geometries, and can therefore be set to the default or any user-defined quantity. -1465 +1471 [Anything] @@ -3264,7 +3264,7 @@ Point that determines the plane in which a 2d model lies in. Has to be in the fo Scalar factor, which is applied to the boundary velocity. You might want to use this to scale the velocities to a reference model (e.g. with free-slip boundary) or another plate reconstruction. -1463 +1469 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -3281,7 +3281,7 @@ phi.%d The file name of the material data. Provide file in format: (Velocity file name).\%d.gpml where \%d is any sprintf integer qualifier, specifying the format of the current file number. -1458 +1464 [Anything] @@ -3964,7 +3964,7 @@ The model assigns boundary indicators as follows: In 2d, inner and outer boundar In 3d, inner and outer indicators are treated as in 2d. If the opening angle is chosen as 90 degrees, i.e., the domain is the intersection of a spherical shell and the first octant, then indicator 2 is at the face $x=0$, 3 at $y=0$, and 4 at $z=0$. These last three boundaries can then also be referred to as `east', `west' and `south' symbolically in input files. -1068 +1074 [Selection box|box with lithosphere boundary indicators|chunk|chunk with lithosphere boundary indicators|ellipsoidal chunk|sphere|spherical shell|unspecified ] @@ -3982,7 +3982,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}. -1112 +1118 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -3999,7 +3999,7 @@ X coordinate of box origin. Units: \si{\meter}. Y coordinate of box origin. Units: \si{\meter}. -1113 +1119 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -4016,7 +4016,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}. -1114 +1120 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -4033,7 +4033,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}. -1109 +1115 [Double 0...MAX_DOUBLE (inclusive)] @@ -4050,7 +4050,7 @@ false Whether the box should be periodic in X direction -1118 +1124 [Bool] @@ -4067,7 +4067,7 @@ Whether the box should be periodic in X direction Number of cells in X direction. -1115 +1121 [Integer range 1...2147483647 (inclusive)] @@ -4084,7 +4084,7 @@ Number of cells in X direction. Extent of the box in y-direction. Units: \si{\meter}. -1110 +1116 [Double 0...MAX_DOUBLE (inclusive)] @@ -4101,7 +4101,7 @@ false Whether the box should be periodic in Y direction -1119 +1125 [Bool] @@ -4118,7 +4118,7 @@ Whether the box should be periodic in Y direction Number of cells in Y direction. -1116 +1122 [Integer range 1...2147483647 (inclusive)] @@ -4135,7 +4135,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}. -1111 +1117 [Double 0...MAX_DOUBLE (inclusive)] @@ -4152,7 +4152,7 @@ false Whether the box should be periodic in Z direction -1120 +1126 [Bool] @@ -4169,7 +4169,7 @@ Whether the box should be periodic in Z direction Number of cells in Z direction. -1117 +1123 [Integer range 1...2147483647 (inclusive)] @@ -4188,7 +4188,7 @@ Number of cells in Z direction. X coordinate of box origin. Units: \si{\meter}. -1083 +1089 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -4205,7 +4205,7 @@ X coordinate of box origin. Units: \si{\meter}. Y coordinate of box origin. Units: \si{\meter}. -1084 +1090 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -4222,7 +4222,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}. -1085 +1091 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -4239,7 +4239,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. -1079 +1085 [Double 0...MAX_DOUBLE (inclusive)] @@ -4256,7 +4256,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. -1096 +1102 [Bool] @@ -4273,7 +4273,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}. -1080 +1086 [Double 0...MAX_DOUBLE (inclusive)] @@ -4290,7 +4290,7 @@ false Whether the box should be periodic in X direction. -1091 +1097 [Bool] @@ -4307,7 +4307,7 @@ false Whether the box should be periodic in X direction in the lithosphere. -1094 +1100 [Bool] @@ -4324,7 +4324,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. -1086 +1092 [Integer range 1...2147483647 (inclusive)] @@ -4341,7 +4341,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}. -1081 +1087 [Double 0...MAX_DOUBLE (inclusive)] @@ -4358,7 +4358,7 @@ false Whether the box should be periodic in Y direction. -1092 +1098 [Bool] @@ -4375,7 +4375,7 @@ false Whether the box should be periodic in Y direction in the lithosphere. This value is ignored if the simulation is in 2d. -1095 +1101 [Bool] @@ -4392,7 +4392,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. -1087 +1093 [Integer range 1...2147483647 (inclusive)] @@ -4409,7 +4409,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. -1089 +1095 [Integer range 1...2147483647 (inclusive)] @@ -4426,7 +4426,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}. -1082 +1088 [Double 0...MAX_DOUBLE (inclusive)] @@ -4443,7 +4443,7 @@ false Whether the box should be periodic in Z direction. This value is ignored if the simulation is in 2d. -1093 +1099 [Bool] @@ -4460,7 +4460,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. -1088 +1094 [Integer range 1...2147483647 (inclusive)] @@ -4477,7 +4477,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. -1090 +1096 [Integer range 1...2147483647 (inclusive)] @@ -4496,7 +4496,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}. -1121 +1127 [Double 0...MAX_DOUBLE (inclusive)] @@ -4513,7 +4513,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. -1126 +1132 [Double -90...90 (inclusive)] @@ -4530,7 +4530,7 @@ Maximum latitude of the chunk. This value is ignored if the simulation is in 2d. Maximum longitude of the chunk. Units: degrees. -1124 +1130 [Double -180...360 (inclusive)] @@ -4547,7 +4547,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. -1125 +1131 [Double -90...90 (inclusive)] @@ -4564,7 +4564,7 @@ Minimum latitude of the chunk. This value is ignored if the simulation is in 2d. Minimum longitude of the chunk. Units: degrees. -1123 +1129 [Double -180...360 (inclusive)] @@ -4581,7 +4581,7 @@ Minimum longitude of the chunk. Units: degrees. Radius at the top surface of the chunk. Units: \si{\meter}. -1122 +1128 [Double 0...MAX_DOUBLE (inclusive)] @@ -4598,7 +4598,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 -1129 +1135 [Integer range 1...2147483647 (inclusive)] @@ -4615,7 +4615,7 @@ Number of cells in latitude. This value is ignored if the simulation is in 2d Number of cells in longitude. -1128 +1134 [Integer range 1...2147483647 (inclusive)] @@ -4632,7 +4632,7 @@ Number of cells in longitude. Number of cells in radius. -1127 +1133 [Integer range 1...2147483647 (inclusive)] @@ -4651,7 +4651,7 @@ Number of cells in radius. Radius at the bottom surface of the chunk. Units: \si{\meter}. -1097 +1103 [Double 0...MAX_DOUBLE (inclusive)] @@ -4668,7 +4668,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. -1103 +1109 [Double -90...90 (inclusive)] @@ -4685,7 +4685,7 @@ Maximum latitude of the chunk. This value is ignored if the simulation is in 2d. Maximum longitude of the chunk. Units: degrees. -1101 +1107 [Double -180...360 (inclusive)] @@ -4702,7 +4702,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}. -1099 +1105 [Double 0...MAX_DOUBLE (inclusive)] @@ -4719,7 +4719,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. -1102 +1108 [Double -90...90 (inclusive)] @@ -4736,7 +4736,7 @@ Minimum latitude of the chunk. This value is ignored if the simulation is in 2d. Minimum longitude of the chunk. Units: degrees. -1100 +1106 [Double -180...360 (inclusive)] @@ -4753,7 +4753,7 @@ Minimum longitude of the chunk. Units: degrees. Radius at the top surface of the chunk. Units: \si{\meter}. -1098 +1104 [Double 0...MAX_DOUBLE (inclusive)] @@ -4770,7 +4770,7 @@ Radius at the top surface of the chunk. Units: \si{\meter}. Number of cells in radial direction for the lower chunk. -1105 +1111 [Integer range 1...2147483647 (inclusive)] @@ -4787,7 +4787,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 -1107 +1113 [Integer range 1...2147483647 (inclusive)] @@ -4804,7 +4804,7 @@ Number of cells in latitude. This value is ignored if the simulation is in 2d Number of cells in longitude. -1106 +1112 [Integer range 1...2147483647 (inclusive)] @@ -4821,7 +4821,7 @@ Number of cells in longitude. Number of cells in radial direction for the upper chunk. -1104 +1110 [Integer range 1...2147483647 (inclusive)] @@ -4838,7 +4838,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. -1108 +1114 [Bool] @@ -4857,7 +4857,7 @@ Whether to make the grid by gluing together two boxes, or just use one chunk to Bottom depth of model region. -1134 +1140 [Double 0...MAX_DOUBLE (inclusive)] @@ -4874,7 +4874,7 @@ Bottom depth of model region. The number of subdivisions of the coarse (initial) mesh in depth. -1139 +1145 [Integer range 0...2147483647 (inclusive)] @@ -4891,7 +4891,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. -1137 +1143 [Integer range 0...2147483647 (inclusive)] @@ -4908,7 +4908,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. -1136 +1142 [Double 0...MAX_DOUBLE (inclusive)] @@ -4921,7 +4921,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. -1130 +1136 [Anything] @@ -4934,7 +4934,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. -1131 +1137 [Anything] @@ -4951,7 +4951,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. -1138 +1144 [Integer range 0...2147483647 (inclusive)] @@ -4964,7 +4964,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. -1133 +1139 [Anything] @@ -4977,7 +4977,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. -1132 +1138 [Anything] @@ -4994,7 +4994,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. -1135 +1141 [Double 0...MAX_DOUBLE (inclusive)] @@ -5021,7 +5021,7 @@ Select one of the following models: `zero topography': Implementation of a model in which the initial topography is zero. -1140 +1146 [Selection ascii data|function|prm polygon|zero topography ] @@ -5039,7 +5039,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. -1141 +1147 [DirectoryName] @@ -5056,7 +5056,7 @@ box_2d_%s.0.txt The file name of the model data. -1142 +1148 [Anything] @@ -5073,7 +5073,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. -1143 +1149 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -5092,7 +5092,7 @@ cartesian A selection that determines the assumed coordinate system for the function variables. Allowed values are `cartesian' and `spherical'. `spherical' coordinates are interpreted as r,phi or r,phi,theta in 2d/3d respectively with theta being the polar angle. -1145 +1151 [Selection cartesian|spherical ] @@ -5107,7 +5107,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.) -1148 +1154 [Anything] @@ -5126,7 +5126,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. -1147 +1153 [Anything] @@ -5143,7 +5143,7 @@ If the function you are describing represents a vector-valued function with mult The maximum value the topography given by the function can take. -1144 +1150 [Double 0...MAX_DOUBLE (inclusive)] @@ -5160,7 +5160,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. -1146 +1152 [Anything] @@ -5175,7 +5175,7 @@ The names of the variables as they will be used in the function, separated by co Set the topography height and the polygon which should be set to that height. The format is : "The topography height extgreater The point list describing a polygon \& The next topography height extgreater the next point list describing a polygon." The format for the point list describing the polygon is "x1,y1;x2,y2". For example for two triangular areas of 100 and -100 meters high set: '100 extgreater 0,0;5,5;0,10 \& -100 extgreater 10,10;10,15;20,15'. Units of the height are always in meters. The units of the coordinates are dependent on the geometry model. In the box model they are in meters, in the chunks they are in degrees, etc. Please refer to the manual of the individual geometry model to so see how the topography is implemented. -1149 +1155 [Anything] @@ -5195,7 +5195,7 @@ Set the topography height and the polygon which should be set to that height. Th Radius of the sphere. Units: \si{\meter}. -1069 +1075 [Double 0...MAX_DOUBLE (inclusive)] @@ -5218,7 +5218,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. -1077 +1083 [Integer range 0...2147483647 (inclusive)] @@ -5235,7 +5235,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. -1070 +1076 [Selection none|list of radial values|number of slices ] @@ -5252,7 +5252,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. -1073 +1079 [Integer range 0...2147483647 (inclusive)] @@ -5273,7 +5273,7 @@ The default value of 3,481,000 m equals the radius of a sphere with equal volume ::: -1074 +1080 [Double 0...MAX_DOUBLE (inclusive)] @@ -5286,7 +5286,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. -1071 +1077 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -5303,7 +5303,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. -1072 +1078 [Integer range 1...2147483647 (inclusive)] @@ -5320,7 +5320,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. -1076 +1082 [Double 0...360 (inclusive)] @@ -5341,7 +5341,7 @@ The default value of 6,336,000 m equals the radius of a sphere with equal volume ::: -1075 +1081 [Double 0...MAX_DOUBLE (inclusive)] @@ -5358,7 +5358,7 @@ false Whether the shell should be periodic in the phi direction. -1078 +1084 [Bool] @@ -5390,7 +5390,7 @@ Select one of the following models: `vertical': A gravity model in which the gravity direction is vertical (pointing downward for positive values) and at a constant magnitude by default equal to one. -1150 +1156 [Selection ascii data|function|radial constant|radial earth-like|radial linear|vertical|unspecified ] @@ -5408,7 +5408,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. -1159 +1165 [DirectoryName] @@ -5425,7 +5425,7 @@ prem.txt The file name of the model data. -1160 +1166 [Anything] @@ -5442,7 +5442,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. -1161 +1167 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -5461,7 +5461,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. -1151 +1157 [Selection cartesian|spherical|depth ] @@ -5476,7 +5476,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.) -1154 +1160 [Anything] @@ -5495,7 +5495,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. -1153 +1159 [Anything] @@ -5512,7 +5512,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. -1152 +1158 [Anything] @@ -5531,7 +5531,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. -1155 +1161 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -5550,7 +5550,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}. -1157 +1163 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -5567,7 +5567,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}. -1156 +1162 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -5586,7 +5586,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. -1158 +1164 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -5634,7 +5634,7 @@ The formula is interpreted as having units W/kg. `shear heating with melt': Implementation of a standard model for shear heating of migrating melt, including bulk (compression) heating $\xi \left( \nabla \cdot \mathbf u_s \right)^2 $ and heating due to melt segregation $\frac{\eta_f \phi^2}{k} \left( \mathbf u_f - \mathbf u_s \right)^2 $. For full shear heating, this has to be used in combination with the heating model shear heating to also include shear heating for the solid part. -1045 +1051 [MultipleSelection adiabatic heating|adiabatic heating of melt|compositional heating|constant heating|function|latent heat|latent heat melt|radioactive decay|shear heating|shear heating with melt ] @@ -5652,7 +5652,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) $. -1063 +1069 [Bool] @@ -5671,7 +5671,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) $. -1064 +1070 [Bool] @@ -5690,7 +5690,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}. -1065 +1071 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -5707,7 +5707,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). -1066 +1072 [List of <[Integer range 0...1 (inclusive)]> of length 0...4294967295 (inclusive)] @@ -5726,7 +5726,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 $\rho H$. Units: W/kg. -1067 +1073 [Double 0...MAX_DOUBLE (inclusive)] @@ -5745,7 +5745,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. -1046 +1052 [Selection cartesian|spherical|depth ] @@ -5760,7 +5760,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.) -1049 +1055 [Anything] @@ -5779,7 +5779,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. -1048 +1054 [Anything] @@ -5796,7 +5796,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. -1047 +1053 [Anything] @@ -5815,7 +5815,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}. -1050 +1056 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -5832,7 +5832,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)$. -1051 +1057 [Bool] @@ -5851,7 +5851,7 @@ Instead of using the entropy change given in the 'Melting entropy change&ap Which composition field should be treated as crust -1059 +1065 [Integer range 0...2147483647 (inclusive)] @@ -5868,7 +5868,7 @@ false Whether crust defined by composition or depth -1057 +1063 [Bool] @@ -5885,7 +5885,7 @@ Whether crust defined by composition or depth Depth of the crust when crust if defined by depth. Units: \si{\meter}. -1058 +1064 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -5898,7 +5898,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'. -1054 +1060 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -5911,7 +5911,7 @@ Half decay times. Units: (Seconds), or (Years) if set `use years instead of seco Heating rates of different elements (W/kg) -1053 +1059 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -5924,7 +5924,7 @@ Heating rates of different elements (W/kg) Initial concentrations of different elements (ppm) -1055 +1061 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -5937,7 +5937,7 @@ Initial concentrations of different elements (ppm) Initial concentrations of different elements (ppm) -1056 +1062 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -5954,7 +5954,7 @@ Initial concentrations of different elements (ppm) Number of radioactive elements -1052 +1058 [Integer range 0...2147483647 (inclusive)] @@ -5973,7 +5973,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. -1061 +1067 [Double 0...MAX_DOUBLE (inclusive)] @@ -5990,7 +5990,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. -1062 +1068 [Double 0...MAX_DOUBLE (inclusive)] @@ -6007,7 +6007,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. -1060 +1066 [Bool] @@ -6041,7 +6041,7 @@ The following composition models are available: `world builder': Specify the initial composition through the World Builder. More information on the World Builder can be found at \url{https://geodynamicworldbuilder.github.io}. Make sure to specify the location of the World Builder file in the parameter 'World builder file'. It is possible to use the World Builder only for selected compositional fields by specifying the parameter 'List of relevant compositions'. -1277 +1283 [MultipleSelection adiabatic density|ascii data|ascii data layered|entropy table lookup|function|porosity|slab model|world builder ] @@ -6058,7 +6058,7 @@ add A comma-separated list of operators that will be used to append the listed composition models onto the previous models. If only one operator is given, the same operator is applied to all models. -1278 +1284 [MultipleSelection add|subtract|minimum|maximum|replace if valid ] @@ -6093,7 +6093,7 @@ Select one of the following models: \textbf{Warning}: This parameter provides an old and deprecated way of specifying initial composition models and shouldn't be used. Please use 'List of model names' instead. -1279 +1285 [Selection adiabatic density|ascii data|ascii data layered|entropy table lookup|function|porosity|slab model|world builder|unspecified ] @@ -6128,7 +6128,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. -1289 +1295 [DirectoryName] @@ -6145,7 +6145,7 @@ initial_composition_top_mantle_box_3d.txt The file name of the model data. -1287 +1293 [Anything] @@ -6162,7 +6162,7 @@ initial_composition_top_mantle_box_3d.txt The file names of the model data (comma separated). -1290 +1296 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -6179,7 +6179,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. -1284 +1290 [Anything] @@ -6196,7 +6196,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. -1291 +1297 [Selection piecewise constant|linear ] @@ -6213,7 +6213,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. -1288 +1294 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -6230,7 +6230,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. -1285 +1291 [Anything] @@ -6247,7 +6247,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. -1283 +1289 [Bool] @@ -6266,7 +6266,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. -1292 +1298 [DirectoryName] @@ -6283,7 +6283,7 @@ material_table_temperature_pressure.txt The file name of the material data. -1293 +1299 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -6302,7 +6302,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. -1294 +1300 [Selection cartesian|spherical|depth ] @@ -6317,7 +6317,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.) -1297 +1303 [Anything] @@ -6336,7 +6336,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. -1296 +1302 [Anything] @@ -6353,7 +6353,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. -1295 +1301 [Anything] @@ -6372,7 +6372,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. -1298 +1304 [DirectoryName] @@ -6389,7 +6389,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). -1301 +1307 [Anything] @@ -6406,7 +6406,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. -1300 +1306 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -6421,7 +6421,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. -1302 +1308 [Anything] @@ -6488,7 +6488,7 @@ Make sure the top and bottom temperatures of the lithosphere agree with temperat `world builder': Specify the initial temperature through the World Builder. More information on the World Builder can be found at \url{https://geodynamicworldbuilder.github.io}. Make sure to specify the location of the World Builder file in the parameter 'World builder file'. -1162 +1168 [MultipleSelection S40RTS perturbation|SAVANI perturbation|adiabatic|adiabatic boundary|ascii data|ascii data layered|ascii profile|continental geotherm|function|harmonic perturbation|inclusion shape perturbation|lithosphere mask|mandelbox|patch on S40RTS|perturbed box|polar box|prescribed temperature|random Gaussian perturbation|spherical gaussian perturbation|spherical hexagonal perturbation|world builder ] @@ -6505,7 +6505,7 @@ add A comma-separated list of operators that will be used to append the listed temperature models onto the previous models. If only one operator is given, the same operator is applied to all models. -1163 +1169 [MultipleSelection add|subtract|minimum|maximum|replace if valid ] @@ -6573,7 +6573,7 @@ Make sure the top and bottom temperatures of the lithosphere agree with temperat \textbf{Warning}: This parameter provides an old and deprecated way of specifying initial temperature models and shouldn't be used. Please use 'List of model names' instead. -1164 +1170 [Selection S40RTS perturbation|SAVANI perturbation|adiabatic|adiabatic boundary|ascii data|ascii data layered|ascii profile|continental geotherm|function|harmonic perturbation|inclusion shape perturbation|lithosphere mask|mandelbox|patch on S40RTS|perturbed box|polar box|prescribed temperature|random Gaussian perturbation|spherical gaussian perturbation|spherical hexagonal perturbation|world builder|unspecified ] @@ -6591,7 +6591,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. -1233 +1239 [Double 0...MAX_DOUBLE (inclusive)] @@ -6608,7 +6608,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. -1232 +1238 [Double 0...MAX_DOUBLE (inclusive)] @@ -6625,7 +6625,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. -1235 +1241 [Double 0...MAX_DOUBLE (inclusive)] @@ -6642,7 +6642,7 @@ half-space cooling Whether to use the half space cooling model or the plate cooling model -1239 +1245 [Selection half-space cooling|plate cooling ] @@ -6659,7 +6659,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. -1229 +1235 [DirectoryName] @@ -6676,7 +6676,7 @@ adiabatic.txt The file name of the model data. -1230 +1236 [Anything] @@ -6693,7 +6693,7 @@ The file name of the model data. Thickness of the lithosphere for plate cooling model. \si{\m} -1240 +1246 [Double 0...MAX_DOUBLE (inclusive)] @@ -6710,7 +6710,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. -1236 +1242 [Selection center ] @@ -6727,7 +6727,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. -1234 +1240 [Double 0...MAX_DOUBLE (inclusive)] @@ -6744,7 +6744,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. -1231 +1237 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -6763,7 +6763,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\`. -1237 +1243 [Double 0...MAX_DOUBLE (inclusive)] @@ -6780,7 +6780,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'. -1238 +1244 [Selection constant|function|ascii data ] @@ -6798,7 +6798,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. -1244 +1250 [Selection cartesian|spherical ] @@ -6813,7 +6813,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.) -1247 +1253 [Anything] @@ -6832,7 +6832,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. -1246 +1252 [Anything] @@ -6849,7 +6849,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. -1245 +1251 [Anything] @@ -6866,7 +6866,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.) -1243 +1249 [Anything] @@ -6885,7 +6885,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. -1242 +1248 [Anything] @@ -6902,7 +6902,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. -1241 +1247 [Anything] @@ -6922,7 +6922,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}. -1253 +1259 [Double 0...MAX_DOUBLE (inclusive)] @@ -6939,7 +6939,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. -1248 +1254 [DirectoryName] @@ -6956,7 +6956,7 @@ adiabatic_boundary.txt The file name of the model data. -1249 +1255 [Anything] @@ -6973,7 +6973,7 @@ The file name of the model data. The value of the isothermal boundary temperature. Units: \si{\kelvin}. -1251 +1257 [Double 0...MAX_DOUBLE (inclusive)] @@ -6990,7 +6990,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. -1250 +1256 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -7007,7 +7007,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}. -1252 +1258 [Double 0...MAX_DOUBLE (inclusive)] @@ -7026,7 +7026,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. -1263 +1269 [DirectoryName] @@ -7043,7 +7043,7 @@ initial_isotherm_500K_box_3d.txt The file name of the model data. -1261 +1267 [Anything] @@ -7060,7 +7060,7 @@ initial_isotherm_500K_box_3d.txt The file names of the model data (comma separated). -1264 +1270 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -7077,7 +7077,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. -1258 +1264 [Anything] @@ -7094,7 +7094,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. -1265 +1271 [Selection piecewise constant|linear ] @@ -7111,7 +7111,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. -1262 +1268 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -7128,7 +7128,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. -1259 +1265 [Anything] @@ -7145,7 +7145,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. -1257 +1263 [Bool] @@ -7164,7 +7164,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. -1266 +1272 [DirectoryName] @@ -7181,7 +7181,7 @@ simple_test.txt The file name of the model data. -1267 +1273 [Anything] @@ -7198,7 +7198,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. -1268 +1274 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -7217,7 +7217,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}. -1173 +1179 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -7234,7 +7234,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}. -1175 +1181 [Double 0...MAX_DOUBLE (inclusive)] @@ -7251,7 +7251,7 @@ The value of the isotherm that is assumed at the Lithosphere-Asthenosphere bound The value of the surface temperature. Units: \si{\kelvin}. -1174 +1180 [Double 0...MAX_DOUBLE (inclusive)] @@ -7270,7 +7270,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. -1176 +1182 [Selection cartesian|spherical|depth ] @@ -7285,7 +7285,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.) -1179 +1185 [Anything] @@ -7304,7 +7304,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. -1178 +1184 [Anything] @@ -7321,7 +7321,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. -1177 +1183 [Anything] @@ -7340,7 +7340,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. -1181 +1187 [Integer range -2147483648...2147483647 (inclusive)] @@ -7357,7 +7357,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. -1182 +1188 [Integer range -2147483648...2147483647 (inclusive)] @@ -7374,7 +7374,7 @@ Doubled second lateral wave number of the harmonic perturbation. Equals the sphe The magnitude of the Harmonic perturbation. -1183 +1189 [Double 0...MAX_DOUBLE (inclusive)] @@ -7391,7 +7391,7 @@ The magnitude of the Harmonic perturbation. The reference temperature that is perturbed by the harmonic function. Only used in incompressible models. -1184 +1190 [Double 0...MAX_DOUBLE (inclusive)] @@ -7408,7 +7408,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. -1180 +1186 [Integer range -2147483648...2147483647 (inclusive)] @@ -7427,7 +7427,7 @@ Doubled radial wave number of the harmonic perturbation. One equals half of a s The background temperature for the temperature field. -1272 +1278 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -7444,7 +7444,7 @@ The background temperature for the temperature field. The X coordinate for the center of the shape. -1274 +1280 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -7461,7 +7461,7 @@ The X coordinate for the center of the shape. The Y coordinate for the center of the shape. -1275 +1281 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -7478,7 +7478,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. -1276 +1282 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -7495,7 +7495,7 @@ constant The gradient of the inclusion to be generated. -1270 +1276 [Selection gaussian|linear|constant ] @@ -7512,7 +7512,7 @@ circle The shape of the inclusion to be generated. -1269 +1275 [Selection square|circle ] @@ -7529,7 +7529,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. -1273 +1279 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -7546,7 +7546,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. -1271 +1277 [Double 0...MAX_DOUBLE (inclusive)] @@ -7565,7 +7565,7 @@ $ASPECT_SOURCE_DIR/data/initial-temperature/lithosphere-mask/ The path to the LAB depth data file -1187 +1193 [DirectoryName] @@ -7582,7 +7582,7 @@ Value Method that is used to specify the depth of the lithosphere-asthenosphere boundary. -1185 +1191 [Selection File|Value ] @@ -7599,7 +7599,7 @@ LAB_CAM2016.txt File from which the lithosphere-asthenosphere boundary depth data is read. -1188 +1194 [FileName (Type: input)] @@ -7616,7 +7616,7 @@ File from which the lithosphere-asthenosphere boundary depth data is read. The initial temperature within lithosphere, applied abovethe maximum lithosphere depth. -1189 +1195 [Double 0...MAX_DOUBLE (inclusive)] @@ -7633,7 +7633,7 @@ The initial temperature within lithosphere, applied abovethe maximum lithosphere Units: \si{\meter}.The maximum depth of the lithosphere. The model will be NaNs below this depth. -1186 +1192 [Double 0...MAX_DOUBLE (inclusive)] @@ -7652,7 +7652,7 @@ Units: \si{\meter}.The maximum depth of the lithosphere. The model will be NaNs The maximum depth of the Vs ascii grid. The model will read in Vs from S40RTS below this depth. -1190 +1196 [Double 0...MAX_DOUBLE (inclusive)] @@ -7669,7 +7669,7 @@ The maximum depth of the Vs ascii grid. The model will read in Vs from S40RTS b This will set the heterogeneity prescribed by the Vs ascii grid and 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 660 km, but your closest spherical depth layers are only at 500 km and 750 km (due to a coarse resolution) it will only zero out heterogeneities down to 500 km. Similar caution has to be taken when using adaptive meshing. -1192 +1198 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -7686,7 +7686,7 @@ This will set the heterogeneity prescribed by the Vs ascii grid and S40RTS to ze The depth range (above maximum grid depth) over which to smooth. The boundary is smoothed using a depth weighted combination of Vs values from the ascii grid and S40RTS at each point in the region of smoothing. -1191 +1197 [Double 0...MAX_DOUBLE (inclusive)] @@ -7704,7 +7704,7 @@ $ASPECT_SOURCE_DIR/data/initial-temperature/patch-on-S40RTS/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. -1193 +1199 [DirectoryName] @@ -7721,7 +7721,7 @@ upper_shell_3d.txt The file name of the model data. -1194 +1200 [Anything] @@ -7738,7 +7738,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. -1195 +1201 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -7758,7 +7758,7 @@ Scalar factor, which is applied to the model data. You might want to use this to The maximum magnitude of the Gaussian perturbation. For each perturbation, a random magnitude between plus and minus the maximum magnitude will be chosen. Units: \si{\kelvin}. -1197 +1203 [Double 0...MAX_DOUBLE (inclusive)] @@ -7775,7 +7775,7 @@ The maximum magnitude of the Gaussian perturbation. For each perturbation, a ran Total number of perturbations to be introduced into the model. Perturbations will be placed at random locations within the model domain. -1196 +1202 [Integer range -2147483648...2147483647 (inclusive)] @@ -7792,7 +7792,7 @@ Total number of perturbations to be introduced into the model. Perturbations wil The Gaussian RMS width of the perturbations. Units: \si{\meter}. -1198 +1204 [Double 0...MAX_DOUBLE (inclusive)] @@ -7811,7 +7811,7 @@ $ASPECT_SOURCE_DIR/data/initial-temperature/S40RTS/ The path to the model data. -1199 +1205 [DirectoryName] @@ -7828,7 +7828,7 @@ S40RTS.sph The file name of the spherical harmonics coefficients from Ritsema et al. -1200 +1206 [Anything] @@ -7845,7 +7845,7 @@ The file name of the spherical harmonics coefficients from Ritsema et al. The maximum degree the users specify when reading the data file of spherical harmonic coefficients, which must be smaller than the maximum degree the data file stored. This parameter will be used only if 'Specify a lower maximum degree' is set to true. -1210 +1216 [Integer range 0...2147483647 (inclusive)] @@ -7862,7 +7862,7 @@ The maximum degree the users specify when reading the data file of spherical har The reference temperature that is perturbed by the spherical harmonic functions. Only used in incompressible models. -1207 +1213 [Double 0...MAX_DOUBLE (inclusive)] @@ -7879,7 +7879,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. -1206 +1212 [Bool] @@ -7896,7 +7896,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 660 km, but your closest spherical depth layers are only at 500 km and 750 km (due to a coarse resolution) it will only zero out heterogeneities down to 500 km. Similar caution has to be taken when using adaptive meshing. -1208 +1214 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -7913,7 +7913,7 @@ false Option to use a lower maximum degree 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 degree. -1209 +1215 [Bool] @@ -7930,7 +7930,7 @@ Spline_knots.txt The file name of the spline knot locations from Ritsema et al. -1201 +1207 [Anything] @@ -7947,7 +7947,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}. -1204 +1210 [Double 0...MAX_DOUBLE (inclusive)] @@ -7964,7 +7964,7 @@ false Option to take the thermal expansion coefficient from the material model instead of from what is specified in this section. -1205 +1211 [Bool] @@ -7981,7 +7981,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. -1203 +1209 [Double 0...MAX_DOUBLE (inclusive)] @@ -7998,7 +7998,7 @@ constant Method that is used to specify how the vs-to-density scaling varies with depth. -1202 +1208 [Selection file|constant ] @@ -8016,7 +8016,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. -1211 +1217 [DirectoryName] @@ -8033,7 +8033,7 @@ vs_to_density_Steinberger.txt The file name of the model data. -1212 +1218 [Anything] @@ -8050,7 +8050,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. -1213 +1219 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -8070,7 +8070,7 @@ $ASPECT_SOURCE_DIR/data/initial-temperature/SAVANI/ The path to the model data. -1214 +1220 [DirectoryName] @@ -8087,7 +8087,7 @@ savani.dlnvs.60.m.ab The file name of the spherical harmonics coefficients from Auer et al. -1215 +1221 [Anything] @@ -8104,7 +8104,7 @@ The file name of the spherical harmonics coefficients from Auer et al. The maximum degree the users specify when reading the data file of spherical harmonic coefficients, which must be smaller than the maximum degree the data file stored. This parameter will be used only if 'Specify a lower maximum degree' is set to true. -1225 +1231 [Integer range 0...2147483647 (inclusive)] @@ -8121,7 +8121,7 @@ The maximum degree the users specify when reading the data file of spherical har The reference temperature that is perturbed by the spherical harmonic functions. Only used in incompressible models. -1222 +1228 [Double 0...MAX_DOUBLE (inclusive)] @@ -8138,7 +8138,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. -1221 +1227 [Bool] @@ -8155,7 +8155,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 660 km, but your closest spherical depth layers are only at 500 km and 750 km (due to a coarse resolution) it will only zero out heterogeneities down to 500 km. Similar caution has to be taken when using adaptive meshing. -1223 +1229 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -8172,7 +8172,7 @@ false Option to use a lower maximum degree 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 degree. -1224 +1230 [Bool] @@ -8189,7 +8189,7 @@ Spline_knots.txt The file name of the spline knots taken from the 28 spherical layers of SAVANI tomography model. -1216 +1222 [Anything] @@ -8206,7 +8206,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}. -1219 +1225 [Double 0...MAX_DOUBLE (inclusive)] @@ -8223,7 +8223,7 @@ false Option to take the thermal expansion coefficient from the material model instead of from what is specified in this section. -1220 +1226 [Bool] @@ -8240,7 +8240,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. -1218 +1224 [Double 0...MAX_DOUBLE (inclusive)] @@ -8257,7 +8257,7 @@ constant Method that is used to specify how the vs-to-density scaling varies with depth. -1217 +1223 [Selection file|constant ] @@ -8275,7 +8275,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. -1226 +1232 [DirectoryName] @@ -8292,7 +8292,7 @@ vs_to_density_Steinberger.txt The file name of the model data. -1227 +1233 [Anything] @@ -8309,7 +8309,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. -1228 +1234 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -8329,7 +8329,7 @@ Scalar factor, which is applied to the model data. You might want to use this to The amplitude of the perturbation. -1169 +1175 [Double 0...MAX_DOUBLE (inclusive)] @@ -8346,7 +8346,7 @@ The amplitude of the perturbation. The angle where the center of the perturbation is placed. -1167 +1173 [Double 0...MAX_DOUBLE (inclusive)] @@ -8363,7 +8363,7 @@ initial-geotherm-table The file from which the initial geotherm table is to be read. The format of the file is defined by what is read in source/initial\_temperature/spherical\_shell.cc. -1172 +1178 [FileName (Type: input)] @@ -8380,7 +8380,7 @@ The file from which the initial geotherm table is to be read. The format of the The non-dimensional radial distance where the center of the perturbation is placed. -1168 +1174 [Double 0...MAX_DOUBLE (inclusive)] @@ -8397,7 +8397,7 @@ The non-dimensional radial distance where the center of the perturbation is plac The standard deviation of the Gaussian perturbation. -1170 +1176 [Double 0...MAX_DOUBLE (inclusive)] @@ -8414,7 +8414,7 @@ The standard deviation of the Gaussian perturbation. The sign of the perturbation. -1171 +1177 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -8433,7 +8433,7 @@ The sign of the perturbation. The number of convection cells with which to perturb the system. -1165 +1171 [Integer range -2147483648...2147483647 (inclusive)] @@ -8450,7 +8450,7 @@ The number of convection cells with which to perturb the system. Amount of clockwise rotation in degrees to apply to the perturbations. Default is set to -45 in order to provide backwards compatibility. -1166 +1172 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -8688,7 +8688,7 @@ Viscous stress may also be limited by a non-linear stress limiter that has a for When more than one compositional field is present at a point, they are averaged arithmetically. An exception is viscosity, which may be averaged arithmetically, harmonically, geometrically, or by selecting the viscosity of the composition field with the greatest volume fraction. -454 +456 [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|reactive fluid transport|replace lithosphere viscosity|simple|simple compressible|simpler|visco plastic|viscoelastic|unspecified ] @@ -8706,7 +8706,7 @@ Viscous stress may also be limited by a non-linear stress limiter that has a for Reference conductivity -968 +974 [Double 0...MAX_DOUBLE (inclusive)] @@ -8723,7 +8723,7 @@ Reference conductivity The temperature dependence of viscosity. Dimensionless exponent. -971 +977 [Double 0...MAX_DOUBLE (inclusive)] @@ -8740,7 +8740,7 @@ The temperature dependence of viscosity. Dimensionless exponent. A list of depths where the viscosity changes. Values must monotonically increase. Units: \si{\meter}. -972 +978 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -8757,7 +8757,7 @@ false Whether to use the TALA instead of the ALA approximation. -970 +976 [Bool] @@ -8774,7 +8774,7 @@ Whether to use the TALA instead of the ALA approximation. Viscosity -969 +975 [Double 0...MAX_DOUBLE (inclusive)] @@ -8791,7 +8791,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. -973 +979 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -8809,7 +8809,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. -974 +980 [DirectoryName] @@ -8822,7 +8822,7 @@ The name of a directory that contains the model data. This path may either be ab The file name of the model data. -975 +981 [Anything] @@ -8839,7 +8839,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. -976 +982 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -8859,7 +8859,7 @@ none Choose the averaging operation to use. -978 +984 [Selection none|arithmetic average|harmonic average|geometric average|pick largest|log average|nwd arithmetic average|nwd harmonic average|nwd geometric average ] @@ -8876,7 +8876,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. -977 +983 [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|reactive fluid transport|replace lithosphere viscosity|simple|simple compressible|simpler|visco plastic|viscoelastic ] @@ -8893,7 +8893,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. -979 +985 [Double 0...MAX_DOUBLE (inclusive)] @@ -8912,7 +8912,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. -980 +986 [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|reactive fluid transport|replace lithosphere viscosity|simple|simple compressible|simpler|visco plastic|viscoelastic|unspecified ] @@ -8929,7 +8929,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. -981 +987 [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|reactive fluid transport|replace lithosphere viscosity|simple|simple compressible|simpler|visco plastic|viscoelastic|unspecified ] @@ -8946,7 +8946,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. -982 +988 [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|reactive fluid transport|replace lithosphere viscosity|simple|simple compressible|simpler|visco plastic|viscoelastic|unspecified ] @@ -8963,7 +8963,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. -983 +989 [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|reactive fluid transport|replace lithosphere viscosity|simple|simple compressible|simpler|visco plastic|viscoelastic|unspecified ] @@ -8980,7 +8980,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. -984 +990 [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|reactive fluid transport|replace lithosphere viscosity|simple|simple compressible|simpler|visco plastic|viscoelastic|unspecified ] @@ -8997,7 +8997,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. -985 +991 [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|reactive fluid transport|replace lithosphere viscosity|simple|simple compressible|simpler|visco plastic|viscoelastic|unspecified ] @@ -9014,7 +9014,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. -986 +992 [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|reactive fluid transport|replace lithosphere viscosity|simple|simple compressible|simpler|visco plastic|viscoelastic|unspecified ] @@ -9031,7 +9031,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. -987 +993 [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|reactive fluid transport|replace lithosphere viscosity|simple|simple compressible|simpler|visco plastic|viscoelastic|unspecified ] @@ -9048,7 +9048,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. -988 +994 [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|reactive fluid transport|replace lithosphere viscosity|simple|simple compressible|simpler|visco plastic|viscoelastic|unspecified ] @@ -9067,7 +9067,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. -997 +1003 [Double 0...MAX_DOUBLE (inclusive)] @@ -9084,7 +9084,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. -998 +1004 [Double 0...MAX_DOUBLE (inclusive)] @@ -9101,7 +9101,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. -993 +999 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -9118,7 +9118,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. -994 +1000 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -9135,7 +9135,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}. -1001 +1007 [Double 0...MAX_DOUBLE (inclusive)] @@ -9152,7 +9152,7 @@ Above this depth the compositional fields react: The first field gets converted Reference density $\rho_0$. Units: \si{\kilogram\per\meter\cubed}. -989 +995 [Double 0...MAX_DOUBLE (inclusive)] @@ -9169,7 +9169,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}. -991 +997 [Double 0...MAX_DOUBLE (inclusive)] @@ -9186,7 +9186,7 @@ The value of the specific heat $C_p$. Units: \si{\joule\per\kelvin\per\kilogram} The reference temperature $T_0$. Units: \si{\kelvin}. -995 +1001 [Double 0...MAX_DOUBLE (inclusive)] @@ -9203,7 +9203,7 @@ The reference temperature $T_0$. Units: \si{\kelvin}. The value of the thermal conductivity $k$. Units: \si{\watt\per\meter\per\kelvin}. -1000 +1006 [Double 0...MAX_DOUBLE (inclusive)] @@ -9220,7 +9220,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}. -992 +998 [Double 0...MAX_DOUBLE (inclusive)] @@ -9237,7 +9237,7 @@ The value of the thermal expansion coefficient $\alpha$. Units: \si{\per\kelvin} The temperature dependence of viscosity. Dimensionless exponent. -999 +1005 [Double 0...MAX_DOUBLE (inclusive)] @@ -9254,7 +9254,7 @@ The temperature dependence of viscosity. Dimensionless exponent. The value of the constant viscosity. Units: \si{\kilogram\per\meter\per\second}. -996 +1002 [Double 0...MAX_DOUBLE (inclusive)] @@ -9273,7 +9273,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. -1005 +1011 [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|reactive fluid transport|replace lithosphere viscosity|simple|simple compressible|simpler|visco plastic|viscoelastic ] @@ -9290,7 +9290,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. -1002 +1008 [DirectoryName] @@ -9307,7 +9307,7 @@ ascii_depth_profile.txt The file name of the model data. -1003 +1009 [Anything] @@ -9324,7 +9324,7 @@ None Method that is used to specify how the viscosity should vary with depth. -1006 +1012 [Selection Function|File|List|None ] @@ -9337,7 +9337,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. -1007 +1013 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -9354,7 +9354,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}. -1009 +1015 [Double 0...MAX_DOUBLE (inclusive)] @@ -9371,7 +9371,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. -1004 +1010 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -9392,7 +9392,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''. -1008 +1014 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -9408,7 +9408,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.) -1012 +1018 [Anything] @@ -9423,7 +9423,7 @@ A typical example would be to set this runtime parameter to `pi=3.1415926536&apo -1013 +1019 [Anything] @@ -9440,7 +9440,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. -1010 +1016 [Anything] @@ -9460,7 +9460,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. -893 +899 [DirectoryName] @@ -9477,7 +9477,7 @@ ascii_depth_profile.txt The file name of the model data. -894 +900 [Anything] @@ -9494,7 +9494,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. -895 +901 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -9513,7 +9513,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 all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: \si{\joule\per\mole}. -1038 +1044 [Anything] @@ -9530,7 +9530,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 all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: \si{\joule\per\mole}. -1043 +1049 [Anything] @@ -9547,7 +9547,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 all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: \si{\meter\cubed\per\mole}. -1039 +1045 [Anything] @@ -9564,7 +9564,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 all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: \si{\meter\cubed\per\mole}. -1044 +1050 [Anything] @@ -9581,7 +9581,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 all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: \si{\kilogram\per\meter\cubed}. -1023 +1029 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -9598,7 +9598,7 @@ List of densities, $\rho$, for background mantle and compositional fields, for a Scaling coefficient for effective viscosity. -1018 +1024 [Double 0...MAX_DOUBLE (inclusive)] @@ -9615,7 +9615,7 @@ Scaling coefficient for effective viscosity. The fixed grain size of the material. This grain size is only used if the parent material model does not provide its own (possibly variable) grain size when calling this rheology.Units: \si{\meter}. -1040 +1046 [Double 0...MAX_DOUBLE (inclusive)] @@ -9632,7 +9632,7 @@ The fixed grain size of the material. This grain size is only used if the parent 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 all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: None. -1037 +1043 [Anything] @@ -9649,7 +9649,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}. -1022 +1028 [Double 0...MAX_DOUBLE (inclusive)] @@ -9666,7 +9666,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. -1020 +1026 [Integer range 0...2147483647 (inclusive)] @@ -9683,7 +9683,7 @@ Maximum number of iterations to find the correct diffusion/dislocation strain ra Upper cutoff for effective viscosity. Units: \si{\pascal\second}. -1017 +1023 [Double 0...MAX_DOUBLE (inclusive)] @@ -9700,7 +9700,7 @@ Upper cutoff for effective viscosity. Units: \si{\pascal\second}. Stabilizes strain dependent viscosity. Units: \si{\per\second}. -1015 +1021 [Double 0...MAX_DOUBLE (inclusive)] @@ -9717,7 +9717,7 @@ Stabilizes strain dependent viscosity. Units: \si{\per\second}. Lower cutoff for effective viscosity. Units: \si{\pascal\second}. -1016 +1022 [Double 0...MAX_DOUBLE (inclusive)] @@ -9734,7 +9734,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 all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: \si{\per\pascal\meter}$^{m_{\text{diffusion}}}$\si{\per\second}. -1035 +1041 [Anything] @@ -9751,7 +9751,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 all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: \si{\pascal}$^{-n_{\text{dislocation}}}$ \si{\per\second}. -1041 +1047 [Anything] @@ -9768,7 +9768,7 @@ List of viscosity prefactors, $A$, for background material and compositional fie For calculating density by thermal expansivity. Units: \si{\kelvin}. -1014 +1020 [Double 0...MAX_DOUBLE (inclusive)] @@ -9785,7 +9785,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. -1019 +1025 [Double 0...MAX_DOUBLE (inclusive)] @@ -9802,7 +9802,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 all compositional fields or only those corresponding to chemical compositions. 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. -1036 +1042 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -9819,7 +9819,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 all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: None. -1042 +1048 [Anything] @@ -9836,7 +9836,7 @@ List of stress exponents, $n_{\text{dislocation}}$, for background material and Units: \si{\meter\squared\per\second}. -1021 +1027 [Double 0...MAX_DOUBLE (inclusive)] @@ -9853,7 +9853,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 all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: \si{\per\kelvin}. -1024 +1030 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -9870,7 +9870,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. -1025 +1031 [Selection arithmetic|harmonic|geometric|maximum composition ] @@ -9889,7 +9889,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}. -864 +870 [Double 0...MAX_DOUBLE (inclusive)] @@ -9906,7 +9906,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}. -866 +872 [Double 0...MAX_DOUBLE (inclusive)] @@ -9923,7 +9923,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}. -868 +874 [Double 0...MAX_DOUBLE (inclusive)] @@ -9940,7 +9940,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}. -869 +875 [Double 0...MAX_DOUBLE (inclusive)] @@ -9957,7 +9957,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}. -867 +873 [Double 0...MAX_DOUBLE (inclusive)] @@ -9975,7 +9975,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. -873 +879 [Double 0...MAX_DOUBLE (inclusive)] @@ -9992,7 +9992,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}. -874 +880 [Double 0...MAX_DOUBLE (inclusive)] @@ -10009,7 +10009,7 @@ The value of the cohesion $C$. Units: \si{\pascal}. The value of the maximum viscosity cutoff $\eta_max$. Units: \si{\pascal\second}. -871 +877 [Double 0...MAX_DOUBLE (inclusive)] @@ -10026,7 +10026,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}. -870 +876 [Double 0...MAX_DOUBLE (inclusive)] @@ -10043,7 +10043,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}. -872 +878 [Double 0...MAX_DOUBLE (inclusive)] @@ -10063,7 +10063,7 @@ The value of the initial strain rate prescribed during the first nonlinear itera 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. -882 +888 [Double 0...MAX_DOUBLE (inclusive)] @@ -10080,7 +10080,7 @@ The value of the angle of internal friction, $\phi$.For a value of zero, in 2D t The value of the cohesion, $C$. The extremely large defaultcohesion value (1e20 Pa) prevents the viscous stress from exceeding the yield stress. Units: \si{\pascal}. -883 +889 [Double 0...MAX_DOUBLE (inclusive)] @@ -10097,7 +10097,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. -875 +881 [DirectoryName] @@ -10114,7 +10114,7 @@ temp-viscosity-prefactor.txt The file name of the lateral viscosity prefactor. -878 +884 [Anything] @@ -10131,7 +10131,7 @@ material_table.txt The file name of the material data. The first material data file is intended for the background composition. -876 +882 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -10148,7 +10148,7 @@ The file name of the material data. The first material data file is intended for The relative cutoff value for lateral viscosity variations caused by temperature deviations. The viscosity may vary laterally by this factor squared. -881 +887 [Double 0...MAX_DOUBLE (inclusive)] @@ -10165,7 +10165,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. -892 +898 [Double 0...MAX_DOUBLE (inclusive)] @@ -10182,7 +10182,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. -880 +886 [Double 0...MAX_DOUBLE (inclusive)] @@ -10199,7 +10199,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. -879 +885 [Double 0...MAX_DOUBLE (inclusive)] @@ -10216,7 +10216,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}. -888 +894 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10233,7 +10233,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}. -889 +895 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10250,7 +10250,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} -887 +893 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10269,7 +10269,7 @@ The viscosity that is used in this model. Units: \si{\pascal\second} -877 +883 [Double 0...MAX_DOUBLE (inclusive)] @@ -10286,7 +10286,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. -891 +897 [List of <[Double 0...1 (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10303,7 +10303,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}. -884 +890 [Double 0...MAX_DOUBLE (inclusive)] @@ -10320,7 +10320,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. -890 +896 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10337,7 +10337,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). -885 +891 [Selection constant|p-T-dependent ] @@ -10354,7 +10354,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}. -886 +892 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10373,7 +10373,7 @@ false This option does not exist any more. -962 +968 [Bool] @@ -10390,7 +10390,7 @@ This option does not exist any more. 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 all compositional fields or only those corresponding to chemical compositions. 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. -943 +949 [Anything] @@ -10407,7 +10407,7 @@ List of angles of internal friction, $\phi$, for background material and composi The average specific grain boundary energy $\gamma$. List must have one more entry than the Phase transition depths. Units: \si{\joule\per\meter\squared}. -957 +963 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10424,7 +10424,7 @@ true This parameter determines whether to use bilinear interpolation to compute material properties (slower but more accurate). -940 +946 [Bool] @@ -10441,7 +10441,7 @@ This parameter determines whether to use bilinear interpolation to compute mater List of cohesions, $C$, for background material and compositional fields, for a total of N+1 values, where N is the number of all compositional fields or only those corresponding to chemical compositions. The extremely large default cohesion value (1e20 Pa) prevents the viscous stress from exceeding the yield stress. Units: \si{\pascal}. -944 +950 [Anything] @@ -10458,7 +10458,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. -934 +940 [DirectoryName] @@ -10475,7 +10475,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. -907 +913 [Bool] @@ -10488,7 +10488,7 @@ Whether to list phase transitions by depth or pressure. If this parameter is tru 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). -936 +942 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -10505,7 +10505,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}. -919 +925 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10522,7 +10522,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}. -920 +926 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10539,7 +10539,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. -918 +924 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10556,7 +10556,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. -922 +928 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10573,7 +10573,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}. -921 +927 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10590,7 +10590,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}. -915 +921 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10607,7 +10607,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}. -916 +922 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10624,7 +10624,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. -914 +920 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10641,7 +10641,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}. -917 +923 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10658,7 +10658,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. -913 +919 [Integer range 0...2147483647 (inclusive)] @@ -10675,7 +10675,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. -912 +918 [Double 0...MAX_DOUBLE (inclusive)] @@ -10692,7 +10692,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. -959 +965 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10709,7 +10709,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}. -948 +954 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10726,7 +10726,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}. -949 +955 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10743,7 +10743,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. -950 +956 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10760,7 +10760,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}. -951 +957 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10777,7 +10777,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). -955 +961 [Selection paleowattmeter|paleopiezometer|pinned grain damage ] @@ -10794,7 +10794,7 @@ A flag indicating whether the material model should use the paleowattmeter appro This option does not exist any more. -961 +967 [Double 0...MAX_DOUBLE (inclusive)] @@ -10811,7 +10811,7 @@ perplex The material file format to be read in the property tables. -938 +944 [Selection perplex|hefesto ] @@ -10828,7 +10828,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). -935 +941 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -10845,7 +10845,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. -930 +936 [Integer range 1...2147483647 (inclusive)] @@ -10862,7 +10862,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. -927 +933 [Double 0...MAX_DOUBLE (inclusive)] @@ -10879,7 +10879,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. -923 +929 [Double 0...MAX_DOUBLE (inclusive)] @@ -10896,7 +10896,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. -929 +935 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -10913,7 +10913,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. -925 +931 [Double 0...MAX_DOUBLE (inclusive)] @@ -10930,7 +10930,7 @@ The maximum viscosity that is allowed in the whole model domain. Units: Pa \, s. 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}. -945 +951 [Double 0...MAX_DOUBLE (inclusive)] @@ -10947,7 +10947,7 @@ Limits the maximum value of the yield stress determined by the Drucker-Prager pl 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}. -960 +966 [Double 0...MAX_DOUBLE (inclusive)] @@ -10964,7 +10964,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. -926 +932 [Double 0...MAX_DOUBLE (inclusive)] @@ -10981,7 +10981,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. -928 +934 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -10998,7 +10998,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. -924 +930 [Double 0...MAX_DOUBLE (inclusive)] @@ -11011,7 +11011,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}. -911 +917 [Anything] @@ -11024,7 +11024,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}. -903 +909 [Anything] @@ -11037,7 +11037,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}. -906 +912 [Anything] @@ -11050,7 +11050,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}. -905 +911 [Anything] @@ -11067,7 +11067,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}. -910 +916 [Anything] @@ -11084,7 +11084,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}. -909 +915 [Anything] @@ -11097,7 +11097,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}. -908 +914 [Anything] @@ -11110,7 +11110,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}. -904 +910 [Anything] @@ -11127,7 +11127,7 @@ A list of widths for each phase transition, in terms of depth. The phase functio 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. -954 +960 [Double 0...1 (inclusive)] @@ -11144,7 +11144,7 @@ The volume fraction of one of the phases in the two-phase damage model of Bercov Viscosity of the damper that acts in parallel with the plastic viscosity to produce mesh-independent behavior at sufficient resolutions. Units: \si{\pascal\second} -947 +953 [Double 0...MAX_DOUBLE (inclusive)] @@ -11161,7 +11161,7 @@ Viscosity of the damper that acts in parallel with the plastic viscosity to prod 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. -952 +958 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -11174,7 +11174,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}. -953 +959 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -11191,7 +11191,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}. -902 +908 [Double 0...MAX_DOUBLE (inclusive)] @@ -11208,7 +11208,7 @@ The value of the reference compressibility. Units: \si{\per\pascal}. The reference density $\rho_0$. Units: \si{\kilogram\per\meter\cubed}. -896 +902 [Double 0...MAX_DOUBLE (inclusive)] @@ -11225,7 +11225,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}. -900 +906 [Double 0...MAX_DOUBLE (inclusive)] @@ -11242,7 +11242,7 @@ The value of the specific heat $cp$. Units: \si{\joule\per\kelvin\per\kilogram}. The reference temperature $T_0$. Units: \si{\kelvin}. -897 +903 [Double 0...MAX_DOUBLE (inclusive)] @@ -11259,7 +11259,7 @@ The reference temperature $T_0$. Units: \si{\kelvin}. The value of the thermal conductivity $k$. Units: \si{\watt\per\meter\per\kelvin}. -899 +905 [Double 0...MAX_DOUBLE (inclusive)] @@ -11276,7 +11276,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}. -901 +907 [Double 0...MAX_DOUBLE (inclusive)] @@ -11293,7 +11293,7 @@ false This parameter determines whether to apply plastic yielding according to a Drucker-Prager rheology after computing the viscosity from the (grain-size dependent) visous creep flow laws (if true) or not (if false). -941 +947 [Bool] @@ -11310,7 +11310,7 @@ false Whether to use the adiabatic pressure (if true) instead of the full (non-negative) pressure (if false) when calculating the yield stress. Using the adiabatic pressure (which is analogous to the depth-dependent von Mises model) can be useful to avoid the strong non-linearity associated with dynamic pressure variations affecting the yield strength, which can make the problem ill-posed. However, dynamic pressure can affect the localization of the strain rate and the resulting deformation, and neglecting it therefore changes the solution. -942 +948 [Bool] @@ -11327,7 +11327,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). -939 +945 [Bool] @@ -11344,7 +11344,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. -956 +962 [Selection true|false|default ] @@ -11361,7 +11361,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. -946 +952 [Bool] @@ -11378,7 +11378,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. -937 +943 [Bool] @@ -11395,7 +11395,7 @@ This parameter determines whether to use the table properties also for density, The value of the constant viscosity. Units: \si{\pascal\second}. -898 +904 [Double 0...MAX_DOUBLE (inclusive)] @@ -11412,7 +11412,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}. -958 +964 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -11430,7 +11430,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. -967 +973 [Double 0...MAX_DOUBLE (inclusive)] @@ -11447,7 +11447,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. -966 +972 [Double 0...1 (inclusive)] @@ -11464,7 +11464,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. -965 +971 [Double 0...1 (inclusive)] @@ -11481,7 +11481,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. -964 +970 [Double 0...MAX_DOUBLE (inclusive)] @@ -11498,7 +11498,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. -963 +969 [Double 0...MAX_DOUBLE (inclusive)] @@ -11518,7 +11518,7 @@ This parameter determines the temperature at which the computed coefficient of s A linear dependency of viscosity on composition. Dimensionless prefactor. -696 +702 [Double 0...MAX_DOUBLE (inclusive)] @@ -11535,7 +11535,7 @@ A linear dependency of viscosity on composition. Dimensionless prefactor. The value of the compressibility $\kappa$. Units: \si{\per\pascal}. -701 +707 [Double 0...MAX_DOUBLE (inclusive)] @@ -11548,7 +11548,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}. -704 +710 [List of <[Integer range 0...2147483647 (inclusive)]> of length 0...4294967295 (inclusive)] @@ -11565,7 +11565,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. -712 +718 [Bool] @@ -11582,7 +11582,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. -702 +708 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -11599,7 +11599,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. -707 +713 [Double 0...MAX_DOUBLE (inclusive)] @@ -11616,7 +11616,7 @@ Limit for the maximum viscosity in the model. Units: Pa \, s. Limit for the minimum viscosity in the model. Units: Pa \, s. -706 +712 [Double 0...MAX_DOUBLE (inclusive)] @@ -11629,7 +11629,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}. -716 +722 [Anything] @@ -11642,7 +11642,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}. -703 +709 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -11655,7 +11655,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}. -708 +714 [Anything] @@ -11668,7 +11668,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}. -711 +717 [Anything] @@ -11681,7 +11681,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}. -710 +716 [Anything] @@ -11698,7 +11698,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}. -715 +721 [Anything] @@ -11715,7 +11715,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}. -714 +720 [Anything] @@ -11728,7 +11728,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}. -713 +719 [Anything] @@ -11741,7 +11741,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}. -709 +715 [Anything] @@ -11758,7 +11758,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}. -693 +699 [Double 0...MAX_DOUBLE (inclusive)] @@ -11775,7 +11775,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}. -699 +705 [Double 0...MAX_DOUBLE (inclusive)] @@ -11792,7 +11792,7 @@ The value of the specific heat $C_p$. Units: \si{\joule\per\kelvin\per\kilogram} The reference temperature $T_0$. Units: \si{\kelvin}. -694 +700 [Double 0...MAX_DOUBLE (inclusive)] @@ -11809,7 +11809,7 @@ The reference temperature $T_0$. Units: \si{\kelvin}. The value of the thermal conductivity $k$. Units: \si{\watt\per\meter\per\kelvin}. -698 +704 [Double 0...MAX_DOUBLE (inclusive)] @@ -11826,7 +11826,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}. -700 +706 [Double 0...MAX_DOUBLE (inclusive)] @@ -11843,7 +11843,7 @@ The value of the thermal expansion coefficient $\beta$. Units: \si{\per\kelvin}. The temperature dependence of viscosity. Dimensionless exponent. -697 +703 [Double 0...MAX_DOUBLE (inclusive)] @@ -11860,7 +11860,7 @@ The temperature dependence of viscosity. Dimensionless exponent. The value of the constant viscosity. Units: \si{\pascal\second}. -695 +701 [Double 0...MAX_DOUBLE (inclusive)] @@ -11873,7 +11873,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. -705 +711 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -11892,7 +11892,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}. -728 +734 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -11909,7 +11909,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}. -729 +735 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -11926,7 +11926,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}. -730 +736 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -11943,7 +11943,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}. -731 +737 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -11960,7 +11960,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}. -732 +738 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -11977,7 +11977,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}. -733 +739 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -11994,7 +11994,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}. -734 +740 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12011,7 +12011,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}. -735 +741 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12028,7 +12028,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}. -736 +742 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12045,7 +12045,7 @@ Prefactor of the quadratic pressure term in the quadratic function that approxim A linear dependency of viscosity on composition. Dimensionless prefactor. -720 +726 [Double 0...MAX_DOUBLE (inclusive)] @@ -12062,7 +12062,7 @@ A linear dependency of viscosity on composition. Dimensionless prefactor. The value of the compressibility $\kappa$. Units: \si{\per\pascal}. -726 +732 [Double 0...MAX_DOUBLE (inclusive)] @@ -12079,7 +12079,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}. -742 +748 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12096,7 +12096,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}. -743 +749 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12113,7 +12113,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}. -744 +750 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12130,7 +12130,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. -727 +733 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12147,7 +12147,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}. -745 +751 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12164,7 +12164,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}. -746 +752 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12181,7 +12181,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. -741 +747 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12198,7 +12198,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. -748 +754 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12215,7 +12215,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}. -740 +746 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12232,7 +12232,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}. -747 +753 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12249,7 +12249,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}. -717 +723 [Double 0...MAX_DOUBLE (inclusive)] @@ -12266,7 +12266,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}. -723 +729 [Double 0...MAX_DOUBLE (inclusive)] @@ -12283,7 +12283,7 @@ The value of the specific heat $C_p$. Units: \si{\joule\per\kelvin\per\kilogram} The reference temperature $T_0$. Units: \si{\kelvin}. -718 +724 [Double 0...MAX_DOUBLE (inclusive)] @@ -12300,7 +12300,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. -749 +755 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12317,7 +12317,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}. -722 +728 [Double 0...MAX_DOUBLE (inclusive)] @@ -12334,7 +12334,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}. -724 +730 [Double 0...MAX_DOUBLE (inclusive)] @@ -12351,7 +12351,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}. -725 +731 [Double 0...MAX_DOUBLE (inclusive)] @@ -12368,7 +12368,7 @@ The value of the thermal expansion coefficient $\alpha_f$. Units: \si{\per\kelvi The temperature dependence of viscosity. Dimensionless exponent. -721 +727 [Double 0...MAX_DOUBLE (inclusive)] @@ -12385,7 +12385,7 @@ The temperature dependence of viscosity. Dimensionless exponent. The value of the constant viscosity. Units: \si{\pascal\second}. -719 +725 [Double 0...MAX_DOUBLE (inclusive)] @@ -12402,7 +12402,7 @@ The value of the constant viscosity. Units: \si{\pascal\second}. Exponent of the melting temperature in the melt fraction calculation. Units: non-dimensional. -739 +745 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12419,7 +12419,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. -737 +743 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12436,7 +12436,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}. -738 +744 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12455,7 +12455,7 @@ Prefactor of the linear pressure term in the linear function that approximates t List of Einstein temperatures for each different endmember.Units: K. -775 +781 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -12472,7 +12472,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. -766 +772 [List of <[MultipleSelection MgSiO3_bridgmanite|FeSiO3_bridgmanite|MgO_periclase|FeO_periclase|MgO_melt|FeO_melt|SiO2_melt ]> of length 0...4294967295 (inclusive)] @@ -12489,7 +12489,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. -767 +773 [List of <[MultipleSelection solid|melt ]> of length 0...4294967295 (inclusive)] @@ -12506,7 +12506,7 @@ States of the endmember components used in the equation of state and the melting The porosity dependence of the viscosity. Units: dimensionless. -753 +759 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12523,7 +12523,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. -760 +766 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12540,7 +12540,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. -762 +768 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12557,7 +12557,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. -773 +779 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -12574,7 +12574,7 @@ true Whether to include melting and freezing (according to a simplified linear melting approximation in the model (if true), or not (if false). -758 +764 [Bool] @@ -12591,7 +12591,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. -779 +785 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -12610,7 +12610,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. -759 +765 [Double 0...MAX_DOUBLE (inclusive)] @@ -12627,7 +12627,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. -761 +767 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12644,7 +12644,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. -763 +769 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12661,7 +12661,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. -768 +774 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -12678,7 +12678,7 @@ Molar masses of the different endmembersUnits: kg/mol. Number of atoms per in the formula of each endmember.Units: none. -769 +775 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -12695,7 +12695,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. -772 +778 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -12712,7 +12712,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$. -751 +757 [Double 0...MAX_DOUBLE (inclusive)] @@ -12729,7 +12729,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. -776 +782 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -12746,7 +12746,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. -777 +783 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -12763,7 +12763,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$. -752 +758 [Double 0...MAX_DOUBLE (inclusive)] @@ -12780,7 +12780,7 @@ The value of the constant melt viscosity $\eta_f$. Units: $Pa \, s$. Reference permeability of the solid host rock.Units: $m^2$. -757 +763 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12797,7 +12797,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. -765 +771 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12814,7 +12814,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$. -750 +756 [Double 0...MAX_DOUBLE (inclusive)] @@ -12831,7 +12831,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. -778 +784 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -12848,7 +12848,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. -764 +770 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12865,7 +12865,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. -771 +777 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -12882,7 +12882,7 @@ List of thermal expansivities for each different endmember at the reference temp Reference volumes of the different endmembers.Units: $m^3$. -770 +776 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -12899,7 +12899,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. -780 +786 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -12916,7 +12916,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. -774 +780 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -12933,7 +12933,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. -755 +761 [Double 0...MAX_DOUBLE (inclusive)] @@ -12950,7 +12950,7 @@ The temperature dependence of the bulk viscosity. Dimensionless exponent. See th The value of the thermal conductivity $k$. Units: $W/m/K$. -756 +762 [Double 0...MAX_DOUBLE (inclusive)] @@ -12967,7 +12967,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. -754 +760 [Double 0...MAX_DOUBLE (inclusive)] @@ -12984,7 +12984,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). -781 +787 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -13003,7 +13003,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}. -795 +801 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13020,7 +13020,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}. -797 +803 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13037,7 +13037,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 $std::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). -804 +810 [Double 0...MAX_DOUBLE (inclusive)] @@ -13054,7 +13054,7 @@ $\alpha_F$: exponential dependency of viscosity on the depletion field $F$ (call The porosity dependence of the viscosity. Units: dimensionless. -788 +794 [Double 0...MAX_DOUBLE (inclusive)] @@ -13071,7 +13071,7 @@ true Whether to include melting and freezing (according to a simplified linear melting approximation in the model (if true), or not (if false). -802 +808 [Bool] @@ -13088,7 +13088,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). -805 +811 [Double 0...MAX_DOUBLE (inclusive)] @@ -13105,7 +13105,7 @@ $\Delta \eta_{F,max}$: maximum depletion strengthening of viscosity. Rationale: The value of the pressure derivative of the melt bulk modulus. Units: None. -801 +807 [Double 0...MAX_DOUBLE (inclusive)] @@ -13122,7 +13122,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}. -800 +806 [Double 0...MAX_DOUBLE (inclusive)] @@ -13141,7 +13141,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. -803 +809 [Double 0...MAX_DOUBLE (inclusive)] @@ -13158,7 +13158,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}. -798 +804 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13175,7 +13175,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}. -786 +792 [Double 0...MAX_DOUBLE (inclusive)] @@ -13192,7 +13192,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}. -783 +789 [Double 0...MAX_DOUBLE (inclusive)] @@ -13209,7 +13209,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}. -787 +793 [Double 0...MAX_DOUBLE (inclusive)] @@ -13226,7 +13226,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}. -794 +800 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13243,7 +13243,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}. -785 +791 [Double 0...MAX_DOUBLE (inclusive)] @@ -13260,7 +13260,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}. -782 +788 [Double 0...MAX_DOUBLE (inclusive)] @@ -13277,7 +13277,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}. -792 +798 [Double 0...MAX_DOUBLE (inclusive)] @@ -13294,7 +13294,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}. -784 +790 [Double 0...MAX_DOUBLE (inclusive)] @@ -13311,7 +13311,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}. -799 +805 [Double 0...MAX_DOUBLE (inclusive)] @@ -13328,7 +13328,7 @@ The value of the compressibility of the solid matrix. Units: \si{\per\pascal}. Solidus for a pressure of zero. Units: \si{\kelvin}. -796 +802 [Double 0...MAX_DOUBLE (inclusive)] @@ -13345,7 +13345,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. -790 +796 [Double 0...MAX_DOUBLE (inclusive)] @@ -13362,7 +13362,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}. -791 +797 [Double 0...MAX_DOUBLE (inclusive)] @@ -13379,7 +13379,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}. -793 +799 [Double 0...MAX_DOUBLE (inclusive)] @@ -13396,7 +13396,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. -789 +795 [Double 0...MAX_DOUBLE (inclusive)] @@ -13415,7 +13415,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}. -806 +812 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13432,7 +13432,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}. -807 +813 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13449,7 +13449,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}. -808 +814 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13466,7 +13466,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}. -809 +815 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13483,7 +13483,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}. -810 +816 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13500,7 +13500,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}. -811 +817 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13517,7 +13517,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}. -812 +818 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13534,7 +13534,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}. -813 +819 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13551,7 +13551,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}. -814 +820 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13568,7 +13568,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}. -841 +847 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13585,7 +13585,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}. -831 +837 [Double 0...MAX_DOUBLE (inclusive)] @@ -13602,7 +13602,7 @@ The solidus temperature change for a depletion of 100\%. For positive values, th The porosity dependence of the viscosity. Units: dimensionless. -823 +829 [Double 0...MAX_DOUBLE (inclusive)] @@ -13619,7 +13619,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. -829 +835 [Double 0...MAX_DOUBLE (inclusive)] @@ -13636,7 +13636,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. -818 +824 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13653,7 +13653,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. -827 +833 [Double 0...MAX_DOUBLE (inclusive)] @@ -13670,7 +13670,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}. -826 +832 [Double 0...MAX_DOUBLE (inclusive)] @@ -13687,7 +13687,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}. -825 +831 [Double 0...MAX_DOUBLE (inclusive)] @@ -13706,7 +13706,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. -830 +836 [Double 0...MAX_DOUBLE (inclusive)] @@ -13723,7 +13723,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}. -819 +825 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13740,7 +13740,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}. -821 +827 [Double 0...MAX_DOUBLE (inclusive)] @@ -13757,7 +13757,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}. -820 +826 [Double 0...MAX_DOUBLE (inclusive)] @@ -13771,10 +13771,10 @@ Reference density of the melt/fluid$\rho_{f,0}$. Units: \si{\kilogram\per\meter\ 10. -The value of the constant melt viscosity $\viscosity_fluid$. Units: \si{\pascal\second}. +The value of the constant melt viscosity $\eta_f$. Units: \si{\pascal\second}. -822 +828 [Double 0...MAX_DOUBLE (inclusive)] @@ -13791,7 +13791,7 @@ The value of the constant melt viscosity $\viscosity_fluid$. Units: \si{\pascal\ Reference permeability of the solid host rock.Units: \si{\meter\squared}. -832 +838 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13808,7 +13808,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}. -835 +841 [Double 0...MAX_DOUBLE (inclusive)] @@ -13825,7 +13825,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}. -842 +848 [Double 0...MAX_DOUBLE (inclusive)] @@ -13842,7 +13842,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}. -836 +842 [Double 0...MAX_DOUBLE (inclusive)] @@ -13859,7 +13859,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}. -840 +846 [Double 0...MAX_DOUBLE (inclusive)] @@ -13876,7 +13876,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}. -838 +844 [Double 0...MAX_DOUBLE (inclusive)] @@ -13893,7 +13893,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. -824 +830 [Double 0...MAX_DOUBLE (inclusive)] @@ -13910,7 +13910,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}. -837 +843 [Double 0...MAX_DOUBLE (inclusive)] @@ -13927,7 +13927,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}. -834 +840 [Double 0...MAX_DOUBLE (inclusive)] @@ -13944,7 +13944,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. -839 +845 [Double 0...MAX_DOUBLE (inclusive)] @@ -13963,7 +13963,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. -828 +834 [Bool] @@ -13980,7 +13980,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). -833 +839 [Bool] @@ -13997,7 +13997,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. -817 +823 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -14014,7 +14014,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. -815 +821 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -14031,7 +14031,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}. -816 +822 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -14050,7 +14050,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}. -849 +855 [Double 0...MAX_DOUBLE (inclusive)] @@ -14067,7 +14067,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. -847 +853 [Double 0...MAX_DOUBLE (inclusive)] @@ -14084,7 +14084,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}. -845 +851 [Double 0...MAX_DOUBLE (inclusive)] @@ -14101,7 +14101,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}. -846 +852 [Double 0...MAX_DOUBLE (inclusive)] @@ -14118,7 +14118,7 @@ The isothermal bulk modulus at the reference pressure and temperature. Units: \s Reference pressure $P_0$. Units: \si{\pascal}. -843 +849 [Double 0...MAX_DOUBLE (inclusive)] @@ -14135,7 +14135,7 @@ Reference pressure $P_0$. Units: \si{\pascal}. Reference temperature $T_0$. Units: \si{\kelvin}. -844 +850 [Double 0...MAX_DOUBLE (inclusive)] @@ -14152,7 +14152,7 @@ Reference temperature $T_0$. Units: \si{\kelvin}. The thermal expansion coefficient at the reference pressure and temperature. Units: \si{\per\kelvin}. -848 +854 [Double 0...MAX_DOUBLE (inclusive)] @@ -14169,7 +14169,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}. -851 +857 [Double 0...MAX_DOUBLE (inclusive)] @@ -14186,7 +14186,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}. -850 +856 [Double 0...MAX_DOUBLE (inclusive)] @@ -14202,7 +14202,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.) -854 +860 [Anything] @@ -14217,7 +14217,7 @@ A typical example would be to set this runtime parameter to `pi=3.1415926536&apo -855 +861 [Anything] @@ -14234,7 +14234,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. -852 +858 [Anything] @@ -14254,7 +14254,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}. -857 +863 [Anything] @@ -14271,7 +14271,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}. -859 +865 [Anything] @@ -14288,7 +14288,7 @@ List of specific heats $C_p$ for background mantle and compositional fields,for The reference temperature $T_0$. Units: \si{\kelvin}. -860 +866 [Double 0...MAX_DOUBLE (inclusive)] @@ -14313,7 +14313,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}. -862 +868 [Anything] @@ -14330,7 +14330,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}. -858 +864 [Anything] @@ -14347,7 +14347,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}. -861 +867 [Anything] @@ -14364,7 +14364,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. -863 +869 [Selection arithmetic|harmonic|geometric|maximum composition ] @@ -14383,7 +14383,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}. -618 +624 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -14400,7 +14400,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: []. -616 +622 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -14417,7 +14417,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}. -614 +620 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -14434,7 +14434,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}. -615 +621 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -14451,7 +14451,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}. -613 +619 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -14468,7 +14468,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}. -617 +623 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -14485,7 +14485,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}. -620 +626 [Anything] @@ -14502,7 +14502,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}. -619 +625 [Anything] @@ -14519,7 +14519,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. -621 +627 [Selection arithmetic|harmonic|geometric|maximum composition ] @@ -14538,7 +14538,7 @@ When more than one compositional field is present at a point with different visc Dissipation number. Pick 0.0 for incompressible computations. -624 +630 [Double 0...MAX_DOUBLE (inclusive)] @@ -14555,7 +14555,7 @@ Dissipation number. Pick 0.0 for incompressible computations. Rayleigh number Ra -623 +629 [Double 0...MAX_DOUBLE (inclusive)] @@ -14572,7 +14572,7 @@ Rayleigh number Ra Reference density $\rho_0$. Units: \si{\kilogram\per\meter\cubed}. -622 +628 [Double 0...MAX_DOUBLE (inclusive)] @@ -14589,7 +14589,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}. -626 +632 [Double 0...MAX_DOUBLE (inclusive)] @@ -14606,7 +14606,7 @@ false Whether to use the TALA instead of the ALA approximation. -629 +635 [Bool] @@ -14623,7 +14623,7 @@ Whether to use the TALA instead of the ALA approximation. Exponential depth prefactor for viscosity. -628 +634 [Double 0...MAX_DOUBLE (inclusive)] @@ -14640,7 +14640,7 @@ Exponential depth prefactor for viscosity. Exponential temperature prefactor for viscosity. -627 +633 [Double 0...MAX_DOUBLE (inclusive)] @@ -14657,7 +14657,7 @@ Exponential temperature prefactor for viscosity. Grueneisen parameter -625 +631 [Double 0...MAX_DOUBLE (inclusive)] @@ -14676,7 +14676,7 @@ Grueneisen parameter The value of the maximum pressure used to query PerpleX. Units: \si{\pascal}. -636 +642 [Double 0...MAX_DOUBLE (inclusive)] @@ -14693,7 +14693,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}. -634 +640 [Double 0...MAX_DOUBLE (inclusive)] @@ -14710,7 +14710,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}. -635 +641 [Double 0...MAX_DOUBLE (inclusive)] @@ -14727,7 +14727,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}. -633 +639 [Double 0...MAX_DOUBLE (inclusive)] @@ -14744,7 +14744,7 @@ rock.dat The name of the PerpleX input file (should end with .dat). -630 +636 [Anything] @@ -14761,7 +14761,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}. -632 +638 [Double 0...MAX_DOUBLE (inclusive)] @@ -14778,7 +14778,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}. -631 +637 [Double 0...MAX_DOUBLE (inclusive)] @@ -14797,7 +14797,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. -637 +643 [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|reactive fluid transport|replace lithosphere viscosity|simple|simple compressible|simpler|visco plastic|viscoelastic ] @@ -14813,7 +14813,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 +646 [Anything] @@ -14832,7 +14832,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. -639 +645 [Anything] @@ -14849,7 +14849,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. -638 +644 [Anything] @@ -14866,7 +14866,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.) -643 +649 [Anything] @@ -14885,7 +14885,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. -642 +648 [Anything] @@ -14902,7 +14902,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. -641 +647 [Anything] @@ -14922,7 +14922,7 @@ visco plastic The name of a material model incorporating the addition of fluids. 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. -671 +677 [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|reactive fluid transport|replace lithosphere viscosity|simple|simple compressible|simpler|visco plastic|viscoelastic ] @@ -14939,7 +14939,7 @@ The name of a material model incorporating the addition of fluids. Valid values The porosity dependence of the viscosity. Units: dimensionless. -677 +683 [Double 0...MAX_DOUBLE (inclusive)] @@ -14956,7 +14956,7 @@ The porosity dependence of the viscosity. Units: dimensionless. The value of the compressibility of the fluid. Units: \si{\per\pascal}. -679 +685 [Double 0...MAX_DOUBLE (inclusive)] @@ -14975,7 +14975,7 @@ In case the operator splitting scheme is used, the porosity field can not be set Also note that the fluid reaction 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. -680 +686 [Double 0...MAX_DOUBLE (inclusive)] @@ -14992,7 +14992,7 @@ no reaction Select what type of scheme to use for reactions between fluid and solid phases. The current available options are models where no reactions occur between the two phases, or the solid phase is insoluble (zero solubility) and all of the bound fluid is released into the fluid phase, tian approximation use polynomials to describe hydration and dehydration reactions for four different rock compositions as defined in Tian et al., 2019, or the Katz et. al. 2003 mantle melting model. If the Katz 2003 melting model is used, its parameters are declared in its own subsection. -685 +691 [Selection no reaction|zero solubility|tian approximation|katz2003 ] @@ -15009,7 +15009,7 @@ Select what type of scheme to use for reactions between fluid and solid phases. Upper cutoff for the compaction viscosity. Units: \si{\pascal\second}. -675 +681 [Double 0...MAX_DOUBLE (inclusive)] @@ -15026,7 +15026,7 @@ Upper cutoff for the compaction viscosity. Units: \si{\pascal\second}. The maximum allowed weight percent that the sediment composition can hold. -682 +688 [Double 0...MAX_DOUBLE (inclusive)] @@ -15043,7 +15043,7 @@ The maximum allowed weight percent that the sediment composition can hold. The maximum allowed weight percent that the sediment composition can hold. -683 +689 [Double 0...MAX_DOUBLE (inclusive)] @@ -15060,7 +15060,7 @@ The maximum allowed weight percent that the sediment composition can hold. The maximum allowed weight percent that the sediment composition can hold. -684 +690 [Double 0...MAX_DOUBLE (inclusive)] @@ -15077,7 +15077,7 @@ The maximum allowed weight percent that the sediment composition can hold. The maximum allowed weight percent that the sediment composition can hold. -681 +687 [Double 0...MAX_DOUBLE (inclusive)] @@ -15094,7 +15094,7 @@ The maximum allowed weight percent that the sediment composition can hold. Lower cutoff for the compaction viscosity. Units: \si{\pascal\second}. -674 +680 [Double 0...MAX_DOUBLE (inclusive)] @@ -15111,7 +15111,7 @@ Lower cutoff for the compaction viscosity. Units: \si{\pascal\second}. Reference density of the melt/fluid$\rho_{f,0}$. Units: \si{\kilogram\per\meter\cubed}. -672 +678 [Double 0...MAX_DOUBLE (inclusive)] @@ -15128,7 +15128,7 @@ Reference density of the melt/fluid$\rho_{f,0}$. Units: \si{\kilogram\per\meter\ The value of the constant melt/fluid viscosity $\eta_f$. Units: \si{\pascal\second}. -676 +682 [Double 0...MAX_DOUBLE (inclusive)] @@ -15145,7 +15145,7 @@ The value of the constant melt/fluid viscosity $\eta_f$. Units: \si{\pascal\seco Reference permeability of the solid host rock.Units: \si{\meter\squared}. -678 +684 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -15162,7 +15162,7 @@ Reference permeability of the solid host rock.Units: \si{\meter\squared}. The reference temperature $T_0$ for the katz2003 reaction model. The reference temperature is used in both the density and viscosity formulas of this model. Units: \si{\kelvin}. -686 +692 [Double 0...MAX_DOUBLE (inclusive)] @@ -15179,7 +15179,7 @@ The reference temperature $T_0$ for the katz2003 reaction model. The reference t Ratio between shear and bulk viscosity at the reference permeability $\phi_0=0.05$. The bulk viscosity additionally scales with $\phi_0/\phi$. The shear viscosity is read in from the base model. Units: dimensionless. -673 +679 [Double 0...MAX_DOUBLE (inclusive)] @@ -15197,7 +15197,7 @@ Ratio between shear and bulk viscosity at the reference permeability $\phi_0=0.0 Constant parameter in the quadratic function that approximates the solidus of peridotite. Units: \si{\degreeCelsius}. -644 +650 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -15214,7 +15214,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}. -645 +651 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -15231,7 +15231,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}. -646 +652 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -15248,7 +15248,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}. -647 +653 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -15265,7 +15265,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}. -648 +654 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -15282,7 +15282,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}. -649 +655 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -15299,7 +15299,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}. -650 +656 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -15316,7 +15316,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}. -651 +657 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -15333,7 +15333,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}. -652 +658 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -15350,7 +15350,7 @@ Prefactor of the quadratic pressure term in the quadratic function that approxim 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}. -669 +675 [Double 0...MAX_DOUBLE (inclusive)] @@ -15367,7 +15367,7 @@ The solidus temperature change for a depletion of 100\%. For positive values, th The porosity dependence of the viscosity. Units: dimensionless. -661 +667 [Double 0...MAX_DOUBLE (inclusive)] @@ -15384,7 +15384,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. -667 +673 [Double 0...MAX_DOUBLE (inclusive)] @@ -15401,7 +15401,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. -656 +662 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -15418,7 +15418,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. -665 +671 [Double 0...MAX_DOUBLE (inclusive)] @@ -15435,7 +15435,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}. -664 +670 [Double 0...MAX_DOUBLE (inclusive)] @@ -15452,7 +15452,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}. -663 +669 [Double 0...MAX_DOUBLE (inclusive)] @@ -15471,7 +15471,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. -668 +674 [Double 0...MAX_DOUBLE (inclusive)] @@ -15488,7 +15488,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}. -657 +663 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -15505,7 +15505,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}. -659 +665 [Double 0...MAX_DOUBLE (inclusive)] @@ -15522,7 +15522,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}. -658 +664 [Double 0...MAX_DOUBLE (inclusive)] @@ -15536,10 +15536,10 @@ Reference density of the melt/fluid$\rho_{f,0}$. Units: \si{\kilogram\per\meter\ 10. -The value of the constant melt viscosity $\viscosity_fluid$. Units: \si{\pascal\second}. +The value of the constant melt viscosity $\eta_f$. Units: \si{\pascal\second}. -660 +666 [Double 0...MAX_DOUBLE (inclusive)] @@ -15556,7 +15556,7 @@ The value of the constant melt viscosity $\viscosity_fluid$. Units: \si{\pascal\ Reference permeability of the solid host rock.Units: \si{\meter\squared}. -670 +676 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -15573,7 +15573,7 @@ Reference permeability of the solid host rock.Units: \si{\meter\squared}. 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. -662 +668 [Double 0...MAX_DOUBLE (inclusive)] @@ -15592,7 +15592,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. -666 +672 [Bool] @@ -15609,7 +15609,7 @@ Note that melt does not freeze unless the 'Freezing rate' parameter is Exponent of the melting temperature in the melt fraction calculation. Units: non-dimensional. -655 +661 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -15626,7 +15626,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. -653 +659 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -15643,7 +15643,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}. -654 +660 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -15663,7 +15663,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. -687 +693 [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|reactive fluid transport|replace lithosphere viscosity|simple|simple compressible|simpler|visco plastic|viscoelastic ] @@ -15680,7 +15680,7 @@ $ASPECT_SOURCE_DIR/data/initial-temperature/lithosphere-mask/ The path to the LAB depth data file -691 +697 [DirectoryName] @@ -15697,7 +15697,7 @@ Value Method that is used to specify the depth of the lithosphere-asthenosphere boundary. -689 +695 [Selection File|Value ] @@ -15714,7 +15714,7 @@ LAB_CAM2016.txt File from which the lithosphere-asthenosphere boundary depth data is read. -692 +698 [FileName (Type: input)] @@ -15731,7 +15731,7 @@ File from which the lithosphere-asthenosphere boundary depth data is read. The viscosity within lithosphere, applied abovethe maximum lithosphere depth. -688 +694 [Double 0...MAX_DOUBLE (inclusive)] @@ -15748,7 +15748,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. -690 +696 [Double 0...MAX_DOUBLE (inclusive)] @@ -15767,7 +15767,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}. -471 +473 [Double 0...MAX_DOUBLE (inclusive)] @@ -15784,7 +15784,7 @@ The value of the reference compressibility. Units: \si{\per\pascal}. Reference density $\rho_0$. Units: \si{\kilogram\per\meter\cubed}. -467 +469 [Double 0...MAX_DOUBLE (inclusive)] @@ -15801,7 +15801,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}. -469 +471 [Double 0...MAX_DOUBLE (inclusive)] @@ -15818,7 +15818,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}. -468 +470 [Double 0...MAX_DOUBLE (inclusive)] @@ -15835,7 +15835,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}. -470 +472 [Double 0...MAX_DOUBLE (inclusive)] @@ -15852,7 +15852,7 @@ The value of the thermal expansion coefficient $\alpha$. Units: \si{\per\kelvin} The value of the viscosity $\eta$. Units: \si{\pascal\second}. -472 +474 [Double 0...MAX_DOUBLE (inclusive)] @@ -15871,7 +15871,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. -462 +464 [Double 0...MAX_DOUBLE (inclusive)] @@ -15888,7 +15888,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. -459 +461 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -15905,7 +15905,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. -464 +466 [Double 0...MAX_DOUBLE (inclusive)] @@ -15922,7 +15922,7 @@ The maximum value of the viscosity prefactor associated with temperature depende The minimum value of the viscosity prefactor associated with temperature dependence. -465 +467 [Double 0...MAX_DOUBLE (inclusive)] @@ -15939,7 +15939,7 @@ The minimum value of the viscosity prefactor associated with temperature depende Reference density $\rho_0$. Units: \si{\kilogram\per\meter\cubed}. -455 +457 [Double 0...MAX_DOUBLE (inclusive)] @@ -15956,7 +15956,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}. -457 +459 [Double 0...MAX_DOUBLE (inclusive)] @@ -15973,7 +15973,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}. -460 +462 [Double 0...MAX_DOUBLE (inclusive)] @@ -15990,7 +15990,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}. -466 +468 [Double 0...MAX_DOUBLE (inclusive)] @@ -16007,7 +16007,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}. -458 +460 [Double 0...MAX_DOUBLE (inclusive)] @@ -16024,7 +16024,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. -463 +465 [Double 0...MAX_DOUBLE (inclusive)] @@ -16041,7 +16041,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}. -461 +463 [Double 0...MAX_DOUBLE (inclusive)] @@ -16060,7 +16060,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}. -473 +475 [Double 0...MAX_DOUBLE (inclusive)] @@ -16077,7 +16077,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}. -475 +477 [Double 0...MAX_DOUBLE (inclusive)] @@ -16094,7 +16094,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}. -474 +476 [Double 0...MAX_DOUBLE (inclusive)] @@ -16111,7 +16111,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}. -477 +479 [Double 0...MAX_DOUBLE (inclusive)] @@ -16128,7 +16128,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}. -476 +478 [Double 0...MAX_DOUBLE (inclusive)] @@ -16145,7 +16145,7 @@ The value of the thermal expansion coefficient $\alpha$. Units: \si{\per\kelvin} The value of the viscosity $\eta$. Units: \si{\pascal\second}. -478 +480 [Double 0...MAX_DOUBLE (inclusive)] @@ -16164,7 +16164,7 @@ true Whether to use bilinear interpolation to compute material properties (slower but more accurate). -502 +504 [Bool] @@ -16181,7 +16181,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}. -487 +489 [Anything] @@ -16198,7 +16198,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. -498 +500 [DirectoryName] @@ -16211,7 +16211,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). -500 +502 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -16228,7 +16228,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. -503 +505 [Bool] @@ -16245,7 +16245,7 @@ temp-viscosity-prefactor.txt The file name of the lateral viscosity data. -481 +483 [Anything] @@ -16262,7 +16262,7 @@ perplex The material file format to be read in the property tables. -501 +503 [Selection perplex|hefesto ] @@ -16279,7 +16279,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. -499 +501 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -16296,7 +16296,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. -504 +506 [Integer range 1...2147483647 (inclusive)] @@ -16313,7 +16313,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. -486 +488 [Double 0...MAX_DOUBLE (inclusive)] @@ -16330,7 +16330,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. -497 +499 [Double 0...MAX_DOUBLE (inclusive)] @@ -16347,7 +16347,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. -485 +487 [Double 0...MAX_DOUBLE (inclusive)] @@ -16364,7 +16364,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. -484 +486 [Double 0...MAX_DOUBLE (inclusive)] @@ -16381,7 +16381,7 @@ The minimum viscosity that is allowed in the viscosity calculation. Smaller valu Number of bands to compute laterally averaged temperature within. -483 +485 [Integer range 1...2147483647 (inclusive)] @@ -16398,7 +16398,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}. -493 +495 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -16415,7 +16415,7 @@ radial-visc.txt The file name of the radial viscosity data. -480 +482 [Anything] @@ -16432,7 +16432,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}. -494 +496 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -16449,7 +16449,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} -492 +494 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -16466,7 +16466,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. -496 +498 [List of <[Double 0...1 (inclusive)]> of length 0...4294967295 (inclusive)] @@ -16483,7 +16483,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}. -489 +491 [Double 0...MAX_DOUBLE (inclusive)] @@ -16500,7 +16500,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. -495 +497 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -16517,7 +16517,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). -490 +492 [Selection constant|p-T-dependent ] @@ -16534,7 +16534,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}. -491 +493 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -16551,7 +16551,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. -482 +484 [Bool] @@ -16568,7 +16568,7 @@ harmonic Method to average viscosities over multiple compositional fields. One of arithmetic, harmonic, geometric or maximum composition. -488 +490 [Selection arithmetic|harmonic|geometric|maximum composition ] @@ -16587,7 +16587,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 all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: \si{\joule\per\mole}. -577 +583 [Anything] @@ -16604,7 +16604,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 all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: \si{\joule\per\mole}. -560 +566 [Anything] @@ -16621,7 +16621,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 all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: \si{\joule\per\mole}. -565 +571 [Anything] @@ -16638,7 +16638,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 all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: \si{\meter\cubed\per\mole}. -578 +584 [Anything] @@ -16655,7 +16655,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 all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: \si{\meter\cubed\per\mole}. -561 +567 [Anything] @@ -16672,7 +16672,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 all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: \si{\meter\cubed\per\mole}. -566 +572 [Anything] @@ -16689,7 +16689,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}. -597 +603 [Double 0...MAX_DOUBLE (inclusive)] @@ -16706,7 +16706,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. -554 +560 [Bool] @@ -16723,7 +16723,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 all compositional fields or only those corresponding to chemical compositions. 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. -591 +597 [Anything] @@ -16740,7 +16740,7 @@ false Whether the cutoff stresses for Peierls creep are used as the minimum stresses in the Peierls rheology -584 +590 [Bool] @@ -16757,7 +16757,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 all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: None. -521 +527 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -16774,7 +16774,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 all compositional fields or only those corresponding to chemical compositions. The extremely large default cohesion value (1e20 Pa) prevents the viscous stress from exceeding the yield stress. Units: \si{\pascal}. -592 +598 [Anything] @@ -16791,7 +16791,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 all compositional fields or only those corresponding to chemical compositions. Units: none. -586 +592 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -16808,12 +16808,29 @@ 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} -583 +589 [Anything] + + +$ASPECT_SOURCE_DIR/data/material-model/entropy-table/pyrtable + + +$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. + + +518 + + +[DirectoryName] + + false @@ -16825,7 +16842,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. -599 +605 [Bool] @@ -16842,7 +16859,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. -509 +512 [Bool] @@ -16859,7 +16876,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}. -515 +521 [Anything] @@ -16876,7 +16893,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 all compositional fields or only those corresponding to chemical compositions. 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}. -536 +542 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -16893,7 +16910,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}. -535 +541 [Double 0...MAX_DOUBLE (inclusive)] @@ -16910,7 +16927,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. -537 +543 [Double 0...MAX_DOUBLE (inclusive)] @@ -16927,7 +16944,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} -546 +552 [Double 0...MAX_DOUBLE (inclusive)] @@ -16944,7 +16961,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 all compositional fields or only those corresponding to chemical compositions. The default value of 75 GPa is representative of mantle rocks. Units: Pa. -542 +548 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -16961,7 +16978,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 all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: None. -520 +526 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -16978,7 +16995,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 all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: None. -524 +530 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -16995,7 +17012,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. -544 +550 [Double 0...MAX_DOUBLE (inclusive)] @@ -17018,7 +17035,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. -534 +540 [Selection none|dynamic friction|function ] @@ -17035,7 +17052,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 all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: None. -522 +528 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -17052,7 +17069,7 @@ List of friction strain weakening factors for background material and compositio The fixed grain size of the material. This grain size is only used if the parent material model does not provide its own (possibly variable) grain size when calling this rheology.Units: \si{\meter}. -562 +568 [Double 0...MAX_DOUBLE (inclusive)] @@ -17069,7 +17086,7 @@ The fixed grain size of the material. This grain size is only used if the parent 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 all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: None. -559 +565 [Anything] @@ -17086,7 +17103,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}. -517 +523 [Anything] @@ -17103,7 +17120,7 @@ false Whether to include Peierls creep in the rheological formulation. -585 +591 [Bool] @@ -17120,7 +17137,7 @@ Whether to include Peierls creep in the rheological formulation. List of lower temperature for maximum strain weakening for background material and compositional fields, for a total of N+1 values, where N is the number of all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: \si{\kelvin}. -528 +534 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -17137,12 +17154,29 @@ List of lower temperature for maximum strain weakening for background material a List of lower temperature for onset of strain weakening for background material and compositional fields, for a total of N+1 values, where N is the number of all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: \si{\kelvin}. -527 +533 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] + + +material_table_temperature_pressure_small.txt + + +material_table_temperature_pressure_small.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 two 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. These data files need to have the same structure as the one necessary for equation of state plus a new column for the phase indexes, which amounts to 8 columns in total. + + +519 + + +[List of <[Anything]> of length 0...4294967295 (inclusive)] + + 40 @@ -17154,7 +17188,7 @@ List of lower temperature for onset of strain weakening for background material Maximum number of iterations to find the correct Peierls strain rate. -574 +580 [Integer range 0...2147483647 (inclusive)] @@ -17171,7 +17205,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). -550 +556 [Anything] @@ -17188,7 +17222,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}. -593 +599 [Double 0...MAX_DOUBLE (inclusive)] @@ -17205,7 +17239,7 @@ Limits the maximum value of the yield stress determined by the Drucker-Prager pl The minimum water content for the HK04 olivine hydration viscosity prefactor scheme. This acts as the cutoff between 'dry' creep and 'wet' creep for olivine, and the default value is chosen based on the value reported by Hirth & Kohlstaedt 2004. For a mass fraction of bound water beneath this value, this value is used instead to compute the water fugacity. Units: \si{\kg} / \si{\kg} %. -587 +593 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -17222,7 +17256,7 @@ The minimum water content for the HK04 olivine hydration viscosity prefactor sch Stabilizes strain dependent viscosity. Units: \si{\per\second}. -547 +553 [Double 0...MAX_DOUBLE (inclusive)] @@ -17239,7 +17273,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). -549 +555 [Anything] @@ -17256,7 +17290,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. -572 +578 [Selection viscosity approximation|exact ] @@ -17273,7 +17307,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 all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: none -580 +586 [Anything] @@ -17290,7 +17324,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 all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: none -581 +587 [Anything] @@ -17307,7 +17341,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 all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: none -582 +588 [Anything] @@ -17324,7 +17358,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. The tolerance is expressed as the difference between the natural logarithm of the input strain rate and the strain rate at the current iteration. -573 +579 [Double 0...MAX_DOUBLE (inclusive)] @@ -17341,7 +17375,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 all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: \si{\pascal} -579 +585 [Anything] @@ -17354,7 +17388,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}. -513 +516 [Anything] @@ -17367,12 +17401,25 @@ 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}. -505 +508 [Anything] + + + + +A list of phase indicators in a look-up table for each phase transition. This parameter selectively assign different rheologies to specific phases, rather than having a unique rheology for each phase in the table. For example, if the table has phases 0, 1, and 2, and one only want a distinct rheology for phase 2, then only phase 2 is needed in the list of indicator. And phases 0, 1 will just be assigned the rheology of the base phase. + + +517 + + +[Anything] + + @@ -17380,7 +17427,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}. -508 +511 [Anything] @@ -17393,7 +17440,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}. -507 +510 [Anything] @@ -17410,7 +17457,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}. -512 +515 [Anything] @@ -17427,7 +17474,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}. -511 +514 [Anything] @@ -17440,7 +17487,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}. -510 +513 [Anything] @@ -17453,7 +17500,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}. -506 +509 [Anything] @@ -17470,7 +17517,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} -595 +601 [Double 0...MAX_DOUBLE (inclusive)] @@ -17487,7 +17534,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 all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: None. -525 +531 [List of <[Double 0...1 (inclusive)]> of length 0...4294967295 (inclusive)] @@ -17504,7 +17551,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 all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: None -568 +574 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -17521,7 +17568,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 all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: \si{\pascal}$^{-n_{\text{peierls}}}$ \si{\per\second} -575 +581 [Anything] @@ -17538,7 +17585,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 all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: \si{\per\pascal\meter}$^{m_{\text{diffusion}}}$\si{\per\second}. -557 +563 [Anything] @@ -17555,7 +17602,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 all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: \si{\pascal}$^{-n_{\text{dislocation}}}$ \si{\per\second}. -563 +569 [Anything] @@ -17572,7 +17619,7 @@ List of viscosity prefactors, $A$, for background material and compositional fie A prefactor for the pressure term in the viscosity approximation, for a total of N+1 values, where N is the number of all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: None -569 +575 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -17589,7 +17636,7 @@ A prefactor for the pressure term in the viscosity approximation, for a total of A reference pressure in the viscosity approximation which specifies where the FK pressure dependence goes to 0.Given for a total of N+1 values, where N is the number of all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: Pa -571 +577 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -17606,7 +17653,7 @@ A reference pressure in the viscosity approximation which specifies where the FK Reference strain rate for first time step. Units: \si{\per\second}. -548 +554 [Double 0...MAX_DOUBLE (inclusive)] @@ -17623,7 +17670,7 @@ Reference strain rate for first time step. Units: \si{\per\second}. The reference temperature $T_0$. Units: \si{\kelvin}. -514 +520 [Double 0...MAX_DOUBLE (inclusive)] @@ -17640,7 +17687,7 @@ The reference temperature $T_0$. Units: \si{\kelvin}. A reference temperature in the viscosity approximation which specifies where the FK temperature dependence goes to 0. Given for a total of N+1 values, where N is the number of all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: K -570 +576 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -17665,7 +17712,7 @@ false A stabilization factor for the elastic stresses that influences how fast elastic stresses adjust to deformation. This value is equal to the elastic time step divided by the computational time step. The default value of 1.0 may lead to oscillatory motion. Increasing this factor to 2.0 can reduce oscillations while preserving an immediate elastic response. In complex models the factor can be increased further to improve convergence behaviour. As the stabilization factor increases, the effective viscosity gets smaller, and is balanced by an increasing body force term. For composite rheologies that use this formulation of elasticity, setting an infinite shear modulus only recovers the nonelastic part of the rheology if this stabilization factor is equal to 1.0. -545 +551 [Double 1...MAX_DOUBLE (inclusive)] @@ -17682,7 +17729,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 all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: None. -519 +525 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -17699,7 +17746,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 all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: None. -523 +529 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -17720,7 +17767,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 -531 +537 [Selection no healing|temperature dependent ] @@ -17737,7 +17784,7 @@ Whether to apply strain healing to plastic yielding and viscosity terms, and if Prefactor for temperature dependent strain healing. Units: None -533 +539 [Double 0...MAX_DOUBLE (inclusive)] @@ -17754,7 +17801,7 @@ Prefactor for temperature dependent strain healing. Units: None Recovery rate prefactor for temperature dependent strain healing. Units: $1/s$ -532 +538 [Double 0...MAX_DOUBLE (inclusive)] @@ -17789,7 +17836,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. -518 +524 [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 ] @@ -17806,7 +17853,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 all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: None. -576 +582 [Anything] @@ -17823,7 +17870,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 all compositional fields or only those corresponding to chemical compositions. 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. -558 +564 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -17840,7 +17887,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 all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: None. -564 +570 [Anything] @@ -17857,7 +17904,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 all compositional fields or only those corresponding to chemical compositions. Units: none. -596 +602 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -17874,7 +17921,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 all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: \si{\watt\per\meter\per\kelvin}. -600 +606 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -17891,7 +17938,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 all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: \si{\meter\squared\per\second}. -598 +604 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -17908,7 +17955,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}. -516 +522 [Anything] @@ -17925,7 +17972,7 @@ List of thermal expansivities for background mantle and compositional fields,for List of upper temperatures for maximum strain weakening for background material and compositional fields, for a total of N+1 values, where N is the number of all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: \si{\kelvin}. -529 +535 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -17942,7 +17989,7 @@ List of upper temperatures for maximum strain weakening for background material List of upper temperatures for onset of strain weakeningfor background material and compositional fields, for a total of N+1 values, where N is the number of all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: \si{\kelvin}. -530 +536 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -17959,7 +18006,7 @@ false Whether to use the adiabatic pressure instead of the full pressure (default) when calculating viscous creep. 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. -555 +561 [Bool] @@ -17976,12 +18023,29 @@ false Whether to use the adiabatic pressure instead of the full pressure when calculating plastic yield stress. This may be helpful in models where the full pressure has unusually large variations, resulting in solver convergence issues. Be aware that this setting will change the plastic shear band angle. -556 +562 [Bool] + + +false + + +false + + +Whether to look up the dominant phase for each composition in its respective material data file to calculate viscosity. This allows each phase to have distinct rheological parameterizations. + + +507 + + +[Bool] + + unspecified @@ -17993,7 +18057,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'. -543 +549 [Selection true|false|unspecified ] @@ -18010,7 +18074,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. -594 +600 [Bool] @@ -18027,7 +18091,7 @@ false Whether viscous strain softening factor depends on temperature -526 +532 [Bool] @@ -18044,7 +18108,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. -551 +557 [Selection arithmetic|harmonic|geometric|maximum composition ] @@ -18061,7 +18125,7 @@ none Select what type of viscosity multiplicative prefactor scheme to apply. Allowed entries are 'none', and 'HK04 olivine hydration'. HK04 olivine hydration calculates the viscosity change due to hydrogen incorporation into olivine following Hirth & Kohlstaedt 2004 (10.1029/138GM06). none does not modify the viscosity. Units: none. -590 +596 [Selection none|HK04 olivine hydration ] @@ -18078,7 +18142,7 @@ Select what type of viscosity multiplicative prefactor scheme to apply. Allowed An adjusted viscosity ratio, $E$, for the viscosity approximation, for a total of N+1 values, where N is the number of all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: None -567 +573 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -18095,7 +18159,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 -552 +558 [Selection diffusion|dislocation|frank kamenetskii|composite ] @@ -18112,7 +18176,7 @@ Select what type of viscosity law to use between diffusion, dislocation, frank k List of water fugacity exponents for diffusion creep for background material and compositional fields, for a total of N+1 where N is the number of all compositional fields or only those corresponding to chemical compositions. This is only applied when using the Viscosity prefactor scheme 'HK04 olivine hydration'. Note, the water fugacity exponent required by ASPECT for diffusion creep is r/n, where n is the stress exponent for diffusion creep, which typically is 1. Units: none. -588 +594 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -18129,7 +18193,7 @@ List of water fugacity exponents for diffusion creep for background material and List of water fugacity exponents for dislocation creep for background material and compositional fields, for a total of N+1 where N is the number of all compositional fields or only those corresponding to chemical compositions. This is only applied when using the Viscosity prefactor scheme 'HK04 olivine hydration'. Note, the water fugacity exponent required by ASPECT for dislocation creep is r/n, where n is the stress exponent for dislocation creep, which typically is 3.5. Units: none. -589 +595 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -18146,7 +18210,7 @@ drucker Select what type of yield mechanism to use between Drucker Prager and stress limiter options. -553 +559 [Selection drucker|limiter ] @@ -18164,7 +18228,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. -538 +544 [Selection cartesian|spherical|depth ] @@ -18179,7 +18243,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.) -541 +547 [Anything] @@ -18198,7 +18262,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. -540 +546 [Anything] @@ -18215,7 +18279,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. -539 +545 [Anything] @@ -18235,7 +18299,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}. -602 +608 [Anything] @@ -18252,7 +18316,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} -609 +615 [Double 0...MAX_DOUBLE (inclusive)] @@ -18269,7 +18333,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 all compositional fields or only those corresponding to chemical compositions. The default value of 75 GPa is representative of mantle rocks. Units: Pa. -605 +611 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -18286,7 +18350,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. -607 +613 [Double 0...MAX_DOUBLE (inclusive)] @@ -18303,7 +18367,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}. -604 +610 [Anything] @@ -18320,7 +18384,7 @@ List of specific heats $C_p$ for background mantle and compositional fields,for The reference temperature $T_0$. Units: \si{\kelvin}. -601 +607 [Double 0...MAX_DOUBLE (inclusive)] @@ -18345,7 +18409,7 @@ false A stabilization factor for the elastic stresses that influences how fast elastic stresses adjust to deformation. This value is equal to the elastic time step divided by the computational time step. The default value of 1.0 may lead to oscillatory motion. Increasing this factor to 2.0 can reduce oscillations while preserving an immediate elastic response. In complex models the factor can be increased further to improve convergence behaviour. As the stabilization factor increases, the effective viscosity gets smaller, and is balanced by an increasing body force term. For composite rheologies that use this formulation of elasticity, setting an infinite shear modulus only recovers the nonelastic part of the rheology if this stabilization factor is equal to 1.0. -608 +614 [Double 1...MAX_DOUBLE (inclusive)] @@ -18362,7 +18426,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 all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: \si{\watt\per\meter\per\kelvin}. -611 +617 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -18379,7 +18443,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}. -603 +609 [Anything] @@ -18396,7 +18460,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'. -606 +612 [Selection true|false|unspecified ] @@ -18413,7 +18477,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 all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: \si{\pascal\second}. -610 +616 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -18430,7 +18494,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. -612 +618 [Selection arithmetic|harmonic|geometric|maximum composition ] @@ -18859,7 +18923,7 @@ true If multiple refinement criteria are specified in the ``Strategy'' parameter, then they need to be combined somehow to form the final refinement indicators. This is done using the method described by the ``Refinement criteria merge operation'' parameter which can either operate on the raw refinement indicators returned by each strategy (i.e., dimensional quantities) or using normalized values where the indicators of each strategy are first normalized to the interval $[0,1]$ (which also makes them non-dimensional). This parameter determines whether this normalization will happen. -408 +410 [Bool] @@ -18881,7 +18945,7 @@ If multiple mesh refinement criteria are computed for each cell (by passing a li \end{itemize}The refinement indicators computed by each strategy are modified by the ``Normalize individual refinement criteria'' and ``Refinement criteria scale factors'' parameters. -410 +412 [Selection plus|max ] @@ -18900,7 +18964,7 @@ You can experimentally play with these scaling factors by choosing to output the If the list of indicators 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 indicators chosen in the ``Strategy'' parameter. -409 +411 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -19067,7 +19131,7 @@ For complex equations such as those we solve here, this observation may not be s `volume of fluid interface': A class that implements a mesh refinement criterion, which ensures a minimum level of refinement near the volume of fluid interface boundary. -407 +409 [MultipleSelection artificial viscosity|boundary|compaction length|composition|composition approximate gradient|composition gradient|composition threshold|density|isosurfaces|maximum refinement function|minimum refinement function|nonadiabatic temperature|nonadiabatic temperature threshold|particle density|slope|strain rate|temperature|thermal energy density|topography|velocity|viscosity|volume of fluid interface ] @@ -19100,7 +19164,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. -428 +430 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -19117,7 +19181,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. -427 +429 [Double 0...MAX_DOUBLE (inclusive)] @@ -19134,7 +19198,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. -429 +431 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -19153,7 +19217,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. -430 +432 [Double 0...MAX_DOUBLE (inclusive)] @@ -19170,7 +19234,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. -418 +420 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -19187,7 +19251,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. -419 +421 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -19204,7 +19268,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. -420 +422 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -19219,7 +19283,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. -421 +423 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -19236,7 +19300,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. -422 +424 [Anything] @@ -19255,7 +19319,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. -423 +425 [Selection depth|cartesian|spherical ] @@ -19270,7 +19334,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.) -426 +428 [Anything] @@ -19289,7 +19353,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. -425 +427 [Anything] @@ -19306,7 +19370,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. -424 +426 [Anything] @@ -19325,7 +19389,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. -412 +414 [Selection depth|cartesian|spherical ] @@ -19340,7 +19404,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.) -415 +417 [Anything] @@ -19359,7 +19423,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. -414 +416 [Anything] @@ -19376,7 +19440,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. -413 +415 [Anything] @@ -19395,7 +19459,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. -417 +419 [Selection negative only|positive only|absolute value ] @@ -19412,7 +19476,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} -416 +418 [Double 0...MAX_DOUBLE (inclusive)] @@ -19431,7 +19495,7 @@ false If true, then explicitly coarsen any cells not neighboring the VolumeOfFluid interface. -411 +413 [Bool] @@ -19475,7 +19539,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. -248 +249 [Bool] @@ -19504,7 +19568,7 @@ Select one of the following models: `rk4': Runge Kutta fourth order integrator, where $y_{n+1} = y_n + \frac{1}{6} k_1 + \frac{1}{3} k_2 + \frac{1}{3} k_3 + \frac{1}{6} k_4$ and $k_1$, $k_2$, $k_3$, $k_4$ are defined as usual. -241 +242 [Selection euler|rk2|rk4 ] @@ -19533,7 +19597,7 @@ Select one of the following models: `quadratic least squares': Interpolates particle properties onto a vector of points using a quadratic least squares method. Note that deal.II must be configured with BLAS/LAPACK. -243 +244 [Selection bilinear least squares|cell average|distance weighted average|harmonic average|nearest neighbor|quadratic least squares ] @@ -19586,7 +19650,7 @@ The following properties are available: `viscoplastic strain invariants': A plugin that calculates the finite strain invariant a particle has experienced and assigns it to either the plastic and/or viscous strain field based on whether the material is plastically yielding, or the total strain field used in the visco plastic material model. The implementation of this property is equivalent to the implementation for compositional fields that is located in the plugin in \texttt{benchmarks/buiter\_et\_al\_2008\_jgr/plugin/},and is effectively the same as what the visco plastic material model uses for compositional fields. -251 +252 [MultipleSelection composition|cpo bingham average|cpo elastic tensor|crystal preferred orientation|elastic stress|elastic tensor decomposition|function|grain size|initial composition|initial position|integrated strain|integrated strain invariant|melt particle|pT path|position|reference position|strain rate|velocity|viscoplastic strain invariants ] @@ -19676,7 +19740,7 @@ Select one of the following models: `quadrature points': Generates particles at the quadrature points of each active cell of the triangulation. Here, Gauss quadrature of degree (velocity\_degree + 1), is used similarly to the assembly of Stokes matrix. -`random uniform': Generates a random uniform distribution of particles over the entire simulation domain. +`random uniform': Generates a random uniform distribution of particles over the entire simulation domain. This generator can be understood as the special case of the 'probability density function' generator where the probability density is constant over the domain. `reference cell': Generates a uniform distribution of particles per cell and spatial direction in the unit cell and transforms each of the particles back to real region in the model domain. Uniform here means the particles will be generated with an equal spacing in each spatial dimension. @@ -19737,7 +19801,7 @@ Some particle interpolation algorithms require knowledge about particles in neig This determines how many samples are taken when using the random draw volume averaging. Setting it to zero means that the number of samples is set to be equal to the number of grains. -254 +255 [Double 0...MAX_DOUBLE (inclusive)] @@ -19754,7 +19818,7 @@ This determines how many samples are taken when using the random draw volume ave The seed used to generate random numbers. This will make sure that results are reproducible 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. -253 +254 [Integer range 0...2147483647 (inclusive)] @@ -19773,7 +19837,7 @@ Spin tensor Options: Spin tensor -260 +261 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -19790,7 +19854,7 @@ Options: Spin tensor The number of grains of each different mineral each particle contains. -256 +257 [Integer range 1...2147483647 (inclusive)] @@ -19807,7 +19871,7 @@ The number of grains of each different mineral each particle contains. The Backward Euler property advection method involve internal iterations. This option allows for setting the maximum number of iterations. Note that when the iteration is ended by the max iteration amount an assert is thrown. -259 +260 [Integer range 0...2147483647 (inclusive)] @@ -19824,7 +19888,7 @@ Backward Euler Options: Forward Euler, Backward Euler -257 +258 [Anything] @@ -19841,7 +19905,7 @@ Options: Forward Euler, Backward Euler The Backward Euler property advection method involve internal iterations. This option allows for setting a tolerance. When the norm of tensor new - tensor old is smaller than this tolerance, the iteration is stopped. -258 +259 [Double 0...MAX_DOUBLE (inclusive)] @@ -19858,7 +19922,7 @@ The Backward Euler property advection method involve internal iterations. This o The seed used to generate random numbers. This will make sure that results are reproducible as long as the problem is run with the same number of MPI processes. It is implemented as final seed = user seed + MPI Rank. -255 +256 [Integer range 0...2147483647 (inclusive)] @@ -19876,7 +19940,7 @@ The seed used to generate random numbers. This will make sure that results are r This is exponent p as defined in equation 11 of Kaminski et al., 2004. -267 +268 [Double 0...MAX_DOUBLE (inclusive)] @@ -19893,7 +19957,7 @@ This is exponent p as defined in equation 11 of Kaminski et al., 2004. The dimensionless intrinsic grain boundary mobility for both olivine and enstatite. -264 +265 [Double 0...MAX_DOUBLE (inclusive)] @@ -19910,7 +19974,7 @@ The dimensionless intrinsic grain boundary mobility for both olivine and enstati This is the dimensionless nucleation rate as defined in equation 8 of Kaminski et al., 2004. -268 +269 [Double 0...MAX_DOUBLE (inclusive)] @@ -19927,7 +19991,7 @@ This is the dimensionless nucleation rate as defined in equation 8 of Kaminski e This is the power law exponent that characterizes the rheology of the slip systems. It is used in equation 11 of Kaminski et al., 2004. -266 +267 [Double 0...MAX_DOUBLE (inclusive)] @@ -19944,7 +20008,7 @@ This is the power law exponent that characterizes the rheology of the slip syste The Dimensionless Grain Boundary Sliding (GBS) threshold. This is a grain size threshold below which grain deform by GBS and become strain-free grains. -269 +270 [Double 0...MAX_DOUBLE (inclusive)] @@ -19961,7 +20025,7 @@ The Dimensionless Grain Boundary Sliding (GBS) threshold. This is a grain size t The volume fraction for the different minerals. There need to be the same amount of values as there are minerals -265 +266 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -19980,7 +20044,7 @@ Olivine: Karato 2008, Enstatite This determines what minerals and fabrics or fabric selectors are used used for the LPO/CPO calculation. The options are Olivine: Passive, A-fabric, Olivine: B-fabric, Olivine: C-fabric, Olivine: D-fabric, Olivine: E-fabric, Olivine: Karato 2008 or Enstatite. Passive sets all RRSS entries to the maximum. The Karato 2008 selector selects a fabric based on stress and water content as defined in figure 4 of the Karato 2008 review paper (doi: 10.1146/annurev.earth.36.031207.124120). -262 +263 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -19997,7 +20061,7 @@ Uniform grains and random uniform rotations The model used to initialize the CPO for all particles. Currently 'Uniform grains and random uniform rotations' and 'World Builder' are the only valid option. -261 +262 [Anything] @@ -20014,7 +20078,7 @@ The model used to initialize the CPO for all particles. Currently 'Uniform The volume fractions for the different minerals. There need to be the same number of values as there are minerals.Note that the currently implemented scheme is incompressible and does not allow chemical interaction or the formation of new phases -263 +264 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -20032,7 +20096,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.) -273 +274 [Anything] @@ -20051,7 +20115,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. -272 +273 [Anything] @@ -20068,7 +20132,7 @@ If the function you are describing represents a vector-valued function with mult The number of function components where each component is described by a function expression delimited by a ';'. -270 +271 [Integer range 0...2147483647 (inclusive)] @@ -20085,7 +20149,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. -271 +272 [Anything] @@ -20147,18 +20211,16 @@ A typical example would be to set this runtime parameter to `pi=3.1415926536&apo -0 +1.0 -0 +1.0 -The formula that denotes the function you want to evaluate for particular values of the independent variables. This expression may contain any of the usual operations such as addition or multiplication, as well as all of the common functions such as `sin' or `cos'. In addition, it may contain expressions like `if(x>0, 1, -1)' where the expression evaluates to the second argument if the first argument is true, and to the third argument otherwise. For a full overview of possible expressions accepted see the documentation of the muparser library at http://muparser.beltoforion.de/. - -If the function you are describing represents a vector-valued function with multiple components, then separate the expressions for individual components by a semicolon. +The formula that denotes the spatially variable probability density function. This expression may contain any of the usual operations such as addition or multiplication, as well as all of the common functions such as `sin' or `cos'. In addition, it may contain expressions like `if(x>0, 1, 0)' where the expression evaluates to the second argument if the first argument is true, and to the third argument otherwise; this example would result in no particles at all in that part of the domain where $x==0$, and a constant particle density in the rest of the domain. For a full overview of possible expressions accepted see the documentation of the muparser library at http://muparser.beltoforion.de/. Note that the function has to be non-negative everywhere in the domain, and needs to be positive in at least some parts of the domain. -236 +238 [Anything] @@ -20175,7 +20237,7 @@ If the function you are describing represents a vector-valued function with mult 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. -238 +239 [Double 0...MAX_DOUBLE (inclusive)] @@ -20192,7 +20254,7 @@ true If true, particle numbers per cell are calculated randomly according to their respective probability density. This means particle numbers per cell can deviate statistically from the integral of the probability density. If false, first determine how many particles each cell should have based on the integral of the density over each of the cells, and then once we know how many particles we want on each cell, choose their locations randomly within each cell. -239 +240 [Bool] @@ -20209,7 +20271,7 @@ If true, particle numbers per cell are calculated randomly according to their re The seed for the random number generator that controls the particle generation. Keep constant to generate identical particle distributions in subsequent model runs. Change to get a different distribution. In parallel computations the seed is further modified on each process to ensure different particle patterns on different processes. Note that the number of particles per processor is not affected by the seed. -240 +241 [Integer range 0...2147483647 (inclusive)] @@ -20629,7 +20691,7 @@ true Whether to correctly evaluate old and current velocity solution to reach higher-order accuracy in time. If set to 'false' only the old velocity solution is evaluated to simulate a first order method in time. This is only recommended for benchmark purposes. -242 +243 [Bool] @@ -20650,7 +20712,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'. -245 +246 [List of <[Bool]> of length 0...4294967295 (inclusive)] @@ -20667,7 +20729,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. -244 +245 [List of <[Bool]> of length 0...4294967295 (inclusive)] @@ -20686,7 +20748,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'. -250 +251 [List of <[Bool]> of length 0...4294967295 (inclusive)] @@ -20703,7 +20765,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. -249 +250 [List of <[Bool]> of length 0...4294967295 (inclusive)] @@ -20723,7 +20785,7 @@ Limit the interpolation of particle properties onto the cell, so that the value The minimum porosity that has to be present at the position of a particle for it to be considered a melt particle (in the sense that the melt presence property is set to 1). -252 +253 [Double 0...1 (inclusive)] @@ -20743,7 +20805,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. -317 +319 [Bool] @@ -20772,7 +20834,7 @@ Select one of the following models: `rk4': Runge Kutta fourth order integrator, where $y_{n+1} = y_n + \frac{1}{6} k_1 + \frac{1}{3} k_2 + \frac{1}{3} k_3 + \frac{1}{6} k_4$ and $k_1$, $k_2$, $k_3$, $k_4$ are defined as usual. -310 +312 [Selection euler|rk2|rk4 ] @@ -20801,7 +20863,7 @@ Select one of the following models: `quadratic least squares': Interpolates particle properties onto a vector of points using a quadratic least squares method. Note that deal.II must be configured with BLAS/LAPACK. -312 +314 [Selection bilinear least squares|cell average|distance weighted average|harmonic average|nearest neighbor|quadratic least squares ] @@ -20854,7 +20916,7 @@ The following properties are available: `viscoplastic strain invariants': A plugin that calculates the finite strain invariant a particle has experienced and assigns it to either the plastic and/or viscous strain field based on whether the material is plastically yielding, or the total strain field used in the visco plastic material model. The implementation of this property is equivalent to the implementation for compositional fields that is located in the plugin in \texttt{benchmarks/buiter\_et\_al\_2008\_jgr/plugin/},and is effectively the same as what the visco plastic material model uses for compositional fields. -320 +322 [MultipleSelection composition|cpo bingham average|cpo elastic tensor|crystal preferred orientation|elastic stress|elastic tensor decomposition|function|grain size|initial composition|initial position|integrated strain|integrated strain invariant|melt particle|pT path|position|reference position|strain rate|velocity|viscoplastic strain invariants ] @@ -20871,7 +20933,7 @@ repartition Strategy that is used to balance the computational load across processors for adaptive meshes. -274 +275 [MultipleSelection none|remove particles|add particles|remove and add particles|repartition ] @@ -20888,7 +20950,7 @@ Strategy that is used to balance the computational load across processors for ad Upper limit for particle number per cell. This limit is useful for adaptive meshes to prevent coarse cells from slowing down the whole model. It will be checked and enforced after mesh refinement, after MPI transfer of particles and after particle movement. If there are \texttt{n\_number\_of\_particles} $>$ \texttt{max\_particles\_per\_cell} particles in one cell then \texttt{n\_number\_of\_particles} - \texttt{max\_particles\_per\_cell} particles in this cell are randomly chosen and destroyed. -276 +277 [Integer range 0...2147483647 (inclusive)] @@ -20905,7 +20967,7 @@ Upper limit for particle number per cell. This limit is useful for adaptive mesh Lower limit for particle number per cell. This limit is useful for adaptive meshes to prevent fine cells from being empty of particles. It will be checked and enforced after mesh refinement and after particle movement. If there are \texttt{n\_number\_of\_particles} $<$ \texttt{min\_particles\_per\_cell} particles in one cell then \texttt{min\_particles\_per\_cell} - \texttt{n\_number\_of\_particles} particles are generated and randomly placed in this cell. If the particles carry properties the individual property plugins control how the properties of the new particles are initialized. -275 +276 [Integer range 0...2147483647 (inclusive)] @@ -20927,7 +20989,7 @@ Select one of the following models: `quadrature points': Generates particles at the quadrature points of each active cell of the triangulation. Here, Gauss quadrature of degree (velocity\_degree + 1), is used similarly to the assembly of Stokes matrix. -`random uniform': Generates a random uniform distribution of particles over the entire simulation domain. +`random uniform': Generates a random uniform distribution of particles over the entire simulation domain. This generator can be understood as the special case of the 'probability density function' generator where the probability density is constant over the domain. `reference cell': Generates a uniform distribution of particles per cell and spatial direction in the unit cell and transforms each of the particles back to real region in the model domain. Uniform here means the particles will be generated with an equal spacing in each spatial dimension. @@ -20936,7 +20998,7 @@ Select one of the following models: `uniform radial': Generate a uniform distribution of particles over a spherical domain in 2d or 3d. Uniform here means the particles will be generated with an equal spacing in each spherical spatial dimension, i.e., the particles are created at positions that increase linearly with equal spacing in radius, colatitude and longitude around a certain center point. Note that in order to produce a regular distribution the number of generated particles might not exactly match the one specified in the input file. -279 +280 [Selection ascii file|probability density function|quadrature points|random uniform|reference cell|uniform box|uniform radial ] @@ -20953,7 +21015,7 @@ Select one of the following models: Weight that is associated with the computational load of a single particle. The sum of particle weights will be added to the sum of cell weights to determine the partitioning of the mesh if the `repartition' particle load balancing strategy is selected. The optimal weight depends on the used integrator and particle properties. In general for a more expensive integrator and more expensive properties a larger particle weight is recommended. Before adding the weights of particles, each cell already carries a weight of 1000 to account for the cost of field-based computations. -277 +278 [Integer range 0...2147483647 (inclusive)] @@ -20970,7 +21032,7 @@ true Some particle interpolation algorithms require knowledge about particles in neighboring cells. To allow this, particles in ghost cells need to be exchanged between the processes neighboring this cell. This parameter determines whether this transport is happening. This parameter is deprecated and will be removed in the future. Ghost particle updates are always performed. Please set the parameter to `true'. -278 +279 [Bool] @@ -20988,7 +21050,7 @@ Some particle interpolation algorithms require knowledge about particles in neig This determines how many samples are taken when using the random draw volume averaging. Setting it to zero means that the number of samples is set to be equal to the number of grains. -323 +325 [Double 0...MAX_DOUBLE (inclusive)] @@ -21005,7 +21067,7 @@ This determines how many samples are taken when using the random draw volume ave The seed used to generate random numbers. This will make sure that results are reproducible 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. -322 +324 [Integer range 0...2147483647 (inclusive)] @@ -21024,7 +21086,7 @@ Spin tensor Options: Spin tensor -329 +331 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -21041,7 +21103,7 @@ Options: Spin tensor The number of grains of each different mineral each particle contains. -325 +327 [Integer range 1...2147483647 (inclusive)] @@ -21058,7 +21120,7 @@ The number of grains of each different mineral each particle contains. The Backward Euler property advection method involve internal iterations. This option allows for setting the maximum number of iterations. Note that when the iteration is ended by the max iteration amount an assert is thrown. -328 +330 [Integer range 0...2147483647 (inclusive)] @@ -21075,7 +21137,7 @@ Backward Euler Options: Forward Euler, Backward Euler -326 +328 [Anything] @@ -21092,7 +21154,7 @@ Options: Forward Euler, Backward Euler The Backward Euler property advection method involve internal iterations. This option allows for setting a tolerance. When the norm of tensor new - tensor old is smaller than this tolerance, the iteration is stopped. -327 +329 [Double 0...MAX_DOUBLE (inclusive)] @@ -21109,7 +21171,7 @@ The Backward Euler property advection method involve internal iterations. This o The seed used to generate random numbers. This will make sure that results are reproducible as long as the problem is run with the same number of MPI processes. It is implemented as final seed = user seed + MPI Rank. -324 +326 [Integer range 0...2147483647 (inclusive)] @@ -21127,7 +21189,7 @@ The seed used to generate random numbers. This will make sure that results are r This is exponent p as defined in equation 11 of Kaminski et al., 2004. -336 +338 [Double 0...MAX_DOUBLE (inclusive)] @@ -21144,7 +21206,7 @@ This is exponent p as defined in equation 11 of Kaminski et al., 2004. The dimensionless intrinsic grain boundary mobility for both olivine and enstatite. -333 +335 [Double 0...MAX_DOUBLE (inclusive)] @@ -21161,7 +21223,7 @@ The dimensionless intrinsic grain boundary mobility for both olivine and enstati This is the dimensionless nucleation rate as defined in equation 8 of Kaminski et al., 2004. -337 +339 [Double 0...MAX_DOUBLE (inclusive)] @@ -21178,7 +21240,7 @@ This is the dimensionless nucleation rate as defined in equation 8 of Kaminski e This is the power law exponent that characterizes the rheology of the slip systems. It is used in equation 11 of Kaminski et al., 2004. -335 +337 [Double 0...MAX_DOUBLE (inclusive)] @@ -21195,7 +21257,7 @@ This is the power law exponent that characterizes the rheology of the slip syste The Dimensionless Grain Boundary Sliding (GBS) threshold. This is a grain size threshold below which grain deform by GBS and become strain-free grains. -338 +340 [Double 0...MAX_DOUBLE (inclusive)] @@ -21212,7 +21274,7 @@ The Dimensionless Grain Boundary Sliding (GBS) threshold. This is a grain size t The volume fraction for the different minerals. There need to be the same amount of values as there are minerals -334 +336 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -21231,7 +21293,7 @@ Olivine: Karato 2008, Enstatite This determines what minerals and fabrics or fabric selectors are used used for the LPO/CPO calculation. The options are Olivine: Passive, A-fabric, Olivine: B-fabric, Olivine: C-fabric, Olivine: D-fabric, Olivine: E-fabric, Olivine: Karato 2008 or Enstatite. Passive sets all RRSS entries to the maximum. The Karato 2008 selector selects a fabric based on stress and water content as defined in figure 4 of the Karato 2008 review paper (doi: 10.1146/annurev.earth.36.031207.124120). -331 +333 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -21248,7 +21310,7 @@ Uniform grains and random uniform rotations The model used to initialize the CPO for all particles. Currently 'Uniform grains and random uniform rotations' and 'World Builder' are the only valid option. -330 +332 [Anything] @@ -21265,7 +21327,7 @@ The model used to initialize the CPO for all particles. Currently 'Uniform The volume fractions for the different minerals. There need to be the same number of values as there are minerals.Note that the currently implemented scheme is incompressible and does not allow chemical interaction or the formation of new phases -332 +334 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -21283,7 +21345,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.) -342 +344 [Anything] @@ -21302,7 +21364,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. -341 +343 [Anything] @@ -21319,7 +21381,7 @@ If the function you are describing represents a vector-valued function with mult The number of function components where each component is described by a function expression delimited by a ';'. -339 +341 [Integer range 0...2147483647 (inclusive)] @@ -21336,7 +21398,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. -340 +342 [Anything] @@ -21356,7 +21418,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. -302 +303 [DirectoryName] @@ -21373,7 +21435,7 @@ particle.dat The name of the particle file. -303 +304 [Anything] @@ -21390,7 +21452,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.) -306 +307 [Anything] @@ -21398,18 +21460,16 @@ A typical example would be to set this runtime parameter to `pi=3.1415926536&apo -0 +1.0 -0 +1.0 -The formula that denotes the function you want to evaluate for particular values of the independent variables. This expression may contain any of the usual operations such as addition or multiplication, as well as all of the common functions such as `sin' or `cos'. In addition, it may contain expressions like `if(x>0, 1, -1)' where the expression evaluates to the second argument if the first argument is true, and to the third argument otherwise. For a full overview of possible expressions accepted see the documentation of the muparser library at http://muparser.beltoforion.de/. - -If the function you are describing represents a vector-valued function with multiple components, then separate the expressions for individual components by a semicolon. +The formula that denotes the spatially variable probability density function. This expression may contain any of the usual operations such as addition or multiplication, as well as all of the common functions such as `sin' or `cos'. In addition, it may contain expressions like `if(x>0, 1, 0)' where the expression evaluates to the second argument if the first argument is true, and to the third argument otherwise; this example would result in no particles at all in that part of the domain where $x==0$, and a constant particle density in the rest of the domain. For a full overview of possible expressions accepted see the documentation of the muparser library at http://muparser.beltoforion.de/. Note that the function has to be non-negative everywhere in the domain, and needs to be positive in at least some parts of the domain. -305 +308 [Anything] @@ -21426,7 +21486,7 @@ If the function you are describing represents a vector-valued function with mult 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. -307 +309 [Double 0...MAX_DOUBLE (inclusive)] @@ -21443,7 +21503,7 @@ true If true, particle numbers per cell are calculated randomly according to their respective probability density. This means particle numbers per cell can deviate statistically from the integral of the probability density. If false, first determine how many particles each cell should have based on the integral of the density over each of the cells, and then once we know how many particles we want on each cell, choose their locations randomly within each cell. -308 +310 [Bool] @@ -21460,7 +21520,7 @@ If true, particle numbers per cell are calculated randomly according to their re The seed for the random number generator that controls the particle generation. Keep constant to generate identical particle distributions in subsequent model runs. Change to get a different distribution. In parallel computations the seed is further modified on each process to ensure different particle patterns on different processes. Note that the number of particles per processor is not affected by the seed. -309 +311 [Integer range 0...2147483647 (inclusive)] @@ -21477,7 +21537,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. -304 +305 [Anything] @@ -21496,7 +21556,7 @@ The names of the variables as they will be used in the function, separated by co 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. -280 +281 [Double 0...MAX_DOUBLE (inclusive)] @@ -21513,7 +21573,7 @@ true If true, particle numbers per cell are calculated randomly according to their respective probability density. This means particle numbers per cell can deviate statistically from the integral of the probability density. If false, first determine how many particles each cell should have based on the integral of the density over each of the cells, and then once we know how many particles we want on each cell, choose their locations randomly within each cell. -281 +282 [Bool] @@ -21530,7 +21590,7 @@ If true, particle numbers per cell are calculated randomly according to their re The seed for the random number generator that controls the particle generation. Keep constant to generate identical particle distributions in subsequent model runs. Change to get a different distribution. In parallel computations the seed is further modified on each process to ensure different particle patterns on different processes. Note that the number of particles per processor is not affected by the seed. -282 +283 [Integer range 0...2147483647 (inclusive)] @@ -21549,7 +21609,7 @@ The seed for the random number generator that controls the particle generation. 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. -283 +284 [List of <[Integer range 1...2147483647 (inclusive)]> of length 0...4294967295 (inclusive)] @@ -21568,7 +21628,7 @@ List of number of particles to create per cell and spatial dimension. The size o Maximum x coordinate for the region of particles. -286 +287 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -21585,7 +21645,7 @@ Maximum x coordinate for the region of particles. Maximum y coordinate for the region of particles. -288 +289 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -21602,7 +21662,7 @@ Maximum y coordinate for the region of particles. Maximum z coordinate for the region of particles. -290 +291 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -21619,7 +21679,7 @@ Maximum z coordinate for the region of particles. Minimum x coordinate for the region of particles. -285 +286 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -21636,7 +21696,7 @@ Minimum x coordinate for the region of particles. Minimum y coordinate for the region of particles. -287 +288 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -21653,7 +21713,7 @@ Minimum y coordinate for the region of particles. Minimum z coordinate for the region of particles. -289 +290 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -21670,7 +21730,7 @@ Minimum z coordinate for the region of particles. 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. -284 +285 [Double 0...MAX_DOUBLE (inclusive)] @@ -21689,7 +21749,7 @@ Total number of particles to create (not per processor or per element). The numb x coordinate for the center of the spherical region, where particles are generated. -292 +293 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -21706,7 +21766,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. -293 +294 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -21723,7 +21783,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. -294 +295 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -21740,7 +21800,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. -300 +301 [Double 0...180 (inclusive)] @@ -21757,7 +21817,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. -298 +299 [Double -180...360 (inclusive)] @@ -21774,7 +21834,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. -296 +297 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -21791,7 +21851,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. -299 +300 [Double 0...180 (inclusive)] @@ -21808,7 +21868,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. -297 +298 [Double -180...360 (inclusive)] @@ -21825,7 +21885,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. -295 +296 [Double 0...MAX_DOUBLE (inclusive)] @@ -21842,7 +21902,7 @@ Minimum radial coordinate for the region of particles. Measured from the center 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. -291 +292 [Double 0...MAX_DOUBLE (inclusive)] @@ -21859,7 +21919,7 @@ Total number of particles to create (not per processor or per element). The numb The number of radial shells of particles that will be generated around the central point. -301 +302 [Integer range 1...2147483647 (inclusive)] @@ -21880,7 +21940,7 @@ true Whether to correctly evaluate old and current velocity solution to reach higher-order accuracy in time. If set to 'false' only the old velocity solution is evaluated to simulate a first order method in time. This is only recommended for benchmark purposes. -311 +313 [Bool] @@ -21901,7 +21961,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'. -314 +316 [List of <[Bool]> of length 0...4294967295 (inclusive)] @@ -21918,7 +21978,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. -313 +315 [List of <[Bool]> of length 0...4294967295 (inclusive)] @@ -21937,7 +21997,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'. -319 +321 [List of <[Bool]> of length 0...4294967295 (inclusive)] @@ -21954,7 +22014,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. -318 +320 [List of <[Bool]> of length 0...4294967295 (inclusive)] @@ -21974,7 +22034,7 @@ Limit the interpolation of particle properties onto the cell, so that the value The minimum porosity that has to be present at the position of a particle for it to be considered a melt particle (in the sense that the melt presence property is set to 1). -321 +323 [Double 0...1 (inclusive)] @@ -22149,7 +22209,7 @@ $ASPECT_SOURCE_DIR/data/postprocess/boundary-strain-rate-residual/ The name of a directory that contains the ascii 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. -394 +396 [DirectoryName] @@ -22166,7 +22226,7 @@ box_3d_boundary_strain_rate.txt The file name of the input surface strain rate an ascii data. The file has one column in addition to the coordinate columns corresponding to the second invariant of strain rate. -395 +397 [Anything] @@ -22183,7 +22243,7 @@ The file name of the input surface strain rate an ascii data. The file has one c Scalar factor, which is applied to the model data. You might want to use this to scale the input to a reference model. -396 +398 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -22202,7 +22262,7 @@ $ASPECT_SOURCE_DIR/data/boundary-velocity/gplates/ The name of a directory that contains the GPlates model or the ascii 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. -397 +399 [DirectoryName] @@ -22219,7 +22279,7 @@ current_day.gpml The file name of the input velocity as a GPlates model or an ascii data. For the GPlates model, provide file in the same format as described in the 'gplates' boundary velocity plugin. For the ascii data, provide file in the same format as described in 'ascii data' initial composition plugin. -398 +400 [Anything] @@ -22236,7 +22296,7 @@ The file name of the input velocity as a GPlates model or an ascii data. For 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/year set this factor to 0.01. -399 +401 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -22253,7 +22313,7 @@ false Use ascii data files (e.g., GPS) for computing residual velocities instead of GPlates data. -401 +403 [Bool] @@ -22270,7 +22330,7 @@ false Specify velocity as r, phi, and theta components instead of x, y, and z. Positive velocities point up, east, and north (in 3d) or out and clockwise (in 2d). This setting only makes sense for spherical geometries.GPlates data is always interpreted to be in east and north directions and is not affected by this parameter. -400 +402 [Bool] @@ -22285,7 +22345,7 @@ Specify velocity as r, phi, and theta components instead of x, y, and z. Positiv Command to execute. -404 +406 [Anything] @@ -22302,7 +22362,7 @@ false Whether to run command from all processes (true), or only on process 0 (false). -403 +405 [Bool] @@ -22319,7 +22379,7 @@ false Select whether \aspect{} should terminate if the command returns a non-zero exit status. -402 +404 [Bool] @@ -22334,7 +22394,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. -405 +407 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -22353,7 +22413,7 @@ true Whether to compress the raw and weighted cpo data output files with zlib. -352 +354 [Bool] @@ -22370,7 +22430,7 @@ Whether 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 reproducible 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. -347 +349 [Integer range 0...2147483647 (inclusive)] @@ -22383,7 +22443,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. -349 +351 [Anything] @@ -22402,7 +22462,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. -346 +348 [Double 0...MAX_DOUBLE (inclusive)] @@ -22419,7 +22479,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. -348 +350 [Bool] @@ -22437,7 +22497,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 multiple times, they will be written out multiple times. -351 +353 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -22455,7 +22515,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 multiple times, they will be written out multiple times. -350 +352 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -22470,7 +22530,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). -355 +357 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -22492,7 +22552,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 -357 +359 [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 ] @@ -22509,7 +22569,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. -354 +356 [Integer range 1...2147483647 (inclusive)] @@ -22526,7 +22586,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. -356 +358 [MultipleSelection none|dx|ucd|gnuplot|povray|eps|gmv|tecplot|vtk|vtu|hdf5|svg|deal.II intermediate|txt ] @@ -22543,7 +22603,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. -353 +355 [Double 0...MAX_DOUBLE (inclusive)] @@ -22562,7 +22622,7 @@ false Output the excess entropy only instead the each entropy terms. -406 +408 [Bool] @@ -22581,7 +22641,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}. -358 +360 [Double 0...MAX_DOUBLE (inclusive)] @@ -22598,7 +22658,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}. -359 +361 [Double 0...MAX_DOUBLE (inclusive)] @@ -22615,7 +22675,7 @@ true Whether to output a file containing the bottom (i.e., CMB) dynamic topography. -361 +363 [Bool] @@ -22632,7 +22692,7 @@ true Whether to output a file containing the surface dynamic topography. -360 +362 [Bool] @@ -22691,7 +22751,7 @@ false The density value above the surface boundary. -367 +369 [Double 0...MAX_DOUBLE (inclusive)] @@ -22708,7 +22768,7 @@ The density value above the surface boundary. The density value below the CMB boundary. -368 +370 [Double 0...MAX_DOUBLE (inclusive)] @@ -22725,7 +22785,7 @@ true Option to include the contribution from CMB topography on geoid. The default is true. -363 +365 [Bool] @@ -22742,7 +22802,7 @@ true Option to include the contribution from surface topography on geoid. The default is true. -362 +364 [Bool] @@ -22759,7 +22819,7 @@ Option to include the contribution from surface 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. -364 +366 [Integer range 0...2147483647 (inclusive)] @@ -22776,7 +22836,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. -365 +367 [Integer range 0...2147483647 (inclusive)] @@ -22793,7 +22853,7 @@ false Option to output the spherical harmonic coefficients of the CMB topography contribution to the maximum degree. The default is false. -371 +373 [Bool] @@ -22810,7 +22870,7 @@ false Option to output the geoid anomaly in geographical coordinates (latitude and longitude). The default is false, so the postprocessor will output the data in geocentric coordinates (x,y,z) as normally. -366 +368 [Bool] @@ -22827,7 +22887,7 @@ false Option to output the spherical harmonic coefficients of the density anomaly contribution to the maximum degree. The default is false. -372 +374 [Bool] @@ -22844,7 +22904,7 @@ false Option to output the spherical harmonic coefficients of the geoid anomaly up to the maximum degree. The default is false, so the postprocessor will only output the geoid anomaly in grid format. -369 +371 [Bool] @@ -22861,7 +22921,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. -373 +375 [Bool] @@ -22878,7 +22938,7 @@ false Option to output the spherical harmonic coefficients of the surface topography contribution to the maximum degree. The default is false. -370 +372 [Bool] @@ -22897,7 +22957,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. -374 +376 [Bool] @@ -22912,7 +22972,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. -391 +393 [List of <[Double -90...90 (inclusive)]> of length 0...4294967295 (inclusive)] @@ -22925,7 +22985,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. -390 +392 [List of <[Double -180...180 (inclusive)]> of length 0...4294967295 (inclusive)] @@ -22938,7 +22998,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 -389 +391 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -22955,7 +23015,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. -386 +388 [Double -90...90 (inclusive)] @@ -22972,7 +23032,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. -385 +387 [Double -180...180 (inclusive)] @@ -22989,7 +23049,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. -382 +384 [Double 0...MAX_DOUBLE (inclusive)] @@ -23006,7 +23066,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. -384 +386 [Double -90...90 (inclusive)] @@ -23023,7 +23083,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. -383 +385 [Double -180...180 (inclusive)] @@ -23040,7 +23100,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. -381 +383 [Double 0...MAX_DOUBLE (inclusive)] @@ -23057,7 +23117,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 -376 +378 [Integer range 0...2147483647 (inclusive)] @@ -23074,7 +23134,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. -380 +382 [Integer range 0...2147483647 (inclusive)] @@ -23091,7 +23151,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. -379 +381 [Integer range 0...2147483647 (inclusive)] @@ -23108,7 +23168,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. -378 +380 [Integer range 0...2147483647 (inclusive)] @@ -23125,7 +23185,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. -388 +390 [Integer range 1...2147483647 (inclusive)] @@ -23142,7 +23202,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. -377 +379 [Integer range -1...2147483647 (inclusive)] @@ -23159,7 +23219,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. -387 +389 [Double 0...MAX_DOUBLE (inclusive)] @@ -23176,7 +23236,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. -375 +377 [Selection map|list|list of points|fibonacci spiral ] @@ -23193,7 +23253,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. -392 +394 [Double 0...MAX_DOUBLE (inclusive)] @@ -23210,7 +23270,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. -393 +395 [Integer range 0...2147483647 (inclusive)] @@ -23342,7 +23402,7 @@ File operations can potentially take a long time, blocking the progress of the r The list of points at which the solution should be evaluated. Points need to be separated by semicolons, and coordinates of each point need to be separated by commas. -344 +346 [List of <[List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 2...2 (inclusive)]> of length 0...4294967295 (inclusive) separated by <;>] @@ -23359,7 +23419,7 @@ The list of points at which the solution should be evaluated. Points need to be The time interval between each generation of point values output. 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. -343 +345 [Double 0...MAX_DOUBLE (inclusive)] @@ -23376,7 +23436,7 @@ false Whether or not the Evaluation points are specified in the natural coordinates of the geometry model, e.g. radius, lon, lat for the chunk model. Currently, natural coordinates for the spherical shell and sphere geometries are not supported. -345 +347 [Bool] @@ -23602,7 +23662,8 @@ false false -deal.II offers the possibility to filter duplicate vertices for HDF5 output files. This merges the vertices of adjacent cells and therefore saves disk space, but misrepresents discontinuous output properties. Activating this function reduces the disk space by about a factor of $2^{dim}$ for HDF5 output, and currently has no effect on other output formats. :::{warning} +deal.II offers the possibility to filter duplicate vertices for HDF5 output files. This merges the vertices of adjacent cells and therefore saves disk space, but misrepresents discontinuous output properties. Activating this function reduces the disk space by about a factor of $2^{dim}$ for HDF5 output, and currently has no effect on other output formats. + :::{warning} Setting this flag to true will result in visualization output that does not accurately represent discontinuous fields. This may be because you are using a discontinuous finite element for the pressure, temperature, or compositional variables, or because you use a visualization postprocessor that outputs quantities as discontinuous fields (e.g., the strain rate, viscosity, etc.). These will then all be visualized as \textit{continuous} quantities even though, internally, \aspect{} considers them as discontinuous fields. ::: @@ -24045,7 +24106,7 @@ false false -deal.II offers the possibility to write vtu files with higher order representations of the output data. This means each cell will correctly show the higher order representation of the output data instead of the linear interpolation between vertices that ParaView and VisIt usually show. Note that activating this option is safe and recommended, but requires that (i) ``Output format'' is set to ``vtu'', (ii) ``Interpolate output'' is set to true, (iii) you use a sufficiently new version of Paraview or VisIt to read the files (Paraview version 5.5 or newer, and VisIt version to be determined), and (iv) you use deal.II version 9.1.0 or newer. +deal.II offers the possibility to write vtu files with higher order representations of the output data. This means each cell will correctly show the higher order representation of the output data instead of the linear interpolation between vertices that ParaView and VisIt usually show. Note that activating this option is safe and recommended, but requires that (i) ``Output format'' is set to ``vtu'', (ii) ``Interpolate output'' is set to true, and (iii) you use a sufficiently new version of Paraview or VisIt to read the files (Paraview version 5.5 or newer, and VisIt version to be determined). The effect of using this option can be seen in the following picture: \begin{center} \includegraphics[width=0.5\textwidth]{viz/parameters/higher-order-output}\end{center}The top figure shows the plain output without interpolation or higher order output. The middle figure shows output that was interpolated as discussed for the ``Interpolate output'' option. The bottom panel shows higher order output that achieves better accuracy than the interpolated output at a lower memory cost. @@ -24686,7 +24747,7 @@ Select one of the following models: `function': This plugin allows to prescribe the Stokes solution for the velocity and pressure field in terms of an explicit formula. The format of these functions follows the syntax understood by the muparser library, see {ref}\`sec:run-aspect:parameters-overview:muparser-format\`. -1303 +1309 [Selection ascii data|circle|function|unspecified ] @@ -24704,7 +24765,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. -1319 +1325 [DirectoryName] @@ -24721,7 +24782,7 @@ box_2d.txt The file name of the model data. -1320 +1326 [Anything] @@ -24738,7 +24799,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. -1323 +1329 [Anything] @@ -24755,7 +24816,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. -1321 +1327 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -24772,7 +24833,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. -1324 +1330 [Anything] @@ -24789,7 +24850,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. -1322 +1328 [Bool] @@ -24806,7 +24867,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.) -1315 +1321 [Anything] @@ -24825,7 +24886,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. -1314 +1320 [Anything] @@ -24842,7 +24903,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. -1313 +1319 [Anything] @@ -24859,7 +24920,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.) -1312 +1318 [Anything] @@ -24878,7 +24939,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. -1311 +1317 [Anything] @@ -24895,7 +24956,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. -1310 +1316 [Anything] @@ -24912,7 +24973,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.) -1318 +1324 [Anything] @@ -24931,7 +24992,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. -1317 +1323 [Anything] @@ -24948,7 +25009,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. -1316 +1322 [Anything] @@ -24965,7 +25026,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.) -1309 +1315 [Anything] @@ -24984,7 +25045,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. -1308 +1314 [Anything] @@ -25001,7 +25062,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. -1307 +1313 [Anything] @@ -25018,7 +25079,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.) -1306 +1312 [Anything] @@ -25037,7 +25098,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. -1305 +1311 [Anything] @@ -25054,7 +25115,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. -1304 +1310 [Anything] @@ -25751,7 +25812,7 @@ false Whether to checkpoint the simulation right before termination. -443 +445 [Bool] @@ -25768,7 +25829,7 @@ Whether to checkpoint the simulation right before termination. Terminate the simulation once the specified timestep has been reached. -433 +435 [Integer range 0...2147483647 (inclusive)] @@ -25801,7 +25862,7 @@ The criterion considers the total heat flux over all boundaries listed by their `wall time': Terminate the simulation once the wall time limit has reached. -431 +433 [MultipleSelection end step|end time|steady state heat flux|steady state temperature|steady state velocity|user request|wall time ] @@ -25818,7 +25879,7 @@ The criterion considers the total heat flux over all boundaries listed by their The wall time of the simulation. Unit: hours. -435 +437 [Double 0...MAX_DOUBLE (inclusive)] @@ -25834,7 +25895,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. -438 +440 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -25851,7 +25912,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. -436 +438 [Double 0...MAX_DOUBLE (inclusive)] @@ -25868,7 +25929,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. -437 +439 [Double 0...MAX_DOUBLE (inclusive)] @@ -25887,7 +25948,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. -441 +443 [Double 0...MAX_DOUBLE (inclusive)] @@ -25904,7 +25965,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. -442 +444 [Double 0...MAX_DOUBLE (inclusive)] @@ -25923,7 +25984,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. -439 +441 [Double 0...MAX_DOUBLE (inclusive)] @@ -25940,7 +26001,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. -440 +442 [Double 0...MAX_DOUBLE (inclusive)] @@ -25959,7 +26020,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. -432 +434 [FileName (Type: input)] @@ -25988,7 +26049,7 @@ A large reduction in time step size typically happens when velocities change abr `repeat on nonlinear solver failure': This time stepping plugin will react when the nonlinear solver does not converge in the specified maximum number of iterations and repeats the current timestep with a smaller step size. This plugin is enabled automatically if "Nonlinear solver failure strategy" is set to "cut timestep size". -445 +447 [MultipleSelection conduction time step|convection time step|function|repeat on cutback|repeat on nonlinear solver failure ] @@ -26005,7 +26066,7 @@ A large reduction in time step size typically happens when velocities change abr Specify a minimum time step size (or 0 to disable). -444 +446 [Double 0...MAX_DOUBLE (inclusive)] @@ -26021,7 +26082,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.) -448 +450 [Anything] @@ -26038,7 +26099,7 @@ A typical example would be to set this runtime parameter to `pi=3.1415926536&apo Expression for the time step size as a function of 'time'. -449 +451 [Anything] @@ -26055,7 +26116,7 @@ time Name for the variable representing the current time. -450 +452 [Anything] @@ -26074,7 +26135,7 @@ Name for the variable representing the current time. A factor that controls the size of the time step when repeating. The default of 0.5 corresponds to 50\% of the original step taken. -452 +454 [Double 0...MAX_DOUBLE (inclusive)] @@ -26091,7 +26152,7 @@ A factor that controls the size of the time step when repeating. The default of A factor that controls when a step is going to be repeated. If the newly computed step size is smaller than the last step size multiplied by this factor, the step is repeated. -451 +453 [Double 0...MAX_DOUBLE (inclusive)] @@ -26110,7 +26171,7 @@ A factor that controls when a step is going to be repeated. If the newly compute A factor that controls the size of the time step when repeating. The default of 0.5 corresponds to 50\% of the original step taken. -453 +455 [Double 0...MAX_DOUBLE (inclusive)] diff --git a/doc/sphinx/conf.py b/doc/sphinx/conf.py index 981031c514c..6059898d245 100644 --- a/doc/sphinx/conf.py +++ b/doc/sphinx/conf.py @@ -89,6 +89,18 @@ "primary_sidebar_end": "navbar_end.html" } +latex_engine = 'xelatex' +latex_elements = { +# Additional stuff for the LaTeX preamble. +'preamble': r''' +% to allow for the degree symbol +\usepackage{gensymb} +\usepackage{siunitx} +\usepackage{etoolbox} +\pretocmd{\hyperlink}{\protect}{}{} +''' +} + bibtex_bibfiles = ["references.bib"] bibtex_default_style = "alpha" bibtex_reference_style = "author_year" diff --git a/doc/sphinx/environment.yml b/doc/sphinx/environment.yml index 29aff467574..99d3c2744cf 100644 --- a/doc/sphinx/environment.yml +++ b/doc/sphinx/environment.yml @@ -6,6 +6,7 @@ dependencies: - myst-parser - sphinx-book-theme - sphinxcontrib-bibtex + - cairosvg - pip>=20.1 - pip: - sphinxcontrib-tikz diff --git a/doc/sphinx/parameters/Geometry_20model.md b/doc/sphinx/parameters/Geometry_20model.md index 5575a5268cf..67beb5044c4 100644 --- a/doc/sphinx/parameters/Geometry_20model.md +++ b/doc/sphinx/parameters/Geometry_20model.md @@ -33,7 +33,7 @@ The dimensions of the model are specified by parameters of the following form: C When used in 2d, this geometry does not imply the use of a spherical coordinate system. Indeed, in 2d the geometry is simply a sector of an annulus in a Cartesian coordinate system and consequently would correspond to a sector of a cross section of the fluid filled space between two infinite cylinders where one has made the assumption that the velocity in direction of the cylinder axes is zero. This is consistent with the definition of what we consider the two-dimension case given in {ref}`sec:methods:2d-models`. It is also possible to add initial topography to the chunk geometry, based on an ascii data file. -‘ellipsoidal chunk’: A 3d chunk geometry that accounts for Earth’s ellipticity (default assuming the WGS84 ellipsoid definition) which can be defined in non-coordinate directions. In the description of the ellipsoidal chunk, two of the ellipsoidal axes have the same length so that there is only a semi-major axis and a semi-minor axis. The user has two options for creating an ellipsoidal chunk geometry: 1) by defining two opposing points (SW and NE or NW and SE) a coordinate parallel ellipsoidal chunk geometry will be created. 2) by defining three points a non-coordinate parallel ellipsoidal chunk will be created. The points are defined in the input file by longitude:latitude. It is also possible to define additional subdivisions of the mesh in each direction. The boundary of the domain is formed by linear interpolation in longitude-latitude space between adjacent points (i.e. $\[lon, lat\](f) = [lon1 \cdot f + lon2 \cdot(1-f), lat1 \cdot f + lat2 \cdot (1-f)]$, where f is a value between 0 and 1). Faces of the model are defined as 0, west; 1,east; 2, south; 3, north; 4, inner; 5, outer. +‘ellipsoidal chunk’: A 3d chunk geometry that accounts for Earth’s ellipticity (default assuming the WGS84 ellipsoid definition) which can be defined in non-coordinate directions. In the description of the ellipsoidal chunk, two of the ellipsoidal axes have the same length so that there is only a semi-major axis and a semi-minor axis. The user has two options for creating an ellipsoidal chunk geometry: 1) by defining two opposing points (SW and NE or NW and SE) a coordinate parallel ellipsoidal chunk geometry will be created. 2) by defining three points a non-coordinate parallel ellipsoidal chunk will be created. The points are defined in the input file by longitude:latitude. It is also possible to define additional subdivisions of the mesh in each direction. The boundary of the domain is formed by linear interpolation in longitude-latitude space between adjacent points (i.e. ${lon, lat}(f) = [lon1 \cdot f + lon2 \cdot(1-f), lat1 \cdot f + lat2 \cdot (1-f)]$, where f is a value between 0 and 1). Faces of the model are defined as 0, west; 1,east; 2, south; 3, north; 4, inner; 5, outer. This geometry model supports initial topography for deforming the initial mesh. diff --git a/doc/sphinx/parameters/Material_20model.md b/doc/sphinx/parameters/Material_20model.md index b8788cd49a8..dde22d0e446 100644 --- a/doc/sphinx/parameters/Material_20model.md +++ b/doc/sphinx/parameters/Material_20model.md @@ -2682,7 +2682,7 @@ Also note that the melting time scale has to be larger than or equal to the reac **Pattern:** [Double 0...MAX_DOUBLE (inclusive)] -**Documentation:** The value of the constant melt viscosity $\viscosity_fluid$. Units: \si{\pascal\second}. +**Documentation:** The value of the constant melt viscosity $\eta_f$. Units: \si{\pascal\second}. (parameters:Material_20model/Melt_20simple/Reference_20permeability)= ### __Parameter name:__ Reference permeability @@ -3542,7 +3542,7 @@ Also note that the melting time scale has to be larger than or equal to the reac **Pattern:** [Double 0...MAX_DOUBLE (inclusive)] -**Documentation:** The value of the constant melt viscosity $\viscosity_fluid$. Units: \si{\pascal\second}. +**Documentation:** The value of the constant melt viscosity $\eta_f$. Units: \si{\pascal\second}. (parameters:Material_20model/Reactive_20Fluid_20Transport_20Model/Katz_202003_20model/Reference_20permeability)= ### __Parameter name:__ Reference permeability @@ -4150,6 +4150,14 @@ Note that melt does not freeze unless the ’Freezing rate’ parameter **Documentation:** 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} +(parameters:Material_20model/Visco_20Plastic/Data_20directory)= +### __Parameter name:__ Data directory +**Default value:** $ASPECT_SOURCE_DIR/data/material-model/entropy-table/pyrtable + +**Pattern:** [DirectoryName] + +**Documentation:** 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. + (parameters:Material_20model/Visco_20Plastic/Define_20thermal_20conductivities)= ### __Parameter name:__ Define thermal conductivities **Default value:** false @@ -4308,6 +4316,14 @@ Note that melt does not freeze unless the ’Freezing rate’ parameter **Documentation:** List of lower temperature for onset of strain weakening for background material and compositional fields, for a total of N+1 values, where N is the number of all compositional fields or only those corresponding to chemical compositions. If only one value is given, then all use the same value. Units: \si{\kelvin}. +(parameters:Material_20model/Visco_20Plastic/Material_20file_20names)= +### __Parameter name:__ Material file names +**Default value:** material_table_temperature_pressure_small.txt + +**Pattern:** [List of <[Anything]> of length 0...4294967295 (inclusive)] + +**Documentation:** 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 two 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. These data files need to have the same structure as the one necessary for equation of state plus a new column for the phase indexes, which amounts to 8 columns in total. + (parameters:Material_20model/Visco_20Plastic/Maximum_20Peierls_20strain_20rate_20iterations)= ### __Parameter name:__ Maximum Peierls strain rate iterations **Default value:** 40 @@ -4420,6 +4436,14 @@ Note that melt does not freeze unless the ’Freezing rate’ parameter **Documentation:** A list of depths where phase transitions occur. Values must monotonically increase. Units: \si{\meter}. +(parameters:Material_20model/Visco_20Plastic/Phase_20transition_20indicators)= +### __Parameter name:__ Phase transition indicators +**Default value:** + +**Pattern:** [Anything] + +**Documentation:** A list of phase indicators in a look-up table for each phase transition. This parameter selectively assign different rheologies to specific phases, rather than having a unique rheology for each phase in the table. For example, if the table has phases 0, 1, and 2, and one only want a distinct rheology for phase 2, then only phase 2 is needed in the list of indicator. And phases 0, 1 will just be assigned the rheology of the base phase. + (parameters:Material_20model/Visco_20Plastic/Phase_20transition_20pressure_20widths)= ### __Parameter name:__ Phase transition pressure widths **Default value:** @@ -4728,6 +4752,14 @@ If a compositional field named ’noninitial\_plastic\_strain’ is incl **Documentation:** Whether to use the adiabatic pressure instead of the full pressure when calculating plastic yield stress. This may be helpful in models where the full pressure has unusually large variations, resulting in solver convergence issues. Be aware that this setting will change the plastic shear band angle. +(parameters:Material_20model/Visco_20Plastic/Use_20dominant_20phase_20for_20viscosity)= +### __Parameter name:__ Use dominant phase for viscosity +**Default value:** false + +**Pattern:** [Bool] + +**Documentation:** Whether to look up the dominant phase for each composition in its respective material data file to calculate viscosity. This allows each phase to have distinct rheological parameterizations. + (parameters:Material_20model/Visco_20Plastic/Use_20fixed_20elastic_20time_20step)= ### __Parameter name:__ Use fixed elastic time step **Default value:** unspecified diff --git a/doc/sphinx/parameters/Particles.md b/doc/sphinx/parameters/Particles.md index 441dbc34388..a993ec99dee 100644 --- a/doc/sphinx/parameters/Particles.md +++ b/doc/sphinx/parameters/Particles.md @@ -147,7 +147,7 @@ The following properties are available: ‘quadrature points’: Generates particles at the quadrature points of each active cell of the triangulation. Here, Gauss quadrature of degree (velocity\_degree + 1), is used similarly to the assembly of Stokes matrix. -‘random uniform’: Generates a random uniform distribution of particles over the entire simulation domain. +‘random uniform’: Generates a random uniform distribution of particles over the entire simulation domain. This generator can be understood as the special case of the ’probability density function’ generator where the probability density is constant over the domain. ‘reference cell’: Generates a uniform distribution of particles per cell and spatial direction in the unit cell and transforms each of the particles back to real region in the model domain. Uniform here means the particles will be generated with an equal spacing in each spatial dimension. @@ -387,13 +387,11 @@ A typical example would be to set this runtime parameter to ‘pi=3.14159265 (parameters:Particles/Generator/Probability_20density_20function/Function_20expression)= ### __Parameter name:__ Function expression -**Default value:** 0 +**Default value:** 1.0 **Pattern:** [Anything] -**Documentation:** The formula that denotes the function you want to evaluate for particular values of the independent variables. This expression may contain any of the usual operations such as addition or multiplication, as well as all of the common functions such as ‘sin’ or ‘cos’. In addition, it may contain expressions like ‘if(x>0, 1, -1)’ where the expression evaluates to the second argument if the first argument is true, and to the third argument otherwise. For a full overview of possible expressions accepted see the documentation of the muparser library at http://muparser.beltoforion.de/. - -If the function you are describing represents a vector-valued function with multiple components, then separate the expressions for individual components by a semicolon. +**Documentation:** The formula that denotes the spatially variable probability density function. This expression may contain any of the usual operations such as addition or multiplication, as well as all of the common functions such as ‘sin’ or ‘cos’. In addition, it may contain expressions like ‘if(x>0, 1, 0)’ where the expression evaluates to the second argument if the first argument is true, and to the third argument otherwise; this example would result in no particles at all in that part of the domain where $x==0$, and a constant particle density in the rest of the domain. For a full overview of possible expressions accepted see the documentation of the muparser library at http://muparser.beltoforion.de/. Note that the function has to be non-negative everywhere in the domain, and needs to be positive in at least some parts of the domain. (parameters:Particles/Generator/Probability_20density_20function/Number_20of_20particles)= ### __Parameter name:__ Number of particles diff --git a/doc/sphinx/parameters/Particles_202.md b/doc/sphinx/parameters/Particles_202.md index d6e7c3227c6..0243508be02 100644 --- a/doc/sphinx/parameters/Particles_202.md +++ b/doc/sphinx/parameters/Particles_202.md @@ -139,7 +139,7 @@ The following properties are available: ‘quadrature points’: Generates particles at the quadrature points of each active cell of the triangulation. Here, Gauss quadrature of degree (velocity\_degree + 1), is used similarly to the assembly of Stokes matrix. -‘random uniform’: Generates a random uniform distribution of particles over the entire simulation domain. +‘random uniform’: Generates a random uniform distribution of particles over the entire simulation domain. This generator can be understood as the special case of the ’probability density function’ generator where the probability density is constant over the domain. ‘reference cell’: Generates a uniform distribution of particles per cell and spatial direction in the unit cell and transforms each of the particles back to real region in the model domain. Uniform here means the particles will be generated with an equal spacing in each spatial dimension. @@ -379,13 +379,11 @@ A typical example would be to set this runtime parameter to ‘pi=3.14159265 (parameters:Particles_202/Generator/Probability_20density_20function/Function_20expression)= ### __Parameter name:__ Function expression -**Default value:** 0 +**Default value:** 1.0 **Pattern:** [Anything] -**Documentation:** The formula that denotes the function you want to evaluate for particular values of the independent variables. This expression may contain any of the usual operations such as addition or multiplication, as well as all of the common functions such as ‘sin’ or ‘cos’. In addition, it may contain expressions like ‘if(x>0, 1, -1)’ where the expression evaluates to the second argument if the first argument is true, and to the third argument otherwise. For a full overview of possible expressions accepted see the documentation of the muparser library at http://muparser.beltoforion.de/. - -If the function you are describing represents a vector-valued function with multiple components, then separate the expressions for individual components by a semicolon. +**Documentation:** The formula that denotes the spatially variable probability density function. This expression may contain any of the usual operations such as addition or multiplication, as well as all of the common functions such as ‘sin’ or ‘cos’. In addition, it may contain expressions like ‘if(x>0, 1, 0)’ where the expression evaluates to the second argument if the first argument is true, and to the third argument otherwise; this example would result in no particles at all in that part of the domain where $x==0$, and a constant particle density in the rest of the domain. For a full overview of possible expressions accepted see the documentation of the muparser library at http://muparser.beltoforion.de/. Note that the function has to be non-negative everywhere in the domain, and needs to be positive in at least some parts of the domain. (parameters:Particles_202/Generator/Probability_20density_20function/Number_20of_20particles)= ### __Parameter name:__ Number of particles diff --git a/doc/sphinx/parameters/Postprocess.md b/doc/sphinx/parameters/Postprocess.md index 03e3e164712..e88a8d12f5d 100644 --- a/doc/sphinx/parameters/Postprocess.md +++ b/doc/sphinx/parameters/Postprocess.md @@ -892,7 +892,8 @@ Units: years if the ’Use years in output instead of seconds’ paramet **Pattern:** [Bool] -**Documentation:** deal.II offers the possibility to filter duplicate vertices for HDF5 output files. This merges the vertices of adjacent cells and therefore saves disk space, but misrepresents discontinuous output properties. Activating this function reduces the disk space by about a factor of $2^{dim}$ for HDF5 output, and currently has no effect on other output formats. :::{warning} +**Documentation:** deal.II offers the possibility to filter duplicate vertices for HDF5 output files. This merges the vertices of adjacent cells and therefore saves disk space, but misrepresents discontinuous output properties. Activating this function reduces the disk space by about a factor of $2^{dim}$ for HDF5 output, and currently has no effect on other output formats. + :::{warning} Setting this flag to true will result in visualization output that does not accurately represent discontinuous fields. This may be because you are using a discontinuous finite element for the pressure, temperature, or compositional variables, or because you use a visualization postprocessor that outputs quantities as discontinuous fields (e.g., the strain rate, viscosity, etc.). These will then all be visualized as *continuous* quantities even though, internally, ASPECT considers them as discontinuous fields. ::: @@ -1226,7 +1227,7 @@ Physical units: \si{\per\second}. **Pattern:** [Bool] -**Documentation:** deal.II offers the possibility to write vtu files with higher order representations of the output data. This means each cell will correctly show the higher order representation of the output data instead of the linear interpolation between vertices that ParaView and VisIt usually show. Note that activating this option is safe and recommended, but requires that (i) “Output format” is set to “vtu”, (ii) “Interpolate output” is set to true, (iii) you use a sufficiently new version of Paraview or VisIt to read the files (Paraview version 5.5 or newer, and VisIt version to be determined), and (iv) you use deal.II version 9.1.0 or newer. +**Documentation:** deal.II offers the possibility to write vtu files with higher order representations of the output data. This means each cell will correctly show the higher order representation of the output data instead of the linear interpolation between vertices that ParaView and VisIt usually show. Note that activating this option is safe and recommended, but requires that (i) “Output format” is set to “vtu”, (ii) “Interpolate output” is set to true, and (iii) you use a sufficiently new version of Paraview or VisIt to read the files (Paraview version 5.5 or newer, and VisIt version to be determined). The effect of using this option can be seen in the following picture: \begin{center} \includegraphics[width=0.5\textwidth]{viz/parameters/higher-order-output}\end{center}The top figure shows the plain output without interpolation or higher order output. The middle figure shows output that was interpolated as discussed for the “Interpolate output” option. The bottom panel shows higher order output that achieves better accuracy than the interpolated output at a lower memory cost. diff --git a/source/material_model/reaction_model/katz2003_mantle_melting.cc b/source/material_model/reaction_model/katz2003_mantle_melting.cc index 2b80c681c11..c7b5619e3e8 100644 --- a/source/material_model/reaction_model/katz2003_mantle_melting.cc +++ b/source/material_model/reaction_model/katz2003_mantle_melting.cc @@ -470,7 +470,7 @@ namespace aspect "dependencies. Units: \\si{\\pascal\\second}."); prm.declare_entry ("Reference melt viscosity", "10.", Patterns::Double (0.), - "The value of the constant melt viscosity $\\viscosity_fluid$. Units: \\si{\\pascal\\second}."); + "The value of the constant melt viscosity $\\eta_f$. Units: \\si{\\pascal\\second}."); prm.declare_entry ("Exponential melt weakening factor", "27.", Patterns::Double (0.), "The porosity dependence of the viscosity. Units: dimensionless.");