Component schemas

Components are reusable building blocks composed into geoscience object schemas. They define shared structures such as coordinate systems, attributes, geometry primitives, and domain-specific data formats. Components are themselves built from elements — the lowest-level data primitives.

Foundational

Core components inherited by all geoscience objects. These define identity, spatial context, and shared metadata.

• Base object properties — common fields for all objects (name, uuid, description)
• Base spatial data properties — adds bounding box and CRS to base properties
• Coordinate reference system — EPSG code or WKT spatial reference
• Bounding box — axis-aligned geographic extents
• Lineage — provenance and processing history (deprecated)
• Locations — 3D point coordinates

Attributes

Attributes attach data values to geometric elements. The attribute system uses a discriminated union (one-of-attribute) so that any attribute list can contain a mix of scalar, categorical, ensemble, and time-series types.

Core

Base types, metadata descriptors, and NaN handling shared across all attribute kinds.

• One-of-attribute — discriminated union of all attribute types
• Attribute list property — attribute list container
• Base attribute — common attribute fields (name, key, type)
• Base continuous attribute — base for continuous-valued attributes
• Base category attribute — base for categorical attributes
• Attribute description — metadata for continuous attributes
• Category attribute description — metadata for categorical attributes
• Category data — lookup table for categorical values
• NaN (continuous) — NaN definitions for floating-point data
• NaN (categorical) — NaN definitions for integral data

Scalar types

Concrete attribute types for individual values — one value per geometric element.

• Continuous attribute — floating-point values
• Integer attribute — integer values
• Bool attribute — boolean values
• String attribute — string values
• Color attribute — ABGR colour values
• Date-time attribute — timestamp values
• Vector attribute — N-dimensional vectors
• Indices attribute — index references to related objects
• Category attribute — categorical values with lookup table

Ensembles and time series

Attributes that store multiple realisations (ensembles) or values varying over time steps.

• Continuous ensemble — ensemble of continuous realisations
• Category ensemble — ensemble of categorical realisations
• Continuous time series — continuous values over time
• Category time series — categorical values over time
• Bool time series — boolean values over time
• Time-step attribute — time step (date or elapsed)
• Time-step continuous — elapsed-time continuous values
• Time-step date-time — timestamped date-time values
• Channel attribute — multi-channel survey data

Geometry

Primitives for defining spatial structures — vertex sets, cell connectivity, polylines, and composed mesh/line geometries.

Vertices and meshes

Vertex coordinate arrays and cell types that define volumetric and surface geometry.

• Vertices 2D — 2D vertex coordinates
• Vertices 3D — 3D vertex coordinates
• Triangles — triangle connectivity and vertices
• Quadrilaterals — quadrilateral cells
• Hexahedrons — hexahedral (brick) cells
• Tetrahedra — tetrahedral cells
• Segments — line segments
• Surface mesh — triangulated surface (open or closed)
• Mesh quality — quality guarantees for meshes
• Unstructured grid geometry — vertices, cells, and connectivity

Lines and polylines

Polyline definitions and line-segment index arrays in 2D and 3D.

• Polyline 2D — 2D polyline
• Polyline 3D — 3D polyline
• 2D line indices — 2D line endpoints with arc support
• 3D line indices — 3D line endpoints

Composite and embedded geometry

Higher-order compositions that group meshes, polylines, and boundary representations into named parts and composites.

• Embedded triangulated mesh — mesh with optional parts
• Geometry composite — grouped geometry types
• Geometry part — named part within a composite
• Embedded line geometry — polylines from line segments
• Embedded mesh object — named mesh referencing parts
• Embedded polyline object — named polyline referencing parts
• BRep container — boundary representation model

Geoscience disciplines

Components specific to geoscientific domains. Some components appear in both this section and the generic Geometry section above when they serve both roles.

Drilling and downhole data

Components for representing drillhole surveys and the data collected along them. Tabular data types (data tables, interval tables, distance tables) are included here because they are almost exclusively consumed within drilling workflows via downhole-attributes.

Drilling survey

Drillhole collar locations, survey path interpolation, and segment geometry.

• Hole collars — drillhole surface locations
• Hole chunks — row associations for drillhole data
• Desurvey method — drillhole path interpolation algorithm
• Downhole direction vector — segment direction and length

Downhole data

Attribute tables and depth/distance range definitions for data sampled along drillhole traces.

• Downhole attributes — attributes along drillhole traces
• Data table — named table of attributes
• Interval table — interval data with attributes
• Distance table — distance-based data
• Intervals — depth or distance ranges
• From-to — from-to depth ranges

Relative orientation data

Structural geology measurements (lineation and planar data) recorded relative to drillhole depth intervals.

• Relative lineation data table — lineation data relative to drillholes
• Relative planar data table — planar data relative to drillholes

Geological modelling

Components used by geological model objects (geological-model-meshes, geological-sections, design-geometry) to represent model surfaces, cross-sections, and material assignments. Several of these also appear under Geometry above; they are repeated here for discoverability by domain.

• Embedded triangulated mesh — mesh with optional parts
• Embedded mesh object — named mesh referencing parts
• Embedded line geometry — polylines from line segments
• Embedded polyline object — named polyline referencing parts
• Geometry part — named part within a composite
• Surface mesh — triangulated surface (open or closed)
• Mesh quality — quality guarantees for meshes
• Material — material identity and colour

Orientation and anisotropy

Rotation conventions, structural geology measurements at point locations, and ellipsoid definitions for describing spatial anisotropy in geostatistical models.

• Rotation — 3D rotation (dip azimuth, dip, pitch)
• Lineation data — lineation measurements at locations
• Planar data — planar orientation measurements at locations
• Ellipsoid — single ellipsoid (anisotropy)
• Ellipsoids — spatially varying ellipsoids

Block model structures

Attribute types and grid structure definitions for block models. Structure components define how parent blocks are subdivided — from uniform grids to octree-based refinement.

• Block model attribute — continuous attribute for block models
• Block model category attribute — categorical attribute for block models
• Regular structure — uniform grid, no subblocking
• Flexible structure — variable-size subblocks within parent blocks
• Fully subblocked structure — all-or-nothing subblocking
• Variable octree structure — octree-based anisotropic refinement

Survey and geophysics

Components for geophysical survey data — survey lines, collections, attribute definitions, and instrument-specific configurations for resistivity-IP and electromagnetic surveys.

• Survey line — spatial path of survey measurements
• Survey collection — grouped survey data
• Survey attribute — survey data values
• Survey attribute definition — survey attribute metadata
• Fiducial description — spatial reference markers
• Lengths — layer thickness values
• Resistivity-IP line — resistivity-IP survey line
• Resistivity-IP DCIP properties — DC induced polarization
• Resistivity-IP Phase IP properties — phase induced polarization
• Resistivity-IP SIP properties — spectral induced polarization
• Resistivity-IP pole-dipole config — pole-dipole electrodes
• Resistivity-IP pole-pole config — pole-pole electrodes
• FDEM channel — frequency-domain EM channel
• TDEM channel — time-domain EM channel

Geostatistics

Variogram model structures and distribution functions used by geostatistical objects for spatial modelling and uncertainty quantification.

• Cumulative distribution function — empirical CDF
• Spherical variogram — spherical model
• Exponential variogram — exponential model
• Gaussian variogram — Gaussian model
• Cubic variogram — cubic model
• Linear variogram — linear model
• Generalised Cauchy variogram — generalised Cauchy model
• Spheroidal variogram — spheroidal model