12.3.31. att.measurement

att.measurement provides attributes to represent a regularized or normalized measurement.

Module tei — Specification

Members measure

Attributes

unit

(unit) indicates the units used for the measurement, usually using the standard symbol for the desired units.

Status	Optional
Datatype	teidata.enumerated
Suggested values include:	m (metre) SI base unit of length kg (kilogram) SI base unit of mass s (second) SI base unit of time Hz (hertz) SI unit of frequency Pa (pascal) SI unit of pressure or stress Ω (ohm) SI unit of electric resistance L (litre) 1 dm³ t (tonne) 10³ kg ha (hectare) 1 hm² Å (ångström) 10⁻¹⁰ m mL (millilitre) cm (centimetre) dB (decibel) see remarks, below kbit (kilobit) 10³ or 1000 bits Kibit (kibibit) 2¹⁰ or 1024 bits kB (kilobyte) 10³ or 1000 bytes KiB (kibibyte) 2¹⁰ or 1024 bytes MB (megabyte) 10⁶ or 1 000 000 bytes MiB (mebibyte) 2²⁰ or 1 048 576 bytes
Note	If the measurement being represented is not expressed in a particular unit, but rather is a number of discrete items, the unit count should be used, or the unit attribute may be left unspecified. Wherever appropriate, a recognized SI unit name should be used (see further http://www.bipm.org/en/publications/si-brochure/; http://physics.nist.gov/cuu/Units/). The list above is indicative rather than exhaustive.

unitRef

points to a unique identifier stored in the xml:id of a <unitDef> element that defines a unit of measure.

Status	Optional
Datatype	teidata.pointer

quantity

(quantity) specifies the number of the specified units that comprise the measurement

Status	Optional
Datatype	teidata.numeric

commodity

(commodity) indicates the substance that is being measured

Status	Optional
Datatype	1–∞ occurrences of teidata.word separated by whitespace
Note	In general, when the commodity is made of discrete entities, the plural form should be used, even when the measurement is of only one of them.

Schematron

<sch:rule context="tei:*[@unitRef]"> <sch:report test="@unit" role="info">The @unit attribute may be unnecessary when @unitRef is present.</sch:report> </sch:rule>

Note

This attribute class provides a triplet of attributes that may be used either to regularize the values of the measurement being encoded, or to normalize them with respect to a standard measurement system.

<l>So weren't you gonna buy <measure quantity="0.5" unit="gal"
  commodity="ice cream">half
   a gallon</measure>, baby</l>
<l>So won't you go and buy <measure quantity="1.893" unit="L"
  commodity="ice cream">half
   a gallon</measure>, baby?</l>

The unit should normally be named using the standard symbol for an SI unit (see further http://www.bipm.org/en/publications/si-brochure/; http://physics.nist.gov/cuu/Units/). However, encoders may also specify measurements using informally defined units such as lines or characters.