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 is developing a migration tool from the previous RESQML Release (V2.0.1) to the RESQML V2.2.
RESQML Editor/Validator for RESQML v2.0.1 “on premise”
The RESQML Editor/Validator software tool (Editor/Validator) 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 RESQML Editor/Validator 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). You can access this tool and more here (select Editor Validator Tool, Documentation and more).
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 User Guide)
- Documentation for the Editor/Validator
- Chapter 2: Installation for the Editor/Validator Tool
- Chapter 6: Installation for the Command Line Tool
This interactive tool is composed of a system of menus and different explained briefly in the table below the figure.
| 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. |
RESQML Editor/Validator Web Studio for RESQML v2.0.1 “cloud”
A Totally redeveloped version of this tool implemented and tested in 2020/2021 and is now available for free from the Cloud. This new version is accessible from your favorite Web Browser here.
- 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/technical workflow.
- It ensures the integrity and validity of the:
- Top-level RESQML data objects contained in an EPC file.
- 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 to create new Energistics Entities and check their validity and consistency
- It ensures the EPC export
A full documentation and training videos can be found here. This interactive tool is composed of a system of menus and different explained briefly in the table below the figure.
| 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. 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.To look 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. |
RESQML Editor/Validator Web Studio dedicated to RESQML v2.2
On the base of the RESQML Web Studio previously developed for the RESQML release V2.0.1, GEOSIRIS has started to implement an enhanced version for the ENERGISTICS RESQML V2.2 Release Candidate published in December 2021 by Energistics.
This tool will authorize user’s management, hdf5 and Graph exploration, long term storage and management of the Epc content and integrate all the new features of the RESQML V2.2 release.
As the previous version this tool can import/create/export Epc file but will also integrate the capability to serve as an ETP v1.2 Client to exchange information with an ETP server (like GABBRO) .
In parallel GEOSIRIS Is also setting up a mechanism to provide direct 3D visualization of Geomodelling Representation of the RESQML entities.
The combination of this complete set of tools (Editor/Validator V2.0.1, Migration tool from V2.0.1 and this Explorer/ Editor V2.2) will allows all the RESQML Users to monitor their migration in a comfortable manner. They can have a look on the RESQML V2.0.1 information, migrate it to a RESQML V2.2 EPC and complete it by adding new information.
RESQML Migration tools from v2.0.1 to v2.2
Starting from its experience gained on the RESQML V2.0.1 from 2017, GEOSIRIS has started to develop a migration tool to comply with the RESQML V2.2 Release Candidate published in December 2021 by Energistics (link to https://www.energistics.org/release-candidate/).
A first version is in beta testing. It is a java command line executable (*.jar).
It allows to read a RESQML V2.0.1 Epc+hdf5 pair of files, understand what is remaining equivalent between the two versions and execute an ad’hoc transformation of the RESQML V2.0.1 Epc file to create a new RESQML Epc_V2.2 file. The hdf5 file is explored to capture some meta data information about its data arrays but it is not modified.
GEOSIRIS intends to distribute this tool as soon as the Official RESQML v2.2 Release will be published by the Open Group which is now is charge to manage the activities of Energistics.