WITSML Version 1.4.1 Data Schema Change Summary

This documents is intended to sumarize Data Schema changes between version 1.3.1.1 and version 1.4.1.  This incorporates changes made in 1.4.0.

Added the following new data objects:

• attachment

  The attachment data object is used to provide a central location for finding a digital attachment that is associated with another WITSML well related data object. The attachment is captured in a base 64 binary type.

• changeLog

  The changeLog schema is an API schema that is used to provide a central location for knowledge of changes in data objects.

• coordinateReferenceSystem

  This supports a GML style CRS definition. The old definition has been retained but is deprecated.

• drillReport

  The drillReport data object is used to capture a daily drilling report focused on reporting from the operator to partners or to a governmental agency.

• stimJob

  The stimJob data object is used to capture a post job summary report about a stimulation (fracture) job.

• toolErrorModel

  The target data object is used to define a surveying tool error model. This data object is globally unique.

• toolErrorTermSet

  The target data object is used to define a set of surveying tool error terms which may be utilized in a toolErrorModel. This data object is globally unique.

• objectGroup

  The logGroup data object replaces wellLog by capturing explicit knowledge that a group of objects are directly related. This is intended to support concepts such as wireline logging, logging while drilling, well tests, wireline formation tests, etc. While a primary usage is target at logs, it can be used to collect any data-object into a group.

Removed the following data objects:

• dtsInstalledSystem

  Now supported by PRODML.

• dtsMeasurement

  Now supported by PRODML.

• trajectoryStation

  No longer needed for adding individual stations to the trajectory.

• realtime

  With changes to the query capability of the API, this is now redundant to log.

• wellLog

  Redundant to new objectGroup.

The WITSML_composite schema has been moved outside of WITSML.

Supported retention of the timezone for an acquisition (e.g., a log). Made the time zone mandatory in all date-time values and in the well timeZone element.

Added a serviceCategory to all objects (via commonData).

Added an event type to the documentInfo audit structure. This will allow clients and servers to capture timestamps associated with a web service.

Moved the concept of a default datum from wellDatum to commonDatum. This will allow the default to be object specific.

Clarified that only the well data object has a globally unique uid attribute.

In the wellbore data object:

• Added an isActive element.
• Added elements for the measured depth and true vertical depth of the bit.

Supported the concept of noun versus adjective in the lithology qualifiers. This primarily affects the meta data in file ancilary/enumValues.xml. Deprecated 39 values and added 34 values.

In the bhaRun data object, allowed drillingParams to recur.

Eliminated documentation about API behavior from the schema. Instead, classified the "role" of the element within the context of the API.

Added a data delimiter for log data. This allows user specified text to contain commas.

In log:

• Made the curve data type mandatory and added new enumerations.
• Added a class index value parallel to classWitsml values in order to capture an item number (e.g., the 3'rd pump).
• Added a pointer to a parent objectGroup.
• Added curveSensorsAligned.
• Made classWitsml an uncontrolled string.
• Added mnemonicList and unitList to logData and deleted columnIndex from header.
• Alowed logData to recur for adding and updating data using a sparse "view" of the data.
• Made the curve data type mandatory and added new enumerations.
• Documented the use of a multipass parameter.
• Added an index offset flag.
• Added an API parameter for data update rate.
• Added an API parameter for requesting only the latest values from a curve.
• Added a namingSystem attribute to mnemonic and mnemAlias.
• Made the uom attribute mandatory in type genericMeasure.
• Clarified that min/max elements are independent of direction.
• Deleted dataRowCount. The API concept of "maximum rows to return" has been moved to an API OptionsIn parameter.

In the mudLog data object:

• Added a commonTime structure to cs_mudLogParameter and cs_geologyInterval in order to capture the time of creation and time of modification.
• Made mdTop and mdBottom mandatory in cs_mudLogParameter.
• Made type mandatory in cs_lithology.
• Clarified the usage of the lithology information.
• Added a kind attribute to lithostratigraphic and chronostratigraphic.
• Deprecated nameFormation, lithClass, grainType, dunhamClass, densShale and abundanceCode.
• Added compaction, sphericity and porosityFabric.
• Constrained the content of matrixCement.
• Added new lithology types.
• Added the lithology and matrix cement types as qualifiers.

Other small changes and fixes were also made.

• Eliminated use of listOfDouble (conflict with .NET).
• Used an integer instead of xsd:gYear for the rig year entered service.
• Eliminated "locked" and "valid" as values of the trajectory status.
• Changed the type of some water depth elements to be a length rather than a coordinate.
• Modified cs_documentInfo to be consistent with schema construction guidelines.
• Clarified the meaning of biasVert in cs_stnTrajMatrixCov.
• In trajectory, deprecated stnGridCorUsed and gridCorUsed and added stnGridConUsed and gridConUsed.
• Changed the type of tqYield and clarified its meaning.
• Added a uid attribute to type cs_bitRecord.
• Added a uid attribute to type indexedObject and clarified the usage of the type.
• Changed the length of strings phase and detailActivity in cs_activity.
• Made the name and uid mandatory in wellDatum.