Jump to content

Measurement:Units: Difference between revisions

From AOWIS
mNo edit summary
mNo edit summary
 
(13 intermediate revisions by the same user not shown)
Line 3: Line 3:
* Related to: [[Measurement:Unit_Identifiers]]
* Related to: [[Measurement:Unit_Identifiers]]


AOWIS systems, components, and data models MUST use the International System of Units (SI) as the canonical unit system.<ref name="BIPM-SI">International Bureau of Weights and Measures (BIPM) — International System of Units (SI) https://www.bipm.org/en/measurement-units/si-base-units</ref><ref name="NIST-SI">NIST — The International System of Units (SI) https://www.nist.gov/pml/owm/metric-si/si-units</ref>
AOWIS-compliant systems, components, interfaces, and data models MUST use the International System of Units (SI) as the canonical unit system for physical quantities represented in the AOWIS measurement model.<ref name="BIPM-SI">International Bureau of Weights and Measures (BIPM) — International System of Units (SI) https://www.bipm.org/en/measurement-units/si-base-units</ref><ref name="NIST-SI">NIST — The International System of Units (SI) https://www.nist.gov/pml/owm/metric-si/si-units</ref>


SI is the globally accepted standard for scientific and technical measurement and is defined and maintained by the International Bureau of Weights and Measures (BIPM).<ref name="Wikipedia-SI">Wikipedia — International System of Units https://en.wikipedia.org/wiki/International_System_of_Units</ref>
SI is the globally accepted standard for scientific and technical measurement and is defined and maintained by the International Bureau of Weights and Measures (BIPM).<ref name="Wikipedia-SI">Wikipedia — International System of Units https://en.wikipedia.org/wiki/International_System_of_Units</ref>
Line 13: Line 13:
The use of a single unit system reduces implementation complexity, eliminates ambiguity during data exchange, simplifies validation and testing, and improves interoperability between independent AOWIS implementations.
The use of a single unit system reduces implementation complexity, eliminates ambiguity during data exchange, simplifies validation and testing, and improves interoperability between independent AOWIS implementations.


User Interfaces can show numerical values in non-SI units for convenience, but this is only allowed ''additionally'' to the official SI-unit, and the UI needs to transfer this to the user.
User interfaces MAY display numerical values in supported alternative units for convenience, provided that the displayed unit is clearly indicated. Such presentation does not change the authoritative canonical value used by AOWIS.
 
== Terminology ==
 
; AOWIS domain model
: The authoritative representation of concepts, entities, relationships, and state managed by AOWIS.
 
; AOWIS measurement model
: The part of the AOWIS domain model that represents physical quantities, measurement values, units, precision, timestamps, and measurement provenance.
 
; Canonical value
: The authoritative numerical representation of a measurement value expressed in the canonical SI unit defined for its measurement quantity.
 
; Source value
: The original numerical value and unit representation received from a user, device, file, component, or external system before validation and normalization into the canonical AOWIS representation.


== Requirements ==
== Requirements ==
Line 19: Line 33:


<pre>
<pre>
REQ-MEAS-001: All numerical values representing physical quantities within the AOWIS measurement model MUST be represented using their defined canonical SI units.
REQ-MEAS-001: All authoritative numerical values representing physical quantities within the AOWIS measurement model MUST be represented using their defined canonical SI units.


REQ-MEAS-001: All authoritative numerical values representing physical quantities within the AOWIS domain model MUST be represented using their defined canonical SI units.
REQ-MEAS-002: Implementations MUST NOT introduce conversion artifacts, rounding errors, or precision loss exceeding the documented precision of the measurement.


REQ-MEAS-002: Implementations MUST produce results that are numerically consistent with SI-based processing.
REQ-MEAS-003: Interfaces between AOWIS-compliant components and components or systems using non-canonical unit representations MUST perform the required conversion at the applicable boundary. Values entering the AOWIS measurement model MUST be converted to their defined canonical SI units. Values leaving AOWIS MAY be converted to the representation required by the receiving component or system.


REQ-MEAS-003: Implementations MUST NOT introduce conversion artifacts, rounding errors, or precision loss exceeding the documented precision of the measurement.
REQ-MEAS-004: Original source values and their unit identifiers MAY be retained as provenance data. Retained source values MUST be clearly distinguished from the authoritative canonical values and MUST NOT be used as authoritative values for computation, comparison, validation, or control logic.


REQ-MEAS-004: Interfaces between the AOWIS domain model and components using different unit representations MUST perform the required conversion at the component boundary.
REQ-MEAS-005: Each distinct measurement quantity in AOWIS MUST be mapped to exactly one canonical SI unit. Measurement quantities with different meanings MUST have separate identifiers, even when they use the same canonical unit.
 
REQ-MEAS-005: Each distinct measurement quantity in AOWIS MUST be mapped to exactly one canonical unit. Measurement quantities with different meanings MUST have separate identifiers, even when they use the same canonical unit.
</pre>
</pre>


Line 36: Line 48:
REQ-MEAS-UI-000: User interfaces MUST clearly indicate the unit associated with every displayed or entered numerical value representing a physical quantity.
REQ-MEAS-UI-000: User interfaces MUST clearly indicate the unit associated with every displayed or entered numerical value representing a physical quantity.


REQ-MEAS-UI-001: User interfaces MAY display measurement values in supported non-SI units for convenience, provided that the displayed unit is clearly indicated.
REQ-MEAS-UI-001: User interfaces MAY display measurement values in supported non-canonical units for convenience, provided that the displayed unit is clearly indicated.
 
REQ-MEAS-UI-002: User interfaces accepting non-SI input MUST convert the entered value to the canonical SI unit before it enters the AOWIS domain model.


REQ-MEAS-UI-003: Original non-SI input values and their unit identifiers MAY be stored as provenance data but MUST NOT be used as the authoritative values for computation, comparison, validation, or control logic.
REQ-MEAS-UI-002: User interfaces accepting values in non-canonical units MUST convert the entered value to its defined canonical SI unit before it enters the AOWIS measurement model.


REQ-MEAS-UI-004: Rounding performed for presentation MUST NOT modify the underlying canonical value.
REQ-MEAS-UI-003: Rounding performed for presentation MUST NOT modify the underlying canonical value.
</pre>
</pre>


== Notes ==
== Notes ==


External systems MAY use alternative unit systems. Any required conversion between such systems and AOWIS is performed at the system boundary in accordance with REQ-MEAS-004.
External systems MAY use alternative unit systems. Any required conversion between such systems and AOWIS is performed at the system boundary in accordance with REQ-MEAS-003.


== References ==
== References ==
<references />
<references />

Latest revision as of 22:32, 13 July 2026

AOWIS-compliant systems, components, interfaces, and data models MUST use the International System of Units (SI) as the canonical unit system for physical quantities represented in the AOWIS measurement model.[1][2]

SI is the globally accepted standard for scientific and technical measurement and is defined and maintained by the International Bureau of Weights and Measures (BIPM).[3]

Purpose

This specification establishes a single authoritative unit system for all physical quantities represented by AOWIS.

The use of a single unit system reduces implementation complexity, eliminates ambiguity during data exchange, simplifies validation and testing, and improves interoperability between independent AOWIS implementations.

User interfaces MAY display numerical values in supported alternative units for convenience, provided that the displayed unit is clearly indicated. Such presentation does not change the authoritative canonical value used by AOWIS.

Terminology

AOWIS domain model
The authoritative representation of concepts, entities, relationships, and state managed by AOWIS.
AOWIS measurement model
The part of the AOWIS domain model that represents physical quantities, measurement values, units, precision, timestamps, and measurement provenance.
Canonical value
The authoritative numerical representation of a measurement value expressed in the canonical SI unit defined for its measurement quantity.
Source value
The original numerical value and unit representation received from a user, device, file, component, or external system before validation and normalization into the canonical AOWIS representation.

Requirements

General

REQ-MEAS-001: All authoritative numerical values representing physical quantities within the AOWIS measurement model MUST be represented using their defined canonical SI units.

REQ-MEAS-002: Implementations MUST NOT introduce conversion artifacts, rounding errors, or precision loss exceeding the documented precision of the measurement.

REQ-MEAS-003: Interfaces between AOWIS-compliant components and components or systems using non-canonical unit representations MUST perform the required conversion at the applicable boundary. Values entering the AOWIS measurement model MUST be converted to their defined canonical SI units. Values leaving AOWIS MAY be converted to the representation required by the receiving component or system.

REQ-MEAS-004: Original source values and their unit identifiers MAY be retained as provenance data. Retained source values MUST be clearly distinguished from the authoritative canonical values and MUST NOT be used as authoritative values for computation, comparison, validation, or control logic.

REQ-MEAS-005: Each distinct measurement quantity in AOWIS MUST be mapped to exactly one canonical SI unit. Measurement quantities with different meanings MUST have separate identifiers, even when they use the same canonical unit.

User Interface Specific

REQ-MEAS-UI-000: User interfaces MUST clearly indicate the unit associated with every displayed or entered numerical value representing a physical quantity.

REQ-MEAS-UI-001: User interfaces MAY display measurement values in supported non-canonical units for convenience, provided that the displayed unit is clearly indicated.

REQ-MEAS-UI-002: User interfaces accepting values in non-canonical units MUST convert the entered value to its defined canonical SI unit before it enters the AOWIS measurement model.

REQ-MEAS-UI-003: Rounding performed for presentation MUST NOT modify the underlying canonical value.

Notes

External systems MAY use alternative unit systems. Any required conversion between such systems and AOWIS is performed at the system boundary in accordance with REQ-MEAS-003.

References

  1. International Bureau of Weights and Measures (BIPM) — International System of Units (SI) https://www.bipm.org/en/measurement-units/si-base-units
  2. NIST — The International System of Units (SI) https://www.nist.gov/pml/owm/metric-si/si-units
  3. Wikipedia — International System of Units https://en.wikipedia.org/wiki/International_System_of_Units