UnitsML XML unit markup schema

Introduction

This schema was originally developed and published by NIST. The schema is used by the OCX schema which is managed by the OCX Consortium. The UnitsML schema is publihsed by the OCX Consortium under the original LICENSE.

Changelog

• CHANGELOG.md

Project structure

Root
└──ocx_unitsml         
   └───ocx_unitsml_0918

How to contribute

The schema file is maintained using an XML editor like Altova XMLSpy.

1. Installation: Simply download the schema files from the repository or clone it using git.
2. Create an Issue for the proposed schema change. Follow the recipe on the Wiki on how to register an issue.
3. Then create a branch from the issue, check out the branch and implement the proposed changes.
4. When the implementation is completed, create a pull request.
5. The pull request will have to be approved by the OCXStandard maintainer before it can be included in the working draft.

Schema versioning

The UnitsML schema is following the Python PEP 440 versioning recommendations.

Following PEP 440, the canonical public version identifiers MUST comply with the following scheme:

[N!]N(.N)*[{a|b|rc}N][.postN][.devN] see the PEP 440 for a detailed explanation.

tbump versioning tool

The Python tbump tool is used to automate and bump schema versions. tbump also provides the possibility for pre- and post-commit actions. The project config file pyproject.toml contains the tbump settings.

Usage

Assume that the current schema version is 0.9.18. To bump the schema version to a new version 1.0.0 version, the following command can be issued:

> tbump 1.0.0

Naive databinding

A set of Python dataclasses are autogenerated after each version release, see databindings

Generating databindings

Public License

The UnitsML standard is governed by the OASIS Intellectual Property Rights Policy (the License).

Read the License

Unless required by applicable law or agreed to in writing, the UnitsML standard and any derivative works re-distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. The OCX Consortium is not liable to any use whatsoever of the distributed standard or derivative works based on the standard.

Credits

NIST for the original schema development and OASIS UnitsML TC for publishing the schema version 1.0 in 2011.