DFN-Related File Formats

Bootstrapped Distribution File Format

1 header line

x lines defining the discrete distribution. Each contains an ID, followed by the n values of the distribution (1 value for a 1D distribution, 2 values for a 2D distribution, etc.). A last optional column defines the quantity for these values. If not given, all values have the same probability. Separators can be space, tab, comma or semicolons.

The end of the file is specified by any empty line.

Example:

; Bootstrapped distribution of fracture orientations: id dip dipdir quant
1;242;87;43.33;2
2;241;84;51.94;2
3;84;64;22.01;2
4;153;84;25.99;1
5;151;82;27.91;1
6;158;75;37.95;1
7;150;83;27.41;1
8;166;82;24.43;1
9;77;83;37.22;2
10;182;87;19.41;1
11;138;81;39.22;3
12;45;4;11.42;4

Fracture Template File Format

1 header line

A group starting with <info> and ending with <info> defining the template information. Each info is given in a single line under the format info_name info_value.

A group starting with <stats> and ending with <stats> defining the statistical distributions. This group must contain a <size> … <size> group, a <orientation> … <orientation> group and a <position> … <position> group. For each distribution, the parameters are given (1 by line) under the format param_name param_values. These parameters are:

The dimension of the distribution, defined as dim (e.g., dim 1)
The type of the distribution, defined as type (e.g., type 1). 1 stands for uniform, 2 stands for Gaussian, 3 for power-law, 4 for bootstrapped and 5 for FISH function.
The parameters of the distribution, defined as parameters, consistently with the type (e.g., parameters 1.0 0.5 for a Gaussian distribution)
The range of acceptable values, defined as bound (e.g., bounds 20 50 for 1D orientation)

Example:

;ITASCA DFN Template File
<info>
name example
<\info>
<stats>
      <size>
            dim 1
            type 2
            parameters 4.0
            bounds 1.0 +inf
      <\size>
      <orientation>
            dim 2
            type 1
            parameters
            bounds 0 0 180 360
      <\orientation>
      <position>
            dim 3
            type 1
            parameters
            bounds -5 -5 -5 5 5 5
      <\position>
<\stats>

Itasca File Format

Header

1 header line (a comment)
1 line with the number of fractures

Fracture Listings

Each fracture is defined by a first line containing three numbers: the fracture number, the property number (as associated with a property file), and the number of vertices.
The remainder of the fracture definition will take varying forms, depending on the number of vertices given and the number of dimensions.

In 3D the number of vertices can be 1, in which case the fracture is disk shaped. In this case, the second line contains the position, dip (in degrees), dip direction (in degrees) and fracture diameter,

otherwise the fracture vertices are entered on subsequent lines, where the last line following the vertices lists dip and dip direction, or,

in 2D the number of vertices can only be 2 and the subsequent two lines are the vertex locations.

Example:

;ITASCA DFN Geometry File 
5
1 2 1 
2.0296831+00 8.0487830-02 -4.1217539+00 4.8061088+01 2.6002969+01 4.4052353-01
2 2 1 
-2.6883828+00 2.5144140+00 -3.0350415+00 7.8339493+01 7.7384957+01 2.5655889-01
3 2 1 
1.0038389+00 2.9597510+00 1.3758299+00 8.4978698+01 3.2929981+02 4.9254025-01
4 2 14 
-4.3433466+00 4.8693195+00 2.2740352+00 
-4.3495920+00 4.9449926+00 2.2970722+00 
-4.3667014+00 5.0000000+00 2.3044292+00 
-4.7577366+00 5.0000000+00 2.0123462+00 
-4.7578395+00 4.9982014+00 2.0116110+00 
-4.7515941+00 4.9225283+00 1.9885740+00 
-4.7256732+00 4.8479547+00 1.9806360+00 
-4.6826143+00 4.7817803+00 1.9885740+00 
-4.6266323+00 4.7304829+00 2.0116110+00 
-4.5632070+00 4.6990836+00 2.0474919+00 
-4.4985469+00 4.6906562+00 2.0927045+00 
-4.4389815+00 4.7060254+00 2.1428231+00 
-4.3903414+00 4.7436870+00 2.1929417+00 
-4.3573879+00 4.7999543+00 2.2381543+00 
3.9754716+01 2.4389080+02 
5 2 21 
4.2246693+00 3.2446568+00 3.7463259+00 
4.2848815+00 3.2702468+00 3.8738166+00 
4.3760866+00 3.3147333+00 3.9749937+00 
4.4893567+00 3.3737616+00 4.0399535+00 
4.6136043+00 3.4415537+00 4.0623371+00 
4.7366670+00 3.5114735+00 4.0399535+00 
4.8464986+00 3.5766768+00 3.9749937+00 
4.9323482+00 3.6307811+00 3.8738166+00 
4.9858120+00 3.6684902+00 3.7463259+00 
5.0000000+00 3.6816078+00 3.6625394+00 
5.0000000+00 3.6870591+00 3.5749907+00 
4.9783313+00 3.6819244+00 3.4636768+00 
4.9181191+00 3.6563344+00 3.3361862+00 
4.8269140+00 3.6118479+00 3.2350090+00 
4.7136439+00 3.5528196+00 3.1700492+00 
4.5893963+00 3.4850275+00 3.1476656+00 
4.4663336+00 3.4151077+00 3.1700492+00 
4.3565020+00 3.3499044+00 3.2350090+00 
4.2706524+00 3.2958001+00 3.3361862+00 
4.2171886+00 3.2580910+00 3.4636768+00 
4.2013439+00 3.2404682+00 3.6050014+00 
8.6886098+01 3.3088926+02 

Rockmass File Format

The Rockmass file format correponds to a file resulting from field measurements produced by the company Rockmass Technologies. The same file format is used by Leapfrog.

Header

A single line of comma-separated column headers. There may be any number of comma-separated strings and they can be in any order, but the following headings must exist:

X

Y

Z

Dip

Dip Direction

Feature #

Window #

Fracture Listings

Each line corresponds to a single measurement. The line is a list of comma-separated numbers or strings corresponding to the headers.

There may be multiple measurements for a single feature within each window. Measurements for the same feature have the same Feature #. By default, all measurements are used when bootstrapping the orientations. If the keyword average is given when importing the file, then all measurements with the same feature number and the same window number will be averaged.

Example:

X,Y,Z,Depth,Dip Direction,Dip,Date,User,Window #,Type,Notes,Feature Name,Feature #,Scan #,Cluster #,Cluster Size,Magnetic Normal
-4.00,-10.70,1.11,1.02,204.73,61.59,12/19/2022,,1,structure,dfn model,,1,1,1,129,0.615
-4.05,-10.49,1.06,1.02,204.73,61.59,12/19/2022,,1,structure,dfn model,,1,1,1,129,0.615
-3.91,-10.86,1.08,1.02,204.73,61.59,12/19/2022,,1,structure,dfn model,,1,1,1,129,0.615
-4.00,-10.70,1.11,1.39,106.14,66.76,12/19/2022,,1,structure,dfn model,,1,2,1,59,0.612
-4.05,-10.49,1.06,1.39,106.14,66.76,12/19/2022,,1,structure,dfn model,,1,2,1,59,0.612
-3.91,-10.86,1.08,1.39,106.14,66.76,12/19/2022,,1,structure,dfn model,,1,2,1,59,0.612
-4.00,-10.70,1.11,1.39,267.53,79.72,12/19/2022,,1,structure,dfn model,,1,2,2,10,0.612
-4.05,-10.49,1.06,1.39,267.53,79.72,12/19/2022,,1,structure,dfn model,,1,2,2,10,0.612
-3.91,-10.86,1.08,1.39,267.53,79.72,12/19/2022,,1,structure,dfn model,,1,2,2,10,0.612
-4.00,-10.70,1.11,1.39,269.31,23.58,12/19/2022,,1,structure,dfn model,,1,2,3,8,0.612
-4.05,-10.49,1.06,1.39,269.31,23.58,12/19/2022,,1,structure,dfn model,,1,2,3,8,0.612
-3.91,-10.86,1.08,1.39,269.31,23.58,12/19/2022,,1,structure,dfn model,,1,2,3,8,0.612
-4.00,-10.70,1.11,1.33,105.13,81.50,12/19/2022,,1,structure,dfn model,,1,3,1,77,0.614
-4.05,-10.49,1.06,1.33,105.13,81.50,12/19/2022,,1,structure,dfn model,,1,3,1,77,0.614
-3.91,-10.86,1.08,1.33,105.13,81.50,12/19/2022,,1,structure,dfn model,,1,3,1,77,0.614
-4.26,-10.08,0.08,0.62,97.41,73.25,12/19/2022,,1,structure,dfn model,,2,1,1,197,0.608
-4.26,-10.08,0.08,0.62,52.53,85.00,12/19/2022,,1,structure,dfn model,,2,1,2,18,0.608
-4.26,-10.08,0.08,0.62,334.60,89.94,12/19/2022,,1,structure,dfn model,,2,1,3,7,0.608
-4.26,-10.08,0.08,0.62,96.53,82.25,12/19/2022,,1,structure,dfn model,,2,2,1,714,0.607
-4.26,-10.08,0.08,0.62,54.20,84.48,12/19/2022,,1,structure,dfn model,,2,2,2,6,0.607
-4.00,-10.36,-0.14,0.75,25.94,58.75,12/19/2022,,1,structure,dfn model,,3,1,1,743,0.607
-4.00,-10.36,-0.14,0.82,27.66,58.95,12/19/2022,,1,structure,dfn model,,3,2,1,206,0.612
-4.12,-10.35,1.10,1.10,194.22,71.75,12/19/2022,,1,structure,dfn model,,4,1,1,82,0.621
-4.02,-10.63,1.09,1.10,194.22,71.75,12/19/2022,,1,structure,dfn model,,4,1,1,82,0.621
-4.12,-10.35,1.10,0.90,194.78,65.37,12/19/2022,,1,structure,dfn model,,4,2,1,348,0.620
-4.02,-10.63,1.09,0.90,194.78,65.37,12/19/2022,,1,structure,dfn model,,4,2,1,348,0.620
-4.01,-10.52,0.31,0.98,196.04,60.97,12/19/2022,,1,structure,dfn model,,5,1,1,83,0.620
-4.01,-10.52,0.31,1.03,198.27,67.19,12/19/2022,,1,structure,dfn model,,5,2,1,58,0.619
-1.58,-23.62,0.64,0.87,153.45,27.01,12/19/2022,,2,structure,,,1,1,1,293,0.754
-1.58,-23.62,0.64,0.87,166.45,40.88,12/19/2022,,2,structure,,,1,2,1,83,0.737
-1.80,-23.66,-0.03,0.64,25.43,60.24,12/19/2022,,2,structure,,,2,1,1,467,0.667
-2.48,-22.41,0.00,0.64,25.43,60.24,12/19/2022,,2,structure,,,2,1,1,467,0.667
-2.36,-22.63,-0.56,0.64,25.43,60.24,12/19/2022,,2,structure,,,2,1,1,467,0.667
-1.80,-23.66,-0.03,0.87,36.56,63.40,12/19/2022,,2,structure,,,2,2,1,652,0.706
-2.48,-22.41,0.00,0.87,36.56,63.40,12/19/2022,,2,structure,,,2,2,1,652,0.706
-2.36,-22.63,-0.56,0.87,36.56,63.40,12/19/2022,,2,structure,,,2,2,1,652,0.706
-1.80,-23.66,-0.03,0.87,198.20,87.50,12/19/2022,,2,structure,,,2,2,2,19,0.706
-2.48,-22.41,0.00,0.87,198.20,87.50,12/19/2022,,2,structure,,,2,2,2,19,0.706
-2.36,-22.63,-0.56,0.87,198.20,87.50,12/19/2022,,2,structure,,,2,2,2,19,0.706
-1.80,-23.66,-0.03,0.77,57.89,70.41,12/19/2022,,2,structure,,,2,3,1,945,0.704
-2.48,-22.41,0.00,0.77,57.89,70.41,12/19/2022,,2,structure,,,2,3,1,945,0.704
-2.36,-22.63,-0.56,0.77,57.89,70.41,12/19/2022,,2,structure,,,2,3,1,945,0.704
-2.55,-22.15,0.94,1.58,323.53,70.16,12/19/2022,,2,structure,,,3,1,1,10,0.663
-2.55,-22.15,0.94,0.87,307.71,85.19,12/19/2022,,2,structure,,,3,2,1,806,0.748
-2.21,-22.87,-0.39,0.59,272.88,56.88,12/19/2022,,2,structure,,,4,1,1,217,0.723
-2.21,-22.87,-0.39,0.55,300.16,55.97,12/19/2022,,2,structure,,,4,2,1,48,0.716
-2.21,-22.87,-0.39,0.55,156.18,88.08,12/19/2022,,2,structure,,,4,2,2,14,0.716
-2.21,-22.87,-0.39,0.55,198.01,67.75,12/19/2022,,2,structure,,,4,2,3,9,0.716
-2.21,-22.87,-0.39,0.55,237.32,76.30,12/19/2022,,2,structure,,,4,2,4,8,0.716

Fracture Property File Format

1 header line

1 line containing the string names of the properties

1 line with the number of properties

x lines with the properties as a space separated list

Example:

;ITASCA DFN Property File 
jks jkn jcohesion 
2
5.0000000000e+09 5.0000000000e+10 5.0000000000e+01 
1.0000000000e+09 1.0000000000e+10 2.0000000000e+01 

⇄

⇐ DFN Files | Data Files (Labels, Scalars, Tensors, Vectors) ⇒

Was this helpful? ...

Updated: Dec 14, 2024