3.3.1.6. Import borehole data
Importing borehole data requires two or three files (survey optional and assumes vertical boreholes if not given) that will be asked for in a separate dialog. To get to the import dialog, use the main project menu: Import → Borehole Data
This brings up the following import dialog:
From the browse buttons in Step 1, select the collar file, survey file (optional; if not provided, GIFtools assumes the borehole extend vertically downwards), and the property file. Once all the files are selected in Step 1, click on the “Load” button in Step 2.
For the example files we are using, our import dialog now looks like the following:
Our example has three properties: ID, LENGTH, and unitless. These are the headers provided in the property file. We select all three properties in this case. Once the desired properties are selected, we can move onto Step 3.
Step provides two options on how the borehole data are discretized: either the files contain data points at discrete xyz locations or the files provide a “to” and “from” value for each measurement or observation. Below, we will show how to import each type of borehole data.
Note
The datasets used for “discrete” and “interpolate” are different so the property headers will differ as well.
Discrete
For discrete data, select the “Discrete” radio button. The import dialog will look like:
Click OK to import the borehole data. You will notice that a grayed-out BOREdata item has been added to the GIFtools project tree. And the following dialog appears:
For the collar, survey, and property files, select the appropriate headers from the drop-down menus for each item. The options will match the headers given in the respective files. Once done, the dialog looks like the following:
Again, because the borehole data in this case are data points are discrete locations, we use the “Depth” radio button instead of “Intervals”. Once all the headers are assigned, click OK. The data are now being imported into GIFtools. Once done, the BOREdata item in the project tree will have a name. The name will be the same as the property file name (in our case, “geology”).
The info panel will show the origin of the property data, a data summary, the set i/o headers, and the borehole IDs that were imported:
Now the borehole data can be visualized, discretized onto a mesh, and used within Model Builder to create models and weighting functions.
Example
Collar, survey, and property file along with a GIFtools project to repeat the above steps to import discrete borehole data: download
Interpolate
Now, let’s import borehole data that has measurement between two elevations (i.e., to and from). Repeat the steps above to import borehole data in GIFtools, up to Step 3. Because this borehole data has “To” and “From” columns, we now select the “Interpolate” radio button in Step 3 for the data discretization.
We have decided to interpolate these data every 10 m.
Click OK to import the files and move onto the header dialog. The header dialog will appear just as before, except now the “Intervals” option is selected instead of “Depth”. Select the appropriate headers for each item. Once done, our dialog looks like the following:
Click OK to import and set the headers. Once imported, a BOREdata item has been added to the GIFtools project tree and the name of it is the same as the property file name. In this case, that is “Geology1”. When the item is highlighted in the tree, the info panel will provide the same type of information as we saw earlier for the discrete example:
Now the borehole data can be visualized, discretized onto a mesh, and used within Model Builder to create models and weighting functions.
Example
Collar, survey, and property file along with a GIFtools project to repeat the above steps to import interpolated borehole data: download
Note
GIFtools needs all location data to be in meters! Check your borehole data in case it may be in feet.
File formats:
See below links for specifics on the files associated with borehole data: