Open Mining Format (OMF)

Open Mining Format (OMF) is a data exchange format for mining and geological data. OMF is backed by the Global Mining Guidelines Group and aims to be the new standard for transferring data between software applications.

Overview

Vulcan supports data exchange with OMF (version 1.0) through a separate python package, maptekomf-vulcan.

The following data types are supported:

  • Point sets

  • Line work (polylines, polygons, and edge networks)

  • Grids

  • Surfaces

Note:  Other data types such as block models are not currently supported. If this is a priority for you, please contact Maptek to discuss options.

Installation

To use OMF with Vulcan, you need to install the Python package maptekomf-vulcan.

To install, run the following command from a Vulcan tcsh commandline:

python -m pip install maptekomf-vulcan

Importing OMF files into Vulcan

You can use the command line to import OMF files into Vulcan, as described below.

Importing a single OMF file

A single OMF file can be imported into a Vulcan project by typing the following command into native TSCH:

python -m maptekomf.vulcan import path/to/omf/file.omf -o path/to/vulcan/project

where path/to/omf/file.omf is the path to the OMF file to import and path/to/vulcan/project is the path to the Vulcan project.

Tip:  If you open native TSCH after opening Vulcan, the working directory will be set to the current Vulcan Project and the -o path/to/vulcan/project part of the command can be omitted and the OMF file will be imported into the current project.

Overwriting existing files with import

Passing the --overwrite argument to maptekomf.vulcan enables for existing files to be overwritten by the import. This is useful if you receive a newer version of the same OMF file and you would like to overwrite the old version of the imported data. This option should be used with caution because it also allows unrelated existing files to be overwritten, potentially leading to loss of data. To run the command described above with overwriting enabled, simple add --overwrite to the command:

python -m maptekomf.vulcan import path/to/omf/file.omf -o path/to/vulcan/project --overwrite

Importing multiple OMF files

It is possible to import multiple OMF files into a single Vulcan Project at the same time by passing the path to multiple OMF files to the command. For example:

python -m maptekomf.vulcan import path/to/file.omf path/to/file2.omf -o path/to/vulcan/project

where path/to/omf/file.omf is the path to the first OMF file to import, path/to/file2.omf is the path to the second OMF file to import and path/to/vulcan/project is the path to the Vulcan project.

Exporting Vulcan files to OMF

The following examples describe how to export Vulcan files to OMF.

Exporting a single file

The export subcommand can be used to export vulcan files to OMF. For example the command:

python -m maptekomf.vulcan export path/to/file/to/export.00t -o destination_file.omf

will export the file at path/to/file/to/export.00t to the OMF file destination_file.omf.

Exporting multiple files

Similar to importing multiple files, passing multiple file paths to the command triggers all of the passed files to be exported. For example, the command:

python -m maptekomf.vulcan export path/to/drawings.dgd.isis path/to/topography.00t -o destination_file.omf

will export the Vulcan design database at path/to/drawings.dgd.isis and the triangulation at path/to/topography.00t to the OMF file destination_file.omf.

Exporting all supported files in a directory to a single OMF file

Passing the path to a directory to vulcanomf.export causes all supported files in that directory to be exported to the same OMF file. For example the command:

python -m maptekomf.vulcan export path/to/project -o project.omf

exports all supported files in the Vulcan project at path/to/project to the OMF file project.omf.