# HydroGeoSphere/2-D Random Fracture Generator

The 2-D Random Fracture Generator can be used to generate random fracture networks in two dimensions, currently only in the xz-plane. Nevertheless, in the y-direction, more than one block can be used.

## Begin 2D random fractures...End

Causes grok to begin reading instructions that describe the generation of 2-D random fractures until it encounters an End instruction.
The following optional instructions can be used to modify the default behaviour of the fracture generator:

## Number of random fractures

* n rfractures Number of random fractures to generate.
By default, the 2-D random fracture network will consist of 80 fractures.

## Use constant seed

* the_seed Seed for the 2-D Random Fracture Generator.
Causes the 2-D Random Fracture Generator to use a constant seed the_seed to produce the same random fracture network each time grok is run.
By default, the 2-D Random Fracture Generator is seeded with a time-dependent value, based on the current system time. In that case, it produces a different fracture network each time grok is run.
In either case, the seed value is written to the prefixo.eco file and can be used to generate the same random fracture network many times.

## Generate orientation distribution

* or_n_classes Number of orientation classes.
* or_first_class middle Middle of the smallest orientation class.
* or_last_class middle Middle of the largest orientation class.
* or_sigma Standard deviation ${\sigma }_{1}$ of both Gaussian distributions.
* or_my1 Mean ${\mu }_{1}$ of the first Gaussian distribution.
* or_my2 Mean ${\mu }_{2}$ of the second Gaussian distribution.
Causes grok to read the parameters that are used to define the distribution of fracture orientation, which follows a double-peaked Gaussian distribution according to:
    $P({\alpha })=P_{1}({\alpha })+P_{2}({\alpha })$ (Equation 5.1)
where the normal distribution $P(x)$ for a variable $x$ with mean ${\mu }$ and variance ${\alpha }^{2}$ has the probability function
    $P(x)={\frac {1}{{\sigma }{\sqrt {2{\pi }}}}}e^{-{\frac {(x-{\mu })^{2}}{2{\sigma }^{2}}}}$ (Equation 5.2)
for the domain $x{\epsilon }(-{\infty },{\infty })$.
By default, the values given in Table 5.1 are used to define these relationships:
Table 5.1: Default Values for 2-D Random Fracture Orientation :
| Parameter | Value | Unit |
| Number of orientation classes | 13 | - |
| Middle of the smallest orientation class | 30 | degrees |
| Middle of the largest orientation class | 150 | degrees |
| Standard deviation of both classes ${\sigma }$ | 15 | degrees |
| Mean of the first Gaussian distribution ${\mu }_{1}$ | 60 | degrees |
| Mean of the second Gaussian distribution ${\mu }_{2}$ | 120 | degrees |

## Generate aperture distribution

* ap_n_classes Number of aperture classes.
* ap_first_class_middle Middle of the smallest aperture class.
* ap_last_class_middle Middle of the largest aperture class.
* ap_lambda ${\lambda }$ of the exponential aperture distribution.
Causes grok to read the parameters that are used to define the distribution of fracture aperture, which follows an exponential distribution, according to:
    $P(x)=P_{O}\cdot e^{-{\lambda }x}$ (Equation 5.3)
Note that for a high value of ${\lambda }$, the exponential distribution becomes steeper and small apertures are more numerous, whereas a small value of ${\lambda }$ favours larger apertures.
By default, the values given in Table 5.2 are used to define these relationships:
Table 5.2: Default Values for 2-D Random Fracture Aperture :
| Parameter | Value | Unit |
| Number of aperture classes | 10 | - |
| Middle of the smallest aperture class | 50 | microns |
| Middle of the largest aperture class | 300 | microns |
| ${\lambda }$ of the exponential aperture distribution | 9000 | - |

## Generate log-normal length distribution

* le_n_classes Number of length classes.
* le_first_class_middle Middle of the smallest length class.
* le_last_class_middle Middle of the largest length class.
* lognormal_m ${\mu }$ of the log-normal distribution.
* lognormal_s ${\sigma }$ of the log-normal length distribution.
Causes grok to read the parameters that are used to define the distribution of fracture length, which follows a log-normal distribution according to:
    $P(x)={\frac {1}{{\sigma }x{\sqrt {2{\pi }}}}}e^{-{\frac {(lnx-{\mu })^{2}}{2{\sigma }^{2}}}}$ (Equation 5.4)
By default, the values given in Table 5.3 are used to define these relationships:
Table 5.3: Default Values for 2-D Random Fracture Length, Log-normal Distribution :
| Parameter | Value | Unit |
| Number of length classes | 10 | - |
| Middle of the smallest length class | 0.1 $\cdot$ min($L_{x},L_{z}$) † | m ‡ |
| Middle of the largest length class | min($L_{x},L_{z}$) | m |
| ${\mu }$ of the log-normal distribution | 2.9 | - |
| ${\sigma }$ of the log-normal length distribution | 0.45 | - |
† The symbols $L_{x}$ and $L_{z}$ denote the length of the simulation domain the x- and z-directions respectively. ‡ Although metre units of length are shown in this table they may be defined differently by the user as outlined in Section 5.1.2.
It should be noted that the log-normal distribution ${\Lambda }({\mu },{\sigma }^{2})$ results from the curve ${\Lambda }(0,{\sigma }^{2})$ by:
* Stretching of $e^{\mu }$ in the x-direction.
* Stretching of $e^{-{\mu }}$ in the z-direction.
Thus, larger values for ${\mu }$ will move the peak to the right. Altering the standard deviation ${\sigma }$ will have an impact on the scattering of the distribution where a small ${\sigma }$ leads to less scattering and a sharper peak.

## Exponential length distribution

Causes grok to use an exponential distribution of the fracture trace, as opposed to the default log-normal distribution.

## Generate exponential length distribution

* le_n_classes Number of length classes.
* le_first_class_middle Middle of the smallest length class.
* le_last_class_middle Middle of the largest length class.
* le_lambda ${\lambda }$ of the exponential length distribution.
Used in conjunction with the Exponential length distribution instruction, this causes grok to read the parameters that are used to define the distribution of fracture length, which follows an exponential distribution according to:
    $P(x)=P_{O}\cdot e^{-{\lambda }x}$ (Equation 5.5)
Note that for a high value for ${\lambda }$, the exponential distribution becomes steeper and short fractures are more numerous whereas a small ${\lambda }$ favors longer fractures.
By default, the values given in Table 5.4 are used to define these relationships:
Table 5.4: Default Values for 2-D Random Fracture Length, Exponential Distribution :
| Parameter | Value | Unit |
| Number of length classes | 10 | - |
| Middle of the smallest length class | 0.1 $\cdot$ min($L_{x},L_{z}$) † | m ‡ |
| Middle of the largest length class | min($L_{x},L_{z}$) | m |
| ${\lambda }$ of the exponential length distribution | 0.05 | - |
† The symbols $L_{x}$ and $L_{z}$ denote the length of the simulation domain in the x- and z-directions respectively. ‡ Although metre units of length are shown in this table they may be defined differently by the user as outlined in Section 5.1.2.

## Output random apertures

Writes the generated aperture distribution data and individual fracture apertures to the output file prefixo.rfrac.apertures.

## Output random lengths

Writes the generated length distribution data and individual fracture lengths to the output file prefixo.rfrac.lengths.

## Output random orientations

Writes the generated orientation distribution data and individual fracture orientations to the output file prefixo.rfrac.orientations.

## Output random fractures

Writes fracture zone aperture, conductivity and location data to the output file prefixo.rfrac.fractures.

## Default distributions

Figure 5.3 gives an overview of the default distributions which the 2-D Random Fracture Generator employs. The orientation distribution (Figure 5.3a) is based on the assumption that tectonic stress results in the creation of two fracture families as depicted in Figure 5.3b. However, upon assigning identical values for ${\mu }_{1}$ and ${\mu }_{2}$, the distribution collapses to a one-peak distribution. The default distribution for the aperture (Figure 5.3c) is exponential and can be modified by the user. By default, the fracture traces are distributed log-normally (Figure 5.3d), which can be changed to exponential. Note that the fracture trace distribution depends on the domain dimensions. Here, a block has been used with $L_{x}$ = 100 m, $L_{y}$ = 1 m and $L_{z}$ = 50 m.

## Example irregular fracture network

The following instructions were used to generate the irregular fracture network shown in Figure 5.4. Note the dominance of the two orientations 80° and 135°: