diff --git a/doc/parameter_view/parameters.xml b/doc/parameter_view/parameters.xml index 4a39845b20b..0879255577b 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. -363 +433 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -206,15 +206,13 @@ single Advection, single Stokes single Advection, single Stokes -The kind of scheme used to resolve the nonlinearity in the system. `single Advection, single Stokes' means that no nonlinear iterations are done, and the temperature, compositional fields and Stokes equations are solved exactly once per time step, one after the other. The `iterated Advection and Stokes' scheme iterates this decoupled approach by alternating the solution of the temperature, composition and Stokes systems. The `single Advection, iterated Stokes' scheme solves the temperature and composition equation once at the beginning of each time step and then iterates out the solution of the Stokes equation. The `no Advection, iterated Stokes' scheme only solves the Stokes system, iterating out the solution, and ignores compositions and the temperature equation (careful, the material model must not depend on the temperature or composition; this is mostly useful for Stokes benchmarks). The `no Advection, single Stokes' scheme only solves the Stokes system once per timestep. This is also mostly useful for Stokes benchmarks. The `single Advection, no Stokes' scheme only solves the temperature and other advection systems once, and instead of solving for the Stokes system, a prescribed velocity and pressure is used. The `iterated Advection and Newton Stokes' scheme iterates by alternating the solution of the temperature, composition and Stokes equations, using Picard iterations for the temperature and composition, and Newton iterations for the Stokes system. The `single Advection, iterated Newton Stokes' scheme solves the temperature and composition equations once at the beginning of each time step and then iterates out the solution of the Stokes equation, using Newton iterations for the Stokes system. The `iterated Advection and defect correction Stokes' scheme iterates by alternating the solution of the temperature, composition and Stokes equations, using Picard iterations for the temperature and composition, and defect correction Picard iterations for the Stokes system. The `single Advection, iterated defect correction Stokes' scheme solves the temperature and composition equations once at the beginning of each time step and then iterates out the solution of the Stokes equation, using defect correction Picard iterations for the Stokes system. The `no Advection, iterated defect correction Stokes' scheme solves the temperature and composition equations once at the beginning of each time step and then iterates out the solution of the Stokes equation, using defect correction Picard iterations for the Stokes system. The `first timestep only, single Stokes' scheme solves the Stokes equations exactly once, at the first time step. No nonlinear iterations are done, and the temperature and composition systems are not solved. - -The `IMPES' scheme is deprecated and only allowed for reasons of backwards compatibility. It is the same as `single Advection, single Stokes' .The `iterated IMPES' scheme is deprecated and only allowed for reasons of backwards compatibility. It is the same as `iterated Advection and Stokes'. The `iterated Stokes' scheme is deprecated and only allowed for reasons of backwards compatibility. It is the same as `single Advection, iterated Stokes'. The `Stokes only' scheme is deprecated and only allowed for reasons of backwards compatibility. It is the same as `no Advection, iterated Stokes'. The `Advection only' scheme is deprecated and only allowed for reasons of backwards compatibility. It is the same as `single Advection, no Stokes'. The `Newton Stokes' scheme is deprecated and only allowed for reasons of backwards compatibility. It is the same as `iterated Advection and Newton Stokes'. +The kind of scheme used to resolve the nonlinearity in the system. `single Advection, single Stokes' means that no nonlinear iterations are done, and the temperature, compositional fields and Stokes equations are solved exactly once per time step, one after the other. The `iterated Advection and Stokes' scheme iterates this decoupled approach by alternating the solution of the temperature, composition and Stokes systems. The `single Advection, iterated Stokes' scheme solves the temperature and composition equation once at the beginning of each time step and then iterates out the solution of the Stokes equation. The `no Advection, iterated Stokes' scheme only solves the Stokes system, iterating out the solution, and ignores compositions and the temperature equation (careful, the material model must not depend on the temperature or composition; this is mostly useful for Stokes benchmarks). The `no Advection, single Stokes' scheme only solves the Stokes system once per timestep. This is also mostly useful for Stokes benchmarks. The `single Advection, no Stokes' scheme only solves the temperature and other advection systems once, and instead of solving for the Stokes system, a prescribed velocity and pressure is used. The `iterated Advection and Newton Stokes' scheme iterates by alternating the solution of the temperature, composition and Stokes equations, using Picard iterations for the temperature and composition, and Newton iterations for the Stokes system. The `single Advection, iterated Newton Stokes' scheme solves the temperature and composition equations once at the beginning of each time step and then iterates out the solution of the Stokes equation, using Newton iterations for the Stokes system. The `iterated Advection and defect correction Stokes' scheme iterates by alternating the solution of the temperature, composition and Stokes equations, using Picard iterations for the temperature and composition, and defect correction Picard iterations for the Stokes system. The `single Advection, iterated defect correction Stokes' scheme solves the temperature and composition equations once at the beginning of each time step and then iterates out the solution of the Stokes equation, using defect correction Picard iterations for the Stokes system. The `no Advection, iterated defect correction Stokes' scheme solves the temperature and composition equations once at the beginning of each time step and then iterates out the solution of the Stokes equation, using defect correction Picard iterations for the Stokes system. The `first timestep only, single Stokes' scheme solves the Stokes equations exactly once, at the first time step. No nonlinear iterations are done, and the temperature and composition systems are not solved. 13 -[Selection single Advection, single Stokes|iterated Advection and Stokes|single Advection, iterated Stokes|no Advection, iterated Stokes|no Advection, single Stokes|no Advection, iterated defect correction Stokes|single Advection, iterated defect correction Stokes|iterated Advection and defect correction Stokes|iterated Advection and Newton Stokes|single Advection, iterated Newton Stokes|single Advection, no Stokes|IMPES|iterated IMPES|iterated Stokes|Newton Stokes|Stokes only|Advection only|first timestep only, single Stokes|no Advection, no Stokes ] +[Selection single Advection, single Stokes|iterated Advection and Stokes|single Advection, iterated Stokes|no Advection, iterated Stokes|no Advection, single Stokes|no Advection, iterated defect correction Stokes|single Advection, iterated defect correction Stokes|iterated Advection and defect correction Stokes|iterated Advection and Newton Stokes|single Advection, iterated Newton Stokes|single Advection, no Stokes|first timestep only, single Stokes|no Advection, no Stokes ] @@ -428,7 +426,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. -1349 +1419 [Selection ascii data|compute entropy profile|compute profile|function ] @@ -446,7 +444,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. -1350 +1420 [DirectoryName] @@ -459,7 +457,7 @@ The name of a directory that contains the model data. This path may either be ab The file name of the model data. -1351 +1421 [Anything] @@ -476,7 +474,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. -1352 +1422 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -495,7 +493,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. -1353 +1423 [Integer range 5...2147483647 (inclusive)] @@ -512,7 +510,7 @@ The number of points we use to compute the adiabatic profile. The higher the num The surface entropy for the profile. -1354 +1424 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -531,7 +529,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. -1358 +1428 [Selection initial composition|function ] @@ -546,7 +544,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.) -1357 +1427 [Anything] @@ -565,7 +563,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. -1356 +1426 [Anything] @@ -582,7 +580,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. -1359 +1429 [Integer range 5...2147483647 (inclusive)] @@ -599,7 +597,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. -1360 +1430 [Bool] @@ -616,7 +614,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. -1355 +1425 [Anything] @@ -632,7 +630,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.) -1363 +1433 [Anything] @@ -651,7 +649,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. -1362 +1432 [Anything] @@ -668,7 +666,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. -1361 +1431 [Anything] @@ -686,7 +684,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.) -1366 +1436 [Anything] @@ -703,7 +701,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'. -1367 +1437 [Anything] @@ -718,7 +716,7 @@ depth -1368 +1438 [Anything] @@ -742,7 +740,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. -1322 +1392 [Selection true|false|false for models without melt ] @@ -759,7 +757,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. -1321 +1391 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -792,7 +790,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'. -1318 +1388 [MultipleSelection ascii data|box|box with lithosphere boundary indicators|function|initial composition|spherical constant ] @@ -809,7 +807,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. -1319 +1389 [MultipleSelection add|subtract|minimum|maximum|replace if valid ] @@ -846,7 +844,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. -1320 +1390 [Selection ascii data|box|box with lithosphere boundary indicators|function|initial composition|spherical constant|unspecified ] @@ -864,7 +862,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. -1323 +1393 [DirectoryName] @@ -881,7 +879,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. -1326 +1396 [Anything] @@ -898,7 +896,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. -1327 +1397 [Double 0...MAX_DOUBLE (inclusive)] @@ -915,7 +913,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. -1330 +1400 [Bool] @@ -932,7 +930,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. -1328 +1398 [Double 0...MAX_DOUBLE (inclusive)] @@ -949,7 +947,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'. -1329 +1399 [Integer range -2147483648...2147483647 (inclusive)] @@ -966,7 +964,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. -1325 +1395 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -981,7 +979,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. -1333 +1403 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -994,7 +992,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. -1331 +1401 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -1007,7 +1005,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. -1332 +1402 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -1020,7 +1018,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. -1334 +1404 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -1035,7 +1033,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. -1347 +1417 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -1048,7 +1046,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. -1343 +1413 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -1061,7 +1059,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. -1345 +1415 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -1074,7 +1072,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. -1344 +1414 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -1087,7 +1085,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. -1346 +1416 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -1100,7 +1098,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. -1348 +1418 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -1119,7 +1117,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. -1335 +1405 [Selection cartesian|spherical|depth ] @@ -1134,7 +1132,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.) -1338 +1408 [Anything] @@ -1153,7 +1151,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. -1337 +1407 [Anything] @@ -1170,7 +1168,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. -1336 +1406 [Anything] @@ -1189,7 +1187,7 @@ The names of the variables as they will be used in the function, separated by co Maximal composition. Units: none. -1340 +1410 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -1206,7 +1204,7 @@ Maximal composition. Units: none. Minimal composition. Units: none. -1339 +1409 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -1225,7 +1223,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. -1342 +1412 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -1242,7 +1240,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. -1341 +1411 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -1264,7 +1262,7 @@ Select one of the following plugins: `density': A plugin that prescribes the fluid pressure gradient at the boundary based on fluid/solid density from the material model. -108 +109 [Selection density ] @@ -1288,7 +1286,7 @@ The density formulation used to compute the fluid pressure gradient at the model 'average density' prescribes the gradient of the fluid pressure as the averaged fluid and solid density times gravity (which is a better approximation for the lithostatic pressure than just the solid density) and leads to approximately the same pressure in the melt as in the solid, so that fluid is only flowing in or out due to differences in dynamic pressure. -109 +110 [Selection solid density|fluid density|average density ] @@ -1308,7 +1306,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 heat flux, but not what heat flux should hold on these boundaries. The latter piece of information needs to be implemented in a plugin in the BoundaryHeatFlux group, unless an existing implementation in this group already provides what you want. -55 +56 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -1331,7 +1329,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. -1412 +1482 [Selection function ] @@ -1349,7 +1347,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. -1413 +1483 [Selection cartesian|spherical|depth ] @@ -1364,7 +1362,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.) -1416 +1486 [Anything] @@ -1383,7 +1381,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. -1415 +1485 [Anything] @@ -1400,7 +1398,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. -1414 +1484 [Anything] @@ -1422,7 +1420,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. -1258 +1328 [Bool] @@ -1441,7 +1439,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. -1257 +1327 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -1482,7 +1480,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'. -1254 +1324 [MultipleSelection ascii data|box|box with lithosphere boundary indicators|constant|dynamic core|function|initial temperature|spherical constant ] @@ -1499,7 +1497,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. -1255 +1325 [MultipleSelection add|subtract|minimum|maximum|replace if valid ] @@ -1542,7 +1540,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. -1256 +1326 [Selection ascii data|box|box with lithosphere boundary indicators|constant|dynamic core|function|initial temperature|spherical constant|unspecified ] @@ -1560,7 +1558,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. -1269 +1339 [DirectoryName] @@ -1577,7 +1575,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. -1272 +1342 [Anything] @@ -1594,7 +1592,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. -1273 +1343 [Double 0...MAX_DOUBLE (inclusive)] @@ -1611,7 +1609,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. -1276 +1346 [Bool] @@ -1628,7 +1626,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. -1274 +1344 [Double 0...MAX_DOUBLE (inclusive)] @@ -1645,7 +1643,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'. -1275 +1345 [Integer range -2147483648...2147483647 (inclusive)] @@ -1662,7 +1660,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. -1271 +1341 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -1681,7 +1679,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}. -1279 +1349 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -1698,7 +1696,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}. -1277 +1347 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -1715,7 +1713,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}. -1278 +1348 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -1732,7 +1730,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}. -1280 +1350 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -1751,7 +1749,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}. -1265 +1335 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -1768,7 +1766,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}. -1263 +1333 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -1785,7 +1783,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}. -1267 +1337 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -1802,7 +1800,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}. -1264 +1334 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -1819,7 +1817,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}. -1268 +1338 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -1836,7 +1834,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}. -1266 +1336 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -1851,7 +1849,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. -1281 +1351 [Map of <[Anything]>:<[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -1870,7 +1868,7 @@ A comma separated list of mappings between boundary indicators and the temperatu Core thermal expansivity. Units: \si{\per\kelvin}. -1295 +1365 [Double 0...MAX_DOUBLE (inclusive)] @@ -1887,7 +1885,7 @@ Core thermal expansivity. Units: \si{\per\kelvin}. Compositional expansion coefficient $Beta_c$. See \cite{NPB+04} for more details. -1298 +1368 [Double 0...MAX_DOUBLE (inclusive)] @@ -1904,7 +1902,7 @@ Compositional expansion coefficient $Beta_c$. See \cite{NPB+04} for more details Pressure at CMB. Units: \si{\pascal}. -1289 +1359 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -1921,7 +1919,7 @@ Pressure at CMB. Units: \si{\pascal}. Core heat conductivity $k_c$. Units: \si{\watt\per\meter\per\kelvin}. -1300 +1370 [Double 0...MAX_DOUBLE (inclusive)] @@ -1938,7 +1936,7 @@ Core heat conductivity $k_c$. Units: \si{\watt\per\meter\per\kelvin}. Density of the core. Units: \si{\kilogram\per\meter\cubed}. -1287 +1357 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -1955,7 +1953,7 @@ Density of the core. Units: \si{\kilogram\per\meter\cubed}. Heat capacity of the core. Units: \si{\joule\per\kelvin\per\kilogram}. -1292 +1362 [Double 0...MAX_DOUBLE (inclusive)] @@ -1972,7 +1970,7 @@ Heat capacity of the core. Units: \si{\joule\per\kelvin\per\kilogram}. Partition coefficient of the light element. -1299 +1369 [Double 0...1 (inclusive)] @@ -1989,7 +1987,7 @@ Partition coefficient of the light element. Gravitation acceleration at CMB. Units: \si{\meter\per\second\squared}. -1288 +1358 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -2006,7 +2004,7 @@ Gravitation acceleration at CMB. Units: \si{\meter\per\second\squared}. Initial light composition (eg. S,O) concentration in weight fraction. -1290 +1360 [Double 0...MAX_DOUBLE (inclusive)] @@ -2023,7 +2021,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}. -1283 +1353 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -2040,7 +2038,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. -1293 +1363 [Double 0...MAX_DOUBLE (inclusive)] @@ -2057,7 +2055,7 @@ Core compressibility at zero pressure. See \cite{NPB+04} for more details. The latent heat of core freeze. Units: \si{\joule\per\kilogram}. -1296 +1366 [Double 0...MAX_DOUBLE (inclusive)] @@ -2074,7 +2072,7 @@ The latent heat of core freeze. Units: \si{\joule\per\kilogram}. The max iterations for nonlinear core energy solver. -1291 +1361 [Integer range 0...2147483647 (inclusive)] @@ -2091,7 +2089,7 @@ The max iterations for nonlinear core energy solver. Temperature at the outer boundary (lithosphere water/air). Units: \si{\kelvin}. -1282 +1352 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -2108,7 +2106,7 @@ Temperature at the outer boundary (lithosphere water/air). Units: \si{\kelvin}. The heat of reaction. Units: \si{\joule\per\kilogram}. -1297 +1367 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -2125,7 +2123,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. -1294 +1364 [Double 0...MAX_DOUBLE (inclusive)] @@ -2142,7 +2140,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. -1285 +1355 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -2159,7 +2157,7 @@ Initial inner core radius changing rate. Units: \si{\kilo\meter}/year. Initial CMB temperature changing rate. Units: \si{\kelvin}/year. -1284 +1354 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -2176,7 +2174,7 @@ Initial CMB temperature changing rate. Units: \si{\kelvin}/year. Initial light composition changing rate. Units: 1/year. -1286 +1356 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -2194,7 +2192,7 @@ true If melting curve dependent on composition. -1305 +1375 [Bool] @@ -2211,7 +2209,7 @@ If melting curve dependent on composition. Melting curve (\cite{NPB+04} eq. (40)) parameter Theta. -1304 +1374 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -2228,7 +2226,7 @@ Melting curve (\cite{NPB+04} eq. (40)) parameter Theta. Melting curve (\cite{NPB+04} eq. (40)) parameter Tm0. Units: \si{\kelvin}. -1301 +1371 [Double 0...MAX_DOUBLE (inclusive)] @@ -2245,7 +2243,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}. -1302 +1372 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -2262,7 +2260,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}. -1303 +1373 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -2279,7 +2277,7 @@ false If using the Fe-FeS system solidus from Buono \& Walker (2011) instead. -1306 +1376 [Bool] @@ -2294,7 +2292,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)] -1311 +1381 [Anything] @@ -2309,7 +2307,7 @@ Data file name for other energy source into the core. The 'other energy sou Half decay times of different elements (Ga) -1309 +1379 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -2322,7 +2320,7 @@ Half decay times of different elements (Ga) Heating rates of different elements (W/kg) -1308 +1378 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -2335,7 +2333,7 @@ Heating rates of different elements (W/kg) Initial concentrations of different elements (ppm) -1310 +1380 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -2352,7 +2350,7 @@ Initial concentrations of different elements (ppm) Number of different radioactive heating elements in core -1307 +1377 [Integer range 0...2147483647 (inclusive)] @@ -2372,7 +2370,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. -1312 +1382 [Selection cartesian|spherical|depth ] @@ -2387,7 +2385,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 +1385 [Anything] @@ -2406,7 +2404,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 +1384 [Anything] @@ -2423,7 +2421,7 @@ If the function you are describing represents a vector-valued function with mult Maximal temperature. Units: \si{\kelvin}. -1317 +1387 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -2440,7 +2438,7 @@ Maximal temperature. Units: \si{\kelvin}. Minimal temperature. Units: \si{\kelvin}. -1316 +1386 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -2457,7 +2455,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 +1383 [Anything] @@ -2476,7 +2474,7 @@ The names of the variables as they will be used in the function, separated by co Maximal temperature. Units: \si{\kelvin}. -1260 +1330 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -2493,7 +2491,7 @@ Maximal temperature. Units: \si{\kelvin}. Minimal temperature. Units: \si{\kelvin}. -1259 +1329 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -2512,7 +2510,7 @@ Minimal temperature. Units: \si{\kelvin}. Temperature at the inner boundary (core mantle boundary). Units: \si{\kelvin}. -1262 +1332 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -2529,7 +2527,7 @@ Temperature at the inner boundary (core mantle boundary). Units: \si{\kelvin}. Temperature at the outer boundary (lithosphere water/air). Units: \si{\kelvin}. -1261 +1331 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -2563,7 +2561,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. -1396 +1466 [Map of <[Anything]>:<[Selection ascii data|function|initial lithostatic pressure|zero traction ]> of length 0...4294967295 (inclusive)] @@ -2581,7 +2579,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. -1397 +1467 [DirectoryName] @@ -2598,7 +2596,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. -1400 +1470 [Anything] @@ -2615,7 +2613,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. -1401 +1471 [Double 0...MAX_DOUBLE (inclusive)] @@ -2632,7 +2630,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. -1404 +1474 [Bool] @@ -2649,7 +2647,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. -1402 +1472 [Double 0...MAX_DOUBLE (inclusive)] @@ -2666,7 +2664,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'. -1403 +1473 [Integer range -2147483648...2147483647 (inclusive)] @@ -2683,7 +2681,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. -1399 +1469 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -2702,7 +2700,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. -1405 +1475 [Selection cartesian|spherical|depth ] @@ -2717,7 +2715,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 +1479 [Anything] @@ -2736,7 +2734,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 +1478 [Anything] @@ -2753,7 +2751,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. -1406 +1476 [Bool] @@ -2770,7 +2768,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 +1477 [Anything] @@ -2789,7 +2787,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. -1411 +1481 [Integer range 0...2147483647 (inclusive)] @@ -2802,7 +2800,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. -1410 +1480 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -2836,7 +2834,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. -1369 +1439 [Map of <[Anything]>:<[Selection ascii data|function|gplates|zero velocity ]> of length 0...4294967295 (inclusive)] @@ -2851,7 +2849,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. -1371 +1441 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -2866,7 +2864,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. -1370 +1440 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -2884,7 +2882,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. -1372 +1442 [DirectoryName] @@ -2901,7 +2899,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. -1375 +1445 [Anything] @@ -2918,7 +2916,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. -1376 +1446 [Double 0...MAX_DOUBLE (inclusive)] @@ -2935,7 +2933,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. -1379 +1449 [Bool] @@ -2952,7 +2950,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. -1377 +1447 [Double 0...MAX_DOUBLE (inclusive)] @@ -2969,7 +2967,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'. -1378 +1448 [Integer range -2147483648...2147483647 (inclusive)] @@ -2986,7 +2984,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. -1374 +1444 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -3003,7 +3001,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. -1380 +1450 [Bool] @@ -3022,7 +3020,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. -1381 +1451 [Selection cartesian|spherical|depth ] @@ -3037,7 +3035,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.) -1385 +1455 [Anything] @@ -3056,7 +3054,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. -1384 +1454 [Anything] @@ -3073,7 +3071,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. -1382 +1452 [Bool] @@ -3090,7 +3088,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. -1383 +1453 [Anything] @@ -3109,7 +3107,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. -1386 +1456 [DirectoryName] @@ -3126,7 +3124,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. -1391 +1461 [Double 0...MAX_DOUBLE (inclusive)] @@ -3143,7 +3141,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. -1390 +1460 [Bool] @@ -3160,7 +3158,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. -1388 +1458 [Double 0...MAX_DOUBLE (inclusive)] @@ -3177,7 +3175,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'. -1389 +1459 [Integer range -2147483648...2147483647 (inclusive)] @@ -3194,7 +3192,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. -1395 +1465 [Double 0...MAX_DOUBLE (inclusive)] @@ -3211,7 +3209,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. -1393 +1463 [Anything] @@ -3228,7 +3226,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. -1394 +1464 [Anything] @@ -3245,7 +3243,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. -1392 +1462 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -3262,7 +3260,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. -1387 +1457 [Anything] @@ -3282,7 +3280,7 @@ The file name of the material data. Provide file in format: (Velocity file name) The number of timesteps between performing checkpoints. If 0 and time between checkpoint is not specified, checkpointing will not be performed. Units: None. -70 +71 [Integer range 0...2147483647 (inclusive)] @@ -3299,7 +3297,7 @@ The number of timesteps between performing checkpoints. If 0 and time between ch The wall time between performing checkpoints. If 0, will use the checkpoint step frequency instead. Units: Seconds. -69 +70 [Integer range 0...2147483647 (inclusive)] @@ -3323,7 +3321,7 @@ These choices correspond to the following methods by which compositional fields \item ``prescribed field with diffusion'': If a compositional field is marked this way, the value of a specific additional material model output, called the `PrescribedFieldOutputs' is interpolated onto the field, as in the ``prescribed field'' method. Afterwards, the field is diffused based on a solver parameter, the diffusion length scale, smoothing the field. Specifically, the field is updated by solving the equation $(I-l^2 \Delta) C_\text{smoothed} = C_\text{prescribed}$, where $l$ is the diffusion length scale. Note that this means that the amount of diffusion is independent of the time step size, and that the field is not advected with the flow.\end{itemize} -96 +97 [List of <[Selection field|particles|volume of fluid|static|melt field|darcy field|prescribed field|prescribed field with diffusion ]> of length 0...4294967295 (inclusive)] @@ -3336,7 +3334,7 @@ These choices correspond to the following methods by which compositional fields A list of integers smaller than or equal to the number of compositional fields. All compositional fields in this list will be normalized before the first timestep. The normalization is implemented in the following way: First, the sum of the fields to be normalized is calculated at every point and the global maximum is determined. Second, the compositional fields to be normalized are divided by this maximum. -98 +99 [List of <[Integer range 0...2147483647 (inclusive)]> of length 0...4294967295 (inclusive)] @@ -3351,7 +3349,7 @@ A comma separated list denoting the particle properties that will be projected t The format of valid entries for this parameter is that of a map given as ``key1: value1, key2: value2 [component2], key3: value3 [component4], ...'' where each key must be a valid field name of the ``particles'' type, and each value must be one of the currently selected particle properties. Component is a component index of the particle property that is 0 by default, but can be set up to n-1, where n is the number of vector components of this particle property. The component indicator only needs to be set if not the first component of the particle property should be mapped (e.g. the $y$-component of the velocity at the particle positions). -97 +98 [Map of <[Anything]>:<[Anything]> of length 0...4294967295 (inclusive)] @@ -3364,7 +3362,7 @@ The format of valid entries for this parameter is that of a map given as ``key1: A user-defined name for each of the compositional fields requested. -94 +95 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -3381,7 +3379,7 @@ A user-defined name for each of the compositional fields requested. The number of fields that will be advected along with the flow field, excluding velocity, pressure and temperature. -93 +94 [Integer range 0...2147483647 (inclusive)] @@ -3398,7 +3396,7 @@ unspecified A type for each of the compositional fields requested. Each entry of the list must be one of several recognized types: chemical composition, stress, strain, grain size, porosity, density, entropy, general and unspecified. The generic type is intended to be a placeholder type that has no effect on the running of any material model, while the unspecified type is intended to tell ASPECT that the user has not explicitly indicated the type of field (facilitating parameter file checking). Plugins such as material models can use these types to affect how that plugin functions. -95 +96 [List of <[Selection chemical composition|stress|strain|grain size|porosity|density|entropy|generic|unspecified ]> of length 0...4294967295 (inclusive)] @@ -3419,7 +3417,7 @@ The polynomial degree to use for the composition variable(s). As an example, a v For continuous elements, the value needs to be 1 or larger as $Q_1$ is the lowest order element, while $DGQ_0$ is a valid choice. Units: None. -73 +74 [List of <[Integer range 0...2147483647 (inclusive)]> of length 0...4294967295 (inclusive)] @@ -3438,7 +3436,7 @@ The polynomial degree to use for the velocity variables in the Stokes system. Th Be careful if you choose 1 as the degree. The resulting element is not stable and it may lead to artifacts in the solution. Units: None. -71 +72 [Integer range 1...2147483647 (inclusive)] @@ -3455,7 +3453,7 @@ Be careful if you choose 1 as the degree. The resulting element is not stable an The polynomial degree to use for the temperature variable. As an example, a value of 2 for this parameter will yield either the element $Q_2$ or $DGQ_2$ for the temperature field, depending on whether we use a continuous or discontinuous field. Units: None. -72 +73 [Integer range 1...2147483647 (inclusive)] @@ -3472,7 +3470,7 @@ false Whether to use a composition discretization that is discontinuous as opposed to continuous. This then requires the assembly of face terms between cells, and weak imposition of boundary terms for the composition field via the discontinuous Galerkin method. -77 +78 [List of <[Bool]> of length 0...4294967295 (inclusive)] @@ -3489,7 +3487,7 @@ false Whether to use a temperature discretization that is discontinuous as opposed to continuous. This then requires the assembly of face terms between cells, and weak imposition of boundary terms for the temperature field via the interior-penalty discontinuous Galerkin method. -76 +77 [Bool] @@ -3514,7 +3512,7 @@ While \aspect{} \textit{allows} you to use this method, it is generally understo ::: -75 +76 [Bool] @@ -3539,7 +3537,7 @@ On the other hand, if this parameter is set to ``false''(the default), For an in-depth discussion of these issues and a quantitative evaluation of the different choices, see \cite{kronbichler:etal:2012}. -74 +75 [Bool] @@ -3557,7 +3555,7 @@ For an in-depth discussion of these issues and a quantitative evaluation of the The value used to penalize discontinuities in the discontinuous Galerkin method. This is used only for the temperature field, and not for the composition field, as pure advection does not use the interior penalty method. This is largely empirically decided -- it must be large enough to ensure the bilinear form is coercive, but not so large as to penalize discontinuity at all costs. -85 +86 [Double 0...MAX_DOUBLE (inclusive)] @@ -3574,7 +3572,7 @@ The value used to penalize discontinuities in the discontinuous Galerkin method. The maximum global composition values that will be used in the bound preserving limiter for the discontinuous solutions from composition advection fields. The number of the input 'Global composition maximum' values separated by ',' has to be one or the same as the number of the compositional fields. When only one value is supplied, this same value is assumed for all compositional fields. -90 +91 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -3591,7 +3589,7 @@ The maximum global composition values that will be used in the bound preserving The minimum global composition value that will be used in the bound preserving limiter for the discontinuous solutions from composition advection fields. The number of the input 'Global composition minimum' values separated by ',' has to be one or the same as the number of the compositional fields. When only one value is supplied, this same value is assumed for all compositional fields. -91 +92 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -3608,7 +3606,7 @@ The minimum global composition value that will be used in the bound preserving l The maximum global temperature value that will be used in the bound preserving limiter for the discontinuous solutions from temperature advection fields. -88 +89 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -3625,7 +3623,7 @@ The maximum global temperature value that will be used in the bound preserving l The minimum global temperature value that will be used in the bound preserving limiter for the discontinuous solutions from temperature advection fields. -89 +90 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -3638,7 +3636,7 @@ The minimum global temperature value that will be used in the bound preserving l Select for which compositional fields to skip the entropy viscosity stabilization at dirichlet boundaries. This is only advisable for compositional fieldsthat have intrinsic physical diffusion terms, otherwise oscillations may develop. The parameter should contain a list of compositional field names. -79 +80 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -3655,7 +3653,7 @@ entropy viscosity Select the method for stabilizing the advection equation. The original method implemented is 'entropy viscosity' as described in \cite {kronbichler:etal:2012}. SUPG is currently experimental. -78 +79 [Selection entropy viscosity|SUPG ] @@ -3672,7 +3670,7 @@ false If set to false, the artificial viscosity of a cell is computed and is computed on every cell separately as discussed in \cite{kronbichler:etal:2012}. If set to true, the maximum of the artificial viscosity in the cell as well as the neighbors of the cell is computed and used instead. -80 +81 [Bool] @@ -3689,7 +3687,7 @@ false Whether to apply the bound preserving limiter as a correction after having the discontinuous composition solution. The limiter will only have an effect if the 'Global composition maximum' and 'Global composition minimum' parameters are defined in the .prm file. This limiter keeps the discontinuous solution in the range given by Global composition maximum' and 'Global composition minimum'. The number of input values in this parameter separated by ',' has to be one or the number of the compositional fields. When only one value is supplied, this same value is assumed for all compositional fields, otherwise each value represents if the limiter should be applied to the respective compositional field. Because this limiter modifies the solution it no longer satisfies the assembled equation. Therefore, the nonlinear residual for this field is meaningless, and in nonlinear solvers we will ignore the residual for this field to evaluate if the nonlinear solver has converged. -87 +88 [List of <[Bool]> of length 0...4294967295 (inclusive)] @@ -3706,7 +3704,7 @@ false Whether to apply the bound preserving limiter as a correction after computing the discontinuous temperature solution. The limiter will only have an effect if the 'Global temperature maximum' and 'Global temperature minimum' parameters are defined in the .prm file. This limiter keeps the discontinuous solution in the range given by 'Global temperature maximum' and 'Global temperature minimum'. Because this limiter modifies the solution it no longer satisfies the assembled equation. Therefore, the nonlinear residual for this field is meaningless, and in nonlinear solvers we will ignore the residual for this field to evaluate if the nonlinear solver has converged. -86 +87 [Bool] @@ -3723,7 +3721,7 @@ Whether to apply the bound preserving limiter as a correction after computing th The exponent $\alpha$ in the entropy viscosity stabilization. Valid options are 1 or 2. The recommended setting is 2. (This parameter does not correspond to any variable in the 2012 paper by Kronbichler, Heister and Bangerth that describes ASPECT, see \cite{kronbichler:etal:2012}. Rather, the paper always uses 2 as the exponent in the definition of the entropy, following equation (15) of the paper. The full approach is discussed in \cite{guermond:etal:2011}.) Note that this is not the thermal expansion coefficient, also commonly referred to as $\alpha$.Units: None. -81 +82 [Integer range 1...2 (inclusive)] @@ -3740,7 +3738,7 @@ The exponent $\alpha$ in the entropy viscosity stabilization. Valid options are The $\beta$ factor in the artificial viscosity stabilization. This parameter controls the maximum dissipation of the entropy viscosity, which is the part that only scales with the cell diameter and the maximum velocity in the cell, but does not depend on the solution field itself or its residual. An appropriate value for 2d is 0.052 and 0.78 for 3d. (For historical reasons, the name used here is different from the one used in the 2012 paper by Kronbichler, Heister and Bangerth that describes ASPECT, see \cite{kronbichler:etal:2012}. This parameter can be given as a single value or as a list with as many entries as one plus the number of compositional fields. In the former case all advection fields use the same stabilization parameters, in the latter case each field (temperature first, then all compositions) use individual parameters. This can be useful to reduce the stabilization for the temperature, which already has some physical diffusion. This parameter corresponds to the factor $\alpha_{\text{max}}$ in the formulas following equation (15) of the paper.) Units: None. -83 +84 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -3757,7 +3755,7 @@ The $\beta$ factor in the artificial viscosity stabilization. This parameter con The $c_R$ factor in the entropy viscosity stabilization. This parameter controls the part of the entropy viscosity that depends on the solution field itself and its residual in addition to the cell diameter and the maximum velocity in the cell. This parameter can be given as a single value or as a list with as many entries as one plus the number of compositional fields. In the former case all advection fields use the same stabilization parameters, in the latter case each field (temperature first, then all compositions) use individual parameters. This can be useful to reduce the stabilization for the temperature, which already has some physical diffusion. (For historical reasons, the name used here is different from the one used in the 2012 paper by Kronbichler, Heister and Bangerth that describes ASPECT, see \cite{kronbichler:etal:2012}. This parameter corresponds to the factor $\alpha_E$ in the formulas following equation (15) of the paper.) Units: None. -82 +83 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -3774,7 +3772,7 @@ The $c_R$ factor in the entropy viscosity stabilization. This parameter controls The strain rate scaling factor in the artificial viscosity stabilization. This parameter determines how much the strain rate (in addition to the velocity) should influence the stabilization. (This parameter does not correspond to any variable in the 2012 paper by Kronbichler, Heister and Bangerth that describes ASPECT, see \cite{kronbichler:etal:2012}. Rather, the paper always uses 0, i.e. they specify the maximum dissipation $\nu_h^\text{max}$ as $\nu_h^\text{max}\vert_K = \alpha_{\text{max}} h_K \|\mathbf u\|_{\infty,K}$. Here, we use $\|\lvert\mathbf u\rvert + \gamma h_K \lvert\varepsilon (\mathbf u)\rvert\|_{\infty,K}$ instead of $\|\mathbf u\|_{\infty,K}$. Units: None. -84 +85 [Double 0...MAX_DOUBLE (inclusive)] @@ -3794,7 +3792,7 @@ false Whether to ask the material model for additional terms for the right-hand side of the Stokes equation. This feature is likely only used when implementing force vectors for manufactured solution problems and requires filling additional outputs of type AdditionalMaterialOutputsStokesRHS. -50 +51 [Bool] @@ -3811,7 +3809,7 @@ false Whether to include the additional elastic terms on the right-hand side of the Stokes equation. -51 +52 [Bool] @@ -3828,7 +3826,7 @@ false Whether to include additional terms on the right-hand side of the Stokes equation to set a given compression term specified in the MaterialModel output PrescribedPlasticDilation. -52 +53 [Bool] @@ -3854,7 +3852,7 @@ The `anelastic liquid approximation' option here can also be used to set up ::: -47 +48 [Selection isentropic compression|custom|anelastic liquid approximation|Boussinesq approximation ] @@ -3871,7 +3869,7 @@ ask material model Possible approximations for the density derivatives in the mass conservation equation. Note that this parameter is only evaluated if `Formulation' is set to `custom'. Other formulations ignore the value of this parameter. -48 +49 [Selection incompressible|isentropic compression|hydrostatic compression|reference density profile|implicit reference density profile|projected density field|ask material model ] @@ -3888,7 +3886,7 @@ real density Possible approximations for the density in the temperature equation. Possible approximations are `real density' and `reference density profile'. Note that this parameter is only evaluated if `Formulation' is set to `custom'. Other formulations ignore the value of this parameter. -49 +50 [Selection real density|reference density profile ] @@ -3945,7 +3943,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. -997 +1067 [Selection box|box with lithosphere boundary indicators|chunk|chunk with lithosphere boundary indicators|ellipsoidal chunk|sphere|spherical shell|unspecified ] @@ -3963,7 +3961,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}. -1041 +1111 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -3980,7 +3978,7 @@ X coordinate of box origin. Units: \si{\meter}. Y coordinate of box origin. Units: \si{\meter}. -1042 +1112 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -3997,7 +3995,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}. -1043 +1113 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -4014,7 +4012,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}. -1038 +1108 [Double 0...MAX_DOUBLE (inclusive)] @@ -4031,7 +4029,7 @@ false Whether the box should be periodic in X direction -1047 +1117 [Bool] @@ -4048,7 +4046,7 @@ Whether the box should be periodic in X direction Number of cells in X direction. -1044 +1114 [Integer range 1...2147483647 (inclusive)] @@ -4065,7 +4063,7 @@ Number of cells in X direction. Extent of the box in y-direction. Units: \si{\meter}. -1039 +1109 [Double 0...MAX_DOUBLE (inclusive)] @@ -4082,7 +4080,7 @@ false Whether the box should be periodic in Y direction -1048 +1118 [Bool] @@ -4099,7 +4097,7 @@ Whether the box should be periodic in Y direction Number of cells in Y direction. -1045 +1115 [Integer range 1...2147483647 (inclusive)] @@ -4116,7 +4114,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}. -1040 +1110 [Double 0...MAX_DOUBLE (inclusive)] @@ -4133,7 +4131,7 @@ false Whether the box should be periodic in Z direction -1049 +1119 [Bool] @@ -4150,7 +4148,7 @@ Whether the box should be periodic in Z direction Number of cells in Z direction. -1046 +1116 [Integer range 1...2147483647 (inclusive)] @@ -4169,7 +4167,7 @@ Number of cells in Z direction. X coordinate of box origin. Units: \si{\meter}. -1012 +1082 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -4186,7 +4184,7 @@ X coordinate of box origin. Units: \si{\meter}. Y coordinate of box origin. Units: \si{\meter}. -1013 +1083 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -4203,7 +4201,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}. -1014 +1084 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -4220,7 +4218,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. -1008 +1078 [Double 0...MAX_DOUBLE (inclusive)] @@ -4237,7 +4235,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. -1025 +1095 [Bool] @@ -4254,7 +4252,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}. -1009 +1079 [Double 0...MAX_DOUBLE (inclusive)] @@ -4271,7 +4269,7 @@ false Whether the box should be periodic in X direction. -1020 +1090 [Bool] @@ -4288,7 +4286,7 @@ false Whether the box should be periodic in X direction in the lithosphere. -1023 +1093 [Bool] @@ -4305,7 +4303,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. -1015 +1085 [Integer range 1...2147483647 (inclusive)] @@ -4322,7 +4320,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}. -1010 +1080 [Double 0...MAX_DOUBLE (inclusive)] @@ -4339,7 +4337,7 @@ false Whether the box should be periodic in Y direction. -1021 +1091 [Bool] @@ -4356,7 +4354,7 @@ false Whether the box should be periodic in Y direction in the lithosphere. This value is ignored if the simulation is in 2d. -1024 +1094 [Bool] @@ -4373,7 +4371,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. -1016 +1086 [Integer range 1...2147483647 (inclusive)] @@ -4390,7 +4388,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. -1018 +1088 [Integer range 1...2147483647 (inclusive)] @@ -4407,7 +4405,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}. -1011 +1081 [Double 0...MAX_DOUBLE (inclusive)] @@ -4424,7 +4422,7 @@ false Whether the box should be periodic in Z direction. This value is ignored if the simulation is in 2d. -1022 +1092 [Bool] @@ -4441,7 +4439,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. -1017 +1087 [Integer range 1...2147483647 (inclusive)] @@ -4458,7 +4456,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. -1019 +1089 [Integer range 1...2147483647 (inclusive)] @@ -4477,7 +4475,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}. -1050 +1120 [Double 0...MAX_DOUBLE (inclusive)] @@ -4494,7 +4492,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. -1055 +1125 [Double -90...90 (inclusive)] @@ -4511,7 +4509,7 @@ Maximum latitude of the chunk. This value is ignored if the simulation is in 2d. Maximum longitude of the chunk. Units: degrees. -1053 +1123 [Double -180...360 (inclusive)] @@ -4528,7 +4526,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. -1054 +1124 [Double -90...90 (inclusive)] @@ -4545,7 +4543,7 @@ Minimum latitude of the chunk. This value is ignored if the simulation is in 2d. Minimum longitude of the chunk. Units: degrees. -1052 +1122 [Double -180...360 (inclusive)] @@ -4562,7 +4560,7 @@ Minimum longitude of the chunk. Units: degrees. Radius at the top surface of the chunk. Units: \si{\meter}. -1051 +1121 [Double 0...MAX_DOUBLE (inclusive)] @@ -4579,7 +4577,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 -1058 +1128 [Integer range 1...2147483647 (inclusive)] @@ -4596,7 +4594,7 @@ Number of cells in latitude. This value is ignored if the simulation is in 2d Number of cells in longitude. -1057 +1127 [Integer range 1...2147483647 (inclusive)] @@ -4613,7 +4611,7 @@ Number of cells in longitude. Number of cells in radius. -1056 +1126 [Integer range 1...2147483647 (inclusive)] @@ -4632,7 +4630,7 @@ Number of cells in radius. Radius at the bottom surface of the chunk. Units: \si{\meter}. -1026 +1096 [Double 0...MAX_DOUBLE (inclusive)] @@ -4649,7 +4647,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. -1032 +1102 [Double -90...90 (inclusive)] @@ -4666,7 +4664,7 @@ Maximum latitude of the chunk. This value is ignored if the simulation is in 2d. Maximum longitude of the chunk. Units: degrees. -1030 +1100 [Double -180...360 (inclusive)] @@ -4683,7 +4681,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}. -1028 +1098 [Double 0...MAX_DOUBLE (inclusive)] @@ -4700,7 +4698,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. -1031 +1101 [Double -90...90 (inclusive)] @@ -4717,7 +4715,7 @@ Minimum latitude of the chunk. This value is ignored if the simulation is in 2d. Minimum longitude of the chunk. Units: degrees. -1029 +1099 [Double -180...360 (inclusive)] @@ -4734,7 +4732,7 @@ Minimum longitude of the chunk. Units: degrees. Radius at the top surface of the chunk. Units: \si{\meter}. -1027 +1097 [Double 0...MAX_DOUBLE (inclusive)] @@ -4751,7 +4749,7 @@ Radius at the top surface of the chunk. Units: \si{\meter}. Number of cells in radial direction for the lower chunk. -1034 +1104 [Integer range 1...2147483647 (inclusive)] @@ -4768,7 +4766,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 -1036 +1106 [Integer range 1...2147483647 (inclusive)] @@ -4785,7 +4783,7 @@ Number of cells in latitude. This value is ignored if the simulation is in 2d Number of cells in longitude. -1035 +1105 [Integer range 1...2147483647 (inclusive)] @@ -4802,7 +4800,7 @@ Number of cells in longitude. Number of cells in radial direction for the upper chunk. -1033 +1103 [Integer range 1...2147483647 (inclusive)] @@ -4819,7 +4817,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. -1037 +1107 [Bool] @@ -4838,7 +4836,7 @@ Whether to make the grid by gluing together two boxes, or just use one chunk to Bottom depth of model region. -1063 +1133 [Double 0...MAX_DOUBLE (inclusive)] @@ -4855,7 +4853,7 @@ Bottom depth of model region. The number of subdivisions of the coarse (initial) mesh in depth. -1068 +1138 [Integer range 0...2147483647 (inclusive)] @@ -4872,7 +4870,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. -1066 +1136 [Integer range 0...2147483647 (inclusive)] @@ -4889,7 +4887,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. -1065 +1135 [Double 0...MAX_DOUBLE (inclusive)] @@ -4902,7 +4900,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. -1059 +1129 [Anything] @@ -4915,7 +4913,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. -1060 +1130 [Anything] @@ -4932,7 +4930,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. -1067 +1137 [Integer range 0...2147483647 (inclusive)] @@ -4945,7 +4943,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. -1062 +1132 [Anything] @@ -4958,7 +4956,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. -1061 +1131 [Anything] @@ -4975,7 +4973,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. -1064 +1134 [Double 0...MAX_DOUBLE (inclusive)] @@ -5002,7 +5000,7 @@ Select one of the following models: `zero topography': Implementation of a model in which the initial topography is zero. -1069 +1139 [Selection ascii data|function|prm polygon|zero topography ] @@ -5020,7 +5018,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. -1070 +1140 [DirectoryName] @@ -5037,7 +5035,7 @@ box_2d_%s.0.txt The file name of the model data. -1071 +1141 [Anything] @@ -5054,7 +5052,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. -1072 +1142 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -5073,7 +5071,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. -1074 +1144 [Selection cartesian|spherical ] @@ -5088,7 +5086,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.) -1077 +1147 [Anything] @@ -5107,7 +5105,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. -1076 +1146 [Anything] @@ -5124,7 +5122,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. -1073 +1143 [Double 0...MAX_DOUBLE (inclusive)] @@ -5141,7 +5139,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. -1075 +1145 [Anything] @@ -5156,7 +5154,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. -1078 +1148 [Anything] @@ -5176,7 +5174,7 @@ Set the topography height and the polygon which should be set to that height. Th Radius of the sphere. Units: \si{\meter}. -998 +1068 [Double 0...MAX_DOUBLE (inclusive)] @@ -5199,7 +5197,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. -1006 +1076 [Integer range 0...2147483647 (inclusive)] @@ -5216,7 +5214,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. -999 +1069 [Selection none|list of radial values|number of slices ] @@ -5233,7 +5231,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. -1002 +1072 [Integer range 0...2147483647 (inclusive)] @@ -5254,7 +5252,7 @@ The default value of 3,481,000 m equals the radius of a sphere with equal volume ::: -1003 +1073 [Double 0...MAX_DOUBLE (inclusive)] @@ -5267,7 +5265,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. -1000 +1070 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -5284,7 +5282,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. -1001 +1071 [Integer range 1...2147483647 (inclusive)] @@ -5301,7 +5299,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. -1005 +1075 [Double 0...360 (inclusive)] @@ -5322,7 +5320,7 @@ The default value of 6,336,000 m equals the radius of a sphere with equal volume ::: -1004 +1074 [Double 0...MAX_DOUBLE (inclusive)] @@ -5339,7 +5337,7 @@ false Whether the shell should be periodic in the phi direction. -1007 +1077 [Bool] @@ -5371,7 +5369,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. -1079 +1149 [Selection ascii data|function|radial constant|radial earth-like|radial linear|vertical|unspecified ] @@ -5389,7 +5387,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. -1088 +1158 [DirectoryName] @@ -5406,7 +5404,7 @@ prem.txt The file name of the model data. -1089 +1159 [Anything] @@ -5423,7 +5421,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. -1090 +1160 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -5442,7 +5440,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. -1080 +1150 [Selection cartesian|spherical|depth ] @@ -5457,7 +5455,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.) -1083 +1153 [Anything] @@ -5476,7 +5474,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. -1082 +1152 [Anything] @@ -5493,7 +5491,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. -1081 +1151 [Anything] @@ -5512,7 +5510,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. -1084 +1154 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -5531,7 +5529,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}. -1086 +1156 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -5548,7 +5546,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}. -1085 +1155 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -5567,7 +5565,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. -1087 +1157 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -5615,7 +5613,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. -974 +1044 [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 ] @@ -5633,7 +5631,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) $. -992 +1062 [Bool] @@ -5652,7 +5650,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) $. -993 +1063 [Bool] @@ -5671,7 +5669,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}. -994 +1064 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -5688,7 +5686,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). -995 +1065 [List of <[Integer range 0...1 (inclusive)]> of length 0...4294967295 (inclusive)] @@ -5707,7 +5705,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. -996 +1066 [Double 0...MAX_DOUBLE (inclusive)] @@ -5726,7 +5724,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. -975 +1045 [Selection cartesian|spherical|depth ] @@ -5741,7 +5739,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.) -978 +1048 [Anything] @@ -5760,7 +5758,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. -977 +1047 [Anything] @@ -5777,7 +5775,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. -976 +1046 [Anything] @@ -5796,7 +5794,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}. -979 +1049 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -5813,7 +5811,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)$. -980 +1050 [Bool] @@ -5832,7 +5830,7 @@ Instead of using the entropy change given in the 'Melting entropy change&ap Which composition field should be treated as crust -988 +1058 [Integer range 0...2147483647 (inclusive)] @@ -5849,7 +5847,7 @@ false Whether crust defined by composition or depth -986 +1056 [Bool] @@ -5866,7 +5864,7 @@ Whether crust defined by composition or depth Depth of the crust when crust if defined by depth. Units: \si{\meter}. -987 +1057 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -5879,7 +5877,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'. -983 +1053 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -5892,7 +5890,7 @@ Half decay times. Units: (Seconds), or (Years) if set `use years instead of seco Heating rates of different elements (W/kg) -982 +1052 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -5905,7 +5903,7 @@ Heating rates of different elements (W/kg) Initial concentrations of different elements (ppm) -984 +1054 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -5918,7 +5916,7 @@ Initial concentrations of different elements (ppm) Initial concentrations of different elements (ppm) -985 +1055 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -5935,7 +5933,7 @@ Initial concentrations of different elements (ppm) Number of radioactive elements -981 +1051 [Integer range 0...2147483647 (inclusive)] @@ -5954,7 +5952,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. -990 +1060 [Double 0...MAX_DOUBLE (inclusive)] @@ -5971,7 +5969,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. -991 +1061 [Double 0...MAX_DOUBLE (inclusive)] @@ -5988,7 +5986,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. -989 +1059 [Bool] @@ -6022,7 +6020,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'. -1206 +1276 [MultipleSelection adiabatic density|ascii data|ascii data layered|entropy table lookup|function|porosity|slab model|world builder ] @@ -6039,7 +6037,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. -1207 +1277 [MultipleSelection add|subtract|minimum|maximum|replace if valid ] @@ -6074,7 +6072,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. -1208 +1278 [Selection adiabatic density|ascii data|ascii data layered|entropy table lookup|function|porosity|slab model|world builder|unspecified ] @@ -6091,7 +6089,7 @@ The format of valid entries for this parameter is that of a map given as ``key1: When ``composition is specified, the initial model is treated as a standard composition field with bounds between 0 and 1 assumed, The initial fluid fractions are then based on an iterated midpoint quadrature. Resultant volume fractions outside of the bounds will be coerced to the nearest valid value (ie 0 or 1). If ``level set`` is specified, the initial data will be assumed to be in the form of a signed distance level set function (i.e. a function which is positive when in the fluid, negative outside, and zero on the interface and the magnitude is always the distance to the interface so the gradient is one everywhere). -103 +104 [Map of <[Anything]>:<[Selection composition|level set ]> of length 0...4294967295 (inclusive)] @@ -6109,7 +6107,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. -1218 +1288 [DirectoryName] @@ -6126,7 +6124,7 @@ initial_composition_top_mantle_box_3d.txt The file name of the model data. -1216 +1286 [Anything] @@ -6143,7 +6141,7 @@ initial_composition_top_mantle_box_3d.txt The file names of the model data (comma separated). -1219 +1289 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -6160,7 +6158,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. -1213 +1283 [Anything] @@ -6177,7 +6175,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. -1220 +1290 [Selection piecewise constant|linear ] @@ -6194,7 +6192,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. -1217 +1287 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -6211,7 +6209,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. -1214 +1284 [Anything] @@ -6228,7 +6226,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. -1212 +1282 [Bool] @@ -6247,7 +6245,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. -1221 +1291 [DirectoryName] @@ -6264,7 +6262,7 @@ material_table_temperature_pressure.txt The file name of the material data. -1222 +1292 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -6283,7 +6281,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. -1223 +1293 [Selection cartesian|spherical|depth ] @@ -6298,7 +6296,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.) -1226 +1296 [Anything] @@ -6317,7 +6315,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. -1225 +1295 [Anything] @@ -6334,7 +6332,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. -1224 +1294 [Anything] @@ -6353,7 +6351,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. -1227 +1297 [DirectoryName] @@ -6370,7 +6368,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). -1230 +1300 [Anything] @@ -6387,7 +6385,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. -1229 +1299 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -6402,7 +6400,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. -1231 +1301 [Anything] @@ -6469,7 +6467,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'. -1091 +1161 [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 ] @@ -6486,7 +6484,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. -1092 +1162 [MultipleSelection add|subtract|minimum|maximum|replace if valid ] @@ -6554,7 +6552,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. -1093 +1163 [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 ] @@ -6572,7 +6570,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. -1162 +1232 [Double 0...MAX_DOUBLE (inclusive)] @@ -6589,7 +6587,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. -1161 +1231 [Double 0...MAX_DOUBLE (inclusive)] @@ -6606,7 +6604,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. -1164 +1234 [Double 0...MAX_DOUBLE (inclusive)] @@ -6623,7 +6621,7 @@ half-space cooling Whether to use the half space cooling model or the plate cooling model -1168 +1238 [Selection half-space cooling|plate cooling ] @@ -6640,7 +6638,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. -1158 +1228 [DirectoryName] @@ -6657,7 +6655,7 @@ adiabatic.txt The file name of the model data. -1159 +1229 [Anything] @@ -6674,7 +6672,7 @@ The file name of the model data. Thickness of the lithosphere for plate cooling model. \si{\m} -1169 +1239 [Double 0...MAX_DOUBLE (inclusive)] @@ -6691,7 +6689,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. -1165 +1235 [Selection center ] @@ -6708,7 +6706,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. -1163 +1233 [Double 0...MAX_DOUBLE (inclusive)] @@ -6725,7 +6723,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. -1160 +1230 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -6744,7 +6742,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\`. -1166 +1236 [Double 0...MAX_DOUBLE (inclusive)] @@ -6761,7 +6759,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'. -1167 +1237 [Selection constant|function|ascii data ] @@ -6779,7 +6777,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. -1173 +1243 [Selection cartesian|spherical ] @@ -6794,7 +6792,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.) -1176 +1246 [Anything] @@ -6813,7 +6811,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. -1175 +1245 [Anything] @@ -6830,7 +6828,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. -1174 +1244 [Anything] @@ -6847,7 +6845,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.) -1172 +1242 [Anything] @@ -6866,7 +6864,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. -1171 +1241 [Anything] @@ -6883,7 +6881,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. -1170 +1240 [Anything] @@ -6903,7 +6901,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}. -1182 +1252 [Double 0...MAX_DOUBLE (inclusive)] @@ -6920,7 +6918,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. -1177 +1247 [DirectoryName] @@ -6937,7 +6935,7 @@ adiabatic_boundary.txt The file name of the model data. -1178 +1248 [Anything] @@ -6954,7 +6952,7 @@ The file name of the model data. The value of the isothermal boundary temperature. Units: \si{\kelvin}. -1180 +1250 [Double 0...MAX_DOUBLE (inclusive)] @@ -6971,7 +6969,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. -1179 +1249 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -6988,7 +6986,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}. -1181 +1251 [Double 0...MAX_DOUBLE (inclusive)] @@ -7007,7 +7005,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. -1192 +1262 [DirectoryName] @@ -7024,7 +7022,7 @@ initial_isotherm_500K_box_3d.txt The file name of the model data. -1190 +1260 [Anything] @@ -7041,7 +7039,7 @@ initial_isotherm_500K_box_3d.txt The file names of the model data (comma separated). -1193 +1263 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -7058,7 +7056,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. -1187 +1257 [Anything] @@ -7075,7 +7073,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. -1194 +1264 [Selection piecewise constant|linear ] @@ -7092,7 +7090,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. -1191 +1261 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -7109,7 +7107,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. -1188 +1258 [Anything] @@ -7126,7 +7124,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. -1186 +1256 [Bool] @@ -7145,7 +7143,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. -1195 +1265 [DirectoryName] @@ -7162,7 +7160,7 @@ simple_test.txt The file name of the model data. -1196 +1266 [Anything] @@ -7179,7 +7177,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. -1197 +1267 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -7198,7 +7196,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}. -1102 +1172 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -7215,7 +7213,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}. -1104 +1174 [Double 0...MAX_DOUBLE (inclusive)] @@ -7232,7 +7230,7 @@ The value of the isotherm that is assumed at the Lithosphere-Asthenosphere bound The value of the surface temperature. Units: \si{\kelvin}. -1103 +1173 [Double 0...MAX_DOUBLE (inclusive)] @@ -7251,7 +7249,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. -1105 +1175 [Selection cartesian|spherical|depth ] @@ -7266,7 +7264,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.) -1108 +1178 [Anything] @@ -7285,7 +7283,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. -1107 +1177 [Anything] @@ -7302,7 +7300,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. -1106 +1176 [Anything] @@ -7321,7 +7319,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. -1110 +1180 [Integer range -2147483648...2147483647 (inclusive)] @@ -7338,7 +7336,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. -1111 +1181 [Integer range -2147483648...2147483647 (inclusive)] @@ -7355,7 +7353,7 @@ Doubled second lateral wave number of the harmonic perturbation. Equals the sphe The magnitude of the Harmonic perturbation. -1112 +1182 [Double 0...MAX_DOUBLE (inclusive)] @@ -7372,7 +7370,7 @@ The magnitude of the Harmonic perturbation. The reference temperature that is perturbed by the harmonic function. Only used in incompressible models. -1113 +1183 [Double 0...MAX_DOUBLE (inclusive)] @@ -7389,7 +7387,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. -1109 +1179 [Integer range -2147483648...2147483647 (inclusive)] @@ -7408,7 +7406,7 @@ Doubled radial wave number of the harmonic perturbation. One equals half of a s The background temperature for the temperature field. -1201 +1271 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -7425,7 +7423,7 @@ The background temperature for the temperature field. The X coordinate for the center of the shape. -1203 +1273 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -7442,7 +7440,7 @@ The X coordinate for the center of the shape. The Y coordinate for the center of the shape. -1204 +1274 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -7459,7 +7457,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. -1205 +1275 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -7476,7 +7474,7 @@ constant The gradient of the inclusion to be generated. -1199 +1269 [Selection gaussian|linear|constant ] @@ -7493,7 +7491,7 @@ circle The shape of the inclusion to be generated. -1198 +1268 [Selection square|circle ] @@ -7510,7 +7508,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. -1202 +1272 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -7527,7 +7525,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. -1200 +1270 [Double 0...MAX_DOUBLE (inclusive)] @@ -7546,7 +7544,7 @@ $ASPECT_SOURCE_DIR/data/initial-temperature/lithosphere-mask/ The path to the LAB depth data file -1116 +1186 [DirectoryName] @@ -7563,7 +7561,7 @@ Value Method that is used to specify the depth of the lithosphere-asthenosphere boundary. -1114 +1184 [Selection File|Value ] @@ -7580,7 +7578,7 @@ LAB_CAM2016.txt File from which the lithosphere-asthenosphere boundary depth data is read. -1117 +1187 [FileName (Type: input)] @@ -7597,7 +7595,7 @@ File from which the lithosphere-asthenosphere boundary depth data is read. The initial temperature within lithosphere, applied abovethe maximum lithosphere depth. -1118 +1188 [Double 0...MAX_DOUBLE (inclusive)] @@ -7614,7 +7612,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. -1115 +1185 [Double 0...MAX_DOUBLE (inclusive)] @@ -7633,7 +7631,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. -1119 +1189 [Double 0...MAX_DOUBLE (inclusive)] @@ -7650,7 +7648,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. -1121 +1191 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -7667,7 +7665,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. -1120 +1190 [Double 0...MAX_DOUBLE (inclusive)] @@ -7685,7 +7683,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. -1122 +1192 [DirectoryName] @@ -7702,7 +7700,7 @@ upper_shell_3d.txt The file name of the model data. -1123 +1193 [Anything] @@ -7719,7 +7717,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. -1124 +1194 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -7739,7 +7737,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}. -1126 +1196 [Double 0...MAX_DOUBLE (inclusive)] @@ -7756,7 +7754,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. -1125 +1195 [Integer range -2147483648...2147483647 (inclusive)] @@ -7773,7 +7771,7 @@ Total number of perturbations to be introduced into the model. Perturbations wil The Gaussian RMS width of the perturbations. Units: \si{\meter}. -1127 +1197 [Double 0...MAX_DOUBLE (inclusive)] @@ -7792,7 +7790,7 @@ $ASPECT_SOURCE_DIR/data/initial-temperature/S40RTS/ The path to the model data. -1128 +1198 [DirectoryName] @@ -7809,7 +7807,7 @@ S40RTS.sph The file name of the spherical harmonics coefficients from Ritsema et al. -1129 +1199 [Anything] @@ -7826,7 +7824,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. -1139 +1209 [Integer range 0...2147483647 (inclusive)] @@ -7843,7 +7841,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. -1136 +1206 [Double 0...MAX_DOUBLE (inclusive)] @@ -7860,7 +7858,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. -1135 +1205 [Bool] @@ -7877,7 +7875,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. -1137 +1207 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -7894,7 +7892,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. -1138 +1208 [Bool] @@ -7911,7 +7909,7 @@ Spline_knots.txt The file name of the spline knot locations from Ritsema et al. -1130 +1200 [Anything] @@ -7928,7 +7926,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}. -1133 +1203 [Double 0...MAX_DOUBLE (inclusive)] @@ -7945,7 +7943,7 @@ false Option to take the thermal expansion coefficient from the material model instead of from what is specified in this section. -1134 +1204 [Bool] @@ -7962,7 +7960,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. -1132 +1202 [Double 0...MAX_DOUBLE (inclusive)] @@ -7979,7 +7977,7 @@ constant Method that is used to specify how the vs-to-density scaling varies with depth. -1131 +1201 [Selection file|constant ] @@ -7997,7 +7995,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. -1140 +1210 [DirectoryName] @@ -8014,7 +8012,7 @@ vs_to_density_Steinberger.txt The file name of the model data. -1141 +1211 [Anything] @@ -8031,7 +8029,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. -1142 +1212 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -8051,7 +8049,7 @@ $ASPECT_SOURCE_DIR/data/initial-temperature/SAVANI/ The path to the model data. -1143 +1213 [DirectoryName] @@ -8068,7 +8066,7 @@ savani.dlnvs.60.m.ab The file name of the spherical harmonics coefficients from Auer et al. -1144 +1214 [Anything] @@ -8085,7 +8083,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. -1154 +1224 [Integer range 0...2147483647 (inclusive)] @@ -8102,7 +8100,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. -1151 +1221 [Double 0...MAX_DOUBLE (inclusive)] @@ -8119,7 +8117,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. -1150 +1220 [Bool] @@ -8136,7 +8134,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. -1152 +1222 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -8153,7 +8151,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. -1153 +1223 [Bool] @@ -8170,7 +8168,7 @@ Spline_knots.txt The file name of the spline knots taken from the 28 spherical layers of SAVANI tomography model. -1145 +1215 [Anything] @@ -8187,7 +8185,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}. -1148 +1218 [Double 0...MAX_DOUBLE (inclusive)] @@ -8204,7 +8202,7 @@ false Option to take the thermal expansion coefficient from the material model instead of from what is specified in this section. -1149 +1219 [Bool] @@ -8221,7 +8219,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. -1147 +1217 [Double 0...MAX_DOUBLE (inclusive)] @@ -8238,7 +8236,7 @@ constant Method that is used to specify how the vs-to-density scaling varies with depth. -1146 +1216 [Selection file|constant ] @@ -8256,7 +8254,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. -1155 +1225 [DirectoryName] @@ -8273,7 +8271,7 @@ vs_to_density_Steinberger.txt The file name of the model data. -1156 +1226 [Anything] @@ -8290,7 +8288,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. -1157 +1227 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -8310,7 +8308,7 @@ Scalar factor, which is applied to the model data. You might want to use this to The amplitude of the perturbation. -1098 +1168 [Double 0...MAX_DOUBLE (inclusive)] @@ -8327,7 +8325,7 @@ The amplitude of the perturbation. The angle where the center of the perturbation is placed. -1096 +1166 [Double 0...MAX_DOUBLE (inclusive)] @@ -8344,7 +8342,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. -1101 +1171 [FileName (Type: input)] @@ -8361,7 +8359,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. -1097 +1167 [Double 0...MAX_DOUBLE (inclusive)] @@ -8378,7 +8376,7 @@ The non-dimensional radial distance where the center of the perturbation is plac The standard deviation of the Gaussian perturbation. -1099 +1169 [Double 0...MAX_DOUBLE (inclusive)] @@ -8395,7 +8393,7 @@ The standard deviation of the Gaussian perturbation. The sign of the perturbation. -1100 +1170 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -8414,7 +8412,7 @@ The sign of the perturbation. The number of convection cells with which to perturb the system. -1094 +1164 [Integer range -2147483648...2147483647 (inclusive)] @@ -8431,7 +8429,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. -1095 +1165 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -8457,7 +8455,7 @@ The process of averaging, and where it may be used, is discussed in more detail More averaging schemes are available in the averaging material model. This material model is a ``compositing material model'' which can be used in combination with other material models. -99 +100 [Selection none|default averaging|arithmetic average|harmonic average|geometric average|pick largest|project to Q1|log average|harmonic average only viscosity|geometric average only viscosity|project to Q1 only viscosity ] @@ -8669,7 +8667,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. -383 +453 [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 ] @@ -8687,7 +8685,7 @@ Viscous stress may also be limited by a non-linear stress limiter that has a for Reference conductivity -897 +967 [Double 0...MAX_DOUBLE (inclusive)] @@ -8704,7 +8702,7 @@ Reference conductivity The temperature dependence of viscosity. Dimensionless exponent. -900 +970 [Double 0...MAX_DOUBLE (inclusive)] @@ -8721,7 +8719,7 @@ The temperature dependence of viscosity. Dimensionless exponent. A list of depths where the viscosity changes. Values must monotonically increase. Units: \si{\meter}. -901 +971 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -8738,7 +8736,7 @@ false Whether to use the TALA instead of the ALA approximation. -899 +969 [Bool] @@ -8755,7 +8753,7 @@ Whether to use the TALA instead of the ALA approximation. Viscosity -898 +968 [Double 0...MAX_DOUBLE (inclusive)] @@ -8772,7 +8770,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. -902 +972 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -8790,7 +8788,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. -903 +973 [DirectoryName] @@ -8803,7 +8801,7 @@ The name of a directory that contains the model data. This path may either be ab The file name of the model data. -904 +974 [Anything] @@ -8820,7 +8818,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. -905 +975 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -8840,7 +8838,7 @@ none Choose the averaging operation to use. -907 +977 [Selection none|arithmetic average|harmonic average|geometric average|pick largest|log average|nwd arithmetic average|nwd harmonic average|nwd geometric average ] @@ -8857,7 +8855,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. -906 +976 [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 ] @@ -8874,7 +8872,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. -908 +978 [Double 0...MAX_DOUBLE (inclusive)] @@ -8893,7 +8891,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. -909 +979 [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 ] @@ -8910,7 +8908,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. -910 +980 [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 ] @@ -8927,7 +8925,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. -911 +981 [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 ] @@ -8944,7 +8942,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. -912 +982 [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 ] @@ -8961,7 +8959,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. -913 +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|unspecified ] @@ -8978,7 +8976,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. -914 +984 [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 ] @@ -8995,7 +8993,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. -915 +985 [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 ] @@ -9012,7 +9010,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. -916 +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 ] @@ -9029,7 +9027,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. -917 +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 ] @@ -9048,7 +9046,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. -926 +996 [Double 0...MAX_DOUBLE (inclusive)] @@ -9065,7 +9063,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. -927 +997 [Double 0...MAX_DOUBLE (inclusive)] @@ -9082,7 +9080,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. -922 +992 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -9099,7 +9097,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. -923 +993 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -9116,7 +9114,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}. -930 +1000 [Double 0...MAX_DOUBLE (inclusive)] @@ -9133,7 +9131,7 @@ Above this depth the compositional fields react: The first field gets converted Reference density $\rho_0$. Units: \si{\kilogram\per\meter\cubed}. -918 +988 [Double 0...MAX_DOUBLE (inclusive)] @@ -9150,7 +9148,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}. -920 +990 [Double 0...MAX_DOUBLE (inclusive)] @@ -9167,7 +9165,7 @@ The value of the specific heat $C_p$. Units: \si{\joule\per\kelvin\per\kilogram} The reference temperature $T_0$. Units: \si{\kelvin}. -924 +994 [Double 0...MAX_DOUBLE (inclusive)] @@ -9184,7 +9182,7 @@ The reference temperature $T_0$. Units: \si{\kelvin}. The value of the thermal conductivity $k$. Units: \si{\watt\per\meter\per\kelvin}. -929 +999 [Double 0...MAX_DOUBLE (inclusive)] @@ -9201,7 +9199,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}. -921 +991 [Double 0...MAX_DOUBLE (inclusive)] @@ -9218,7 +9216,7 @@ The value of the thermal expansion coefficient $\alpha$. Units: \si{\per\kelvin} The temperature dependence of viscosity. Dimensionless exponent. -928 +998 [Double 0...MAX_DOUBLE (inclusive)] @@ -9235,7 +9233,7 @@ The temperature dependence of viscosity. Dimensionless exponent. The value of the constant viscosity. Units: \si{\kilogram\per\meter\per\second}. -925 +995 [Double 0...MAX_DOUBLE (inclusive)] @@ -9254,7 +9252,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. -934 +1004 [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 ] @@ -9271,7 +9269,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. -931 +1001 [DirectoryName] @@ -9288,7 +9286,7 @@ ascii_depth_profile.txt The file name of the model data. -932 +1002 [Anything] @@ -9305,7 +9303,7 @@ None Method that is used to specify how the viscosity should vary with depth. -935 +1005 [Selection Function|File|List|None ] @@ -9318,7 +9316,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. -936 +1006 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -9335,7 +9333,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}. -938 +1008 [Double 0...MAX_DOUBLE (inclusive)] @@ -9352,7 +9350,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. -933 +1003 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -9373,7 +9371,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''. -937 +1007 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -9389,7 +9387,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.) -941 +1011 [Anything] @@ -9404,7 +9402,7 @@ A typical example would be to set this runtime parameter to `pi=3.1415926536&apo -942 +1012 [Anything] @@ -9421,7 +9419,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. -939 +1009 [Anything] @@ -9441,7 +9439,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. -822 +892 [DirectoryName] @@ -9458,7 +9456,7 @@ ascii_depth_profile.txt The file name of the model data. -823 +893 [Anything] @@ -9475,7 +9473,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. -824 +894 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -9494,7 +9492,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}. -967 +1037 [Anything] @@ -9511,7 +9509,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}. -972 +1042 [Anything] @@ -9528,7 +9526,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}. -968 +1038 [Anything] @@ -9545,7 +9543,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}. -973 +1043 [Anything] @@ -9562,7 +9560,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}. -952 +1022 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -9579,7 +9577,7 @@ List of densities, $\rho$, for background mantle and compositional fields, for a Scaling coefficient for effective viscosity. -947 +1017 [Double 0...MAX_DOUBLE (inclusive)] @@ -9596,7 +9594,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}. -969 +1039 [Double 0...MAX_DOUBLE (inclusive)] @@ -9613,7 +9611,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. -966 +1036 [Anything] @@ -9630,7 +9628,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}. -951 +1021 [Double 0...MAX_DOUBLE (inclusive)] @@ -9647,7 +9645,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. -949 +1019 [Integer range 0...2147483647 (inclusive)] @@ -9664,7 +9662,7 @@ Maximum number of iterations to find the correct diffusion/dislocation strain ra Upper cutoff for effective viscosity. Units: \si{\pascal\second}. -946 +1016 [Double 0...MAX_DOUBLE (inclusive)] @@ -9681,7 +9679,7 @@ Upper cutoff for effective viscosity. Units: \si{\pascal\second}. Stabilizes strain dependent viscosity. Units: \si{\per\second}. -944 +1014 [Double 0...MAX_DOUBLE (inclusive)] @@ -9698,7 +9696,7 @@ Stabilizes strain dependent viscosity. Units: \si{\per\second}. Lower cutoff for effective viscosity. Units: \si{\pascal\second}. -945 +1015 [Double 0...MAX_DOUBLE (inclusive)] @@ -9715,7 +9713,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}. -964 +1034 [Anything] @@ -9732,7 +9730,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}. -970 +1040 [Anything] @@ -9749,7 +9747,7 @@ List of viscosity prefactors, $A$, for background material and compositional fie For calculating density by thermal expansivity. Units: \si{\kelvin}. -943 +1013 [Double 0...MAX_DOUBLE (inclusive)] @@ -9766,7 +9764,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. -948 +1018 [Double 0...MAX_DOUBLE (inclusive)] @@ -9783,7 +9781,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. -965 +1035 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -9800,7 +9798,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. -971 +1041 [Anything] @@ -9817,7 +9815,7 @@ List of stress exponents, $n_{\text{dislocation}}$, for background material and Units: \si{\meter\squared\per\second}. -950 +1020 [Double 0...MAX_DOUBLE (inclusive)] @@ -9834,7 +9832,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}. -953 +1023 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -9851,7 +9849,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. -954 +1024 [Selection arithmetic|harmonic|geometric|maximum composition ] @@ -9870,7 +9868,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}. -793 +863 [Double 0...MAX_DOUBLE (inclusive)] @@ -9887,7 +9885,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}. -795 +865 [Double 0...MAX_DOUBLE (inclusive)] @@ -9904,7 +9902,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}. -797 +867 [Double 0...MAX_DOUBLE (inclusive)] @@ -9921,7 +9919,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}. -798 +868 [Double 0...MAX_DOUBLE (inclusive)] @@ -9938,7 +9936,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}. -796 +866 [Double 0...MAX_DOUBLE (inclusive)] @@ -9956,7 +9954,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. -802 +872 [Double 0...MAX_DOUBLE (inclusive)] @@ -9973,7 +9971,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}. -803 +873 [Double 0...MAX_DOUBLE (inclusive)] @@ -9990,7 +9988,7 @@ The value of the cohesion $C$. Units: \si{\pascal}. The value of the maximum viscosity cutoff $\eta_max$. Units: \si{\pascal\second}. -800 +870 [Double 0...MAX_DOUBLE (inclusive)] @@ -10007,7 +10005,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}. -799 +869 [Double 0...MAX_DOUBLE (inclusive)] @@ -10024,7 +10022,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}. -801 +871 [Double 0...MAX_DOUBLE (inclusive)] @@ -10044,7 +10042,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. -811 +881 [Double 0...MAX_DOUBLE (inclusive)] @@ -10061,7 +10059,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}. -812 +882 [Double 0...MAX_DOUBLE (inclusive)] @@ -10078,7 +10076,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. -804 +874 [DirectoryName] @@ -10095,7 +10093,7 @@ temp-viscosity-prefactor.txt The file name of the lateral viscosity prefactor. -807 +877 [Anything] @@ -10112,7 +10110,7 @@ material_table.txt The file name of the material data. The first material data file is intended for the background composition. -805 +875 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -10129,7 +10127,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. -810 +880 [Double 0...MAX_DOUBLE (inclusive)] @@ -10146,7 +10144,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. -821 +891 [Double 0...MAX_DOUBLE (inclusive)] @@ -10163,7 +10161,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. -809 +879 [Double 0...MAX_DOUBLE (inclusive)] @@ -10180,7 +10178,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. -808 +878 [Double 0...MAX_DOUBLE (inclusive)] @@ -10197,7 +10195,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}. -817 +887 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10214,7 +10212,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}. -818 +888 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10231,7 +10229,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} -816 +886 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10250,7 +10248,7 @@ The viscosity that is used in this model. Units: \si{\pascal\second} -806 +876 [Double 0...MAX_DOUBLE (inclusive)] @@ -10267,7 +10265,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. -820 +890 [List of <[Double 0...1 (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10284,7 +10282,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}. -813 +883 [Double 0...MAX_DOUBLE (inclusive)] @@ -10301,7 +10299,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. -819 +889 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10318,7 +10316,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). -814 +884 [Selection constant|p-T-dependent ] @@ -10335,7 +10333,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}. -815 +885 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10354,7 +10352,7 @@ false This option does not exist any more. -891 +961 [Bool] @@ -10371,7 +10369,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. -872 +942 [Anything] @@ -10388,7 +10386,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}. -886 +956 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10405,7 +10403,7 @@ true This parameter determines whether to use bilinear interpolation to compute material properties (slower but more accurate). -869 +939 [Bool] @@ -10422,7 +10420,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}. -873 +943 [Anything] @@ -10439,7 +10437,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. -863 +933 [DirectoryName] @@ -10456,7 +10454,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. -836 +906 [Bool] @@ -10469,7 +10467,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). -865 +935 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -10486,7 +10484,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}. -848 +918 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10503,7 +10501,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}. -849 +919 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10520,7 +10518,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. -847 +917 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10537,7 +10535,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. -851 +921 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10554,7 +10552,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}. -850 +920 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10571,7 +10569,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}. -844 +914 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10588,7 +10586,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}. -845 +915 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10605,7 +10603,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. -843 +913 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10622,7 +10620,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}. -846 +916 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10639,7 +10637,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. -842 +912 [Integer range 0...2147483647 (inclusive)] @@ -10656,7 +10654,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. -841 +911 [Double 0...MAX_DOUBLE (inclusive)] @@ -10673,7 +10671,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. -888 +958 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10690,7 +10688,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}. -877 +947 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10707,7 +10705,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}. -878 +948 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10724,7 +10722,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. -879 +949 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10741,7 +10739,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}. -880 +950 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -10758,7 +10756,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). -884 +954 [Selection paleowattmeter|paleopiezometer|pinned grain damage ] @@ -10775,7 +10773,7 @@ A flag indicating whether the material model should use the paleowattmeter appro This option does not exist any more. -890 +960 [Double 0...MAX_DOUBLE (inclusive)] @@ -10792,7 +10790,7 @@ perplex The material file format to be read in the property tables. -867 +937 [Selection perplex|hefesto ] @@ -10809,7 +10807,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). -864 +934 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -10826,7 +10824,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. -859 +929 [Integer range 1...2147483647 (inclusive)] @@ -10843,7 +10841,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. -856 +926 [Double 0...MAX_DOUBLE (inclusive)] @@ -10860,7 +10858,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. -852 +922 [Double 0...MAX_DOUBLE (inclusive)] @@ -10877,7 +10875,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. -858 +928 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -10894,7 +10892,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. -854 +924 [Double 0...MAX_DOUBLE (inclusive)] @@ -10911,7 +10909,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}. -874 +944 [Double 0...MAX_DOUBLE (inclusive)] @@ -10928,7 +10926,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}. -889 +959 [Double 0...MAX_DOUBLE (inclusive)] @@ -10945,7 +10943,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. -855 +925 [Double 0...MAX_DOUBLE (inclusive)] @@ -10962,7 +10960,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. -857 +927 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -10979,7 +10977,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. -853 +923 [Double 0...MAX_DOUBLE (inclusive)] @@ -10992,7 +10990,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}. -840 +910 [Anything] @@ -11005,7 +11003,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}. -832 +902 [Anything] @@ -11018,7 +11016,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}. -835 +905 [Anything] @@ -11031,7 +11029,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}. -834 +904 [Anything] @@ -11048,7 +11046,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}. -839 +909 [Anything] @@ -11065,7 +11063,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}. -838 +908 [Anything] @@ -11078,7 +11076,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}. -837 +907 [Anything] @@ -11091,7 +11089,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}. -833 +903 [Anything] @@ -11108,7 +11106,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. -883 +953 [Double 0...1 (inclusive)] @@ -11125,7 +11123,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} -876 +946 [Double 0...MAX_DOUBLE (inclusive)] @@ -11142,7 +11140,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. -881 +951 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -11155,7 +11153,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}. -882 +952 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -11172,7 +11170,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}. -831 +901 [Double 0...MAX_DOUBLE (inclusive)] @@ -11189,7 +11187,7 @@ The value of the reference compressibility. Units: \si{\per\pascal}. The reference density $\rho_0$. Units: \si{\kilogram\per\meter\cubed}. -825 +895 [Double 0...MAX_DOUBLE (inclusive)] @@ -11206,7 +11204,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}. -829 +899 [Double 0...MAX_DOUBLE (inclusive)] @@ -11223,7 +11221,7 @@ The value of the specific heat $cp$. Units: \si{\joule\per\kelvin\per\kilogram}. The reference temperature $T_0$. Units: \si{\kelvin}. -826 +896 [Double 0...MAX_DOUBLE (inclusive)] @@ -11240,7 +11238,7 @@ The reference temperature $T_0$. Units: \si{\kelvin}. The value of the thermal conductivity $k$. Units: \si{\watt\per\meter\per\kelvin}. -828 +898 [Double 0...MAX_DOUBLE (inclusive)] @@ -11257,7 +11255,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}. -830 +900 [Double 0...MAX_DOUBLE (inclusive)] @@ -11274,7 +11272,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). -870 +940 [Bool] @@ -11291,7 +11289,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. -871 +941 [Bool] @@ -11308,7 +11306,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). -868 +938 [Bool] @@ -11325,7 +11323,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. -885 +955 [Selection true|false|default ] @@ -11342,7 +11340,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. -875 +945 [Bool] @@ -11359,7 +11357,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. -866 +936 [Bool] @@ -11376,7 +11374,7 @@ This parameter determines whether to use the table properties also for density, The value of the constant viscosity. Units: \si{\pascal\second}. -827 +897 [Double 0...MAX_DOUBLE (inclusive)] @@ -11393,7 +11391,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}. -887 +957 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -11411,7 +11409,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. -896 +966 [Double 0...MAX_DOUBLE (inclusive)] @@ -11428,7 +11426,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. -895 +965 [Double 0...1 (inclusive)] @@ -11445,7 +11443,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. -894 +964 [Double 0...1 (inclusive)] @@ -11462,7 +11460,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. -893 +963 [Double 0...MAX_DOUBLE (inclusive)] @@ -11479,7 +11477,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. -892 +962 [Double 0...MAX_DOUBLE (inclusive)] @@ -11499,7 +11497,7 @@ This parameter determines the temperature at which the computed coefficient of s A linear dependency of viscosity on composition. Dimensionless prefactor. -625 +695 [Double 0...MAX_DOUBLE (inclusive)] @@ -11516,7 +11514,7 @@ A linear dependency of viscosity on composition. Dimensionless prefactor. The value of the compressibility $\kappa$. Units: \si{\per\pascal}. -630 +700 [Double 0...MAX_DOUBLE (inclusive)] @@ -11529,7 +11527,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}. -633 +703 [List of <[Integer range 0...2147483647 (inclusive)]> of length 0...4294967295 (inclusive)] @@ -11546,7 +11544,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. -641 +711 [Bool] @@ -11563,7 +11561,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. -631 +701 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -11580,7 +11578,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. -636 +706 [Double 0...MAX_DOUBLE (inclusive)] @@ -11597,7 +11595,7 @@ Limit for the maximum viscosity in the model. Units: Pa \, s. Limit for the minimum viscosity in the model. Units: Pa \, s. -635 +705 [Double 0...MAX_DOUBLE (inclusive)] @@ -11610,7 +11608,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}. -645 +715 [Anything] @@ -11623,7 +11621,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}. -632 +702 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -11636,7 +11634,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}. -637 +707 [Anything] @@ -11649,7 +11647,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}. -640 +710 [Anything] @@ -11662,7 +11660,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}. -639 +709 [Anything] @@ -11679,7 +11677,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}. -644 +714 [Anything] @@ -11696,7 +11694,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}. -643 +713 [Anything] @@ -11709,7 +11707,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}. -642 +712 [Anything] @@ -11722,7 +11720,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}. -638 +708 [Anything] @@ -11739,7 +11737,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}. -622 +692 [Double 0...MAX_DOUBLE (inclusive)] @@ -11756,7 +11754,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}. -628 +698 [Double 0...MAX_DOUBLE (inclusive)] @@ -11773,7 +11771,7 @@ The value of the specific heat $C_p$. Units: \si{\joule\per\kelvin\per\kilogram} The reference temperature $T_0$. Units: \si{\kelvin}. -623 +693 [Double 0...MAX_DOUBLE (inclusive)] @@ -11790,7 +11788,7 @@ The reference temperature $T_0$. Units: \si{\kelvin}. The value of the thermal conductivity $k$. Units: \si{\watt\per\meter\per\kelvin}. -627 +697 [Double 0...MAX_DOUBLE (inclusive)] @@ -11807,7 +11805,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}. -629 +699 [Double 0...MAX_DOUBLE (inclusive)] @@ -11824,7 +11822,7 @@ The value of the thermal expansion coefficient $\beta$. Units: \si{\per\kelvin}. The temperature dependence of viscosity. Dimensionless exponent. -626 +696 [Double 0...MAX_DOUBLE (inclusive)] @@ -11841,7 +11839,7 @@ The temperature dependence of viscosity. Dimensionless exponent. The value of the constant viscosity. Units: \si{\pascal\second}. -624 +694 [Double 0...MAX_DOUBLE (inclusive)] @@ -11854,7 +11852,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. -634 +704 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -11873,7 +11871,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}. -657 +727 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -11890,7 +11888,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}. -658 +728 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -11907,7 +11905,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}. -659 +729 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -11924,7 +11922,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}. -660 +730 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -11941,7 +11939,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}. -661 +731 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -11958,7 +11956,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}. -662 +732 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -11975,7 +11973,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}. -663 +733 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -11992,7 +11990,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}. -664 +734 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12009,7 +12007,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}. -665 +735 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12026,7 +12024,7 @@ Prefactor of the quadratic pressure term in the quadratic function that approxim A linear dependency of viscosity on composition. Dimensionless prefactor. -649 +719 [Double 0...MAX_DOUBLE (inclusive)] @@ -12043,7 +12041,7 @@ A linear dependency of viscosity on composition. Dimensionless prefactor. The value of the compressibility $\kappa$. Units: \si{\per\pascal}. -655 +725 [Double 0...MAX_DOUBLE (inclusive)] @@ -12060,7 +12058,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}. -671 +741 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12077,7 +12075,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}. -672 +742 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12094,7 +12092,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}. -673 +743 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12111,7 +12109,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. -656 +726 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12128,7 +12126,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}. -674 +744 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12145,7 +12143,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}. -675 +745 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12162,7 +12160,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. -670 +740 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12179,7 +12177,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. -677 +747 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12196,7 +12194,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}. -669 +739 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12213,7 +12211,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}. -676 +746 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12230,7 +12228,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}. -646 +716 [Double 0...MAX_DOUBLE (inclusive)] @@ -12247,7 +12245,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}. -652 +722 [Double 0...MAX_DOUBLE (inclusive)] @@ -12264,7 +12262,7 @@ The value of the specific heat $C_p$. Units: \si{\joule\per\kelvin\per\kilogram} The reference temperature $T_0$. Units: \si{\kelvin}. -647 +717 [Double 0...MAX_DOUBLE (inclusive)] @@ -12281,7 +12279,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. -678 +748 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12298,7 +12296,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}. -651 +721 [Double 0...MAX_DOUBLE (inclusive)] @@ -12315,7 +12313,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}. -653 +723 [Double 0...MAX_DOUBLE (inclusive)] @@ -12332,7 +12330,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}. -654 +724 [Double 0...MAX_DOUBLE (inclusive)] @@ -12349,7 +12347,7 @@ The value of the thermal expansion coefficient $\alpha_f$. Units: \si{\per\kelvi The temperature dependence of viscosity. Dimensionless exponent. -650 +720 [Double 0...MAX_DOUBLE (inclusive)] @@ -12366,7 +12364,7 @@ The temperature dependence of viscosity. Dimensionless exponent. The value of the constant viscosity. Units: \si{\pascal\second}. -648 +718 [Double 0...MAX_DOUBLE (inclusive)] @@ -12383,7 +12381,7 @@ The value of the constant viscosity. Units: \si{\pascal\second}. Exponent of the melting temperature in the melt fraction calculation. Units: non-dimensional. -668 +738 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12400,7 +12398,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. -666 +736 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12417,7 +12415,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}. -667 +737 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12436,7 +12434,7 @@ Prefactor of the linear pressure term in the linear function that approximates t List of Einstein temperatures for each different endmember.Units: K. -704 +774 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -12453,7 +12451,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. -695 +765 [List of <[MultipleSelection MgSiO3_bridgmanite|FeSiO3_bridgmanite|MgO_periclase|FeO_periclase|MgO_melt|FeO_melt|SiO2_melt ]> of length 0...4294967295 (inclusive)] @@ -12470,7 +12468,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. -696 +766 [List of <[MultipleSelection solid|melt ]> of length 0...4294967295 (inclusive)] @@ -12487,7 +12485,7 @@ States of the endmember components used in the equation of state and the melting The porosity dependence of the viscosity. Units: dimensionless. -682 +752 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12504,7 +12502,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. -689 +759 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12521,7 +12519,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. -691 +761 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12538,7 +12536,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. -702 +772 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -12555,7 +12553,7 @@ true Whether to include melting and freezing (according to a simplified linear melting approximation in the model (if true), or not (if false). -687 +757 [Bool] @@ -12572,7 +12570,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. -708 +778 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -12591,7 +12589,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. -688 +758 [Double 0...MAX_DOUBLE (inclusive)] @@ -12608,7 +12606,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. -690 +760 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12625,7 +12623,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. -692 +762 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12642,7 +12640,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. -697 +767 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -12659,7 +12657,7 @@ Molar masses of the different endmembersUnits: kg/mol. Number of atoms per in the formula of each endmember.Units: none. -698 +768 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -12676,7 +12674,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. -701 +771 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -12693,7 +12691,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$. -680 +750 [Double 0...MAX_DOUBLE (inclusive)] @@ -12710,7 +12708,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. -705 +775 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -12727,7 +12725,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. -706 +776 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -12744,7 +12742,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$. -681 +751 [Double 0...MAX_DOUBLE (inclusive)] @@ -12761,7 +12759,7 @@ The value of the constant melt viscosity $\eta_f$. Units: $Pa \, s$. Reference permeability of the solid host rock.Units: $m^2$. -686 +756 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12778,7 +12776,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. -694 +764 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12795,7 +12793,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$. -679 +749 [Double 0...MAX_DOUBLE (inclusive)] @@ -12812,7 +12810,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. -707 +777 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -12829,7 +12827,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. -693 +763 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -12846,7 +12844,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. -700 +770 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -12863,7 +12861,7 @@ List of thermal expansivities for each different endmember at the reference temp Reference volumes of the different endmembers.Units: $m^3$. -699 +769 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -12880,7 +12878,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. -709 +779 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -12897,7 +12895,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. -703 +773 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -12914,7 +12912,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. -684 +754 [Double 0...MAX_DOUBLE (inclusive)] @@ -12931,7 +12929,7 @@ The temperature dependence of the bulk viscosity. Dimensionless exponent. See th The value of the thermal conductivity $k$. Units: $W/m/K$. -685 +755 [Double 0...MAX_DOUBLE (inclusive)] @@ -12948,7 +12946,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. -683 +753 [Double 0...MAX_DOUBLE (inclusive)] @@ -12965,7 +12963,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). -710 +780 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -12984,7 +12982,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}. -724 +794 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13001,7 +12999,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}. -726 +796 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13015,10 +13013,10 @@ The solidus temperature change for a depletion of 100\%. For positive values, th 0.0 -$\alpha_F$: exponential dependency of viscosity on the depletion field $F$ (called peridotite). Dimensionless factor. With a value of 0.0 (the default) the viscosity does not depend on the depletion. The effective viscosity increasedue to depletion is defined as $exp( \alpha_F * F)$. Rationale: melting dehydrates the source rock by removing most of the volatiles,and makes it stronger. Hirth and Kohlstedt (1996) report typical values around a factor 100 to 1000 viscosity contrast between wet and dry rocks, although some experimental studies report a smaller (factor 10) contrast (e.g. Fei et al., 2013). +$\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). -733 +803 [Double 0...MAX_DOUBLE (inclusive)] @@ -13035,7 +13033,7 @@ $\alpha_F$: exponential dependency of viscosity on the depletion field $F$ (call The porosity dependence of the viscosity. Units: dimensionless. -717 +787 [Double 0...MAX_DOUBLE (inclusive)] @@ -13052,7 +13050,7 @@ true Whether to include melting and freezing (according to a simplified linear melting approximation in the model (if true), or not (if false). -731 +801 [Bool] @@ -13069,7 +13067,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). -734 +804 [Double 0...MAX_DOUBLE (inclusive)] @@ -13086,7 +13084,7 @@ $\Delta \eta_{F,max}$: maximum depletion strengthening of viscosity. Rationale: The value of the pressure derivative of the melt bulk modulus. Units: None. -730 +800 [Double 0...MAX_DOUBLE (inclusive)] @@ -13103,7 +13101,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}. -729 +799 [Double 0...MAX_DOUBLE (inclusive)] @@ -13122,7 +13120,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. -732 +802 [Double 0...MAX_DOUBLE (inclusive)] @@ -13139,7 +13137,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}. -727 +797 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13156,7 +13154,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}. -715 +785 [Double 0...MAX_DOUBLE (inclusive)] @@ -13173,7 +13171,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}. -712 +782 [Double 0...MAX_DOUBLE (inclusive)] @@ -13190,7 +13188,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}. -716 +786 [Double 0...MAX_DOUBLE (inclusive)] @@ -13207,7 +13205,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}. -723 +793 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13224,7 +13222,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}. -714 +784 [Double 0...MAX_DOUBLE (inclusive)] @@ -13241,7 +13239,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}. -711 +781 [Double 0...MAX_DOUBLE (inclusive)] @@ -13258,7 +13256,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}. -721 +791 [Double 0...MAX_DOUBLE (inclusive)] @@ -13275,7 +13273,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}. -713 +783 [Double 0...MAX_DOUBLE (inclusive)] @@ -13292,7 +13290,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}. -728 +798 [Double 0...MAX_DOUBLE (inclusive)] @@ -13309,7 +13307,7 @@ The value of the compressibility of the solid matrix. Units: \si{\per\pascal}. Solidus for a pressure of zero. Units: \si{\kelvin}. -725 +795 [Double 0...MAX_DOUBLE (inclusive)] @@ -13326,7 +13324,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. -719 +789 [Double 0...MAX_DOUBLE (inclusive)] @@ -13343,7 +13341,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}. -720 +790 [Double 0...MAX_DOUBLE (inclusive)] @@ -13360,7 +13358,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}. -722 +792 [Double 0...MAX_DOUBLE (inclusive)] @@ -13377,7 +13375,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. -718 +788 [Double 0...MAX_DOUBLE (inclusive)] @@ -13396,7 +13394,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}. -735 +805 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13413,7 +13411,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}. -736 +806 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13430,7 +13428,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}. -737 +807 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13447,7 +13445,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}. -738 +808 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13464,7 +13462,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}. -739 +809 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13481,7 +13479,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}. -740 +810 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13498,7 +13496,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}. -741 +811 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13515,7 +13513,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}. -742 +812 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13532,7 +13530,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}. -743 +813 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13549,7 +13547,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}. -770 +840 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13566,7 +13564,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}. -760 +830 [Double 0...MAX_DOUBLE (inclusive)] @@ -13583,7 +13581,7 @@ The solidus temperature change for a depletion of 100\%. For positive values, th The porosity dependence of the viscosity. Units: dimensionless. -752 +822 [Double 0...MAX_DOUBLE (inclusive)] @@ -13600,7 +13598,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. -758 +828 [Double 0...MAX_DOUBLE (inclusive)] @@ -13617,7 +13615,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. -747 +817 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13634,7 +13632,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. -756 +826 [Double 0...MAX_DOUBLE (inclusive)] @@ -13651,7 +13649,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}. -755 +825 [Double 0...MAX_DOUBLE (inclusive)] @@ -13668,7 +13666,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}. -754 +824 [Double 0...MAX_DOUBLE (inclusive)] @@ -13687,7 +13685,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. -759 +829 [Double 0...MAX_DOUBLE (inclusive)] @@ -13704,7 +13702,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}. -748 +818 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13721,7 +13719,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}. -750 +820 [Double 0...MAX_DOUBLE (inclusive)] @@ -13738,7 +13736,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}. -749 +819 [Double 0...MAX_DOUBLE (inclusive)] @@ -13755,7 +13753,7 @@ Reference density of the melt/fluid$\rho_{f,0}$. Units: \si{\kilogram\per\meter\ The value of the constant melt viscosity $\viscosity_fluid$. Units: \si{\pascal\second}. -751 +821 [Double 0...MAX_DOUBLE (inclusive)] @@ -13772,7 +13770,7 @@ The value of the constant melt viscosity $\viscosity_fluid$. Units: \si{\pascal\ Reference permeability of the solid host rock.Units: \si{\meter\squared}. -761 +831 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13789,7 +13787,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}. -764 +834 [Double 0...MAX_DOUBLE (inclusive)] @@ -13806,7 +13804,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}. -771 +841 [Double 0...MAX_DOUBLE (inclusive)] @@ -13823,7 +13821,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}. -765 +835 [Double 0...MAX_DOUBLE (inclusive)] @@ -13840,7 +13838,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}. -769 +839 [Double 0...MAX_DOUBLE (inclusive)] @@ -13857,7 +13855,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}. -767 +837 [Double 0...MAX_DOUBLE (inclusive)] @@ -13874,7 +13872,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. -753 +823 [Double 0...MAX_DOUBLE (inclusive)] @@ -13891,7 +13889,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}. -766 +836 [Double 0...MAX_DOUBLE (inclusive)] @@ -13908,7 +13906,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}. -763 +833 [Double 0...MAX_DOUBLE (inclusive)] @@ -13925,7 +13923,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. -768 +838 [Double 0...MAX_DOUBLE (inclusive)] @@ -13944,7 +13942,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. -757 +827 [Bool] @@ -13961,7 +13959,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). -762 +832 [Bool] @@ -13978,7 +13976,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. -746 +816 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -13995,7 +13993,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. -744 +814 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -14012,7 +14010,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}. -745 +815 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -14031,7 +14029,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}. -778 +848 [Double 0...MAX_DOUBLE (inclusive)] @@ -14048,7 +14046,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. -776 +846 [Double 0...MAX_DOUBLE (inclusive)] @@ -14065,7 +14063,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}. -774 +844 [Double 0...MAX_DOUBLE (inclusive)] @@ -14082,7 +14080,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}. -775 +845 [Double 0...MAX_DOUBLE (inclusive)] @@ -14099,7 +14097,7 @@ The isothermal bulk modulus at the reference pressure and temperature. Units: \s Reference pressure $P_0$. Units: \si{\pascal}. -772 +842 [Double 0...MAX_DOUBLE (inclusive)] @@ -14116,7 +14114,7 @@ Reference pressure $P_0$. Units: \si{\pascal}. Reference temperature $T_0$. Units: \si{\kelvin}. -773 +843 [Double 0...MAX_DOUBLE (inclusive)] @@ -14133,7 +14131,7 @@ Reference temperature $T_0$. Units: \si{\kelvin}. The thermal expansion coefficient at the reference pressure and temperature. Units: \si{\per\kelvin}. -777 +847 [Double 0...MAX_DOUBLE (inclusive)] @@ -14150,7 +14148,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}. -780 +850 [Double 0...MAX_DOUBLE (inclusive)] @@ -14167,7 +14165,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}. -779 +849 [Double 0...MAX_DOUBLE (inclusive)] @@ -14183,7 +14181,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.) -783 +853 [Anything] @@ -14198,7 +14196,7 @@ A typical example would be to set this runtime parameter to `pi=3.1415926536&apo -784 +854 [Anything] @@ -14215,7 +14213,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. -781 +851 [Anything] @@ -14235,7 +14233,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}. -786 +856 [Anything] @@ -14252,7 +14250,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}. -788 +858 [Anything] @@ -14269,7 +14267,7 @@ List of specific heats $C_p$ for background mantle and compositional fields,for The reference temperature $T_0$. Units: \si{\kelvin}. -789 +859 [Double 0...MAX_DOUBLE (inclusive)] @@ -14294,7 +14292,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}. -791 +861 [Anything] @@ -14311,7 +14309,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}. -787 +857 [Anything] @@ -14328,7 +14326,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}. -790 +860 [Anything] @@ -14345,7 +14343,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. -792 +862 [Selection arithmetic|harmonic|geometric|maximum composition ] @@ -14364,7 +14362,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}. -547 +617 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -14381,7 +14379,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: []. -545 +615 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -14398,7 +14396,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}. -543 +613 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -14415,7 +14413,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}. -544 +614 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -14432,7 +14430,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}. -542 +612 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -14449,7 +14447,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}. -546 +616 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -14466,7 +14464,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}. -549 +619 [Anything] @@ -14483,7 +14481,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}. -548 +618 [Anything] @@ -14500,7 +14498,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. -550 +620 [Selection arithmetic|harmonic|geometric|maximum composition ] @@ -14519,7 +14517,7 @@ When more than one compositional field is present at a point with different visc Dissipation number. Pick 0.0 for incompressible computations. -553 +623 [Double 0...MAX_DOUBLE (inclusive)] @@ -14536,7 +14534,7 @@ Dissipation number. Pick 0.0 for incompressible computations. Rayleigh number Ra -552 +622 [Double 0...MAX_DOUBLE (inclusive)] @@ -14553,7 +14551,7 @@ Rayleigh number Ra Reference density $\rho_0$. Units: \si{\kilogram\per\meter\cubed}. -551 +621 [Double 0...MAX_DOUBLE (inclusive)] @@ -14570,7 +14568,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}. -555 +625 [Double 0...MAX_DOUBLE (inclusive)] @@ -14587,7 +14585,7 @@ false Whether to use the TALA instead of the ALA approximation. -558 +628 [Bool] @@ -14604,7 +14602,7 @@ Whether to use the TALA instead of the ALA approximation. Exponential depth prefactor for viscosity. -557 +627 [Double 0...MAX_DOUBLE (inclusive)] @@ -14621,7 +14619,7 @@ Exponential depth prefactor for viscosity. Exponential temperature prefactor for viscosity. -556 +626 [Double 0...MAX_DOUBLE (inclusive)] @@ -14638,7 +14636,7 @@ Exponential temperature prefactor for viscosity. Grueneisen parameter -554 +624 [Double 0...MAX_DOUBLE (inclusive)] @@ -14657,7 +14655,7 @@ Grueneisen parameter The value of the maximum pressure used to query PerpleX. Units: \si{\pascal}. -565 +635 [Double 0...MAX_DOUBLE (inclusive)] @@ -14674,7 +14672,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}. -563 +633 [Double 0...MAX_DOUBLE (inclusive)] @@ -14691,7 +14689,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}. -564 +634 [Double 0...MAX_DOUBLE (inclusive)] @@ -14708,7 +14706,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}. -562 +632 [Double 0...MAX_DOUBLE (inclusive)] @@ -14725,7 +14723,7 @@ rock.dat The name of the PerpleX input file (should end with .dat). -559 +629 [Anything] @@ -14742,7 +14740,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}. -561 +631 [Double 0...MAX_DOUBLE (inclusive)] @@ -14759,7 +14757,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}. -560 +630 [Double 0...MAX_DOUBLE (inclusive)] @@ -14778,7 +14776,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. -566 +636 [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 ] @@ -14794,7 +14792,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.) -569 +639 [Anything] @@ -14813,7 +14811,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. -568 +638 [Anything] @@ -14830,7 +14828,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. -567 +637 [Anything] @@ -14847,7 +14845,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.) -572 +642 [Anything] @@ -14866,7 +14864,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. -571 +641 [Anything] @@ -14883,7 +14881,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. -570 +640 [Anything] @@ -14903,7 +14901,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. -600 +670 [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 ] @@ -14920,7 +14918,7 @@ The name of a material model incorporating the addition of fluids. Valid values The porosity dependence of the viscosity. Units: dimensionless. -606 +676 [Double 0...MAX_DOUBLE (inclusive)] @@ -14937,7 +14935,7 @@ The porosity dependence of the viscosity. Units: dimensionless. The value of the compressibility of the fluid. Units: \si{\per\pascal}. -608 +678 [Double 0...MAX_DOUBLE (inclusive)] @@ -14956,7 +14954,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. -609 +679 [Double 0...MAX_DOUBLE (inclusive)] @@ -14973,7 +14971,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. -614 +684 [Selection no reaction|zero solubility|tian approximation|katz2003 ] @@ -14990,7 +14988,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}. -604 +674 [Double 0...MAX_DOUBLE (inclusive)] @@ -15007,7 +15005,7 @@ Upper cutoff for the compaction viscosity. Units: \si{\pascal\second}. The maximum allowed weight percent that the sediment composition can hold. -611 +681 [Double 0...MAX_DOUBLE (inclusive)] @@ -15024,7 +15022,7 @@ The maximum allowed weight percent that the sediment composition can hold. The maximum allowed weight percent that the sediment composition can hold. -612 +682 [Double 0...MAX_DOUBLE (inclusive)] @@ -15041,7 +15039,7 @@ The maximum allowed weight percent that the sediment composition can hold. The maximum allowed weight percent that the sediment composition can hold. -613 +683 [Double 0...MAX_DOUBLE (inclusive)] @@ -15058,7 +15056,7 @@ The maximum allowed weight percent that the sediment composition can hold. The maximum allowed weight percent that the sediment composition can hold. -610 +680 [Double 0...MAX_DOUBLE (inclusive)] @@ -15075,7 +15073,7 @@ The maximum allowed weight percent that the sediment composition can hold. Lower cutoff for the compaction viscosity. Units: \si{\pascal\second}. -603 +673 [Double 0...MAX_DOUBLE (inclusive)] @@ -15092,7 +15090,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}. -601 +671 [Double 0...MAX_DOUBLE (inclusive)] @@ -15109,7 +15107,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}. -605 +675 [Double 0...MAX_DOUBLE (inclusive)] @@ -15126,7 +15124,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}. -607 +677 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -15143,7 +15141,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}. -615 +685 [Double 0...MAX_DOUBLE (inclusive)] @@ -15160,7 +15158,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. -602 +672 [Double 0...MAX_DOUBLE (inclusive)] @@ -15178,7 +15176,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}. -573 +643 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -15195,7 +15193,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}. -574 +644 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -15212,7 +15210,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}. -575 +645 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -15229,7 +15227,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}. -576 +646 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -15246,7 +15244,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}. -577 +647 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -15263,7 +15261,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}. -578 +648 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -15280,7 +15278,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}. -579 +649 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -15297,7 +15295,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}. -580 +650 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -15314,7 +15312,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}. -581 +651 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -15331,7 +15329,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}. -598 +668 [Double 0...MAX_DOUBLE (inclusive)] @@ -15348,7 +15346,7 @@ The solidus temperature change for a depletion of 100\%. For positive values, th The porosity dependence of the viscosity. Units: dimensionless. -590 +660 [Double 0...MAX_DOUBLE (inclusive)] @@ -15365,7 +15363,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. -596 +666 [Double 0...MAX_DOUBLE (inclusive)] @@ -15382,7 +15380,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. -585 +655 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -15399,7 +15397,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. -594 +664 [Double 0...MAX_DOUBLE (inclusive)] @@ -15416,7 +15414,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}. -593 +663 [Double 0...MAX_DOUBLE (inclusive)] @@ -15433,7 +15431,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}. -592 +662 [Double 0...MAX_DOUBLE (inclusive)] @@ -15452,7 +15450,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. -597 +667 [Double 0...MAX_DOUBLE (inclusive)] @@ -15469,7 +15467,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}. -586 +656 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -15486,7 +15484,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}. -588 +658 [Double 0...MAX_DOUBLE (inclusive)] @@ -15503,7 +15501,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}. -587 +657 [Double 0...MAX_DOUBLE (inclusive)] @@ -15520,7 +15518,7 @@ Reference density of the melt/fluid$\rho_{f,0}$. Units: \si{\kilogram\per\meter\ The value of the constant melt viscosity $\viscosity_fluid$. Units: \si{\pascal\second}. -589 +659 [Double 0...MAX_DOUBLE (inclusive)] @@ -15537,7 +15535,7 @@ The value of the constant melt viscosity $\viscosity_fluid$. Units: \si{\pascal\ Reference permeability of the solid host rock.Units: \si{\meter\squared}. -599 +669 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -15554,7 +15552,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. -591 +661 [Double 0...MAX_DOUBLE (inclusive)] @@ -15573,7 +15571,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. -595 +665 [Bool] @@ -15590,7 +15588,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. -584 +654 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -15607,7 +15605,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. -582 +652 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -15624,7 +15622,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}. -583 +653 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -15644,7 +15642,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. -616 +686 [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 ] @@ -15661,7 +15659,7 @@ $ASPECT_SOURCE_DIR/data/initial-temperature/lithosphere-mask/ The path to the LAB depth data file -620 +690 [DirectoryName] @@ -15678,7 +15676,7 @@ Value Method that is used to specify the depth of the lithosphere-asthenosphere boundary. -618 +688 [Selection File|Value ] @@ -15695,7 +15693,7 @@ LAB_CAM2016.txt File from which the lithosphere-asthenosphere boundary depth data is read. -621 +691 [FileName (Type: input)] @@ -15712,7 +15710,7 @@ File from which the lithosphere-asthenosphere boundary depth data is read. The viscosity within lithosphere, applied abovethe maximum lithosphere depth. -617 +687 [Double 0...MAX_DOUBLE (inclusive)] @@ -15729,7 +15727,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. -619 +689 [Double 0...MAX_DOUBLE (inclusive)] @@ -15748,7 +15746,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}. -400 +470 [Double 0...MAX_DOUBLE (inclusive)] @@ -15765,7 +15763,7 @@ The value of the reference compressibility. Units: \si{\per\pascal}. Reference density $\rho_0$. Units: \si{\kilogram\per\meter\cubed}. -396 +466 [Double 0...MAX_DOUBLE (inclusive)] @@ -15782,7 +15780,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}. -398 +468 [Double 0...MAX_DOUBLE (inclusive)] @@ -15799,7 +15797,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}. -397 +467 [Double 0...MAX_DOUBLE (inclusive)] @@ -15816,7 +15814,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}. -399 +469 [Double 0...MAX_DOUBLE (inclusive)] @@ -15833,7 +15831,7 @@ The value of the thermal expansion coefficient $\alpha$. Units: \si{\per\kelvin} The value of the viscosity $\eta$. Units: \si{\pascal\second}. -401 +471 [Double 0...MAX_DOUBLE (inclusive)] @@ -15852,7 +15850,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. -391 +461 [Double 0...MAX_DOUBLE (inclusive)] @@ -15869,7 +15867,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. -388 +458 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -15886,7 +15884,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. -393 +463 [Double 0...MAX_DOUBLE (inclusive)] @@ -15903,7 +15901,7 @@ The maximum value of the viscosity prefactor associated with temperature depende The minimum value of the viscosity prefactor associated with temperature dependence. -394 +464 [Double 0...MAX_DOUBLE (inclusive)] @@ -15920,7 +15918,7 @@ The minimum value of the viscosity prefactor associated with temperature depende Reference density $\rho_0$. Units: \si{\kilogram\per\meter\cubed}. -384 +454 [Double 0...MAX_DOUBLE (inclusive)] @@ -15937,7 +15935,7 @@ Reference density $\rho_0$. Units: \si{\kilogram\per\meter\cubed}. The value of the specific heat $C_p$. Units: \si{\joule\per\kelvin\per\kilogram}. -386 +456 [Double 0...MAX_DOUBLE (inclusive)] @@ -15954,7 +15952,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}. -389 +459 [Double 0...MAX_DOUBLE (inclusive)] @@ -15971,7 +15969,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}. -395 +465 [Double 0...MAX_DOUBLE (inclusive)] @@ -15988,7 +15986,7 @@ The value of the thermal conductivity $k$. Units: \si{\watt\per\meter\per\kelvin The value of the thermal expansion coefficient $\alpha$. Units: \si{\per\kelvin}. -387 +457 [Double 0...MAX_DOUBLE (inclusive)] @@ -16005,7 +16003,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. -392 +462 [Double 0...MAX_DOUBLE (inclusive)] @@ -16022,7 +16020,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}. -390 +460 [Double 0...MAX_DOUBLE (inclusive)] @@ -16041,7 +16039,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}. -402 +472 [Double 0...MAX_DOUBLE (inclusive)] @@ -16058,7 +16056,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}. -404 +474 [Double 0...MAX_DOUBLE (inclusive)] @@ -16075,7 +16073,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}. -403 +473 [Double 0...MAX_DOUBLE (inclusive)] @@ -16092,7 +16090,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}. -406 +476 [Double 0...MAX_DOUBLE (inclusive)] @@ -16109,7 +16107,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}. -405 +475 [Double 0...MAX_DOUBLE (inclusive)] @@ -16126,7 +16124,7 @@ The value of the thermal expansion coefficient $\alpha$. Units: \si{\per\kelvin} The value of the viscosity $\eta$. Units: \si{\pascal\second}. -407 +477 [Double 0...MAX_DOUBLE (inclusive)] @@ -16145,7 +16143,7 @@ true Whether to use bilinear interpolation to compute material properties (slower but more accurate). -431 +501 [Bool] @@ -16162,7 +16160,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}. -416 +486 [Anything] @@ -16179,7 +16177,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. -427 +497 [DirectoryName] @@ -16192,7 +16190,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). -429 +499 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -16209,7 +16207,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. -432 +502 [Bool] @@ -16226,7 +16224,7 @@ temp-viscosity-prefactor.txt The file name of the lateral viscosity data. -410 +480 [Anything] @@ -16243,7 +16241,7 @@ perplex The material file format to be read in the property tables. -430 +500 [Selection perplex|hefesto ] @@ -16260,7 +16258,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. -428 +498 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -16277,7 +16275,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. -433 +503 [Integer range 1...2147483647 (inclusive)] @@ -16294,7 +16292,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. -415 +485 [Double 0...MAX_DOUBLE (inclusive)] @@ -16311,7 +16309,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. -426 +496 [Double 0...MAX_DOUBLE (inclusive)] @@ -16328,7 +16326,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. -414 +484 [Double 0...MAX_DOUBLE (inclusive)] @@ -16345,7 +16343,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. -413 +483 [Double 0...MAX_DOUBLE (inclusive)] @@ -16362,7 +16360,7 @@ The minimum viscosity that is allowed in the viscosity calculation. Smaller valu Number of bands to compute laterally averaged temperature within. -412 +482 [Integer range 1...2147483647 (inclusive)] @@ -16379,7 +16377,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}. -422 +492 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -16396,7 +16394,7 @@ radial-visc.txt The file name of the radial viscosity data. -409 +479 [Anything] @@ -16413,7 +16411,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}. -423 +493 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -16430,7 +16428,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} -421 +491 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -16447,7 +16445,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. -425 +495 [List of <[Double 0...1 (inclusive)]> of length 0...4294967295 (inclusive)] @@ -16464,7 +16462,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}. -418 +488 [Double 0...MAX_DOUBLE (inclusive)] @@ -16481,7 +16479,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. -424 +494 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -16498,7 +16496,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). -419 +489 [Selection constant|p-T-dependent ] @@ -16515,7 +16513,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}. -420 +490 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -16532,7 +16530,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. -411 +481 [Bool] @@ -16549,7 +16547,7 @@ harmonic Method to average viscosities over multiple compositional fields. One of arithmetic, harmonic, geometric or maximum composition. -417 +487 [Selection arithmetic|harmonic|geometric|maximum composition ] @@ -16568,7 +16566,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}. -506 +576 [Anything] @@ -16585,7 +16583,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}. -489 +559 [Anything] @@ -16602,7 +16600,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}. -494 +564 [Anything] @@ -16619,7 +16617,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}. -507 +577 [Anything] @@ -16636,7 +16634,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}. -490 +560 [Anything] @@ -16653,7 +16651,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}. -495 +565 [Anything] @@ -16670,7 +16668,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}. -526 +596 [Double 0...MAX_DOUBLE (inclusive)] @@ -16687,7 +16685,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. -483 +553 [Bool] @@ -16704,7 +16702,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. -520 +590 [Anything] @@ -16721,7 +16719,7 @@ false Whether the cutoff stresses for Peierls creep are used as the minimum stresses in the Peierls rheology -513 +583 [Bool] @@ -16738,7 +16736,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. -450 +520 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -16755,7 +16753,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}. -521 +591 [Anything] @@ -16772,7 +16770,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. -515 +585 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -16789,7 +16787,7 @@ List of constant viscosity prefactors (i.e., multiplicative factors) for backgro List of the Stress thresholds below which the strain rate is solved for as a quadratic function of stress to aid with convergence when stress exponent n=0. Units: \si{\pascal} -512 +582 [Anything] @@ -16806,7 +16804,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. -528 +598 [Bool] @@ -16823,7 +16821,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. -438 +508 [Bool] @@ -16840,7 +16838,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}. -444 +514 [Anything] @@ -16857,7 +16855,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}. -465 +535 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -16874,7 +16872,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}. -464 +534 [Double 0...MAX_DOUBLE (inclusive)] @@ -16891,7 +16889,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. -466 +536 [Double 0...MAX_DOUBLE (inclusive)] @@ -16908,7 +16906,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} -475 +545 [Double 0...MAX_DOUBLE (inclusive)] @@ -16925,7 +16923,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. -471 +541 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -16942,7 +16940,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. -449 +519 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -16959,7 +16957,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. -453 +523 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -16976,7 +16974,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. -473 +543 [Double 0...MAX_DOUBLE (inclusive)] @@ -16999,7 +16997,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. -463 +533 [Selection none|dynamic friction|function ] @@ -17016,7 +17014,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. -451 +521 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -17033,7 +17031,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}. -491 +561 [Double 0...MAX_DOUBLE (inclusive)] @@ -17050,7 +17048,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. -488 +558 [Anything] @@ -17067,7 +17065,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}. -446 +516 [Anything] @@ -17084,7 +17082,7 @@ false Whether to include Peierls creep in the rheological formulation. -514 +584 [Bool] @@ -17101,7 +17099,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}. -457 +527 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -17118,7 +17116,7 @@ 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}. -456 +526 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -17135,7 +17133,7 @@ List of lower temperature for onset of strain weakening for background material Maximum number of iterations to find the correct Peierls strain rate. -503 +573 [Integer range 0...2147483647 (inclusive)] @@ -17152,7 +17150,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). -479 +549 [Anything] @@ -17169,7 +17167,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}. -522 +592 [Double 0...MAX_DOUBLE (inclusive)] @@ -17186,7 +17184,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} %. -516 +586 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -17203,7 +17201,7 @@ The minimum water content for the HK04 olivine hydration viscosity prefactor sch Stabilizes strain dependent viscosity. Units: \si{\per\second}. -476 +546 [Double 0...MAX_DOUBLE (inclusive)] @@ -17220,7 +17218,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). -478 +548 [Anything] @@ -17237,7 +17235,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. -501 +571 [Selection viscosity approximation|exact ] @@ -17254,7 +17252,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 -509 +579 [Anything] @@ -17271,7 +17269,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 -510 +580 [Anything] @@ -17288,7 +17286,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 -511 +581 [Anything] @@ -17305,7 +17303,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. -502 +572 [Double 0...MAX_DOUBLE (inclusive)] @@ -17322,7 +17320,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} -508 +578 [Anything] @@ -17335,7 +17333,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}. -442 +512 [Anything] @@ -17348,7 +17346,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}. -434 +504 [Anything] @@ -17361,7 +17359,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}. -437 +507 [Anything] @@ -17374,7 +17372,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}. -436 +506 [Anything] @@ -17391,7 +17389,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}. -441 +511 [Anything] @@ -17408,7 +17406,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}. -440 +510 [Anything] @@ -17421,7 +17419,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}. -439 +509 [Anything] @@ -17434,7 +17432,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}. -435 +505 [Anything] @@ -17451,7 +17449,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} -524 +594 [Double 0...MAX_DOUBLE (inclusive)] @@ -17468,7 +17466,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. -454 +524 [List of <[Double 0...1 (inclusive)]> of length 0...4294967295 (inclusive)] @@ -17485,7 +17483,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 -497 +567 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -17502,7 +17500,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} -504 +574 [Anything] @@ -17519,7 +17517,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}. -486 +556 [Anything] @@ -17536,7 +17534,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}. -492 +562 [Anything] @@ -17553,7 +17551,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 -498 +568 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -17570,7 +17568,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 -500 +570 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -17587,7 +17585,7 @@ A reference pressure in the viscosity approximation which specifies where the FK Reference strain rate for first time step. Units: \si{\per\second}. -477 +547 [Double 0...MAX_DOUBLE (inclusive)] @@ -17604,7 +17602,7 @@ Reference strain rate for first time step. Units: \si{\per\second}. The reference temperature $T_0$. Units: \si{\kelvin}. -443 +513 [Double 0...MAX_DOUBLE (inclusive)] @@ -17621,7 +17619,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 -499 +569 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -17646,7 +17644,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. -474 +544 [Double 1...MAX_DOUBLE (inclusive)] @@ -17663,7 +17661,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. -448 +518 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -17680,7 +17678,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. -452 +522 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -17701,7 +17699,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 -460 +530 [Selection no healing|temperature dependent ] @@ -17718,7 +17716,7 @@ Whether to apply strain healing to plastic yielding and viscosity terms, and if Prefactor for temperature dependent strain healing. Units: None -462 +532 [Double 0...MAX_DOUBLE (inclusive)] @@ -17735,7 +17733,7 @@ Prefactor for temperature dependent strain healing. Units: None Recovery rate prefactor for temperature dependent strain healing. Units: $1/s$ -461 +531 [Double 0...MAX_DOUBLE (inclusive)] @@ -17770,7 +17768,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. -447 +517 [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 ] @@ -17787,7 +17785,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. -505 +575 [Anything] @@ -17804,7 +17802,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. -487 +557 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -17821,7 +17819,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. -493 +563 [Anything] @@ -17838,7 +17836,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. -525 +595 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -17855,7 +17853,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}. -529 +599 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -17872,7 +17870,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}. -527 +597 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -17889,7 +17887,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}. -445 +515 [Anything] @@ -17906,7 +17904,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}. -458 +528 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -17923,7 +17921,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}. -459 +529 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -17940,7 +17938,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. -484 +554 [Bool] @@ -17957,7 +17955,7 @@ 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. -485 +555 [Bool] @@ -17974,7 +17972,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'. -472 +542 [Selection true|false|unspecified ] @@ -17991,7 +17989,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. -523 +593 [Bool] @@ -18008,7 +18006,7 @@ false Whether viscous strain softening factor depends on temperature -455 +525 [Bool] @@ -18025,7 +18023,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. -480 +550 [Selection arithmetic|harmonic|geometric|maximum composition ] @@ -18042,7 +18040,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. -519 +589 [Selection none|HK04 olivine hydration ] @@ -18059,7 +18057,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 -496 +566 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -18076,7 +18074,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 -481 +551 [Selection diffusion|dislocation|frank kamenetskii|composite ] @@ -18093,7 +18091,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. -517 +587 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -18110,7 +18108,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. -518 +588 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -18127,7 +18125,7 @@ drucker Select what type of yield mechanism to use between Drucker Prager and stress limiter options. -482 +552 [Selection drucker|limiter ] @@ -18145,7 +18143,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. -467 +537 [Selection cartesian|spherical|depth ] @@ -18160,7 +18158,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.) -470 +540 [Anything] @@ -18179,7 +18177,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. -469 +539 [Anything] @@ -18196,7 +18194,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. -468 +538 [Anything] @@ -18216,7 +18214,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}. -531 +601 [Anything] @@ -18233,7 +18231,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} -538 +608 [Double 0...MAX_DOUBLE (inclusive)] @@ -18250,7 +18248,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. -534 +604 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -18267,7 +18265,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. -536 +606 [Double 0...MAX_DOUBLE (inclusive)] @@ -18284,7 +18282,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}. -533 +603 [Anything] @@ -18301,7 +18299,7 @@ List of specific heats $C_p$ for background mantle and compositional fields,for The reference temperature $T_0$. Units: \si{\kelvin}. -530 +600 [Double 0...MAX_DOUBLE (inclusive)] @@ -18326,7 +18324,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. -537 +607 [Double 1...MAX_DOUBLE (inclusive)] @@ -18343,7 +18341,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}. -540 +610 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -18360,7 +18358,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}. -532 +602 [Anything] @@ -18377,7 +18375,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'. -535 +605 [Selection true|false|unspecified ] @@ -18394,7 +18392,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}. -539 +609 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -18411,7 +18409,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. -541 +611 [Selection arithmetic|harmonic|geometric|maximum composition ] @@ -18431,7 +18429,7 @@ true Whether to cell-wise average the material properties that are used to compute the melt velocity or not. The melt velocity is computed as the sum of the solid velocity and the phase separation flux $ - K_D / \phi (\nabla p_f - \rho_f \mathbf g)$. If this parameter is set to true, $K_D$ and $\phi$ will be averaged cell-wise in the computation of the phase separation flux. This is useful because in some models the melt velocity can have spikes close to the interface between regions of melt and no melt, as both $K_D$ and $\phi$ go to zero for vanishing melt fraction. As the melt velocity is used for computing the time step size, and in models that use heat transport by melt or shear heating of melt, setting this parameter to true can speed up the model and make it mode stable. In computations where accuracy and convergence behavior of the melt velocity is important (like in benchmark cases with an analytical solution), this parameter should probably be set to 'false'. -107 +108 [Bool] @@ -18448,7 +18446,7 @@ false Whether to use a porosity weighted average of the melt and solid velocity to advect heat in the temperature equation or not. If this is set to true, additional terms are assembled on the left-hand side of the temperature advection equation. Only used if Include melt transport is true. If this is set to false, only the solid velocity is used (as in models without melt migration). -105 +106 [Bool] @@ -18465,7 +18463,7 @@ false Whether to include the transport of melt into the model or not. If this is set to true, two additional pressures (the fluid pressure and the compaction pressure) will be added to the finite element. Including melt transport in the simulation also requires that there is one compositional field that has the name `porosity'. This field will be used for computing the additional pressures and the melt velocity, and has a different advection equation than other compositional fields, as it is effectively advected with the melt velocity. -53 +54 [Bool] @@ -18482,7 +18480,7 @@ Whether to include the transport of melt into the model or not. If this is set t The factor by how much the Darcy coefficient K\_D in a cell can be smaller than the reference Darcy coefficient for this cell still to be considered a melt cell (for which the melt transport equations are solved). For smaller Darcy coefficients, the Stokes equations (without melt) are solved instead. Only used if ``Include melt transport'' is true. -104 +105 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -18499,7 +18497,7 @@ true Whether to use a discontinuous element for the compaction pressure or not. From our preliminary tests, continuous elements seem to work better in models where the porosity is > 0 everywhere in the domain, and discontinuous elements work better in models where in parts of the domain the porosity = 0. -106 +107 [Bool] @@ -18516,7 +18514,7 @@ A comma separated list of names denoting those boundaries where there the mesh 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. -122 +123 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -18543,7 +18541,7 @@ This surface velocity is used to deform the surface and as a boundary condition `free surface': A plugin that computes the deformation of surface vertices according to the solution of the flow problem. In particular this means if the surface of the domain is left open to flow, this flow will carry the mesh with it. The implementation was described in \cite{rose_freesurface}, with the stabilization of the free surface originally described in \cite{kaus:etal:2010}. -123 +124 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -18561,7 +18559,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. -131 +132 [DirectoryName] @@ -18578,7 +18576,7 @@ box_3d_%s.0.txt The file name of the model data. -132 +133 [Anything] @@ -18595,7 +18593,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. -133 +134 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -18612,7 +18610,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.) -130 +131 [Anything] @@ -18631,7 +18629,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. -129 +130 [Anything] @@ -18648,7 +18646,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. -128 +129 [Anything] @@ -18667,7 +18665,7 @@ The names of the variables as they will be used in the function, separated by co The hillslope transport coefficient $\kappa$ used to diffuse the free surface, either as a stabilization step or to mimic erosional and depositional processes. Units: $\si{m^2/s}$. -125 +126 [Double 0...MAX_DOUBLE (inclusive)] @@ -18684,7 +18682,7 @@ The hillslope transport coefficient $\kappa$ used to diffuse the free surface, e The number of time steps between each application of diffusion. -126 +127 [Integer range 0...2147483647 (inclusive)] @@ -18703,7 +18701,7 @@ The number of time steps between each application of diffusion. Theta parameter described in \cite{kaus:etal:2010}. An unstabilized free surface can overshoot its equilibrium position quite easily and generate unphysical results. One solution is to use a quasi-implicit correction term to the forces near the free surface. This parameter describes how much the free surface is stabilized with this term, where zero is no stabilization, and one is fully implicit. -124 +125 [Double 0...1 (inclusive)] @@ -18720,7 +18718,7 @@ normal After each time step the free surface must be advected in the direction of the velocity field. Mass conservation requires that the mesh velocity is in the normal direction of the surface. However, for steep topography or large curvature, advection in the normal direction can become ill-conditioned, and instabilities in the mesh can form. Projection of the mesh velocity onto the local vertical direction can preserve the mesh quality better, but at the cost of slightly poorer mass conservation of the domain. -127 +128 [Selection normal|vertical ] @@ -18740,7 +18738,7 @@ false Use fraction of the total number of cells instead of fraction of the total error as the limit for refinement and coarsening. -62 +63 [Bool] @@ -18753,7 +18751,7 @@ Use fraction of the total number of cells instead of fraction of the total error A list of times so that if the end time of a time step is beyond this time, an additional round of mesh refinement is triggered. This is mostly useful to make sure we can get through the initial transient phase of a simulation on a relatively coarse mesh, and then refine again when we are in a time range that we are interested in and where we would like to use a finer mesh. Units: Each element of the list has units years if the 'Use years in output instead of seconds' parameter is set; seconds otherwise. -64 +65 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -18770,7 +18768,7 @@ A list of times so that if the end time of a time step is beyond this time, an a Cells are sorted from largest to smallest by their total error (determined by the Strategy). Then the cells with the smallest error (bottom of this sorted list) that account for the given fraction of the error are coarsened. -61 +62 [Double 0...1 (inclusive)] @@ -18787,7 +18785,7 @@ Cells are sorted from largest to smallest by their total error (determined by th The number of adaptive refinement steps performed after initial global refinement but while still within the first time step. These refinement steps (n) are added to the value for initial global refinement (m) so that the final mesh has cells that are at most on refinement level $n+m$. -58 +59 [Integer range 0...2147483647 (inclusive)] @@ -18806,7 +18804,7 @@ The number of global refinement steps performed on the initial coarse mesh, befo Note that it is possible to supply conflicting refinement and coarsening settings, such as an 'Initial global refinement' of 4 and a 'Maximum refinement function' strategy that limits the refinement locally to 2. In this case, the tagging strategies such as the 'Maximum refinement function' will remove refinement flags in each initial global refinement step, such that the resulting mesh is not necessarily uniform or of the level given by the 'Initial global refinement' parameter. -57 +58 [Integer range 0...2147483647 (inclusive)] @@ -18823,7 +18821,7 @@ Note that it is possible to supply conflicting refinement and coarsening setting The minimum refinement level each cell should have, and that can not be exceeded by coarsening. Should not be higher than the 'Initial global refinement' parameter. -63 +64 [Integer range 0...2147483647 (inclusive)] @@ -18840,7 +18838,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. -337 +407 [Bool] @@ -18862,7 +18860,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. -339 +409 [Selection plus|max ] @@ -18881,7 +18879,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. -338 +408 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -18898,7 +18896,7 @@ If the list of indicators given in this parameter is empty, then this indicates Cells are sorted from largest to smallest by their total error (determined by the Strategy). Then the cells with the largest error (top of this sorted list) that account for given fraction of the error are refined. -60 +61 [Double 0...1 (inclusive)] @@ -18915,7 +18913,7 @@ false Whether or not the postprocessors should be executed after each of the initial adaptive refinement cycles that are run at the start of the simulation. This is useful for plotting/analyzing how the mesh refinement parameters are working for a particular model. -65 +66 [Bool] @@ -18932,7 +18930,7 @@ false Whether or not the initial conditions should be set up during the adaptive refinement cycles that are run at the start of the simulation. -67 +68 [Bool] @@ -18949,7 +18947,7 @@ false Whether or not solvers should be executed during the initial adaptive refinement cycles that are run at the start of the simulation. -66 +67 [Bool] @@ -19048,7 +19046,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. -336 +406 [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 ] @@ -19065,7 +19063,7 @@ For complex equations such as those we solve here, this observation may not be s The number of time steps after which the mesh is to be adapted again based on computed error indicators. If 0 then the mesh will never be changed. -59 +60 [Integer range 0...2147483647 (inclusive)] @@ -19081,7 +19079,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. -357 +427 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -19098,7 +19096,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. -356 +426 [Double 0...MAX_DOUBLE (inclusive)] @@ -19115,7 +19113,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. -358 +428 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -19134,7 +19132,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. -359 +429 [Double 0...MAX_DOUBLE (inclusive)] @@ -19151,7 +19149,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. -347 +417 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -19168,7 +19166,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. -348 +418 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -19185,7 +19183,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. -349 +419 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -19200,7 +19198,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. -350 +420 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -19217,7 +19215,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. -351 +421 [Anything] @@ -19236,7 +19234,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. -352 +422 [Selection depth|cartesian|spherical ] @@ -19251,7 +19249,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.) -355 +425 [Anything] @@ -19270,7 +19268,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. -354 +424 [Anything] @@ -19287,7 +19285,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. -353 +423 [Anything] @@ -19306,7 +19304,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. -341 +411 [Selection depth|cartesian|spherical ] @@ -19321,7 +19319,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.) -344 +414 [Anything] @@ -19340,7 +19338,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. -343 +413 [Anything] @@ -19357,7 +19355,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. -342 +412 [Anything] @@ -19376,7 +19374,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. -346 +416 [Selection negative only|positive only|absolute value ] @@ -19393,7 +19391,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} -345 +415 [Double 0...MAX_DOUBLE (inclusive)] @@ -19412,7 +19410,7 @@ false If true, then explicitly coarsen any cells not neighboring the VolumeOfFluid interface. -340 +410 [Bool] @@ -19437,7 +19435,7 @@ The ``angular momentum'' option removes a rotation such that the net a Note that while more than one operation can be selected it only makes sense to pick one rotational and one translational operation. -56 +57 [MultipleSelection net rotation|angular momentum|net surface rotation|net translation|linear momentum|net x translation|net y translation|net z translation|linear x momentum|linear y momentum|linear z momentum ] @@ -19456,7 +19454,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. -246 +247 [Bool] @@ -19485,7 +19483,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. -239 +240 [Selection euler|rk2|rk4 ] @@ -19514,7 +19512,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. -241 +242 [Selection bilinear least squares|cell average|distance weighted average|harmonic average|nearest neighbor|quadratic least squares ] @@ -19567,7 +19565,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. -249 +250 [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 ] @@ -19584,7 +19582,7 @@ repartition Strategy that is used to balance the computational load across processors for adaptive meshes. -203 +204 [MultipleSelection none|remove particles|add particles|remove and add particles|repartition ] @@ -19601,7 +19599,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. -205 +206 [Integer range 0...2147483647 (inclusive)] @@ -19618,12 +19616,29 @@ 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. -204 +205 [Integer range 0...2147483647 (inclusive)] + + +1 + + +1 + + +The number of particle systems to be created. The maximum number of particle systems is set by the CMake variable `ASPECT_MAX_NUM_PARTICLE_SYSTEMS` and is by default 2. + + +22 + + +[Integer range 0...2 (inclusive)] + + random uniform @@ -19649,7 +19664,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. -208 +209 [Selection ascii file|probability density function|quadrature points|random uniform|reference cell|uniform box|uniform radial ] @@ -19666,7 +19681,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. -206 +207 [Integer range 0...2147483647 (inclusive)] @@ -19683,7 +19698,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'. -207 +208 [Bool] @@ -19701,7 +19716,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. -252 +253 [Double 0...MAX_DOUBLE (inclusive)] @@ -19718,7 +19733,1258 @@ 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. -251 +252 + + +[Integer range 0...2147483647 (inclusive)] + + + + + + +Spin tensor + + +Spin tensor + + +Options: Spin tensor + + +259 + + +[List of <[Anything]> of length 0...4294967295 (inclusive)] + + + + +50 + + +50 + + +The number of grains of each different mineral each particle contains. + + +255 + + +[Integer range 1...2147483647 (inclusive)] + + + + +100 + + +100 + + +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. + + +258 + + +[Integer range 0...2147483647 (inclusive)] + + + + +Backward Euler + + +Backward Euler + + +Options: Forward Euler, Backward Euler + + +256 + + +[Anything] + + + + +1e-10 + + +1e-10 + + +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. + + +257 + + +[Double 0...MAX_DOUBLE (inclusive)] + + + + +1 + + +1 + + +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. + + +254 + + +[Integer range 0...2147483647 (inclusive)] + + + + + +1.5 + + +1.5 + + +This is exponent p as defined in equation 11 of Kaminski et al., 2004. + + +266 + + +[Double 0...MAX_DOUBLE (inclusive)] + + + + +50 + + +50 + + +The dimensionless intrinsic grain boundary mobility for both olivine and enstatite. + + +263 + + +[Double 0...MAX_DOUBLE (inclusive)] + + + + +5 + + +5 + + +This is the dimensionless nucleation rate as defined in equation 8 of Kaminski et al., 2004. + + +267 + + +[Double 0...MAX_DOUBLE (inclusive)] + + + + +3.5 + + +3.5 + + +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. + + +265 + + +[Double 0...MAX_DOUBLE (inclusive)] + + + + +0.3 + + +0.3 + + +The Dimensionless Grain Boundary Sliding (GBS) threshold. This is a grain size threshold below which grain deform by GBS and become strain-free grains. + + +268 + + +[Double 0...MAX_DOUBLE (inclusive)] + + + + +0.5, 0.5 + + +0.5, 0.5 + + +The volume fraction for the different minerals. There need to be the same amount of values as there are minerals + + +264 + + +[List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] + + + + + + +Olivine: Karato 2008, Enstatite + + +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). + + +261 + + +[List of <[Anything]> of length 0...4294967295 (inclusive)] + + + + +Uniform grains and random uniform rotations + + +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. + + +260 + + +[Anything] + + + + +0.7, 0.3 + + +0.7, 0.3 + + +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 + + +262 + + +[List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] + + + + + + + + + +Sometimes it is convenient to use symbolic constants in the expression that describes the function, rather than having to use its numeric value everywhere the constant appears. These values can be defined using this parameter, in the form `var1=value1, var2=value2, ...'. + +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.) + + +272 + + +[Anything] + + + + +0 + + +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. + + +271 + + +[Anything] + + + + +1 + + +1 + + +The number of function components where each component is described by a function expression delimited by a ';'. + + +269 + + +[Integer range 0...2147483647 (inclusive)] + + + + +x,y,t + + +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. + + +270 + + +[Anything] + + + + + + + +$ASPECT_SOURCE_DIR/data/particle/generator/ascii/ + + +$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. + + +232 + + +[DirectoryName] + + + + +particle.dat + + +particle.dat + + +The name of the particle file. + + +233 + + +[Anything] + + + + + + + + +Sometimes it is convenient to use symbolic constants in the expression that describes the function, rather than having to use its numeric value everywhere the constant appears. These values can be defined using this parameter, in the form `var1=value1, var2=value2, ...'. + +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.) + + +236 + + +[Anything] + + + + +0 + + +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. + + +235 + + +[Anything] + + + + +1000 + + +1000 + + +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. + + +237 + + +[Double 0...MAX_DOUBLE (inclusive)] + + + + +true + + +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. + + +238 + + +[Bool] + + + + +5432 + + +5432 + + +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. + + +239 + + +[Integer range 0...2147483647 (inclusive)] + + + + +x,y,t + + +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. + + +234 + + +[Anything] + + + + + + +1000 + + +1000 + + +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. + + +210 + + +[Double 0...MAX_DOUBLE (inclusive)] + + + + +true + + +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. + + +211 + + +[Bool] + + + + +5432 + + +5432 + + +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. + + +212 + + +[Integer range 0...2147483647 (inclusive)] + + + + + + +2 + + +2 + + +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. + + +213 + + +[List of <[Integer range 1...2147483647 (inclusive)]> of length 0...4294967295 (inclusive)] + + + + + + +1. + + +1. + + +Maximum x coordinate for the region of particles. + + +216 + + +[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] + + + + +1. + + +1. + + +Maximum y coordinate for the region of particles. + + +218 + + +[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] + + + + +1. + + +1. + + +Maximum z coordinate for the region of particles. + + +220 + + +[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] + + + + +0. + + +0. + + +Minimum x coordinate for the region of particles. + + +215 + + +[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] + + + + +0. + + +0. + + +Minimum y coordinate for the region of particles. + + +217 + + +[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] + + + + +0. + + +0. + + +Minimum z coordinate for the region of particles. + + +219 + + +[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] + + + + +1000 + + +1000 + + +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. + + +214 + + +[Double 0...MAX_DOUBLE (inclusive)] + + + + + + +0. + + +0. + + +x coordinate for the center of the spherical region, where particles are generated. + + +222 + + +[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] + + + + +0. + + +0. + + +y coordinate for the center of the spherical region, where particles are generated. + + +223 + + +[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] + + + + +0. + + +0. + + +z coordinate for the center of the spherical region, where particles are generated. + + +224 + + +[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] + + + + +180. + + +180. + + +Maximum latitude coordinate for the region of particles in degrees. Measured from the center position, and from the north pole. + + +230 + + +[Double 0...180 (inclusive)] + + + + +360. + + +360. + + +Maximum longitude coordinate for the region of particles in degrees. Measured from the center position. + + +228 + + +[Double -180...360 (inclusive)] + + + + +1. + + +1. + + +Maximum radial coordinate for the region of particles. Measured from the center position. + + +226 + + +[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] + + + + +0. + + +0. + + +Minimum latitude coordinate for the region of particles in degrees. Measured from the center position, and from the north pole. + + +229 + + +[Double 0...180 (inclusive)] + + + + +0. + + +0. + + +Minimum longitude coordinate for the region of particles in degrees. Measured from the center position. + + +227 + + +[Double -180...360 (inclusive)] + + + + +0. + + +0. + + +Minimum radial coordinate for the region of particles. Measured from the center position. + + +225 + + +[Double 0...MAX_DOUBLE (inclusive)] + + + + +1000 + + +1000 + + +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. + + +221 + + +[Double 0...MAX_DOUBLE (inclusive)] + + + + +1 + + +1 + + +The number of radial shells of particles that will be generated around the central point. + + +231 + + +[Integer range 1...2147483647 (inclusive)] + + + + + + + + +true + + +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. + + +241 + + +[Bool] + + + + + + + + +false + + +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'. + + +244 + + +[List of <[Bool]> of length 0...4294967295 (inclusive)] + + + + +true + + +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. + + +243 + + +[List of <[Bool]> of length 0...4294967295 (inclusive)] + + + + + + +false + + +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'. + + +249 + + +[List of <[Bool]> of length 0...4294967295 (inclusive)] + + + + +true + + +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. + + +248 + + +[List of <[Bool]> of length 0...4294967295 (inclusive)] + + + + + + + +1e-3 + + +1e-3 + + +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). + + +251 + + +[Double 0...1 (inclusive)] + + + + + + + +false + + +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. + + +316 + + +[Bool] + + + + +rk2 + + +rk2 + + +This parameter is used to decide which method to use to solve the equation that describes the position of particles, i.e., $\frac{d}{dt}\mathbf x_k(t) = \mathbf u(\mathbf x_k(t),t)$, where $k$ is an index that runs over all particles, and $\mathbf u(\mathbf x,t)$ is the velocity field that results from the Stokes equations. + +In practice, the exact velocity $\mathbf u(\mathbf x,t)$ is of course not available, but only a numerical approximation $\mathbf u_h(\mathbf x,t)$. Furthermore, this approximation is only available at discrete time steps, $\mathbf u^n(\mathbf x)=\mathbf u(\mathbf x,t^n)$, and these need to be interpolated between time steps if the integrator for the equation above requires an evaluation at time points between the discrete time steps. If we denote this interpolation in time by $\tilde{\mathbf u}_h(\mathbf x,t)$ where $\tilde{\mathbf u}_h(\mathbf x,t^n)=\mathbf u^n(\mathbf x)$, then the equation the differential equation solver really tries to solve is $\frac{d}{dt}\tilde{\mathbf x}_k(t) = \tilde{\mathbf u}_h(\mathbf x_k(t),t)$. + +As a consequence of these considerations, if you try to assess convergence properties of an ODE integrator -- for example to verify that the RK4 integrator converges with fourth order --, it is important to recall that the integrator may not solve the equation you think it solves. If, for example, we call the numerical solution of the ODE $\tilde{\mathbf x}_{k,h}(t)$, then the error will typically satisfy a relationship like \[ \| \tilde{\mathbf x}_k(T) - \tilde{\mathbf x}_{k,h}(T) \| \le C(T) \Delta t^p\] where $\Delta t$ is the time step and $p$ the convergence order of the method, and $C(T)$ is a (generally unknown) constant that depends on the end time $T$ at which one compares the solutions. On the other hand, an analytically computed trajectory would likely use the \textit{exact} velocity, and one may be tempted to compute $\| \mathbf x_k(T) - \tilde{\mathbf x}_{k,h}(T) \|$, but this quantity will, in the best case, only satisfy an estimate of the form \[ \| \mathbf x_k(T) - \tilde{\mathbf x}_{k,h}(T) \| \le C_1(T) \Delta t^p + C_2(T) \| \mathbf u-\mathbf u_h \| + C_3(T) \| \mathbf u_h-\tilde{\mathbf u}_h \|\] with appropriately chosen norms for the second and third term. These second and third terms typically converge to zero at relatively low rates (compared to the order $p$ of the integrator, which can often be chosen relatively high) in the mesh size $h$ and the time step size $\\Delta t$, limiting the overall accuracy of the ODE integrator. + +Select one of the following models: + +`euler': Explicit Euler scheme integrator, where $y_{n+1} = y_n + \Delta t \, v(y_n)$. This requires only one integration substep per timestep. + +`rk2': Second Order Runge Kutta integrator $y_{n+1} = y_n + \Delta t\, v(t_{n+1/2}, y_{n} + \frac{1}{2} k_1)$ where $k_1 = \Delta t\, v(t_{n}, y_{n})$ + +`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. + + +309 + + +[Selection euler|rk2|rk4 ] + + + + +cell average + + +cell average + + +Select one of the following models: + +`bilinear least squares': Uses linear least squares to obtain the slopes and center of a 2d or 3d plane from the particle positions and a particular property value on those particles. Interpolate this property onto a vector of points. If the limiter is enabled then it will ensure the interpolated properties do not exceed the range of the minimum and maximum of the values of the property on the particles. Note that deal.II must be configured with BLAS and LAPACK to support this operation. + +`cell average': Return the arithmetic average of all particle properties in the given cell, or in the neighboring cells if the given cell is empty. In case the neighboring cells are also empty, and 'Allow cells without particles' is set to true, the interpolator returns 0. Otherwise, an exception is thrown. + +`distance weighted average': Interpolates particle properties onto a vector of points using a distance weighed averaging method. + +`harmonic average': Return the harmonic average of all particle properties in the given cell. If the cell contains no particles, return the harmonic average of the properties in the neighboring cells. In case the neighboring cells are also empty, and 'Allow cells without particles' is set to true, the interpolator returns 0. Otherwise, an exception is thrown. + +`nearest neighbor': Return the properties of the nearest neighboring particle in the current cell, or nearest particle in nearest neighboring cell if current cell is empty. In case the neighboring cells are also empty, and 'Allow cells without particles' is set to true, the interpolator returns 0. Otherwise, an exception is thrown. + +`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. + + +311 + + +[Selection bilinear least squares|cell average|distance weighted average|harmonic average|nearest neighbor|quadratic least squares ] + + + + + + +A comma separated list of particle properties that should be tracked. By default none is selected, which means only position, velocity and id of the particles are output. + +The following properties are available: + +`composition': Implementation of a plugin in which the particle property is defined by the compositional fields in the model. This can be used to track solid compositionevolution over time. + +`cpo bingham average': This is a particle property plugin which computes the Bingham average for the Crystal Preferred Orientation particle property plugin so that it can be visualized. + +`cpo elastic tensor': A plugin in which the particle property tensor is defined as the Voigt average of the elastic tensors of the minerals in the textured rock.Currently only Olivine and Enstatite are supported. + +`crystal preferred orientation': WARNING: all the CPO plugins are a work in progress and not ready for production use yet. See https://github.com/geodynamics/aspect/issues/3885 for current status and alternatives. The plugin manages and computes the evolution of Lattice/Crystal Preferred Orientations (LPO/CPO) on particles. Each ASPECT particle can be assigned many grains. Each grain is assigned a size and a orientation matrix. This allows for CPO evolution tracking with polycrystalline kinematic CrystalPreferredOrientation evolution models such as D-Rex (Kaminski and Ribe, 2001; Kaminski et al., 2004). + +`elastic stress': A plugin in which the particle property tensor is defined as the total elastic stress a particle has accumulated. See the viscoelastic material model documentation for more detailed information. + +`elastic tensor decomposition': A plugin which decomposes the elastic tensor into different approximations (Isotropic, Hexagonal, Tetragonal, Orthorhombic, Monoclinic and Triclinic) and provides the eigenvectors of the tensor. + +`function': Implementation of a model in which the particle property is set by evaluating an explicit function at the initial position of each particle. The function is defined in the parameters in section ``Particles|Function''. The format of these functions follows the syntax understood by the muparser library, see {ref}\`sec:run-aspect:parameters-overview:muparser-format\`. + +`grain size': A plugin in which the particle property is defined as the evolving grain size of a particle. See the grain_size material model documentation for more detailed information. + +`initial composition': Implementation of a plugin in which the particle property is given as the initial composition at the particle's initial position. The particle gets as many properties as there are compositional fields. + +`initial position': Implementation of a plugin in which the particle property is given as the initial position of the particle. This property is vector-valued with as many components as there are space dimensions. In practice, it is often most useful to only visualize one of the components of this vector, or the magnitude of the vector. For example, in a spherical mantle simulation, the magnitude of this property equals the starting radius of a particle, and is thereby indicative of which part of the mantle a particle comes from. + +`integrated strain': A plugin in which the particle property tensor is defined as the deformation gradient tensor $\mathbf F$ this particle has experienced. $\mathbf F$ can be polar-decomposed into the left stretching tensor $\mathbf L$ (the finite strain we are interested in), and the rotation tensor $\mathbf Q$. See the corresponding cookbook in the manual for more detailed information. + +`integrated strain invariant': A plugin in which the particle property is defined as the finite strain invariant ($\varepsilon_{ii}$). This property is calculated with the timestep ($dt$) and the second invariant of the deviatoric strain rate tensor ($\dot{\varepsilon}_{ii}$), where the value at time step $n$ is $\varepsilon_{ii}^{n} = \varepsilon_{ii}^{n-1} + dt\dot{\varepsilon}_{ii}$. + +`melt particle': Implementation of a plugin in which the particle property is defined as presence of melt above a threshold, which can be set as an input parameter. This property is set to 0 if melt is not present and set to 1 if melt is present. + +`pT path': Implementation of a plugin in which the particle property is defined as the current pressure and temperature at this position. This can be used to generate pressure-temperature paths of material points over time. + +`position': Implementation of a plugin in which the particle property is defined as the current position. + +`reference position': Implementation of a plugin in which the particle property is defined as the current reference position. + +`strain rate': Implementation of a plugin in which the time evolution of strain rate is saved and stored on the particles. + +`velocity': Implementation of a plugin in which the particle property is defined as the recent velocity at this position. + +`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. + + +319 + + +[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 ] + + + + +repartition + + +repartition + + +Strategy that is used to balance the computational load across processors for adaptive meshes. + + +273 + + +[MultipleSelection none|remove particles|add particles|remove and add particles|repartition ] + + + + +100 + + +100 + + +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. + + +275 + + +[Integer range 0...2147483647 (inclusive)] + + + + +0 + + +0 + + +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. + + +274 + + +[Integer range 0...2147483647 (inclusive)] + + + + +random uniform + + +random uniform + + +Select one of the following models: + +`ascii file': Generates a distribution of particles from coordinates specified in an Ascii data file. The file format is a simple text file, with as many columns as spatial dimensions and as many lines as particles to be generated. Initial comment lines starting with `#' will be discarded. Note that this plugin always generates as many particles as there are coordinates in the data file, the ``Particles/Number of particles'' parameter has no effect on this plugin. All of the values that define this generator are read from a section ``Particles/Generator/Ascii file'' in the input file, see Section~\ref{parameters:Particles/Generator/Ascii_20file}. + +`probability density function': Generate a random distribution of particles over the entire simulation domain. The probability density is prescribed in the form of a user-prescribed function. The format of this function follows the syntax understood by the muparser library, see {ref}\`sec:run-aspect:parameters-overview:muparser-format\`. The return value of the function is always checked to be a non-negative probability density but it can be zero in parts of the domain. + +`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. + +`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. + +`uniform box': Generate a uniform distribution of particles over a rectangular domain in 2d or 3d. Uniform here means the particles will be generated with an equal spacing in each spatial dimension. 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. + +`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. + + +278 + + +[Selection ascii file|probability density function|quadrature points|random uniform|reference cell|uniform box|uniform radial ] + + + + +10 + + +10 + + +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. + + +276 + + +[Integer range 0...2147483647 (inclusive)] + + + + +true + + +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'. + + +277 + + +[Bool] + + + + + +0 + + +0 + + +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. + + +322 + + +[Double 0...MAX_DOUBLE (inclusive)] + + + + +1 + + +1 + + +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. + + +321 [Integer range 0...2147483647 (inclusive)] @@ -19737,7 +21003,7 @@ Spin tensor Options: Spin tensor -258 +328 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -19754,7 +21020,7 @@ Options: Spin tensor The number of grains of each different mineral each particle contains. -254 +324 [Integer range 1...2147483647 (inclusive)] @@ -19771,7 +21037,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. -257 +327 [Integer range 0...2147483647 (inclusive)] @@ -19788,7 +21054,7 @@ Backward Euler Options: Forward Euler, Backward Euler -255 +325 [Anything] @@ -19805,7 +21071,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. -256 +326 [Double 0...MAX_DOUBLE (inclusive)] @@ -19822,7 +21088,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. -253 +323 [Integer range 0...2147483647 (inclusive)] @@ -19840,7 +21106,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. -265 +335 [Double 0...MAX_DOUBLE (inclusive)] @@ -19857,7 +21123,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. -262 +332 [Double 0...MAX_DOUBLE (inclusive)] @@ -19874,7 +21140,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. -266 +336 [Double 0...MAX_DOUBLE (inclusive)] @@ -19891,7 +21157,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. -264 +334 [Double 0...MAX_DOUBLE (inclusive)] @@ -19908,7 +21174,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. -267 +337 [Double 0...MAX_DOUBLE (inclusive)] @@ -19925,7 +21191,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 -263 +333 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -19944,7 +21210,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). -260 +330 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -19961,7 +21227,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. -259 +329 [Anything] @@ -19978,7 +21244,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 -261 +331 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -19996,7 +21262,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.) -271 +341 [Anything] @@ -20015,7 +21281,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. -270 +340 [Anything] @@ -20032,7 +21298,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 ';'. -268 +338 [Integer range 0...2147483647 (inclusive)] @@ -20049,7 +21315,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. -269 +339 [Anything] @@ -20069,7 +21335,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. -231 +301 [DirectoryName] @@ -20086,7 +21352,7 @@ particle.dat The name of the particle file. -232 +302 [Anything] @@ -20103,7 +21369,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.) -235 +305 [Anything] @@ -20117,17 +21383,87 @@ A typical example would be to set this runtime parameter to `pi=3.1415926536&apo 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 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. + + +304 + + +[Anything] + + + + +1000 + + +1000 + + +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. + + +306 + + +[Double 0...MAX_DOUBLE (inclusive)] + + + + +true + + +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. + + +307 + + +[Bool] + + + + +5432 + + +5432 + + +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. + + +308 + + +[Integer range 0...2147483647 (inclusive)] + + + + +x,y,t + + +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. -234 +303 [Anything] - + + + 1000 @@ -20139,7 +21475,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. -236 +279 [Double 0...MAX_DOUBLE (inclusive)] @@ -20156,7 +21492,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. -237 +280 [Bool] @@ -20173,30 +21509,13 @@ 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. -238 +281 [Integer range 0...2147483647 (inclusive)] - - -x,y,t - - -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. - - -233 - - -[Anything] - - - + @@ -20209,7 +21528,7 @@ The names of the variables as they will be used in the function, separated by co List of number of particles to create per cell and spatial dimension. The size of the list is the number of spatial dimensions. If only one value is given, then each spatial dimension is set to the same value. The list of numbers are parsed as a floating point number (so that one can specify, for example, '1e4' particles) but it is interpreted as an integer, of course. -212 +282 [List of <[Integer range 1...2147483647 (inclusive)]> of length 0...4294967295 (inclusive)] @@ -20228,7 +21547,7 @@ List of number of particles to create per cell and spatial dimension. The size o Maximum x coordinate for the region of particles. -215 +285 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -20245,7 +21564,7 @@ Maximum x coordinate for the region of particles. Maximum y coordinate for the region of particles. -217 +287 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -20262,7 +21581,7 @@ Maximum y coordinate for the region of particles. Maximum z coordinate for the region of particles. -219 +289 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -20279,7 +21598,7 @@ Maximum z coordinate for the region of particles. Minimum x coordinate for the region of particles. -214 +284 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -20296,7 +21615,7 @@ Minimum x coordinate for the region of particles. Minimum y coordinate for the region of particles. -216 +286 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -20313,7 +21632,7 @@ Minimum y coordinate for the region of particles. Minimum z coordinate for the region of particles. -218 +288 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -20330,7 +21649,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. -213 +283 [Double 0...MAX_DOUBLE (inclusive)] @@ -20349,7 +21668,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. -221 +291 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -20366,7 +21685,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. -222 +292 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -20383,7 +21702,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. -223 +293 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -20400,7 +21719,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. -229 +299 [Double 0...180 (inclusive)] @@ -20417,7 +21736,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. -227 +297 [Double -180...360 (inclusive)] @@ -20434,7 +21753,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. -225 +295 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -20451,7 +21770,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. -228 +298 [Double 0...180 (inclusive)] @@ -20468,7 +21787,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. -226 +296 [Double -180...360 (inclusive)] @@ -20485,7 +21804,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. -224 +294 [Double 0...MAX_DOUBLE (inclusive)] @@ -20502,7 +21821,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. -220 +290 [Double 0...MAX_DOUBLE (inclusive)] @@ -20519,7 +21838,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. -230 +300 [Integer range 1...2147483647 (inclusive)] @@ -20540,7 +21859,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. -240 +310 [Bool] @@ -20561,7 +21880,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'. -243 +313 [List of <[Bool]> of length 0...4294967295 (inclusive)] @@ -20578,7 +21897,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. -242 +312 [List of <[Bool]> of length 0...4294967295 (inclusive)] @@ -20597,7 +21916,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'. -248 +318 [List of <[Bool]> of length 0...4294967295 (inclusive)] @@ -20614,7 +21933,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. -247 +317 [List of <[Bool]> of length 0...4294967295 (inclusive)] @@ -20634,14 +21953,14 @@ 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). -250 +320 [Double 0...1 (inclusive)] - + @@ -20774,7 +22093,7 @@ It is worth comparing this postprocessor with the visualization postprocessor ca `volume of fluid statistics': A postprocessor that computes some statistics about the volume-of-fluid fields. -134 +135 [MultipleSelection ODE statistics|Stokes residual|basic statistics|boundary densities|boundary pressures|boundary strain rate residual statistics|boundary velocity residual statistics|command|composition statistics|composition velocity statistics|core statistics|crystal preferred orientation|depth average|domain volume statistics|dynamic topography|entropy viscosity statistics|geoid|global statistics|gravity calculation|heat flux densities|heat flux map|heat flux statistics|heating statistics|load balance statistics|mass flux statistics|material statistics|matrix statistics|maximum depth of field|melt statistics|memory statistics|mobility statistics|particle count statistics|particles|point values|pressure statistics|rotation statistics|sea level|spherical velocity statistics|temperature statistics|topography|velocity boundary statistics|velocity statistics|viscous dissipation statistics|visualization|volume of fluid statistics ] @@ -20791,7 +22110,7 @@ false Whether or not the postprocessors should be executed after each of the nonlinear iterations done within one time step. As this is mainly an option for the purposes of debugging, it is not supported when the 'Time between graphical output' is larger than zero, or when the postprocessor is not intended to be run more than once per timestep. -68 +69 [Bool] @@ -20809,7 +22128,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. -323 +393 [DirectoryName] @@ -20826,7 +22145,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. -324 +394 [Anything] @@ -20843,7 +22162,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. -325 +395 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -20862,7 +22181,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. -326 +396 [DirectoryName] @@ -20879,7 +22198,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. -327 +397 [Anything] @@ -20896,7 +22215,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. -328 +398 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -20913,7 +22232,7 @@ false Use ascii data files (e.g., GPS) for computing residual velocities instead of GPlates data. -330 +400 [Bool] @@ -20930,7 +22249,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. -329 +399 [Bool] @@ -20945,7 +22264,7 @@ Specify velocity as r, phi, and theta components instead of x, y, and z. Positiv Command to execute. -333 +403 [Anything] @@ -20962,7 +22281,7 @@ false Whether to run command from all processes (true), or only on process 0 (false). -332 +402 [Bool] @@ -20979,7 +22298,7 @@ false Select whether \aspect{} should terminate if the command returns a non-zero exit status. -331 +401 [Bool] @@ -20994,7 +22313,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. -334 +404 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -21013,7 +22332,7 @@ true Whether to compress the raw and weighted cpo data output files with zlib. -281 +351 [Bool] @@ -21030,7 +22349,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. -276 +346 [Integer range 0...2147483647 (inclusive)] @@ -21043,7 +22362,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. -278 +348 [Anything] @@ -21062,7 +22381,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. -275 +345 [Double 0...MAX_DOUBLE (inclusive)] @@ -21079,7 +22398,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. -277 +347 [Bool] @@ -21097,7 +22416,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. -280 +350 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -21115,7 +22434,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. -279 +349 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -21130,7 +22449,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). -284 +354 [List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -21152,7 +22471,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 -286 +356 [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 ] @@ -21169,7 +22488,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. -283 +353 [Integer range 1...2147483647 (inclusive)] @@ -21186,7 +22505,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. -285 +355 [MultipleSelection none|dx|ucd|gnuplot|povray|eps|gmv|tecplot|vtk|vtu|hdf5|svg|deal.II intermediate|txt ] @@ -21203,7 +22522,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. -282 +352 [Double 0...MAX_DOUBLE (inclusive)] @@ -21222,7 +22541,7 @@ false Output the excess entropy only instead the each entropy terms. -335 +405 [Bool] @@ -21241,7 +22560,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}. -287 +357 [Double 0...MAX_DOUBLE (inclusive)] @@ -21258,7 +22577,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}. -288 +358 [Double 0...MAX_DOUBLE (inclusive)] @@ -21275,7 +22594,7 @@ true Whether to output a file containing the bottom (i.e., CMB) dynamic topography. -290 +360 [Bool] @@ -21292,7 +22611,7 @@ true Whether to output a file containing the surface dynamic topography. -289 +359 [Bool] @@ -21351,7 +22670,7 @@ false The density value above the surface boundary. -296 +366 [Double 0...MAX_DOUBLE (inclusive)] @@ -21368,7 +22687,7 @@ The density value above the surface boundary. The density value below the CMB boundary. -297 +367 [Double 0...MAX_DOUBLE (inclusive)] @@ -21385,7 +22704,7 @@ true Option to include the contribution from CMB topography on geoid. The default is true. -292 +362 [Bool] @@ -21402,7 +22721,7 @@ true Option to include the contribution from surface topography on geoid. The default is true. -291 +361 [Bool] @@ -21419,7 +22738,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. -293 +363 [Integer range 0...2147483647 (inclusive)] @@ -21436,7 +22755,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. -294 +364 [Integer range 0...2147483647 (inclusive)] @@ -21453,7 +22772,7 @@ false Option to output the spherical harmonic coefficients of the CMB topography contribution to the maximum degree. The default is false. -300 +370 [Bool] @@ -21470,7 +22789,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. -295 +365 [Bool] @@ -21487,7 +22806,7 @@ false Option to output the spherical harmonic coefficients of the density anomaly contribution to the maximum degree. The default is false. -301 +371 [Bool] @@ -21504,7 +22823,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. -298 +368 [Bool] @@ -21521,7 +22840,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. -302 +372 [Bool] @@ -21538,7 +22857,7 @@ false Option to output the spherical harmonic coefficients of the surface topography contribution to the maximum degree. The default is false. -299 +369 [Bool] @@ -21557,7 +22876,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. -303 +373 [Bool] @@ -21572,7 +22891,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. -320 +390 [List of <[Double -90...90 (inclusive)]> of length 0...4294967295 (inclusive)] @@ -21585,7 +22904,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. -319 +389 [List of <[Double -180...180 (inclusive)]> of length 0...4294967295 (inclusive)] @@ -21598,7 +22917,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 -318 +388 [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] @@ -21615,7 +22934,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. -315 +385 [Double -90...90 (inclusive)] @@ -21632,7 +22951,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. -314 +384 [Double -180...180 (inclusive)] @@ -21649,7 +22968,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. -311 +381 [Double 0...MAX_DOUBLE (inclusive)] @@ -21666,7 +22985,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. -313 +383 [Double -90...90 (inclusive)] @@ -21683,7 +23002,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. -312 +382 [Double -180...180 (inclusive)] @@ -21700,7 +23019,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. -310 +380 [Double 0...MAX_DOUBLE (inclusive)] @@ -21717,7 +23036,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 -305 +375 [Integer range 0...2147483647 (inclusive)] @@ -21734,7 +23053,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. -309 +379 [Integer range 0...2147483647 (inclusive)] @@ -21751,7 +23070,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. -308 +378 [Integer range 0...2147483647 (inclusive)] @@ -21768,7 +23087,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. -307 +377 [Integer range 0...2147483647 (inclusive)] @@ -21785,7 +23104,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. -317 +387 [Integer range 1...2147483647 (inclusive)] @@ -21802,7 +23121,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. -306 +376 [Integer range -1...2147483647 (inclusive)] @@ -21819,7 +23138,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. -316 +386 [Double 0...MAX_DOUBLE (inclusive)] @@ -21836,7 +23155,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. -304 +374 [Selection map|list|list of points|fibonacci spiral ] @@ -21853,7 +23172,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. -321 +391 [Double 0...MAX_DOUBLE (inclusive)] @@ -21870,7 +23189,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. -322 +392 [Integer range 0...2147483647 (inclusive)] @@ -21889,7 +23208,7 @@ true If set to 'true', also output the peak virtual memory usage (computed as the maximum over all processors). -196 +197 [Bool] @@ -21908,7 +23227,7 @@ vtu A comma separated list of file formats to be used for graphical output. 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. -198 +199 [MultipleSelection none|dx|ucd|gnuplot|povray|eps|gmv|tecplot|vtk|vtu|hdf5|svg|deal.II intermediate|ascii ] @@ -21921,7 +23240,7 @@ A comma separated list of file formats to be used for graphical output. The list A comma separated list of particle properties that should \textit{not} be output. If this list contains the entry `all', only the id of particles will be provided in graphical output files. -202 +203 [Anything] @@ -21938,7 +23257,7 @@ A comma separated list of particle properties that should \textit{not} be output VTU file output supports grouping files from several CPUs into a given number of files using MPI I/O when writing on a parallel filesystem. Select 0 for no grouping. This will disable parallel file output and instead write one file per processor. A value of 1 will generate one big file containing the whole solution, while a larger value will create that many files (at most as many as there are MPI ranks). -199 +200 [Integer range 0...2147483647 (inclusive)] @@ -21951,7 +23270,7 @@ VTU file output supports grouping files from several CPUs into a given number of 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. -201 +202 [Anything] @@ -21970,7 +23289,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. -197 +198 [Double 0...MAX_DOUBLE (inclusive)] @@ -21987,7 +23306,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 a background thread, while the rest of the model continues. -200 +201 [Bool] @@ -22002,7 +23321,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. -273 +343 [List of <[List of <[Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)]> of length 2...2 (inclusive)]> of length 0...4294967295 (inclusive) separated by <;>] @@ -22019,7 +23338,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. -272 +342 [Double 0...MAX_DOUBLE (inclusive)] @@ -22036,7 +23355,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. -274 +344 [Bool] @@ -22055,7 +23374,7 @@ false Whether to write the full moment of inertia tensor into the statistics output instead of its norm for the current rotation axis. This is a second-order symmetric tensor with 6 components in 3d. In 2d this option has no effect, because the rotation axis is fixed and thus the moment of inertia is always a scalar. -185 +186 [Bool] @@ -22072,7 +23391,7 @@ false Whether to use a constant density of one for the computation of the angular momentum and moment of inertia. This is an approximation that assumes that the 'volumetric' rotation is equal to the 'mass' rotation. If this parameter is true this postprocessor computes 'net rotation' instead of 'angular momentum'. -184 +185 [Bool] @@ -22091,7 +23410,7 @@ $ASPECT_SOURCE_DIR/data/postprocess/sea-level/ The name of a directory that contains the ice height [m] 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. -190 +191 [DirectoryName] @@ -22108,7 +23427,7 @@ $ASPECT_SOURCE_DIR/data/postprocess/sea-level/ The name of a directory that contains the topography 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. -188 +189 [DirectoryName] @@ -22125,7 +23444,7 @@ shell_3d_ice_top.0.txt The file name of the ice height ascii data. For the ascii data, provide file in the same format as described in 'ascii data' initial composition plugin. -191 +192 [Anything] @@ -22142,7 +23461,7 @@ shell_3d_topo_top.0.txt The file name of the topography ascii data. For the ascii data, provide file in the same format as described in 'ascii data' initial composition plugin. -189 +190 [Anything] @@ -22159,7 +23478,7 @@ The file name of the topography ascii data. For the ascii data, provide file in The density of ice [kg/m3] -186 +187 [Double 0...MAX_DOUBLE (inclusive)] @@ -22176,7 +23495,7 @@ false Whether or not to write sea level to a text file named named 'sea_level.NNNNN' in the output directory -192 +193 [List of <[Bool]> of length 0...4294967295 (inclusive)] @@ -22193,7 +23512,7 @@ Whether or not to write sea level to a text file named named 'sea_level.NNN The time interval between each generation of text 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. -193 +194 [Double 0...MAX_DOUBLE (inclusive)] @@ -22210,7 +23529,7 @@ The time interval between each generation of text output files. A value of zero The density of water [kg/m3] -187 +188 [Double 0...MAX_DOUBLE (inclusive)] @@ -22229,7 +23548,7 @@ false Whether or not to write topography to a text file named named 'topography.NNNNN' in the output directory -194 +195 [Bool] @@ -22246,7 +23565,7 @@ Whether or not to write topography to a text file named named 'topography.N The time interval between each generation of text 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. -195 +196 [Double 0...MAX_DOUBLE (inclusive)] @@ -22267,7 +23586,7 @@ Setting this flag to true will result in visualization output that does not accu ::: -144 +145 [Bool] @@ -22290,7 +23609,7 @@ The effect of using this option can be seen in the following picture showing a v Of course, activating this option also greatly increases the amount of data \aspect{} will write to disk: approximately by a factor of 4 in 2d, and a factor of 8 in 3d, when using quadratic elements for the velocity, and correspondingly more for even higher order elements. -141 +142 [Bool] @@ -22525,7 +23844,7 @@ Physical units: None. Physical units: \si{\per\second}. -149 +150 [MultipleSelection ISA rotation timescale|Vp anomaly|Vs anomaly|adiabat|artificial viscosity|artificial viscosity composition|boundary indicators|boundary strain rate residual|boundary velocity residual|compositional vector|darcy velocity|depth|dynamic topography|error indicator|geoid|grain lag angle|gravity|heat flux map|heating|material properties|maximum horizontal compressive stress|melt fraction|melt material properties|named additional outputs|nonadiabatic pressure|nonadiabatic temperature|particle count|partition|principal stress|shear stress|spd factor|spherical velocity components|strain rate|strain rate tensor|stress|stress second invariant|surface dynamic topography|surface elevation|surface strain rate tensor|surface stress|temperature anomaly|vertical heat flux|volume of fluid values|volumetric strain rate|density|specific heat|thermal conductivity|thermal diffusivity|thermal expansivity|viscosity ] @@ -22542,7 +23861,7 @@ Physical units: \si{\per\second}. VTU file output supports grouping files from several CPUs into a given number of files using MPI I/O when writing on a parallel filesystem. Select 0 for no grouping. This will disable parallel file output and instead write one file per processor. A value of 1 will generate one big file containing the whole solution, while a larger value will create that many files (at most as many as there are MPI ranks). -138 +139 [Integer range 0...2147483647 (inclusive)] @@ -22559,7 +23878,7 @@ false Whether or not to also output the base variables velocity, fluid pressure (when present), fluid velocity (when present), pressure, temperature and compositional fields (when present) on the surface of the mesh. The mesh surface includes not only the top boundary, but all boundaries of the domain. -148 +149 [Bool] @@ -22576,7 +23895,7 @@ vtu The file format to be used for graphical output. 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. -137 +138 [Selection none|dx|ucd|gnuplot|povray|eps|gmv|tecplot|vtk|vtu|hdf5|svg|deal.II intermediate|parallel deal.II intermediate ] @@ -22593,7 +23912,7 @@ false For computations with deforming meshes, ASPECT uses an Arbitrary-Lagrangian-Eulerian formulation to handle deforming the domain. The displacement vector from the reference configuration may be written as an output field by setting this parameter to true. -146 +147 [Bool] @@ -22610,7 +23929,7 @@ false For computations with deforming meshes, ASPECT uses an Arbitrary-Lagrangian-Eulerian formulation to handle deforming the domain, so the mesh has its own velocity field. This may be written as an output field by setting this parameter to true. -145 +146 [Bool] @@ -22627,7 +23946,7 @@ false For computations with deforming meshes, ASPECT uses an Arbitrary-Lagrangian-Eulerian formulation to handle deforming the domain. By default, we output the deformed mesh. If this setting is set to true, the mesh will be written in the reference state without deformation instead. If you output the mesh displacement, you can obtain the deformed mesh by using the 'warp by vector' ParaView filter. -147 +148 [Bool] @@ -22644,7 +23963,7 @@ false If set to true, quantities related to stress and strain are computed in each vertex. Otherwise, an average per cell is computed. -142 +143 [Bool] @@ -22657,7 +23976,7 @@ If set to true, quantities related to stress and strain are computed in each ver 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. -140 +141 [Anything] @@ -22674,7 +23993,7 @@ On large clusters it can be advantageous to first write the output to a temporar 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. -135 +136 [Double 0...MAX_DOUBLE (inclusive)] @@ -22691,7 +24010,7 @@ The time interval between each generation of graphical output files. A value of The maximum number of time steps between each generation of graphical output files. -136 +137 [Integer range 0...2147483647 (inclusive)] @@ -22711,7 +24030,7 @@ 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. -143 +144 [Bool] @@ -22728,7 +24047,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 a background thread, while the rest of the model continues. -139 +140 [Bool] @@ -22742,7 +24061,7 @@ File operations can potentially take a long time, blocking the progress of the r The name of the compositional field whose output should be visualized. -183 +184 [Anything] @@ -22757,7 +24076,7 @@ The name of the compositional field whose output should be visualized. A list of sets of compositional fields which should be output as vectors. Sets are separated from each other by semicolons and vector components within each set are separated by commas (e.g. $vec1_x$, $vec1_y$ ; $vec2_x$, $vec2_y$) where each name must be a defined named compositional field. If only one name is given in a set, it is interpreted as the first in a sequence of dim consecutive compositional fields. -182 +183 [Anything] @@ -22770,7 +24089,7 @@ A list of sets of compositional fields which should be output as vectors. Sets a Names of vectors as they will appear in the output. -181 +182 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -22789,7 +24108,7 @@ false A boolean flag that controls whether to output the heat flux map as a point wise value, or as a cell-wise averaged value. The point wise output is more accurate, but it currently omits prescribed heat flux values at boundaries and advective heat flux that is caused by velocities non-tangential to boundaries. If you do not use these two features it is recommended to switch this setting on to benefit from the increased output resolution. -160 +161 [Bool] @@ -22810,7 +24129,7 @@ A comma separated list of material properties that should be written whenever wr viscosity|density|thermal expansivity|specific heat|thermal conductivity|thermal diffusivity|compressibility|entropy derivative temperature|entropy derivative pressure|reaction terms|melt fraction -161 +162 [MultipleSelection viscosity|density|thermal expansivity|specific heat|thermal conductivity|thermal diffusivity|compressibility|entropy derivative temperature|entropy derivative pressure|reaction terms|melt fraction ] @@ -22829,7 +24148,7 @@ viscosity|density|thermal expansivity|specific heat|thermal conductivity|thermal Constant parameter in the quadratic function that approximates the solidus of peridotite. Units: \si{\degreeCelsius}. -163 +164 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -22846,7 +24165,7 @@ Constant parameter in the quadratic function that approximates the solidus of pe Prefactor of the linear pressure term in the quadratic function that approximates the solidus of peridotite. \si{\degreeCelsius\per\pascal}. -164 +165 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -22863,7 +24182,7 @@ Prefactor of the linear pressure term in the quadratic function that approximate Prefactor of the quadratic pressure term in the quadratic function that approximates the solidus of peridotite. \si{\degreeCelsius\per\pascal\squared}. -165 +166 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -22880,7 +24199,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}. -166 +167 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -22897,7 +24216,7 @@ Constant parameter in the quadratic function that approximates the lherzolite li Prefactor of the linear pressure term in the quadratic function that approximates the lherzolite liquidus used for calculating the fraction of peridotite-derived melt. \si{\degreeCelsius\per\pascal}. -167 +168 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -22914,7 +24233,7 @@ Prefactor of the linear pressure term in the quadratic function that approximate Prefactor of the quadratic pressure term in the quadratic function that approximates the lherzolite liquidus used for calculating the fraction of peridotite-derived melt. \si{\degreeCelsius\per\pascal\squared}. -168 +169 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -22931,7 +24250,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}. -169 +170 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -22948,7 +24267,7 @@ Constant parameter in the quadratic function that approximates the liquidus of p Prefactor of the linear pressure term in the quadratic function that approximates the liquidus of peridotite. \si{\degreeCelsius\per\pascal}. -170 +171 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -22965,7 +24284,7 @@ Prefactor of the linear pressure term in the quadratic function that approximate Prefactor of the quadratic pressure term in the quadratic function that approximates the liquidus of peridotite. \si{\degreeCelsius\per\pascal\squared}. -171 +172 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -22982,7 +24301,7 @@ Prefactor of the quadratic pressure term in the quadratic function that approxim Constant parameter in the quadratic function that approximates the solidus of pyroxenite. Units: \si{\degreeCelsius}. -176 +177 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -22999,7 +24318,7 @@ Constant parameter in the quadratic function that approximates the solidus of py Prefactor of the linear pressure term in the quadratic function that approximates the solidus of pyroxenite. Note that this factor is different from the value given in Sobolev, 2011, because they use the potential temperature whereas we use the absolute temperature. \si{\degreeCelsius\per\pascal}. -177 +178 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -23016,7 +24335,7 @@ Prefactor of the linear pressure term in the quadratic function that approximate Prefactor of the quadratic pressure term in the quadratic function that approximates the solidus of pyroxenite. \si{\degreeCelsius\per\pascal\squared}. -178 +179 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -23033,7 +24352,7 @@ Prefactor of the quadratic pressure term in the quadratic function that approxim Prefactor of the linear depletion term in the quadratic function that approximates the melt fraction of pyroxenite. \si{\degreeCelsius\per\pascal}. -179 +180 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -23050,7 +24369,7 @@ Prefactor of the linear depletion term in the quadratic function that approximat Prefactor of the quadratic depletion term in the quadratic function that approximates the melt fraction of pyroxenite. \si{\degreeCelsius\per\pascal\squared}. -180 +181 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -23067,7 +24386,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. -175 +176 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -23084,7 +24403,7 @@ Mass fraction of clinopyroxene in the peridotite to be molten. Units: non-dimens Exponent of the melting temperature in the melt fraction calculation. Units: non-dimensional. -174 +175 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -23101,7 +24420,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. -172 +173 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -23118,7 +24437,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}. -173 +174 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -23139,7 +24458,7 @@ A comma separated list of melt properties that should be written whenever writin compaction viscosity|fluid viscosity|permeability|fluid density|fluid density gradient|is melt cell|darcy coefficient|darcy coefficient no cutoff|compaction length -162 +163 [MultipleSelection compaction viscosity|fluid viscosity|permeability|fluid density|fluid density gradient|is melt cell|darcy coefficient|darcy coefficient no cutoff|compaction length ] @@ -23158,7 +24477,7 @@ false Whether to use the deviatoric stress tensor instead of the full stress tensor to compute principal stress directions and values. -155 +156 [Bool] @@ -23177,7 +24496,7 @@ Whether to use the deviatoric stress tensor instead of the full stress tensor to Number of depth slices used to define average temperature. -150 +151 [Integer range 1...2147483647 (inclusive)] @@ -23194,7 +24513,7 @@ true If true, use the specified boundary temperatures as average temperatures at the surface. If false, extrapolate the temperature gradient between the first and second cells to the surface. This option will only work for models with a fixed surface temperature. -151 +152 [Bool] @@ -23211,7 +24530,7 @@ true Whether to use the minimal specified boundary temperature as the bottom boundary temperature. This option will only work for models with a fixed bottom boundary temperature. -152 +153 [Bool] @@ -23230,7 +24549,7 @@ false Include the internal data for the interface normal on the unit cells. -154 +155 [Bool] @@ -23247,7 +24566,7 @@ false Include fields defined such that the 0 contour is the fluid interface. -153 +154 [Bool] @@ -23266,7 +24585,7 @@ reference profile Scheme to compute the average velocity-depth profile. The reference profile option evaluates the conditions along the reference adiabat according to the material model. The lateral average option instead calculates a lateral average from subdivision of the mesh. The lateral average option may produce spurious results where there are sharp velocity changes. -158 +159 [Selection reference profile|lateral average ] @@ -23283,7 +24602,7 @@ Scheme to compute the average velocity-depth profile. The reference profile opti Number of depth slices used to define average seismic compressional wave velocities from which anomalies are calculated. Units: non-dimensional. -159 +160 [Integer range 1...2147483647 (inclusive)] @@ -23302,7 +24621,7 @@ reference profile Scheme to compute the average velocity-depth profile. The reference profile option evaluates the conditions along the reference adiabat according to the material model. The lateral average option instead calculates a lateral average from subdivision of the mesh. The lateral average option may produce spurious results where there are sharp velocity changes. -156 +157 [Selection reference profile|lateral average ] @@ -23319,7 +24638,7 @@ Scheme to compute the average velocity-depth profile. The reference profile opti Number of depth slices used to define average seismic shear wave velocities from which anomalies are calculated. Units: non-dimensional. -157 +158 [Integer range 1...2147483647 (inclusive)] @@ -23346,7 +24665,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\`. -1232 +1302 [Selection ascii data|circle|function|unspecified ] @@ -23364,7 +24683,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. -1248 +1318 [DirectoryName] @@ -23381,7 +24700,7 @@ box_2d.txt The file name of the model data. -1249 +1319 [Anything] @@ -23398,7 +24717,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. -1252 +1322 [Anything] @@ -23415,7 +24734,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. -1250 +1320 [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] @@ -23432,7 +24751,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. -1253 +1323 [Anything] @@ -23449,7 +24768,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. -1251 +1321 [Bool] @@ -23466,7 +24785,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.) -1244 +1314 [Anything] @@ -23485,7 +24804,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. -1243 +1313 [Anything] @@ -23502,7 +24821,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. -1242 +1312 [Anything] @@ -23519,7 +24838,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.) -1241 +1311 [Anything] @@ -23538,7 +24857,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. -1240 +1310 [Anything] @@ -23555,7 +24874,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. -1239 +1309 [Anything] @@ -23572,7 +24891,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 +1317 [Anything] @@ -23591,7 +24910,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 +1316 [Anything] @@ -23608,7 +24927,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 +1315 [Anything] @@ -23625,7 +24944,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.) -1238 +1308 [Anything] @@ -23644,7 +24963,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. -1237 +1307 [Anything] @@ -23661,7 +24980,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. -1236 +1306 [Anything] @@ -23678,7 +24997,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.) -1235 +1305 [Anything] @@ -23697,7 +25016,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. -1234 +1304 [Anything] @@ -23714,7 +25033,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. -1233 +1303 [Anything] @@ -23734,7 +25053,7 @@ The names of the variables as they will be used in the function, separated by co The relative tolerance up to which the linear system for the composition system gets solved. See `Stokes solver parameters/Linear solver tolerance' for more details. -23 +24 [Double 0...1 (inclusive)] @@ -23751,7 +25070,7 @@ The relative tolerance up to which the linear system for the composition system The relative tolerance up to which the linear system for the temperature system gets solved. See `Stokes solver parameters/Linear solver tolerance' for more details. -22 +23 [Double 0...1 (inclusive)] @@ -23769,7 +25088,7 @@ The relative tolerance up to which the linear system for the temperature system This threshold tells the AMG setup how the coarsening should be performed. In the AMG used by ML, all points that strongly couple with the tentative coarse-level point form one aggregate. The term strong coupling is controlled by the variable aggregation\_threshold, meaning that all elements that are not smaller than aggregation\_threshold times the diagonal element do couple strongly. The default is strongly recommended. There are indications that for the Newton solver a different value might be better. For extensive benchmarking of various settings of the AMG parameters in this section for the Stokes problem and others, see https://github.com/geodynamics/aspect/pull/234. -40 +41 [Double 0...1 (inclusive)] @@ -23786,7 +25105,7 @@ false Turns on extra information on the AMG solver. Note that this will generate much more output. -41 +42 [Bool] @@ -23803,7 +25122,7 @@ Turns on extra information on the AMG solver. Note that this will generate much Determines how many sweeps of the smoother should be performed. When the flag elliptic is set to true, (which is true for ASPECT), the polynomial degree of the Chebyshev smoother is set to this value. The term sweeps refers to the number of matrix-vector products performed in the Chebyshev case. In the non-elliptic case, this parameter sets the number of SSOR relaxation sweeps for post-smoothing to be performed. The default is strongly recommended. There are indications that for the Newton solver a different value might be better. For extensive benchmarking of various settings of the AMG parameters in this section for the Stokes problem and others, see https://github.com/geodynamics/aspect/pull/234. -39 +40 [Integer range 0...2147483647 (inclusive)] @@ -23820,7 +25139,7 @@ Chebyshev This parameter sets the type of smoother for the AMG. The default is strongly recommended for any normal runs with ASPECT. There are some indications that the symmetric Gauss-Seidel might be better and more stable for the Newton solver. For extensive benchmarking of various settings of the AMG parameters in this section for the Stokes problem and others, see https://github.com/geodynamics/aspect/pull/234. -38 +39 [Selection Chebyshev|symmetric Gauss-Seidel ] @@ -23839,7 +25158,7 @@ This parameter sets the type of smoother for the AMG. The default is strongly re This is the number of iterations that define the GMRES solver restart length. Increasing this parameter makes the solver more robust and decreases the number of iterations. Be aware that increasing this number increases the memory usage of the advection solver, and makes individual iterations more expensive. -24 +25 [Integer range 1...2147483647 (inclusive)] @@ -23858,7 +25177,7 @@ This is the number of iterations that define the GMRES solver restart length. In Set a length scale for the diffusion of advection fields if the ``prescribed field with diffusion'' method is selected for a field. More precisely, this length scale represents the square root of the product of diffusivity and time in the diffusion equation, and controls the distance over which features are diffused. Units: \si{\meter}. -46 +47 [Double 0...MAX_DOUBLE (inclusive)] @@ -23877,7 +25196,7 @@ false Executes different parts of the Stokes solver repeatedly and print timing information. This is for internal benchmarking purposes: It is useful if you want to see how the solver performs. Otherwise, you don't want to enable this, since it adds additional computational cost to get the timing information. -121 +122 [Bool] @@ -23894,7 +25213,7 @@ false Turns on extra information for the matrix free GMG solver to be printed. -120 +121 [Bool] @@ -23913,7 +25232,7 @@ Turns on extra information for the matrix free GMG solver to be printed. The maximum number of line search iterations allowed. If the criterion is not reached after this number of iterations, we apply the scaled increment even though it does not satisfy the necessary criteria and simply continue with the next Newton iteration. -112 +113 [Integer range 0...2147483647 (inclusive)] @@ -23930,7 +25249,7 @@ The maximum number of line search iterations allowed. If the criterion is not re If the 'Nonlinear Newton solver switch tolerance' is reached before the maximal number of Picard iterations, then the solver switches to Newton solves anyway. -111 +112 [Integer range 0...2147483647 (inclusive)] @@ -23947,7 +25266,7 @@ If the 'Nonlinear Newton solver switch tolerance' is reached before th The linear Stokes solver tolerance is dynamically chosen for the Newton solver, based on the Eisenstat Walker (1994) paper (https://doi.org/10.1137/0917003), equation 2.2. Because this value can become larger than one, we limit this value by this parameter. -114 +115 [Double 0...1 (inclusive)] @@ -23964,7 +25283,7 @@ The linear Stokes solver tolerance is dynamically chosen for the Newton solver, A relative tolerance with respect to the residual of the first iteration, up to which the nonlinear Picard solver will iterate, before changing to the Newton solver. -110 +111 [Double 0...1 (inclusive)] @@ -23981,7 +25300,7 @@ A relative tolerance with respect to the residual of the first iteration, up to When stabilizing the Newton matrix, we can encounter situations where the coefficient inside the elliptic (top-left) block becomes negative or zero. This coefficient has the form $1+x$ where $x$ can sometimes be smaller than $-1$. In this case, the top-left block of the matrix is no longer positive definite, and both preconditioners and iterative solvers may fail. To prevent this, the stabilization computes an $\alpha$ so that $1+\alpha x$ is never negative and so that always $0\le \alpha \le 1$. On the other hand, we also want to stay away from $1+\alpha x=0$, and so modify the choice of $\alpha$ by a factor $c$ between zero and one so that if $c<1$, we are assured that $1+\alpha x>0$, i.e., bounded away from zero. If $c=1$, we allow $1+\alpha x=0$, i.e., an unsafe situation. If $c=0$, then $\alpha$ is always set to zero which guarantees the desired property that $1+\alpha x=1>0$, but at the cost of a diminished convergence rate of the Newton method. -118 +119 [Double 0...1 (inclusive)] @@ -23998,7 +25317,7 @@ SPD This parameters allows for the stabilization of the preconditioner. If one derives the Newton method without any modifications, the matrix created for the preconditioning is not necessarily Symmetric Positive Definite. This is problematic (see \cite{fraters:etal:2019}). When `none' is chosen, the preconditioner is not stabilized. The `symmetric' parameters symmetrizes the matrix, and `PD' makes the matrix Positive Definite. `SPD' is the full stabilization, where the matrix is guaranteed Symmetric Positive Definite. -115 +116 [Selection SPD|PD|symmetric|none ] @@ -24015,7 +25334,7 @@ SPD This parameters allows for the stabilization of the velocity block. If one derives the Newton method without any modifications, the matrix created for the velocity block is not necessarily Symmetric Positive Definite. This is problematic (see \cite{fraters:etal:2019}). When `none' is chosen, the velocity block is not stabilized. The `symmetric' parameters symmetrizes the matrix, and `PD' makes the matrix Positive Definite. `SPD' is the full stabilization, where the matrix is guaranteed Symmetric Positive Definite. -116 +117 [Selection SPD|PD|symmetric|none ] @@ -24034,7 +25353,7 @@ If set to true, the Picard iteration uses the Eisenstat Walker method to determi Once derivatives are used in a Newton method, \aspect{} always uses the Eisenstat Walker method. -119 +120 [Bool] @@ -24051,7 +25370,7 @@ false When this parameter is true and the linear solver fails, we try again, but now with SPD stabilization for both the preconditioner and the velocity block. The SPD stabilization will remain active until the next timestep, when the default values are restored. -117 +118 [Bool] @@ -24068,7 +25387,7 @@ false This method allows to slowly introduce the derivatives based on the improvement of the residual. If set to false, the scaling factor for the Newton derivatives is set to one immediately when switching on the Newton solver. When this is set to true, the derivatives are slowly introduced by the following equation: $\max(0.0, (1.0-(residual/switch\_initial\_residual)))$, where switch\_initial\_residual is the residual at the time when the Newton solver is switched on. -113 +114 [Bool] @@ -24087,7 +25406,7 @@ This method allows to slowly introduce the derivatives based on the improvement The relative solver tolerance used in the ARKode reaction solver. This tolerance is used to adaptively determine the reaction step size. For more details, see the ARKode documentation. This parameter is only used if the `ARKode' reaction solver type is used. Units: none. -43 +44 [Double 0...MAX_DOUBLE (inclusive)] @@ -24104,7 +25423,7 @@ ARKode This parameter determines what solver will be used when the reactions are computed within the operator splitting scheme. For reactions where the reaction rate is a known, finite quantity, the appropriate choice is `ARKode', which uses an ODE solver from SUNDIALs ARKode (adaptive-step additive Runge Kutta ODE solver methods) to compute the solution. ARKode will pick a reasonable step size based on the reaction rate and the given `Reaction solver relative tolerance'. However, in some cases we have instantaneous reactions, where we know the new value of a compositional field (and the reaction rate would be infinite), or reaction where we need to know or be able to control the step size we use to compute the reactions. In theses cases, it is appropriate to use the `fixed step' scheme, a method that a forward Euler scheme and a fixed number of steps given by the `Reaction time step' and `Reaction time steps per advection step' parameters. -42 +43 [Selection ARKode|fixed step ] @@ -24121,7 +25440,7 @@ This parameter determines what solver will be used when the reactions are comput Set a time step size for computing reactions of compositional fields and the temperature field in case operator splitting is used. This is only used when the parameter ``Use operator splitting'' is set to true and when the `fixed step' reaction solver type is used. The reaction time step must be greater than 0. If you want to prescribe the reaction time step only as a relative value compared to the advection time step as opposed to as an absolute value, you should use the parameter ``Reaction time steps per advection step'' and set this parameter to the same (or larger) value as the ``Maximum time step'' (which is 5.69e+300 by default). Units: Years or seconds, depending on the ``Use years in output instead of seconds'' parameter. -44 +45 [Double 0...MAX_DOUBLE (inclusive)] @@ -24138,7 +25457,7 @@ Set a time step size for computing reactions of compositional fields and the tem The number of reaction time steps done within one advection time step in case operator splitting is used. This is only used if the parameter ``Use operator splitting'' is set to true and when the `fixed step' reaction solver type is used. If set to zero, this parameter is ignored. Otherwise, the reaction time step size is chosen according to this criterion and the ``Reaction time step'', whichever yields the smaller time step. Units: none. -45 +46 [Integer range 0...2147483647 (inclusive)] @@ -24157,7 +25476,7 @@ false This parameter determines whether to enforce a solver that supports nonsymmetric matrices when solving the inner $A$ block of the Stokes system. By default ASPECT recognizes cases where the A block is nonsymmetric automatically, and chooses an appropriate solver. However, if the inner A block solver does not converge, this parameter can be set to 'true' to force the use of a solver that can handle nonsymmetric matrices. -36 +37 [Bool] @@ -24174,7 +25493,7 @@ This parameter determines whether to enforce a solver that supports nonsymmetric This is the number of iterations that define the GMRES solver restart length. Increasing this parameter helps with convergence issues arising from high localized viscosity jumps in the domain. Be aware that increasing this number increases the memory usage of the Stokes solver, and makes individual Stokes iterations more expensive. -33 +34 [Integer range 1...2147483647 (inclusive)] @@ -24191,7 +25510,7 @@ This is the number of iterations that define the GMRES solver restart length. In This is the sole parameter for the IDR(s) Krylov solver and will dictate the number of matrix-vector products and preconditioner applications per iteration (s+1) and the total number of temporary vectors required (5+3*s). For s=1, this method is analogous to BiCGStab. As s is increased this method is expected to converge to GMRES in terms of matrix-vector/preconditioner applications to solution. -29 +30 [Integer range 1...2147483647 (inclusive)] @@ -24208,7 +25527,7 @@ GMRES This is the Krylov method used to solve the Stokes system. Both options, GMRES and IDR(s), solve non-symmetric, indefinite systems. GMRES guarantees the residual will be reduced in each iteration while IDR(s) has no such property. On the other hand, the vector storage requirement for GMRES is dependent on the restart length and can be quite restrictive (since, for the matrix-free GMG solver, memory is dominated by these vectors) whereas IDR(s) has a short term recurrence. Note that the IDR(s) Krylov method is not available for the AMG solver since it is not a flexible method, i.e., it cannot handle a preconditioner which may change in each iteration (the AMG-based preconditioner contains a CG solve in the pressure space which may have different number of iterations each step). -28 +29 [Selection GMRES|IDR(s) ] @@ -24225,7 +25544,7 @@ This is the Krylov method used to solve the Stokes system. Both options, GMRES a A relative tolerance up to which the approximate inverse of the $A$ block of the Stokes system is computed. This approximate $A$ is used in the preconditioning used in the GMRES solver. The exact definition of this block preconditioner for the Stokes equation can be found in \cite{kronbichler:etal:2012}. -34 +35 [Double 0...1 (inclusive)] @@ -24242,7 +25561,7 @@ A relative tolerance up to which the approximate inverse of the $A$ block of the A relative tolerance up to which the approximate inverse of the $S$ block (i.e., the Schur complement matrix $S = BA^{-1}B^{T}$) of the Stokes system is computed. This approximate inverse of the $S$ block is used in the preconditioning used in the GMRES solver. The exact definition of this block preconditioner for the Stokes equation can be found in \cite{kronbichler:etal:2012}. -37 +38 [Double 0...1 (inclusive)] @@ -24261,7 +25580,7 @@ A relative tolerance up to which the linear Stokes systems in each time or nonli In practice, you should choose the value of this parameter to be so that if you make it smaller the results of your simulation do not change any more (qualitatively) whereas if you make it larger, they do. For most cases, the default value should be sufficient. In fact, a tolerance of 1e-4 might be accurate enough. -30 +31 [Double 0...1 (inclusive)] @@ -24278,7 +25597,7 @@ In practice, you should choose the value of this parameter to be so that if you This sets the maximum number of iterations used in the expensive Stokes solver. If this value is set too low for the size of the problem, the Stokes solver will not converge and return an error message pointing out that the user didn't allow a sufficiently large number of iterations for the iterative solver to converge. -32 +33 [Integer range 0...2147483647 (inclusive)] @@ -24295,7 +25614,7 @@ This sets the maximum number of iterations used in the expensive Stokes solver. As explained in the paper that describes ASPECT (Kronbichler, Heister, and Bangerth, 2012, see \cite{kronbichler:etal:2012}) we first try to solve the Stokes system in every time step using a GMRES iteration with a poor but cheap preconditioner. By default, we try whether we can converge the GMRES solver in 200 such iterations before deciding that we need a better preconditioner. This is sufficient for simple problems with variable viscosity and we never need the second phase with the more expensive preconditioner. On the other hand, for more complex problems, and in particular for problems with strongly nonlinear viscosity, the 200 cheap iterations don't actually do very much good and one might skip this part right away. In that case, this parameter can be set to zero, i.e., we immediately start with the better but more expensive preconditioner. -31 +32 [Integer range 0...2147483647 (inclusive)] @@ -24312,7 +25631,7 @@ default solver This is the type of solver used on the Stokes system. The block geometric multigrid solver currently has a limited implementation and therefore may trigger Asserts in the code when used. If this is the case, please switch to 'block AMG'. Additionally, the block GMG solver requires using material model averaging. The 'default solver' chooses the geometric multigrid solver if supported, otherwise the AMG solver. -25 +26 [Selection default solver|block AMG|direct solver|block GMG ] @@ -24329,7 +25648,7 @@ false If set to true the linear system for the Stokes equation will be solved using Trilinos klu, otherwise an iterative Schur complement solver is used. The direct solver is only efficient for small problems. -26 +27 [Bool] @@ -24350,7 +25669,7 @@ There is no clear way to determine which preconditioner performs better. The def The default value should be good for relatively simple models, but in particular for very strong viscosity contrasts the full $A$ block can be advantageous. This parameter is always set to true when using the GMG solver. -35 +36 [Bool] @@ -24367,7 +25686,7 @@ false If set to true, the Schur complement approximation in the Block preconditioner uses the weighted BFBT preconditioner, otherwise a weighted mass matrix will be used. The BFBT preconditioner is more expensive, but works better for large viscosity variations. -27 +28 [Bool] @@ -24392,7 +25711,7 @@ These choices correspond to the following methods by which the temperature field \item ``static'': If a temperature field is marked this way, then it does not evolve at all. Its values are simply set to the initial conditions, and will then never change.\end{itemize} -92 +93 [Selection field|prescribed field|prescribed field with diffusion|static ] @@ -24411,7 +25730,7 @@ false Whether to checkpoint the simulation right before termination. -372 +442 [Bool] @@ -24428,7 +25747,7 @@ Whether to checkpoint the simulation right before termination. Terminate the simulation once the specified timestep has been reached. -362 +432 [Integer range 0...2147483647 (inclusive)] @@ -24461,7 +25780,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. -360 +430 [MultipleSelection end step|end time|steady state heat flux|steady state temperature|steady state velocity|user request|wall time ] @@ -24478,7 +25797,7 @@ The criterion considers the total heat flux over all boundaries listed by their The wall time of the simulation. Unit: hours. -364 +434 [Double 0...MAX_DOUBLE (inclusive)] @@ -24494,7 +25813,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. -367 +437 [List of <[Anything]> of length 0...4294967295 (inclusive)] @@ -24511,7 +25830,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. -365 +435 [Double 0...MAX_DOUBLE (inclusive)] @@ -24528,7 +25847,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. -366 +436 [Double 0...MAX_DOUBLE (inclusive)] @@ -24547,7 +25866,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. -370 +440 [Double 0...MAX_DOUBLE (inclusive)] @@ -24564,7 +25883,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. -371 +441 [Double 0...MAX_DOUBLE (inclusive)] @@ -24583,7 +25902,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. -368 +438 [Double 0...MAX_DOUBLE (inclusive)] @@ -24600,7 +25919,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. -369 +439 [Double 0...MAX_DOUBLE (inclusive)] @@ -24619,7 +25938,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. -361 +431 [FileName (Type: input)] @@ -24648,7 +25967,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". -374 +444 [MultipleSelection conduction time step|convection time step|function|repeat on cutback|repeat on nonlinear solver failure ] @@ -24665,7 +25984,7 @@ A large reduction in time step size typically happens when velocities change abr Specify a minimum time step size (or 0 to disable). -373 +443 [Double 0...MAX_DOUBLE (inclusive)] @@ -24681,7 +26000,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.) -377 +447 [Anything] @@ -24698,7 +26017,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'. -378 +448 [Anything] @@ -24715,7 +26034,7 @@ time Name for the variable representing the current time. -379 +449 [Anything] @@ -24734,7 +26053,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. -381 +451 [Double 0...MAX_DOUBLE (inclusive)] @@ -24751,7 +26070,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. -380 +450 [Double 0...MAX_DOUBLE (inclusive)] @@ -24770,7 +26089,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. -382 +452 [Double 0...MAX_DOUBLE (inclusive)] @@ -24790,7 +26109,7 @@ A factor that controls the size of the time step when repeating. The default of Number of divisions per dimension when computing the initial volume fractions.If set to the default of 3 for a 2d model, then initialization will be based on the initialization criterion at $3^2=9$ points within each cell. If the initialization based on a composition style initial condition, a larger value may be desired for better approximation of the initial fluid fractions. Smaller values will suffice in the case of level set initializations due to the presence of more information to better approximate the initial fluid fractions. -102 +103 [Integer range 1...2147483647 (inclusive)] @@ -24807,7 +26126,7 @@ Number of divisions per dimension when computing the initial volume fractions.If Minimum significant volume. Fluid fractions below this value are considered to be zero. -100 +101 [Double 0...1 (inclusive)] @@ -24824,7 +26143,7 @@ Minimum significant volume. Fluid fractions below this value are considered to b The relative tolerance up to which the linear system for the Volume of Fluid system gets solved. See 'Solver parameters/Composition solver tolerance' for more details. -101 +102 [Double 0...1 (inclusive)] diff --git a/doc/sphinx/parameters/Material_20model.md b/doc/sphinx/parameters/Material_20model.md index f2b29ccc903..b8788cd49a8 100644 --- a/doc/sphinx/parameters/Material_20model.md +++ b/doc/sphinx/parameters/Material_20model.md @@ -2332,7 +2332,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:** $\alpha_F$: exponential dependency of viscosity on the depletion field $F$ (called peridotite). Dimensionless factor. With a value of 0.0 (the default) the viscosity does not depend on the depletion. The effective viscosity increasedue to depletion is defined as $exp( \alpha_F * F)$. Rationale: melting dehydrates the source rock by removing most of the volatiles,and makes it stronger. Hirth and Kohlstedt (1996) report typical values around a factor 100 to 1000 viscosity contrast between wet and dry rocks, although some experimental studies report a smaller (factor 10) contrast (e.g. Fei et al., 2013). +**Documentation:** $\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). (parameters:Material_20model/Melt_20global/Exponential_20melt_20weakening_20factor)= ### __Parameter name:__ Exponential melt weakening factor diff --git a/doc/sphinx/parameters/Particles.md b/doc/sphinx/parameters/Particles.md index 90f547376d5..441dbc34388 100644 --- a/doc/sphinx/parameters/Particles.md +++ b/doc/sphinx/parameters/Particles.md @@ -125,6 +125,14 @@ The following properties are available: **Documentation:** 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 `n\_number\_of\_particles` $<$ `min\_particles\_per\_cell` particles in one cell then `min\_particles\_per\_cell` - `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. +(parameters:Particles/Number_20of_20particle_20systems)= +### __Parameter name:__ Number of particle systems +**Default value:** 1 + +**Pattern:** [Integer range 0...2 (inclusive)] + +**Documentation:** The number of particle systems to be created. The maximum number of particle systems is set by the CMake variable ‘ASPECT_MAX_NUM_PARTICLE_SYSTEMS‘ and is by default 2. + (parameters:Particles/Particle_20generator_20name)= ### __Parameter name:__ Particle generator name **Default value:** random uniform @@ -419,6 +427,32 @@ If the function you are describing represents a vector-valued function with mult **Documentation:** 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. +(parameters:Particles/Generator/Random_20uniform)= +## **Subsection:** Particles / Generator / Random uniform +(parameters:Particles/Generator/Random_20uniform/Number_20of_20particles)= +### __Parameter name:__ Number of particles +**Default value:** 1000 + +**Pattern:** [Double 0...MAX_DOUBLE (inclusive)] + +**Documentation:** 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. + +(parameters:Particles/Generator/Random_20uniform/Random_20cell_20selection)= +### __Parameter name:__ Random cell selection +**Default value:** true + +**Pattern:** [Bool] + +**Documentation:** 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. + +(parameters:Particles/Generator/Random_20uniform/Random_20number_20seed)= +### __Parameter name:__ Random number seed +**Default value:** 5432 + +**Pattern:** [Integer range 0...2147483647 (inclusive)] + +**Documentation:** 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. + (parameters:Particles/Generator/Reference_20cell)= ## **Subsection:** Particles / Generator / Reference cell (parameters:Particles/Generator/Reference_20cell/Number_20of_20particles_20per_20cell_20per_20direction)= diff --git a/doc/sphinx/parameters/Particles_202.md b/doc/sphinx/parameters/Particles_202.md new file mode 100644 index 00000000000..d6e7c3227c6 --- /dev/null +++ b/doc/sphinx/parameters/Particles_202.md @@ -0,0 +1,664 @@ +(parameters:Particles_202)= +# Particles 2 + + +## **Subsection:** Particles 2 + + +(parameters:Particles_202/Allow_20cells_20without_20particles)= +### __Parameter name:__ Allow cells without particles +**Default value:** false + +**Pattern:** [Bool] + +**Documentation:** 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. + +(parameters:Particles_202/Integration_20scheme)= +### __Parameter name:__ Integration scheme +**Default value:** rk2 + +**Pattern:** [Selection euler|rk2|rk4 ] + +**Documentation:** This parameter is used to decide which method to use to solve the equation that describes the position of particles, i.e., $\frac{d}{dt}\mathbf x_k(t) = \mathbf u(\mathbf x_k(t),t)$, where $k$ is an index that runs over all particles, and $\mathbf u(\mathbf x,t)$ is the velocity field that results from the Stokes equations. + +In practice, the exact velocity $\mathbf u(\mathbf x,t)$ is of course not available, but only a numerical approximation $\mathbf u_h(\mathbf x,t)$. Furthermore, this approximation is only available at discrete time steps, $\mathbf u^n(\mathbf x)=\mathbf u(\mathbf x,t^n)$, and these need to be interpolated between time steps if the integrator for the equation above requires an evaluation at time points between the discrete time steps. If we denote this interpolation in time by $\tilde{\mathbf u}_h(\mathbf x,t)$ where $\tilde{\mathbf u}_h(\mathbf x,t^n)=\mathbf u^n(\mathbf x)$, then the equation the differential equation solver really tries to solve is $\frac{d}{dt}\tilde{\mathbf x}_k(t) = \tilde{\mathbf u}_h(\mathbf x_k(t),t)$. + +As a consequence of these considerations, if you try to assess convergence properties of an ODE integrator -- for example to verify that the RK4 integrator converges with fourth order --, it is important to recall that the integrator may not solve the equation you think it solves. If, for example, we call the numerical solution of the ODE $\tilde{\mathbf x}_{k,h}(t)$, then the error will typically satisfy a relationship like \[ \| \tilde{\mathbf x}_k(T) - \tilde{\mathbf x}_{k,h}(T) \| \le C(T) \Delta t^p\] where $\Delta t$ is the time step and $p$ the convergence order of the method, and $C(T)$ is a (generally unknown) constant that depends on the end time $T$ at which one compares the solutions. On the other hand, an analytically computed trajectory would likely use the *exact* velocity, and one may be tempted to compute $\| \mathbf x_k(T) - \tilde{\mathbf x}_{k,h}(T) \|$, but this quantity will, in the best case, only satisfy an estimate of the form \[ \| \mathbf x_k(T) - \tilde{\mathbf x}_{k,h}(T) \| \le C_1(T) \Delta t^p + C_2(T) \| \mathbf u-\mathbf u_h \| + C_3(T) \| \mathbf u_h-\tilde{\mathbf u}_h \|\] with appropriately chosen norms for the second and third term. These second and third terms typically converge to zero at relatively low rates (compared to the order $p$ of the integrator, which can often be chosen relatively high) in the mesh size $h$ and the time step size $\\Delta t$, limiting the overall accuracy of the ODE integrator. + +Select one of the following models: + +‘euler’: Explicit Euler scheme integrator, where $y_{n+1} = y_n + \Delta t \, v(y_n)$. This requires only one integration substep per timestep. + +‘rk2’: Second Order Runge Kutta integrator $y_{n+1} = y_n + \Delta t\, v(t_{n+1/2}, y_{n} + \frac{1}{2} k_1)$ where $k_1 = \Delta t\, v(t_{n}, y_{n})$ + +‘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. + +(parameters:Particles_202/Interpolation_20scheme)= +### __Parameter name:__ Interpolation scheme +**Default value:** cell average + +**Pattern:** [Selection bilinear least squares|cell average|distance weighted average|harmonic average|nearest neighbor|quadratic least squares ] + +**Documentation:** Select one of the following models: + +‘bilinear least squares’: Uses linear least squares to obtain the slopes and center of a 2d or 3d plane from the particle positions and a particular property value on those particles. Interpolate this property onto a vector of points. If the limiter is enabled then it will ensure the interpolated properties do not exceed the range of the minimum and maximum of the values of the property on the particles. Note that deal.II must be configured with BLAS and LAPACK to support this operation. + +‘cell average’: Return the arithmetic average of all particle properties in the given cell, or in the neighboring cells if the given cell is empty. In case the neighboring cells are also empty, and ’Allow cells without particles’ is set to true, the interpolator returns 0. Otherwise, an exception is thrown. + +‘distance weighted average’: Interpolates particle properties onto a vector of points using a distance weighed averaging method. + +‘harmonic average’: Return the harmonic average of all particle properties in the given cell. If the cell contains no particles, return the harmonic average of the properties in the neighboring cells. In case the neighboring cells are also empty, and ’Allow cells without particles’ is set to true, the interpolator returns 0. Otherwise, an exception is thrown. + +‘nearest neighbor’: Return the properties of the nearest neighboring particle in the current cell, or nearest particle in nearest neighboring cell if current cell is empty. In case the neighboring cells are also empty, and ’Allow cells without particles’ is set to true, the interpolator returns 0. Otherwise, an exception is thrown. + +‘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. + +(parameters:Particles_202/List_20of_20particle_20properties)= +### __Parameter name:__ List of particle properties +**Default value:** + +**Pattern:** [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 ] + +**Documentation:** A comma separated list of particle properties that should be tracked. By default none is selected, which means only position, velocity and id of the particles are output. + +The following properties are available: + +‘composition’: Implementation of a plugin in which the particle property is defined by the compositional fields in the model. This can be used to track solid compositionevolution over time. + +‘cpo bingham average’: This is a particle property plugin which computes the Bingham average for the Crystal Preferred Orientation particle property plugin so that it can be visualized. + +‘cpo elastic tensor’: A plugin in which the particle property tensor is defined as the Voigt average of the elastic tensors of the minerals in the textured rock.Currently only Olivine and Enstatite are supported. + +‘crystal preferred orientation’: WARNING: all the CPO plugins are a work in progress and not ready for production use yet. See https://github.com/geodynamics/aspect/issues/3885 for current status and alternatives. The plugin manages and computes the evolution of Lattice/Crystal Preferred Orientations (LPO/CPO) on particles. Each ASPECT particle can be assigned many grains. Each grain is assigned a size and a orientation matrix. This allows for CPO evolution tracking with polycrystalline kinematic CrystalPreferredOrientation evolution models such as D-Rex (Kaminski and Ribe, 2001; Kaminski et al., 2004). + +‘elastic stress’: A plugin in which the particle property tensor is defined as the total elastic stress a particle has accumulated. See the viscoelastic material model documentation for more detailed information. + +‘elastic tensor decomposition’: A plugin which decomposes the elastic tensor into different approximations (Isotropic, Hexagonal, Tetragonal, Orthorhombic, Monoclinic and Triclinic) and provides the eigenvectors of the tensor. + +‘function’: Implementation of a model in which the particle property is set by evaluating an explicit function at the initial position of each particle. The function is defined in the parameters in section “Particles|Function”. The format of these functions follows the syntax understood by the muparser library, see {ref}`sec:run-aspect:parameters-overview:muparser-format`. + +‘grain size’: A plugin in which the particle property is defined as the evolving grain size of a particle. See the grain_size material model documentation for more detailed information. + +‘initial composition’: Implementation of a plugin in which the particle property is given as the initial composition at the particle’s initial position. The particle gets as many properties as there are compositional fields. + +‘initial position’: Implementation of a plugin in which the particle property is given as the initial position of the particle. This property is vector-valued with as many components as there are space dimensions. In practice, it is often most useful to only visualize one of the components of this vector, or the magnitude of the vector. For example, in a spherical mantle simulation, the magnitude of this property equals the starting radius of a particle, and is thereby indicative of which part of the mantle a particle comes from. + +‘integrated strain’: A plugin in which the particle property tensor is defined as the deformation gradient tensor $\mathbf F$ this particle has experienced. $\mathbf F$ can be polar-decomposed into the left stretching tensor $\mathbf L$ (the finite strain we are interested in), and the rotation tensor $\mathbf Q$. See the corresponding cookbook in the manual for more detailed information. + +‘integrated strain invariant’: A plugin in which the particle property is defined as the finite strain invariant ($\varepsilon_{ii}$). This property is calculated with the timestep ($dt$) and the second invariant of the deviatoric strain rate tensor ($\dot{\varepsilon}_{ii}$), where the value at time step $n$ is $\varepsilon_{ii}^{n} = \varepsilon_{ii}^{n-1} + dt\dot{\varepsilon}_{ii}$. + +‘melt particle’: Implementation of a plugin in which the particle property is defined as presence of melt above a threshold, which can be set as an input parameter. This property is set to 0 if melt is not present and set to 1 if melt is present. + +‘pT path’: Implementation of a plugin in which the particle property is defined as the current pressure and temperature at this position. This can be used to generate pressure-temperature paths of material points over time. + +‘position’: Implementation of a plugin in which the particle property is defined as the current position. + +‘reference position’: Implementation of a plugin in which the particle property is defined as the current reference position. + +‘strain rate’: Implementation of a plugin in which the time evolution of strain rate is saved and stored on the particles. + +‘velocity’: Implementation of a plugin in which the particle property is defined as the recent velocity at this position. + +‘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 `benchmarks/buiter\_et\_al\_2008\_jgr/plugin/`,and is effectively the same as what the visco plastic material model uses for compositional fields. + +(parameters:Particles_202/Load_20balancing_20strategy)= +### __Parameter name:__ Load balancing strategy +**Default value:** repartition + +**Pattern:** [MultipleSelection none|remove particles|add particles|remove and add particles|repartition ] + +**Documentation:** Strategy that is used to balance the computational load across processors for adaptive meshes. + +(parameters:Particles_202/Maximum_20particles_20per_20cell)= +### __Parameter name:__ Maximum particles per cell +**Default value:** 100 + +**Pattern:** [Integer range 0...2147483647 (inclusive)] + +**Documentation:** 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 `n\_number\_of\_particles` $>$ `max\_particles\_per\_cell` particles in one cell then `n\_number\_of\_particles` - `max\_particles\_per\_cell` particles in this cell are randomly chosen and destroyed. + +(parameters:Particles_202/Minimum_20particles_20per_20cell)= +### __Parameter name:__ Minimum particles per cell +**Default value:** 0 + +**Pattern:** [Integer range 0...2147483647 (inclusive)] + +**Documentation:** 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 `n\_number\_of\_particles` $<$ `min\_particles\_per\_cell` particles in one cell then `min\_particles\_per\_cell` - `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. + +(parameters:Particles_202/Particle_20generator_20name)= +### __Parameter name:__ Particle generator name +**Default value:** random uniform + +**Pattern:** [Selection ascii file|probability density function|quadrature points|random uniform|reference cell|uniform box|uniform radial ] + +**Documentation:** Select one of the following models: + +‘ascii file’: Generates a distribution of particles from coordinates specified in an Ascii data file. The file format is a simple text file, with as many columns as spatial dimensions and as many lines as particles to be generated. Initial comment lines starting with ‘#’ will be discarded. Note that this plugin always generates as many particles as there are coordinates in the data file, the “Particles/Number of particles” parameter has no effect on this plugin. All of the values that define this generator are read from a section “Particles/Generator/Ascii file” in the input file, see {ref}`parameters:Particles/Generator/Ascii_20file`. + +‘probability density function’: Generate a random distribution of particles over the entire simulation domain. The probability density is prescribed in the form of a user-prescribed function. The format of this function follows the syntax understood by the muparser library, see {ref}`sec:run-aspect:parameters-overview:muparser-format`. The return value of the function is always checked to be a non-negative probability density but it can be zero in parts of the domain. + +‘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. + +‘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. + +‘uniform box’: Generate a uniform distribution of particles over a rectangular domain in 2d or 3d. Uniform here means the particles will be generated with an equal spacing in each spatial dimension. 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. + +‘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. + +(parameters:Particles_202/Particle_20weight)= +### __Parameter name:__ Particle weight +**Default value:** 10 + +**Pattern:** [Integer range 0...2147483647 (inclusive)] + +**Documentation:** 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. + +(parameters:Particles_202/Update_20ghost_20particles)= +### __Parameter name:__ Update ghost particles +**Default value:** true + +**Pattern:** [Bool] + +**Documentation:** 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’. + +(parameters:Particles_202/CPO_20Bingham_20Average)= +## **Subsection:** Particles 2 / CPO Bingham Average +(parameters:Particles_202/CPO_20Bingham_20Average/Number_20of_20samples)= +### __Parameter name:__ Number of samples +**Default value:** 0 + +**Pattern:** [Double 0...MAX_DOUBLE (inclusive)] + +**Documentation:** 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. + +(parameters:Particles_202/CPO_20Bingham_20Average/Random_20number_20seed)= +### __Parameter name:__ Random number seed +**Default value:** 1 + +**Pattern:** [Integer range 0...2147483647 (inclusive)] + +**Documentation:** 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. + +(parameters:Particles_202/Crystal_20Preferred_20Orientation)= +## **Subsection:** Particles 2 / Crystal Preferred Orientation +(parameters:Particles_202/Crystal_20Preferred_20Orientation/CPO_20derivatives_20algorithm)= +### __Parameter name:__ CPO derivatives algorithm +**Default value:** Spin tensor + +**Pattern:** [List of <[Anything]> of length 0...4294967295 (inclusive)] + +**Documentation:** Options: Spin tensor + +(parameters:Particles_202/Crystal_20Preferred_20Orientation/Number_20of_20grains_20per_20particle)= +### __Parameter name:__ Number of grains per particle +**Default value:** 50 + +**Pattern:** [Integer range 1...2147483647 (inclusive)] + +**Documentation:** The number of grains of each different mineral each particle contains. + +(parameters:Particles_202/Crystal_20Preferred_20Orientation/Property_20advection_20max_20iterations)= +### __Parameter name:__ Property advection max iterations +**Default value:** 100 + +**Pattern:** [Integer range 0...2147483647 (inclusive)] + +**Documentation:** 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. + +(parameters:Particles_202/Crystal_20Preferred_20Orientation/Property_20advection_20method)= +### __Parameter name:__ Property advection method +**Default value:** Backward Euler + +**Pattern:** [Anything] + +**Documentation:** Options: Forward Euler, Backward Euler + +(parameters:Particles_202/Crystal_20Preferred_20Orientation/Property_20advection_20tolerance)= +### __Parameter name:__ Property advection tolerance +**Default value:** 1e-10 + +**Pattern:** [Double 0...MAX_DOUBLE (inclusive)] + +**Documentation:** 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. + +(parameters:Particles_202/Crystal_20Preferred_20Orientation/Random_20number_20seed)= +### __Parameter name:__ Random number seed +**Default value:** 1 + +**Pattern:** [Integer range 0...2147483647 (inclusive)] + +**Documentation:** 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. + +(parameters:Particles_202/Crystal_20Preferred_20Orientation/D_2dRex_202004)= +## **Subsection:** Particles 2 / Crystal Preferred Orientation / D-Rex 2004 +(parameters:Particles_202/Crystal_20Preferred_20Orientation/D_2dRex_202004/Exponents_20p)= +### __Parameter name:__ Exponents p +**Default value:** 1.5 + +**Pattern:** [Double 0...MAX_DOUBLE (inclusive)] + +**Documentation:** This is exponent p as defined in equation 11 of Kaminski et al., 2004. + +(parameters:Particles_202/Crystal_20Preferred_20Orientation/D_2dRex_202004/Mobility)= +### __Parameter name:__ Mobility +**Default value:** 50 + +**Pattern:** [Double 0...MAX_DOUBLE (inclusive)] + +**Documentation:** The dimensionless intrinsic grain boundary mobility for both olivine and enstatite. + +(parameters:Particles_202/Crystal_20Preferred_20Orientation/D_2dRex_202004/Nucleation_20efficiency)= +### __Parameter name:__ Nucleation efficiency +**Default value:** 5 + +**Pattern:** [Double 0...MAX_DOUBLE (inclusive)] + +**Documentation:** This is the dimensionless nucleation rate as defined in equation 8 of Kaminski et al., 2004. + +(parameters:Particles_202/Crystal_20Preferred_20Orientation/D_2dRex_202004/Stress_20exponents)= +### __Parameter name:__ Stress exponents +**Default value:** 3.5 + +**Pattern:** [Double 0...MAX_DOUBLE (inclusive)] + +**Documentation:** 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. + +(parameters:Particles_202/Crystal_20Preferred_20Orientation/D_2dRex_202004/Threshold_20GBS)= +### __Parameter name:__ Threshold GBS +**Default value:** 0.3 + +**Pattern:** [Double 0...MAX_DOUBLE (inclusive)] + +**Documentation:** The Dimensionless Grain Boundary Sliding (GBS) threshold. This is a grain size threshold below which grain deform by GBS and become strain-free grains. + +(parameters:Particles_202/Crystal_20Preferred_20Orientation/D_2dRex_202004/Volume_20fractions_20minerals)= +### __Parameter name:__ Volume fractions minerals +**Default value:** 0.5, 0.5 + +**Pattern:** [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] + +**Documentation:** The volume fraction for the different minerals. There need to be the same amount of values as there are minerals + +(parameters:Particles_202/Crystal_20Preferred_20Orientation/Initial_20grains)= +## **Subsection:** Particles 2 / Crystal Preferred Orientation / Initial grains +(parameters:Particles_202/Crystal_20Preferred_20Orientation/Initial_20grains/Minerals)= +### __Parameter name:__ Minerals +**Default value:** Olivine: Karato 2008, Enstatite + +**Pattern:** [List of <[Anything]> of length 0...4294967295 (inclusive)] + +**Documentation:** 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). + +(parameters:Particles_202/Crystal_20Preferred_20Orientation/Initial_20grains/Model_20name)= +### __Parameter name:__ Model name +**Default value:** Uniform grains and random uniform rotations + +**Pattern:** [Anything] + +**Documentation:** 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. + +(parameters:Particles_202/Crystal_20Preferred_20Orientation/Initial_20grains/Volume_20fractions_20minerals)= +### __Parameter name:__ Volume fractions minerals +**Default value:** 0.7, 0.3 + +**Pattern:** [List of <[Double 0...MAX_DOUBLE (inclusive)]> of length 0...4294967295 (inclusive)] + +**Documentation:** 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 + +(parameters:Particles_202/Function)= +## **Subsection:** Particles 2 / Function +(parameters:Particles_202/Function/Function_20constants)= +### __Parameter name:__ Function constants +**Default value:** + +**Pattern:** [Anything] + +**Documentation:** Sometimes it is convenient to use symbolic constants in the expression that describes the function, rather than having to use its numeric value everywhere the constant appears. These values can be defined using this parameter, in the form ‘var1=value1, var2=value2, ...’. + +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.) + +(parameters:Particles_202/Function/Function_20expression)= +### __Parameter name:__ Function expression +**Default value:** 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. + +(parameters:Particles_202/Function/Number_20of_20components)= +### __Parameter name:__ Number of components +**Default value:** 1 + +**Pattern:** [Integer range 0...2147483647 (inclusive)] + +**Documentation:** The number of function components where each component is described by a function expression delimited by a ’;’. + +(parameters:Particles_202/Function/Variable_20names)= +### __Parameter name:__ Variable names +**Default value:** x,y,t + +**Pattern:** [Anything] + +**Documentation:** 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. + +(parameters:Particles_202/Generator)= +## **Subsection:** Particles 2 / Generator +(parameters:Particles_202/Generator/Ascii_20file)= +## **Subsection:** Particles 2 / Generator / Ascii file +(parameters:Particles_202/Generator/Ascii_20file/Data_20directory)= +### __Parameter name:__ Data directory +**Default value:** $ASPECT_SOURCE_DIR/data/particle/generator/ascii/ + +**Pattern:** [DirectoryName] + +**Documentation:** 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. + +(parameters:Particles_202/Generator/Ascii_20file/Data_20file_20name)= +### __Parameter name:__ Data file name +**Default value:** particle.dat + +**Pattern:** [Anything] + +**Documentation:** The name of the particle file. + +(parameters:Particles_202/Generator/Probability_20density_20function)= +## **Subsection:** Particles 2 / Generator / Probability density function +(parameters:Particles_202/Generator/Probability_20density_20function/Function_20constants)= +### __Parameter name:__ Function constants +**Default value:** + +**Pattern:** [Anything] + +**Documentation:** Sometimes it is convenient to use symbolic constants in the expression that describes the function, rather than having to use its numeric value everywhere the constant appears. These values can be defined using this parameter, in the form ‘var1=value1, var2=value2, ...’. + +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.) + +(parameters:Particles_202/Generator/Probability_20density_20function/Function_20expression)= +### __Parameter name:__ Function expression +**Default value:** 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. + +(parameters:Particles_202/Generator/Probability_20density_20function/Number_20of_20particles)= +### __Parameter name:__ Number of particles +**Default value:** 1000 + +**Pattern:** [Double 0...MAX_DOUBLE (inclusive)] + +**Documentation:** 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. + +(parameters:Particles_202/Generator/Probability_20density_20function/Random_20cell_20selection)= +### __Parameter name:__ Random cell selection +**Default value:** true + +**Pattern:** [Bool] + +**Documentation:** 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. + +(parameters:Particles_202/Generator/Probability_20density_20function/Random_20number_20seed)= +### __Parameter name:__ Random number seed +**Default value:** 5432 + +**Pattern:** [Integer range 0...2147483647 (inclusive)] + +**Documentation:** 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. + +(parameters:Particles_202/Generator/Probability_20density_20function/Variable_20names)= +### __Parameter name:__ Variable names +**Default value:** x,y,t + +**Pattern:** [Anything] + +**Documentation:** 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. + +(parameters:Particles_202/Generator/Random_20uniform)= +## **Subsection:** Particles 2 / Generator / Random uniform +(parameters:Particles_202/Generator/Random_20uniform/Number_20of_20particles)= +### __Parameter name:__ Number of particles +**Default value:** 1000 + +**Pattern:** [Double 0...MAX_DOUBLE (inclusive)] + +**Documentation:** 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. + +(parameters:Particles_202/Generator/Random_20uniform/Random_20cell_20selection)= +### __Parameter name:__ Random cell selection +**Default value:** true + +**Pattern:** [Bool] + +**Documentation:** 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. + +(parameters:Particles_202/Generator/Random_20uniform/Random_20number_20seed)= +### __Parameter name:__ Random number seed +**Default value:** 5432 + +**Pattern:** [Integer range 0...2147483647 (inclusive)] + +**Documentation:** 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. + +(parameters:Particles_202/Generator/Reference_20cell)= +## **Subsection:** Particles 2 / Generator / Reference cell +(parameters:Particles_202/Generator/Reference_20cell/Number_20of_20particles_20per_20cell_20per_20direction)= +### __Parameter name:__ Number of particles per cell per direction +**Default value:** 2 + +**Pattern:** [List of <[Integer range 1...2147483647 (inclusive)]> of length 0...4294967295 (inclusive)] + +**Documentation:** 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. + +(parameters:Particles_202/Generator/Uniform_20box)= +## **Subsection:** Particles 2 / Generator / Uniform box +(parameters:Particles_202/Generator/Uniform_20box/Maximum_20x)= +### __Parameter name:__ Maximum x +**Default value:** 1. + +**Pattern:** [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] + +**Documentation:** Maximum x coordinate for the region of particles. + +(parameters:Particles_202/Generator/Uniform_20box/Maximum_20y)= +### __Parameter name:__ Maximum y +**Default value:** 1. + +**Pattern:** [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] + +**Documentation:** Maximum y coordinate for the region of particles. + +(parameters:Particles_202/Generator/Uniform_20box/Maximum_20z)= +### __Parameter name:__ Maximum z +**Default value:** 1. + +**Pattern:** [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] + +**Documentation:** Maximum z coordinate for the region of particles. + +(parameters:Particles_202/Generator/Uniform_20box/Minimum_20x)= +### __Parameter name:__ Minimum x +**Default value:** 0. + +**Pattern:** [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] + +**Documentation:** Minimum x coordinate for the region of particles. + +(parameters:Particles_202/Generator/Uniform_20box/Minimum_20y)= +### __Parameter name:__ Minimum y +**Default value:** 0. + +**Pattern:** [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] + +**Documentation:** Minimum y coordinate for the region of particles. + +(parameters:Particles_202/Generator/Uniform_20box/Minimum_20z)= +### __Parameter name:__ Minimum z +**Default value:** 0. + +**Pattern:** [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] + +**Documentation:** Minimum z coordinate for the region of particles. + +(parameters:Particles_202/Generator/Uniform_20box/Number_20of_20particles)= +### __Parameter name:__ Number of particles +**Default value:** 1000 + +**Pattern:** [Double 0...MAX_DOUBLE (inclusive)] + +**Documentation:** 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. + +(parameters:Particles_202/Generator/Uniform_20radial)= +## **Subsection:** Particles 2 / Generator / Uniform radial +(parameters:Particles_202/Generator/Uniform_20radial/Center_20x)= +### __Parameter name:__ Center x +**Default value:** 0. + +**Pattern:** [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] + +**Documentation:** x coordinate for the center of the spherical region, where particles are generated. + +(parameters:Particles_202/Generator/Uniform_20radial/Center_20y)= +### __Parameter name:__ Center y +**Default value:** 0. + +**Pattern:** [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] + +**Documentation:** y coordinate for the center of the spherical region, where particles are generated. + +(parameters:Particles_202/Generator/Uniform_20radial/Center_20z)= +### __Parameter name:__ Center z +**Default value:** 0. + +**Pattern:** [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] + +**Documentation:** z coordinate for the center of the spherical region, where particles are generated. + +(parameters:Particles_202/Generator/Uniform_20radial/Maximum_20latitude)= +### __Parameter name:__ Maximum latitude +**Default value:** 180. + +**Pattern:** [Double 0...180 (inclusive)] + +**Documentation:** Maximum latitude coordinate for the region of particles in degrees. Measured from the center position, and from the north pole. + +(parameters:Particles_202/Generator/Uniform_20radial/Maximum_20longitude)= +### __Parameter name:__ Maximum longitude +**Default value:** 360. + +**Pattern:** [Double -180...360 (inclusive)] + +**Documentation:** Maximum longitude coordinate for the region of particles in degrees. Measured from the center position. + +(parameters:Particles_202/Generator/Uniform_20radial/Maximum_20radius)= +### __Parameter name:__ Maximum radius +**Default value:** 1. + +**Pattern:** [Double -MAX_DOUBLE...MAX_DOUBLE (inclusive)] + +**Documentation:** Maximum radial coordinate for the region of particles. Measured from the center position. + +(parameters:Particles_202/Generator/Uniform_20radial/Minimum_20latitude)= +### __Parameter name:__ Minimum latitude +**Default value:** 0. + +**Pattern:** [Double 0...180 (inclusive)] + +**Documentation:** Minimum latitude coordinate for the region of particles in degrees. Measured from the center position, and from the north pole. + +(parameters:Particles_202/Generator/Uniform_20radial/Minimum_20longitude)= +### __Parameter name:__ Minimum longitude +**Default value:** 0. + +**Pattern:** [Double -180...360 (inclusive)] + +**Documentation:** Minimum longitude coordinate for the region of particles in degrees. Measured from the center position. + +(parameters:Particles_202/Generator/Uniform_20radial/Minimum_20radius)= +### __Parameter name:__ Minimum radius +**Default value:** 0. + +**Pattern:** [Double 0...MAX_DOUBLE (inclusive)] + +**Documentation:** Minimum radial coordinate for the region of particles. Measured from the center position. + +(parameters:Particles_202/Generator/Uniform_20radial/Number_20of_20particles)= +### __Parameter name:__ Number of particles +**Default value:** 1000 + +**Pattern:** [Double 0...MAX_DOUBLE (inclusive)] + +**Documentation:** 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. + +(parameters:Particles_202/Generator/Uniform_20radial/Radial_20layers)= +### __Parameter name:__ Radial layers +**Default value:** 1 + +**Pattern:** [Integer range 1...2147483647 (inclusive)] + +**Documentation:** The number of radial shells of particles that will be generated around the central point. + +(parameters:Particles_202/Integrator)= +## **Subsection:** Particles 2 / Integrator +(parameters:Particles_202/Integrator/RK2)= +## **Subsection:** Particles 2 / Integrator / RK2 +(parameters:Particles_202/Integrator/RK2/Higher_20order_20accurate_20in_20time)= +### __Parameter name:__ Higher order accurate in time +**Default value:** true + +**Pattern:** [Bool] + +**Documentation:** 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. + +(parameters:Particles_202/Interpolator)= +## **Subsection:** Particles 2 / Interpolator +(parameters:Particles_202/Interpolator/Bilinear_20least_20squares)= +## **Subsection:** Particles 2 / Interpolator / Bilinear least squares +(parameters:Particles_202/Interpolator/Bilinear_20least_20squares/Use_20boundary_20extrapolation)= +### __Parameter name:__ Use boundary extrapolation +**Default value:** false + +**Pattern:** [List of <[Bool]> of length 0...4294967295 (inclusive)] + +**Documentation:** 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’. + +(parameters:Particles_202/Interpolator/Bilinear_20least_20squares/Use_20linear_20least_20squares_20limiter)= +### __Parameter name:__ Use linear least squares limiter +**Default value:** true + +**Pattern:** [List of <[Bool]> of length 0...4294967295 (inclusive)] + +**Documentation:** 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. + +(parameters:Particles_202/Interpolator/Quadratic_20least_20squares)= +## **Subsection:** Particles 2 / Interpolator / Quadratic least squares +(parameters:Particles_202/Interpolator/Quadratic_20least_20squares/Use_20boundary_20extrapolation)= +### __Parameter name:__ Use boundary extrapolation +**Default value:** false + +**Pattern:** [List of <[Bool]> of length 0...4294967295 (inclusive)] + +**Documentation:** 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’. + +(parameters:Particles_202/Interpolator/Quadratic_20least_20squares/Use_20quadratic_20least_20squares_20limiter)= +### __Parameter name:__ Use quadratic least squares limiter +**Default value:** true + +**Pattern:** [List of <[Bool]> of length 0...4294967295 (inclusive)] + +**Documentation:** 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. + +(parameters:Particles_202/Melt_20particle)= +## **Subsection:** Particles 2 / Melt particle +(parameters:Particles_202/Melt_20particle/Threshold_20for_20melt_20presence)= +### __Parameter name:__ Threshold for melt presence +**Default value:** 1e-3 + +**Pattern:** [Double 0...1 (inclusive)] + +**Documentation:** 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). diff --git a/doc/sphinx/parameters/global.md b/doc/sphinx/parameters/global.md index 17b5744dc72..e49435af750 100644 --- a/doc/sphinx/parameters/global.md +++ b/doc/sphinx/parameters/global.md @@ -110,12 +110,10 @@ Units: \%. ### __Parameter name:__ Nonlinear solver scheme **Default value:** single Advection, single Stokes -**Pattern:** [Selection single Advection, single Stokes|iterated Advection and Stokes|single Advection, iterated Stokes|no Advection, iterated Stokes|no Advection, single Stokes|no Advection, iterated defect correction Stokes|single Advection, iterated defect correction Stokes|iterated Advection and defect correction Stokes|iterated Advection and Newton Stokes|single Advection, iterated Newton Stokes|single Advection, no Stokes|IMPES|iterated IMPES|iterated Stokes|Newton Stokes|Stokes only|Advection only|first timestep only, single Stokes|no Advection, no Stokes ] +**Pattern:** [Selection single Advection, single Stokes|iterated Advection and Stokes|single Advection, iterated Stokes|no Advection, iterated Stokes|no Advection, single Stokes|no Advection, iterated defect correction Stokes|single Advection, iterated defect correction Stokes|iterated Advection and defect correction Stokes|iterated Advection and Newton Stokes|single Advection, iterated Newton Stokes|single Advection, no Stokes|first timestep only, single Stokes|no Advection, no Stokes ] **Documentation:** The kind of scheme used to resolve the nonlinearity in the system. ‘single Advection, single Stokes’ means that no nonlinear iterations are done, and the temperature, compositional fields and Stokes equations are solved exactly once per time step, one after the other. The ‘iterated Advection and Stokes’ scheme iterates this decoupled approach by alternating the solution of the temperature, composition and Stokes systems. The ‘single Advection, iterated Stokes’ scheme solves the temperature and composition equation once at the beginning of each time step and then iterates out the solution of the Stokes equation. The ‘no Advection, iterated Stokes’ scheme only solves the Stokes system, iterating out the solution, and ignores compositions and the temperature equation (careful, the material model must not depend on the temperature or composition; this is mostly useful for Stokes benchmarks). The ‘no Advection, single Stokes’ scheme only solves the Stokes system once per timestep. This is also mostly useful for Stokes benchmarks. The ‘single Advection, no Stokes’ scheme only solves the temperature and other advection systems once, and instead of solving for the Stokes system, a prescribed velocity and pressure is used. The ‘iterated Advection and Newton Stokes’ scheme iterates by alternating the solution of the temperature, composition and Stokes equations, using Picard iterations for the temperature and composition, and Newton iterations for the Stokes system. The ‘single Advection, iterated Newton Stokes’ scheme solves the temperature and composition equations once at the beginning of each time step and then iterates out the solution of the Stokes equation, using Newton iterations for the Stokes system. The ‘iterated Advection and defect correction Stokes’ scheme iterates by alternating the solution of the temperature, composition and Stokes equations, using Picard iterations for the temperature and composition, and defect correction Picard iterations for the Stokes system. The ‘single Advection, iterated defect correction Stokes’ scheme solves the temperature and composition equations once at the beginning of each time step and then iterates out the solution of the Stokes equation, using defect correction Picard iterations for the Stokes system. The ‘no Advection, iterated defect correction Stokes’ scheme solves the temperature and composition equations once at the beginning of each time step and then iterates out the solution of the Stokes equation, using defect correction Picard iterations for the Stokes system. The ‘first timestep only, single Stokes’ scheme solves the Stokes equations exactly once, at the first time step. No nonlinear iterations are done, and the temperature and composition systems are not solved. -The ‘IMPES’ scheme is deprecated and only allowed for reasons of backwards compatibility. It is the same as ‘single Advection, single Stokes’ .The ‘iterated IMPES’ scheme is deprecated and only allowed for reasons of backwards compatibility. It is the same as ‘iterated Advection and Stokes’. The ‘iterated Stokes’ scheme is deprecated and only allowed for reasons of backwards compatibility. It is the same as ‘single Advection, iterated Stokes’. The ‘Stokes only’ scheme is deprecated and only allowed for reasons of backwards compatibility. It is the same as ‘no Advection, iterated Stokes’. The ‘Advection only’ scheme is deprecated and only allowed for reasons of backwards compatibility. It is the same as ‘single Advection, no Stokes’. The ‘Newton Stokes’ scheme is deprecated and only allowed for reasons of backwards compatibility. It is the same as ‘iterated Advection and Newton Stokes’. - (parameters:Nonlinear_20solver_20tolerance)= ### __Parameter name:__ Nonlinear solver tolerance **Default value:** 1e-5 diff --git a/doc/sphinx/parameters/index.md b/doc/sphinx/parameters/index.md index 9418133f93f..2ae050f883e 100644 --- a/doc/sphinx/parameters/index.md +++ b/doc/sphinx/parameters/index.md @@ -28,6 +28,7 @@ Mesh_20deformation.md Mesh_20refinement.md Nullspace_20removal.md Particles.md +Particles_202.md Postprocess.md Prescribed_20Stokes_20solution.md Solver_20parameters.md