1. Overview of Borehole Data

When working with borehole (or well) data, there are typically three major components:

1. Collars
   • What it represents: The collar is essentially the “top” of the borehole, including the surface coordinates where it starts.
   • Typical data: This includes borehole/well ID, and the x,y,z coordinates of the collar.
2. Survey
   • What it represents: The survey data describes the trajectory (deviation) of the borehole from the collar downward.
   • Typical data: Measured depth (MD), azimuth, and dip data along the well trajectory.
3. Attributes
   • What it represents: Interval-based or point-based properties measured along the borehole. This can include geochemistry, geophysical logs, lithologies, or any other properties that vary with depth.
   • Typical data: The well ID (to match with collars), a from depth, a to depth, and the actual attribute values (e.g., lithology type, geochem assays, etc.).

Why Three Separate Files?

The CSVs are commonly split so that each dataset (collars, survey, attributes) captures a different aspect of the borehole. Splitting the data makes it easier to manage and update individually. LiquidEarth merges these datasets internally by matching the well IDs (collar IDs) and by referencing the same depth ranges or measured depths in the survey and attributes.

Special Note on Lithologies

If the attributes being read are lithologies, LiquidEarth may treat them differently—for instance, by using different internal logic or classification schemes to display them in 3D, or by requiring specific naming conventions for intervals. The import process is similar, but the resulting data might be displayed or analyzed in a different manner (e.g., color-coded strata intervals in a 3D model).

2. Arguments

Guide describing all the key arguments and parameters you’ll encounter when setting up borehole imports (Collars, Surveys, and Attributes) in LiquidEarth. The guide is split into two sections:

1. High-Level Import Settings (what you see directly in the import dialog).
2. Detailed Reader Settings (advanced options controlling how each CSV file is read via pandas).

2.1. High-Level Import Settings

These fields determine what data you’re loading and how LiquidEarth should handle it at a conceptual level.

1. Content Name
   • What it is: A short label for your imported dataset (e.g., “Spring2025 Geochem”).
   • Why it matters: Helps you identify the dataset in LiquidEarth once it’s loaded.
2. Collar File
   • What it is: A selection among the files you have uploaded to your project that contains the collar (starting) positions of your wells/boreholes.
   • Typical columns:
     • Well/borehole ID.
     • X, Y, Z coordinates (the collar location).
3. Survey File
   • What it is: A selection among the uploaded files that contains the well trajectory data.
   • Typical columns:
     • Measured Depth (MD).
     • Azimuth.
     • Dip.
4. Attrs File
   • What it is: A selection among the uploaded files that contains attributes (interval-based or point-based data), such as geochemistry or lithology.
   • Typical columns:
     • Well/borehole ID.
     • From depth.
     • To depth.
     • Attribute values (e.g., lithology type, assay values, etc.).