Pre Geology File

Pre Geology File: Lithology

The ASCII pregeology file name must have a .pgf suffix to be selected in the module's file browser. This file type represents raw (uninterpreted) 3D boring logs representing lithology. This format is used by:

• make_geo_hierarchy

• post_samples

• krig_3d_geology (to extract a top and bottom surface to build a single layer)

• indicator_geology for Geologic Indicator Kriging (GIK).

• adaptive_indicator_krig

You may insert comment lines in C Tech Pre Geology (.pgf) input files. Comments can be inserted anywhere in a file and must begin with a ’#’ character. The line numbers that follow refer to all non-commented lines in the file.

The pre-geology file format is used to represent raw 3D boring logs. We also refer to this geologic data format as "uninterpreted". This is not meant to imply that no form of geologic evaluation or interpretation has occurred. On the contrary, it is required that someone categorizes the materials on the site and in each boring.

Data Concept:

• A PGF file can be considered a group of file sections where each section represents the lithology for individual borings (wells).

• It is essential to use the same ID for the ground surface (first line) as for the bottom of the first observed material (second line) in each section (boring).  If a different material ID is used a synthetic point will be added between the ground and first observed material.  This will be reported for the first five occurrences.

• 
  

• Think about the PGF file as a shorthand way of specifying intervals.  The first line is the FROM.  The second is the TO.

• Please note that the data for each boring must be sorted (by you) from beginning to end (normally top to bottom).

• 
  

• We cannot sort this data for you because some borings may turn to horizontal or even upwards. It is your responsibility to make sure that the data is in the proper order.

• If the data is unsorted, and within a boring the direction between two values varies by more than 90 degrees, an error will be reported. 

FILE FORMAT:

• Line 1: May contain any header message, but cannot be left blank or commented.  There is no information content in this line.

• Line 2: Line 2 contains the declaration of Elevation or Depth, the definitions of Lithology IDs and Names, and coordinate units.

• 
  

• Though it is generally advisable, IDs need not be sequential and may be any integer values.  This allow for a unified set of Lithology IDs and Names to be applied to a large site where models create for sub-sites may not have all materials.

• The number of (material) IDs and Names MUST be equal to the number of Lithology IDs specified in the data section. Each material ID present in the data section must have corresponding Lithology IDs and Names.  If there are four materials represented in your .pgf file, there should be at least four IDs and Names on line two.  

• The order of Lithology IDs and Names will determine the order that they appear in legends.  The IDs do not need to be sequential.

• You can specify additional IDs and Names, which are not in the data and those will appear on legends.

• Depth forces the otherwise optional ground surface elevation column to be required. Depths given in column 3 are distances below the ground surface elevation in the last column (column 6). If the top surface is omitted, a value of 0.0 will be assumed and a warning message will be printed to the EVS Information Window.

• Elevation/Depth Specifier: This line must contain the word Elevation or Depth (case insensitive) to specify whether well screen top and bottom elevations are true elevation or depth below ground surface.

• 
  

• IDs and Names: Line 2 should contain Lithology IDs and corresponding names for each material.  Each Name is explicitly associated with its corresponding Lithology ID and the pairs are delimited by a pipe symbol "|".

• 
  

• Coordinate Units: You should include the units of your coordinates (e.g. feet or meters). If this is included it must follow the names associated with each Lithology ID.

• Line 3: Must be the number of lines of data (n) to follow. For each boring, there is one line for the ground surface and one line for the bottom of each observed lithologic unit.  Therefore the total number of lines in the file should be equal to the number of borings PLUS the sum of the number of materials observed in each boring.

• Line 4: First line of sample data. X, Y, Z, "Lithology ID", Boring name, and Ground surface elevation. The Ground surface elevation is an optional parameter which is required if Depth is specified on line 2. If depths are used (instead of elevations) the top surface should be in the same coordinate system. Depths are relative to the Ground surface (which is assumed at 0.0 if the Ground surface is not defined). The boring name cannot contain spaces unless the entire name is surrounded in quotation marks (example "Boring 1D"). One comma and/or any number of spaces or tabs can separate numbers and name.

• Line 3+n: is the last line of the file.

AN EXAMPLE FILE FOLLOWS:

© 1994-2017 kulunsoft.com