Import 3D models

g-Space imports 3D geological models stored in the GOCAD / SKUA-GOCAD ASCII exchange formats. This topic covers loading a GOCAD SGrid (.sg), a GOCAD TSolid (.so) and a GOCAD Voxet (.vo) into a g-Space project as grids.

Purpose

These GOCAD formats carry 3D grid geometry together with node- or cell-based scalar properties. Importing them brings an externally built structured grid, tetrahedral mesh or voxel volume into the g-Space grid store so it can be viewed, sampled and used alongside native grids. Time / depth domain and the Z sign convention (Z-down depth versus Z-up elevation) are read from the file metadata.

Launching the import

In the Data manager, right-click the Grids root node and choose one of the GOCAD import actions:

  • Import GOCAD SGrid
  • Import GOCAD TSolid
  • Import GOCAD Voxet

[image: placeholder_Data_manager_Grids_root_context_menu_wit.png]

Supported formats

  • GOCAD SGrid (.sg) — a 3D structured (i, j, k) grid. The .sg file is an ASCII header holding the grid dimensions, coordinate-system and unit metadata and the property list; it references a companion ASCII data file that holds the per-node X / Y / Z coordinates and property columns, so both files are needed. A grid whose nodes form a regular rotated-rectangle lattice loads as a g-Space S-Grid; a warped (faulted or curved) grid is imported as a tetrahedral grid. Properties may be point- or cell-aligned.
  • GOCAD TSolid (.so) — an unstructured tetrahedral mesh: a list of vertices and tetrahedra, optionally grouped into TVOLUME parts, with per-cell scalar properties. It is imported as a g-Space tetrahedral grid. A single file may contain several TSolid objects, and multiple parts within one object are merged.
  • GOCAD Voxet (.vo) — a regular, axis-oriented 3D voxel grid defined by an origin, three axis vectors and a sample count per axis, with property values kept in external property files (ASCII text or raw binary IEEE floats). Because the sampling is regular, g-Space imports a Voxet as a structured S-Grid. Voxet is import only.

Step-by-step

  1. Right-click the Grids root in the Data manager and pick the action matching your file: Import GOCAD SGrid, Import GOCAD TSolid or Import GOCAD Voxet.
  2. In the file dialog, select the GOCAD header file (.sg, .so or .vo).
  3. g-Space reads the header and its referenced data / property files. For an SGrid or Voxet, keep the companion data file next to the header; if the referenced data file cannot be found you are prompted to browse for it.
  4. The grid, its dimensions, domain and properties are created from the file, and the new grid appears under the Grids node ready to view and query.

[image: placeholder_Imported_GOCAD_grid_listed_under_the_Gri.png]

Notes

  • An SGrid header only points at the geometry, so its companion ASCII data file must travel with it; a regular-looking header can still reference a warped points file, so the actual node coordinates decide whether the grid becomes an S-Grid or a tetrahedral grid.
  • Time or depth domain and the Z sign convention (ZPOSITIVE Depth versus Elevation) are taken from the axis name / unit metadata; property no-data values are honoured and mapped to undefined nodes.
  • Voxet is supported for import only. Export back to GOCAD is available for structured grids (SGrid) and tetrahedral grids (TSolid).

See Also

Model Data Formats | Export 3D models | GOCAD Data Formats