Smart Data Models’ Candidates repository now includes a new candidate standard from the mining sector: open-mining-format. It has 3 candidate models translated from the Open Mining Format (OMF) of the Global Mining Guidelines Group, for describing 3D geoscience and mining projects: their elements (points, lines, surfaces, block models) and the attributes attached to them. OMF is published under the MIT licence. Like every candidate, each model comes with a JSON Schema, an NGSI-LD @context and all four example serializations (NGSI-v2 and NGSI-LD, key-values and normalized), each validated against its schema.
About the Open Mining Format
The Global Mining Guidelines Group backs OMF as an open format for exchanging data between geological modelling, mine planning and resource estimation applications, which have long relied on closed file formats. An OMF file holds a project with a list of elements. Each element has one geometry and any number of attributes, such as gold assays on drill-hole points or rock types on the blocks of a block model. OMF 2 stores a JSON index, specified by a JSON Schema, together with the bulk arrays as Apache Parquet files, all in one ZIP archive. This translation follows that schema, version 2.0-beta.1. OMF 2 is still a pre-release. The latest stable release is OMF 1.0.1, and the metadata lists how its classes correspond to the models.
The models
| Model | What it describes | Attributes |
|---|---|---|
Project |
An OMF project: name, author, application, coordinate reference system, origin, units, and its elements | 17 |
Element |
One object in the project, with its geometry: point set, line set, triangulated surface, grid surface, block model (regular or tensor, with octree, regular or free-form sub-blocks) or composite | 13 |
Attribute |
Data attached to an element’s vertices, triangles or segments, blocks, sub-blocks or sub-elements: numbers and dates with colormaps, vectors, text, categories, booleans, colors, textures | 12 |
Examples from the specification itself
The examples are translated from OMF’s own reference test file, “One of everything”, which contains roughly one element of every kind. They cover the project, its regular 2×2×2 block model and a boolean “Filter” attribute on the model’s blocks. It is sample data rather than a real deposit, and we did not find an open mining dataset published as OMF 2.
Translation notes
- OMF names, verbatim. Every field keeps its OMF name. The only exception is an attribute’s
location, which becomesomfLocationbecauselocationis reserved in NGSI-LD. Each@contextpoints to the field’s definition in the OMF JSON Schema. - Structure in the broker, numbers in the file. OMF keeps millions of vertices and block values in Parquet files, and so do the models. They hold the geometry and attribute structure, grids, orientation, units and colormaps, plus references to the array files.
- Nested where OMF nests. Geometry and attribute data keep their full OMF structure. Projects, elements and attributes are linked as NGSI-LD relationships.
- Location only when it can be known. OMF coordinates are relative to a project coordinate reference system, often a local mine grid. An NGSI-LD
location(GeoJSON) can be given only when the project’s CRS can be transformed to WGS84, so the attribute is optional. AgeometryTypeattribute is the other addition, so that elements can be filtered by kind.
Try it, and tell us what’s missing
These are Candidates: first, carefully sourced translations that are not yet official Smart Data Models subjects. Smart Data Models has no mining or geology subject yet, so this fills a gap. Several questions are open before promotion. The models should be re-synced with OMF 2.0 once it is final. The generic type names Project and Attribute already exist in other subjects. Mining users may also want dedicated models per geometry, such as a BlockModel entity. A few inconsistencies in the OMF documentation are listed in the metadata for GMG.
Browse the models, open an issue, or send a PR:
👉 https://github.com/smart-data-models/Candidates/tree/master/standards/open-mining-format

