WITSML Developers & Users

WITSML Developers & Users2018-12-14T15:08:20+00:00

Overview

Welcome to the technical resources and the specifications for the WITSML standard.  This material is provided to help in the design, development and testing of software based on the WITSML standard.  The members of the WITSML SIG have contributed a lot of time and effort over the years to build consensus around each version of the standards, as well as make available various tools to make it easier to build software based on the standards, test it and deploy it.

WITSML Version 2.0

Version 2.0 was released in 2016, and it is the current version of the WITSML standard.  It should be used for all new developments.

WITSML Version history

  • Version 1.4.1.1 is still widely in use across the industry, and it is currently supported by Energistics
  • Version 1.3.1 is obsolete and deprecated, and there is no development or support for this version . Contact Energistics at info@energistics.org if you need to access legacy documents.

WITSML Development tools

The following resources are available for developers:

WITSML Server Certification

Energistics currently offers certification testing for v1.3.1 and v1.4.1 WITSML Servers (the v2.0 certification program is under development).  Click here for more information.

Collaboration with other standards organizations

Energistics works with other organizations to explore new capabilities that promote a broader use of standards:

Related standards

WITSML combines with:

Licensing & Legal

Click here to access the information regarding licensing, intellectual property, trademarks and other legal information for companies intending to develop and deploy software using the Energistics Standards

WITSML version 2.0

WITSML V2.0 DATA SCHEMAS

This is the preferred version for new and upgraded production implementations. Use with Energistics Transport Protocol v1.1.

WITSML Version 2.0 leverages the Energistics Common Technical Architecture (CTA), which delivers a common technology foundation for the Energistics domain standards—which includes WITSML, PRODML, and RESQML.  This common architecture makes it easier for companies to implement the standards. It also makes it easier to share data “across” the standards for integrated operations workflows.  For example, RESQML and PRODML can leverage well data in WITSML.

The previous version of WITSML, v1.4.1.1, specified a set of 27 data object definitions and a Web services specification.

In v2.0, the main changes include:

  • A revised set of data objects. For a list, see Table 1 of the WITSML Technical Usage Guide.
  • Replacement of the Web services with the Energistics Transfer Protocol (ETP), which is part of the Energistics CTA.

The Technical Usage Guide describes each WITSML data object, including its business use and an overview of its design.

WITSML DATA SCHEMA SPECIFICATIONS, VERSION 2.0

Standard Link
Browse the Data Schema Specifications – Overview, December 2016 <Data Schema>
Download Data Schema Specifications – December 2016
Includes the normative xsd and data files and the non-normative files such as example and style sheet files.
Download the ETP v1.1 for WITSML v2.0 Implementation Specification – October 2017
Provides guidance for implementation of the Energistics Transfer Protocol with WITSML v2.0 schemas (also included in the Data Schema Specifications Standards Download file)

WITSML Version History

V1.4.1.1

Version 2.0 should be used for new developments.  Developers and users who are working with an existing system based on version 1.4.1.1 will find here important information and resources for maintenance and operation.
Version 1.4.1.1 was initially published in 2012. In 2015 it was revised to include the Raster Data Object.

Standard Links
Browse the Data Schema Specifications (including dpethRegImage) – July 2015
Includes the normative xsd and data files and the non-normative files such as example and style sheet files.
<Data Schema>
Download the Data Schema Specifications – July 2012
Includes the normative xsd and data files and the non-normative files such as example and style sheet files.
Download the API Specifications, July 2014
Includes the normative xsd and data files and the non-normative files such as example and style sheet files.
The API specification has been updated for clarification purposes only. There is no change to behavior. Updates are identified in the Change History.
Download the ETP v1.1 for WITSML v1.4.1.1 Implementation Specification – October 2017
Provides guidance for implementation of the Energistics Transfer Protocol (protocols 0, 1) with WITSML v1.4.1 log only

RASTER DATA OBJECT (ADD-ON TO V1.4.1.1)

Raster image data object is called depthRegImage in the schemas.  This is an add-on capability for v1.4.1 (2102) and must be added to a v1.4.1 implementation; it is not a standalone data object.  The update v1.4.1.1 Data Schema (2015) includes depthRegImage.

This data object was developed in collaboration with members of PPDM.  Our thanks to all who contributed to this effort.

Standard Links
v1.4.1.1 Data Schema Specifications plus depthRegImage – July 2015
Includes the normative xsd and data files and the non-normative files such as example and style sheet files.

<Data Schema>

depthRegImage data schema – July 2015 (add to v1.4.1.1 data schema specifications)

Instructions to install depthRegImage data object in existing v1.4.1.1 implementation

<Instructions>

COMPLETION DATA-OBJECT

This new data-object is compatible with WITSML v1.4.1.1 and PRODML v1.3.

Details found here.

SUPPORTING DOCUMENTATION

In addition to the API and schema specifications, a series of usage guides and other supporting documentation and tools are under development to help assist users and implementers.  This library will grow over time.

USAGE GUIDES

TOOLS

V1.3.1

WITSML 1.3.1.

Version 1.3.1 is deprecated.  New production implementations should use Version 2.0.

For developers or users operating WITSML 1.3.1 systems, contact info@energistics.org to request access to archived documents related to that version.

WITSML Development Tools

Standards DevKit

The Standards DevKit developed by ExxonMobil and maintained by Energistics wraps WITSML, RESQML and PRODML schemas with Microsoft .NET objects. Go to page

Sample WITSML XML data

These data sets represent real world examples.

  • WITSML v1.4.1 data sets donated by Statoil (May 2016) – auto-download.

Other data

  • Members of Energistics have access to additional datasets on demand, contact info@energistics.org
  • Equinor has made available the entire data for the Volve field decommissioned in 2018. It is accessible on their website here
    More on this data set here

Collaborations with Standards Organizations

Proof of Concept (POC) to map WITSML and PPDM

BACKGROUND

Under the banner of the Standards Leadership Council (SLC), Energistics and Petroleum Data Management Association (PPDM) and their respective members joined forces around a proof of concept (POC) to map selected portions of WITSML and the PPDM data model.

The objectives of the POC included:

  • determine the feasibility and usefulness of a general mapping of these data models for specified use cases
  • gauge community interest to extend the mapping
  • identify best practices for development projects involving multiple standards organizations

PROOF OF CONCEPT

The project team identified 5 high value use cases which involve 7 WITSML data objects and associated PPDM tables.

  • Move WITSML well data into an “empty” PPDM store
  • Move WITSML data into a populated PPDM store
  • Directional survey
  • Transfer real-time LWD data (e.g., gamma ray) using WITSML into PPDM data repository
  • Transfer LWD data (e.g., gamma ray) from a PPDM data repository to a WITSML-enabled application

Download use cases (ZIP)    [we need to carry over this content too]

Download mapping (XLS)    [we need to carry over this content too]

RESULTS

The project team determined that:

  • It is feasible to map WITSML and PPDM but the result is a starting point for an organization, not a magic bullet.  Because organizations use data in different ways for different purposes, they may make different judgment calls when mapping data.
  • While there is agreement that mapping WITSML and PPDM is a good idea, this is not a high priority of the membership of either organization when considered against other development and adoption priorities.
  • Mapping WITSML and PPDM is a time- and labor-intensive process that requires dedicated time by subject matter experts of WITSML and PPDM.  There are no plans to extend the POC at this time but a project would be considered with proper funding and resourcing.

APPRECIATION

Energistics and PPDM leadership extend our sincere thanks and appreciation to the dedicated volunteers who worked on this project.  This project serves as an example fo how standards organizations are working together for the benefit of the industry. For more information about the Standards Leadership Council (SLC), see http://oilandgasstandards.org.

WITSML Server Certification

Automated software testing improves the reliability of results and interoperability of WITSML-enabled products.  Testing and certification benefits vendor companies developing server (and client) products, as it demonstrates compliance and can provide a competitive advantage in the marketplace.  For consumer companies (including energy and service companies) that depend on those products to provide reliable data delivery from and across their drilling operations, it enhances the interoperability between deployed solutions, and makes it easier to compare server products feature by feature.

Certification of WITSML 2.0 servers

 This certification program is under development, contact info@energistics.org for more information

Certification of WITSML 1.4.1.1 servers

This certification program has been developed for WITSML servers, API version 1.4.1. and higher.  The keystone of the WITSML Certification Program is an open source testing tool that automates running a suite of tests, which use standard WITSML queries, data-object definitions, and behaviors defined in the WITSML schemas and the WITSML Store Application Interface (API) v1.4.1.

Step Links
(1) Download the Certification Testing Tool DOWNLOAD
(2) Open or download the PDF file containing the WITSML v1.4.1.1 Certification Testing Tool Installation and User Guide PDF
(3) Open or download the PDF file containing the WITSML v1.4.1.1 Certification Overview and Process Guide PDF
(4) Submit the email form if you would like Energistics to run the automated test suite against your server. This will complete the certification process WITSML Certification Form

If a server passes all of the required tests for stated capabilities, it is designated WITSML-certified by Energistics.

This behavior-based, automated software Testing Tool and Certification program replaces all previous certification programs (beginning with v1.4.1) and eliminates the variable nature of former programs by bringing consistency and objectivity to the testing process.  This program is expected to deliver the ease of use and reliable results needed to drive certification, ultimately improving the interoperability and data reliability provided by WITSML.  Upon completion of the certification process, certified v1.4.1 products will be posted to the Energistics website.  Vendors will also be authorized to use the WITSML Certified Product logo

Certification of WITSML 1.3.1 servers

WITSML v1.3.1 has been deprecated but new server certification services are available upon request. Contact Energistics for more information at info@energistics.org

CERTIFICATION PROGRAM OVERVIEW

Energistics developed this program so that vendors can certify that their products comply with related Energistics standards and may use the appropriate Energistics certified product logo.

Upon achieving product certification, vendors may display the WITSML Certified Product Logo.

Current version (2018 – ) Previous version (2016 – 2017)

Details of the certification process, terms and conditions are described in the Certified Product License Agreement for Energistics standards.  For questions or more information on certification, contact Energistics.

Certification Fees

Participation in the Energistics Certification Program is a benefit of membership.
All others pay a specified certification fee which includes membership for the remainder of the calendar year.  Continued membership will be invoiced automatically, fee based on the company’s annual revenue and membership type.  Contact Energistics for more information.

Comments and Questions

All product certification information presented on this website is provided by the vendor company that is requesting certification.  All questions, inquiries or challenges about certification of a specific product should be directed to the product vendor (contact information is on the certification form).  If there are issues or concerns about the accuracy of certification information that are not being adequately addressed by the vendor, please contact Energistics.

Future Plans: Certification Testing

Energistics and its Special Interest Groups (SIGs) may decide to implement additional test suites as part of the certification process.