AGS files

AGS is a logfile standard maintained by the AGS. The Ground Model Add-in supports reading and visualizing AGS files. The AGS format is tabular in nature and lends itself easily to transformation into ArcGIS tables and feature classes.

Loading AGS files

1. In the Ground Model toolbox double click the tool AGS Reader

2. Fill in the input parameters:

   1. AGS File - Browse and select one or multiple AGS files

   2. Output Workspace - Browse and select a file geodatabase. If you would like to generate a new one click New Item/ File Geodatabase in the browsing window.

   3. Spatial Reference - Specify the coordinate system of the AGS files. You can browse for a CRS by clicking the globe, or you can select one of the map layers in the dropdown and the tool will use the map layers CRS.

3. Click Run. The reader will create feature classes and tables corresponding to each AGS category (LOCA, GEOL, etc)

The categories in the AGS file that have a meaningful spatial interpretation will be converted to feature classes. Some categories like PROJ, ABBR, and DICT contain metadata and will instead be converted to plain tables.

The most important feature class is the LOCA feature class. This feature class contains the locations of the boreholes. AGS files may or may not contain interpretations.

The feature classes are of type (X, Y, Z) point with each measure point being a feature, or row. The AGS columns are mapped to columns in the feature class.

To see the AGS data go to the section: Visualizing data

LAS files

The Ground Model Add-in supports reading and displaying log files in the LAS format (Log ASCII Standard).

Before the LAS file is read, a well feature class needs to be generated.

Creating Well Feature Class

1. Open the Create Well Feature Class tool in the Ground Model toolbox.

2. Fill in the input parameters:

   1. Feature Class Location - Browse and select a file geodatabase in which the well feature class will be located.

   2. Feature Class Name - Enter the desired name for the well feature class being made.

   3. Spatial Reference - Specify the coordinate system of the LAS files.

3. Click Run. The tool will create

   • A LAS 2D overview layer feature class

   • A mapping (relationship class) between the logs and the wells

   • A logs class.

Use the LAS Log Reader to import the LAS file and populate the feature classes

Reading LAS files

1. Open the Ground Model toolbox and double-click the LAS Log Reader tool.

2. Fill in the input parameters;

   1. LAS File - Browse in the desired LAS file.

   2. Well ID Mnemonic - Pick the parameter that will be used to identify the well (well name/Unique Well Identifier/API). The well name mnemonic should normally be present in the file. The others are optional.

   3. X/Y Coordinate Mnemonic - This is set to be manually entered. These can often be found within the LAS file itself.

   4. Elevation mnemonic - This option sets the datum elevation for the borehole which determines the Z values of the borehole geometry. The elevation value will be added to the measured depth (the first column in the LAS file). Note that the sign of the measure depth will be reverted to reflect the negative-downwards convention used in ArcIGS.

      • <Use measured depth> : Use the measured depth from the LAS file

      • <Manual> : Enter a value manually

      • <Mnenonic> : Use a mnemonic from the file that will provide the elevation value.

1. Well headers feature class - The well feature class created above.

   1. Click Run. This will populate the feature classes generated in the step above and import the LAS headers and curves. These will be visible in the selected geodatabase in the ArcGIS Pro Catalog.