Geosiris / Data handling · 8 min
Editors / Validators
Software tools that allow checking the correctness of the semantic and syntactic usage of the Energistics standards in a given activity.
In order to be efficiently used for earth modeling activities, the Energistics standards must be complemented by software tools that allow checking the correctness of their semantic and syntactic usage in a given activity. For this, Geosiris has developed software applications which enable developers and end users to explore RESQML entity containers or individual entities, to verify that these data are used and organized in conformity with the standards, and to edit them so that they can be integrated into the geo-modeling workflow or possibly imported or exported in other applications.
As a plus, Geosiris has developed a translation tool from the previous RESQML release (v2.0.1) to RESQML v2.2.
Andesite Studio — in your web browser
Andesite Studio is our newest editor, and the successor of the Web Studio described below. It opens, checks, edits and displays EnergyML data — RESQML, WITSML and PRODML, packaged as EPC files with their HDF5 arrays, or read from an ETP server — entirely in your web browser. Its core is written in Rust and compiled to WebAssembly: nothing is installed, and no file is ever uploaded anywhere.
- Explore a package as trees, tables and an interactive graph of references; compare two packages object by object.
- Validate and repair: each schema error is shown on the very field it concerns, and broken references can be re-pointed in one action.
- Edit and create any object field by field, guided by the schema itself, with undo on every change.
- See the model in 3D, on a map, in cross-sections and along wells, with true coordinates.
- Connect to an ETP server, browse its dataspaces and send your changes back.
Open Andesite Studio · Everything it does, with demonstrations
RESQML Editor/Validator for RESQML v2.0.1 — “on premise”
The RESQML Editor/Validator software tool was designed to help information technology (IT) and geology, geoscience and engineering (GG&E) professionals quickly and easily explore, validate and edit RESQML data sets before importing them into their RESQML-enabled GG&E software applications.
The application was created to assist adoption of RESQML. This tool enables users to explore, edit and validate RESQML v2.0.1 data objects and EPC files (the “container” file used to gather related RESQML data objects and other files for exchange among software packages).
Also available is a Command Line Validator, which may be integrated with RESQML-enabled software, to run automatically when RESQML data is imported.
Content available
- RESQML Editor/Validator Tool
- Examples and related files (explained in the User Guide)
- Documentation for the Editor/Validator
- Chapter 2: Installation for the Editor/Validator Tool
- Chapter 6: Installation for the Command Line Tool
Where to get it
The tool and its documentation are distributed by Energistics (www.energistics.org), now part of The Open Group:
- Access to the product: publications.opengroup.org/standards/energistics-standards/v231b
- Documentation: publications.opengroup.org/standards/energistics-standards/v231d
- Access to automatic validation (Command Line Validator): publications.opengroup.org/standards/energistics-standards/v231c
This interactive tool is composed of a system of menus and views, described briefly below.
| View | What it displays |
|---|---|
| Table | A tabular list of all top-level objects (TLO) in the in-memory model of an EPC file. For each object it shows content type, title and UUID. |
| Graph | A graphical representation of objects in the in-memory model of an EPC file, showing references, hierarchy, etc. |
| Resource Set / Resource Set List | Displays the details of a TLO in the in-memory model of the EPC file. To display the data for an object, in Table View, double click on the object. A Resource window opens for each object, where you can drill down on the hierarchy of data that comprises the object. The Resource View allows multiple TLOs to be open (each in a separate window) and keeps a list of open resources so you can manage them. |
| Log | Displays results data from the validation functions. If you run multiple validations, the results are appended to the log. |
| Properties | Displays property data for the resource that is selected in the Resource View. You can examine and edit properties. |
EnergyML Editor/Validator Web Studio for RESQML v2.0.1 & v2.2, WITSML v2.0 & v2.1, PRODML v2.3 and all EML versions — available as a Docker file
A totally redeveloped version of this tool was implemented and tested from 2020/2021 to 2025 and is available for free on github.com/geosiris-technologies. This improved version is accessible from your favorite web browser. A video tour of the Web Studio.
- It provides a way for you to quickly and easily validate RESQML data contained in an Energistics Packaging Conventions (EPC) file, thereby ensuring its integrity before you begin using the data in a software application or technical workflow.
- It ensures the integrity and validity of the top-level RESQML data objects contained in an EPC file, and of the relationships between these RESQML data objects.
- It delivers interactive exploration and editing capabilities that let you work with your RESQML data (XML and HDF5) to resolve issues or, for advanced users, to create files for examples and testing.
- It allows you to create new Energistics Entities and check their validity and consistency.
- It ensures the EPC export.
| View | What it displays |
|---|---|
| Table | A tabular list of all top-level objects (TLO) in the in-memory model of an EPC file. For each object it shows content type, title, UUID, version number and namespace (RESQML, WITSML). |
| Graph | A graphical representation of objects in the in-memory model of an EPC file, showing references, hierarchy, etc. |
| Resource Set / Resource Set List | Displays the details of a TLO in the in-memory model of the EPC file. To display the data for an object, in Table View, double click on the object. A Resource window opens for each object, where you can drill down on the hierarchy of data that comprises the object. |
| Log | Displays results data from the validation functions. If you run multiple validations, the results are appended to the log. To see the logs you need to activate the show (or hide) console button in the menu. You can clear the log view. |
| Properties | Displays property data for the resource that is selected in the Resource View. You can examine and edit properties. |
How you can use it
The Web Studio runs on your own computer: your files stay with you. Docker is the only thing to install.
-
Install Docker Desktop (Windows, macOS or Linux) and start it.
-
Open a terminal (PowerShell on Windows, Terminal on macOS) and run this single command:
docker run -d --name webstudio -p 80:80 -p 443:443 --env webstudio_enableUserDB=false geosiris/geosiris-webstudio:1.0.16The first time, Docker downloads the application (about 430 MB). It then starts in a few seconds.
-
Open https://localhost in your web browser. The certificate is generated locally, so the browser shows a security warning: choose “Advanced”, then “Continue to localhost”. The editor opens.
-
To stop the Web Studio, run
docker stop webstudio; to start it again later, rundocker start webstudio.
If another program already uses port 80 or 443 on your computer, change the left-hand numbers only — for example -p 8080:80 -p 8443:443 — and open https://localhost:8443 instead.
This version keeps no user accounts and no saved workspaces. The full platform, with both, is described on github.com/geosiris-technologies/webstudio-platform.
RESQML translation tool from v2.0.1 to v2.2
Starting from the experience gained on RESQML v2.0.1 since 2017, Geosiris has rewritten its migration tool from the ground up. The former Java command line executable is replaced by a translation engine written in Rust, which also compiles to WebAssembly and therefore runs in a web browser as well as on a server.
It translates a whole EPC package, together with its HDF5 files, from RESQML v2.0.1 to RESQML v2.2 and EML v2.3. The same engine covers EML v2.0 to v2.3 and WITSML v2.0 to v2.1; every object is routed according to its own release, since a real package often mixes several.
- A quote before the translation. A dry run tells what translating a package would produce, object by object, before anything is written.
- Nothing is changed silently. Every translation comes with a report: what was translated, what was copied unchanged, what was refused and what its absence breaks, what the target release cannot hold (with the original value), and every value written that no source field gave, with the design decision that authorises it.
- An independent check of the result. The translated package is read back by readers that know nothing of the translation, and compared with the source: coordinate reference systems, properties, geometry, patches and cells.
- Identity is preserved. Every object keeps its UUID, so every reference still resolves. On request, the package also records, as an EML Activity, that it was translated and by what.
- Incomplete deliveries are handled. When the HDF5 files are not supplied, everything that does not depend on them is still translated, and the report lists exactly which files would complete the rest.
The HDF5 files themselves are not modified: the translated EPC refers to the same arrays as its source.
