fracture template modify-default
command
Syntax
- fracture template modify-default keyword
Primary keywords:
dip-direction-limits dip-limits orientation position size size-limits
Modify the default fracture generation template. A fracture generation template is a set of statistical parameters used to generate fractures with the
fracture generate
command. If no fracture generation template is specified, the default template is used. Upon amodel new
, the default fracture generation template is given the following properties: 1) uniform fracture positions; 2) uniform fracture orientations (dip between 0 and 180 degrees in 2D; dip between 0 and 90 degrees, dip direction between 0 and 360 degrees in 3D); 3) fracture sizes obeying a negative power-law distribution with exponent 4; and 4) minimum fracture size is size 1.0 and maximum fracture size is ∞. The default fracture generation template is saved with the model state and a DFN cannot be linked to the default template. The following keywords may be applied:- dip-direction-limits fmin fmax (3D only)
Specify that the fracture dip directions must fall in the range [fmin, fmax] degrees. By default, fmin = 0 and fmax = 360.
- dip-limits fmin fmax
Specify that the fracture dips must fall in the range [fmin, fmax] degrees. By default, {fmin = 0 and fmax = 180, in 2D; fmin = 0 and fmax =90, in 3D}.
- orientation s a_{1}...a_{n}
Define the generation rule for fracture orientations with the parameters \(a_{1}...a_{n}\). The following options for s are supported:
- bootstrapped: The dip {and dip direction, in 3D} are bootstrapped from a file. One parameter must be given: the file name holding the discrete distribution of values. This file obeys the bootstrapped distribution file format given in DFN-Related File Formats.
- dips (3D only): The dip and dip direction are bootstrapped from a DIPS file. One parameter must be given: the file name holding the discrete distribution of values. This file obeys the DIPS file format given in DFN-Related File Formats.
- fish: The fish keyword is used to get values from a user-defined FISH function. The function name is given using \(a_{1}\), and the function arguments (any number) are given after the function name. The function must return a {float, in 2D; 2 dimensional vector, in 3D}.
- fisher (3D only): The dip and dip direction are drawn from a Fisher distribution. Three additional parameters are required: dip, dip direction and \(\kappa\).
- gauss: The dip {and dip direction, in 3D} are drawn from Gaussian distributions. In 2D, two additional parameters are required, specifying the mean and standard deviation of the dip distribution. In 3D, four additional parameters are required: mean and standard deviation for the dip distribution, followed by mean and standard deviation for the dip-direction distribution.
- uniform: The dip {and dip direction, in 3D} are drawn from a uniform distribution. No additional parameters can be given.
Note
In 2D, dip is the clockwise angle measured from the positive \(x\)-axis in degrees. In 3D, dip is the angle from the dip direction projected on the \(xy\)-plane to the fracture surface measured in the negative \(z\)-direction. Dip direction in 3D is measured in a clockwise fashion from the positive \(y\)-axis.
- position s a_{1}...a_{n}
Define the generation rule for fracture position with parameters . The supported options for s are uniform, gauss, bootstrapped and fish. The meaning of these keywords is the same as for the orientation keyword except that the position is a {2D vector in 2D; 3D vector in 3D}. Consequently, if bootstrapped is specified, the file must contain the required number of values, and if fish is specified, the FISH function must return a vector of correct dimension. Additionally, the mean and standard deviations must be vectors if the gauss keyword is specified.
- size s a_{1}...a_{n}
Define the distribution of fracture sizes. The fracture size is defined as the {fracture length, in 2D; disk diameter, in 3D}. The supported options for s are uniform, gauss, power-law, bootstrapped and fish. The power-law specifier defines a negative power-law distribution which requires one parameter that is the exponent of the distribution with > 0. The remaining s options are as specified in the orientation description, except that the return value is a floating point value. Thus, only two arguments follow the gauss specifier: the bootstrapped file must follow a one-dimensional format; and the fish function must return a single value.
Was this helpful? ... | FLAC3D © 2019, Itasca | Updated: May 17, 2022 |