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
- 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.
- In the file dialog, select the GOCAD header file (.sg, .so or .vo).
- 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.
- 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