Skip to content

Convert data between geoscience formats and Evo geoscience objects to improve interoperability in geoscience applications.

License

Notifications You must be signed in to change notification settings

antbrown/evo-data-converters

 
 

Seequent logo

Seequent Developer PortalSeequent CommunitySeequent website

Evo

Evo is a unified platform for geoscience teams. It enables access, connection, computation, and management of subsurface data. This empowers better decision-making, simplified collaboration, and accelerated innovation. Evo is built on open APIs, allowing developers to build custom integrations and applications. Our open schemas, code examples, and SDK are available for the community to use and extend.

Evo is powered by Seequent, a Bentley organisation.

Data converters

This repository provides the source code for Evo-specific data converters.

When running a converter, data is imported from a supported file format, converted into geoscience objects, and then published to the Seequent Evo API.

The existing data converters can be used without modification or used as a template for your own integration.

Package Version
evo-data-converters-common PyPI - Version
evo-data-converters-duf PyPI - Version
evo-data-converters-gocad PyPI - Version
evo-data-converters-omf PyPI - Version
evo-data-converters-resqml PyPI - Version
evo-data-converters-ubc PyPI - Version
evo-data-converters-vtk PyPI - Version

Pre-requisites

  • Python 3.10, 3.11, or 3.12

Evo authorisation and discovery

Whether using the converters or undertaking development work on the modules themselves, integration with Evo will require that you are granted access as an Evo Partner or Customer, along with access to a specific Evo Workspace. Access is granted via a token. For more information on getting started, see the Seequent Evo Developer Portal.

Using the data converters

See the documentation for each converter for information on how to use the data converters to upload or download geoscience objects from Seequent Evo.

For the data converter's common framework package, see evo-data-converters-common.

Currently supported converters are:

To use any of the data converters, you will need a few things:

  • An access token for your user
  • The organisation ID, hub URL and workspace ID that you would like to import your data to, or export it from.

To get an access token, see Apps and Tokens in the Seequent Evo Developer portal.

To find the URL of your hub, and the ID of your organisation, see Evo Discovery.

For information on accessing and listing Workspaces, see Workspaces.

There is more information in the Welcome to Seequent Evo area of the Developer portal, so take a look there or ask questions in the Community forum.

Setting up and running Jupyter notebooks

To get up and running with this repository, including all Jupyter notebook examples in it, you will first need to install UV.

Notebooks can be run in your tool of choice (e.g. VS Code). To use Jupyter (the default):

uv sync --all-packages --all-extras

Then in the directory of the notebook(s) you want to run, type:

uv run jupyter notebook

It should open a browser where you can open the notebooks for the current directory.

Contributing

Thank you for your interest in contributing to Seequent software. Please have a look over our contribution guide.

Install pre-commit hooks

Once you've installed UV, install pre-commit hooks. These are used to standardise development workflows for all contributors:

uv run pre-commit install

Developing converters

See evo-data-converters-common's readme for information on how to work on the Evo data converters, including both importers and exporters, and how to extend this library and build your own.

Code of conduct

We rely on an open, friendly, inclusive environment. To help us ensure this remains possible, please familiarise yourself with our code of conduct.

License

Evo data converters are open source and licensed under the Apache 2.0 license.

Copyright © 2025 Bentley Systems, Incorporated.

Licensed under the Apache License, Version 2.0 (the "License"). You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

About

Convert data between geoscience formats and Evo geoscience objects to improve interoperability in geoscience applications.

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 91.3%
  • Jupyter Notebook 8.6%
  • Makefile 0.1%