gml:UnitDefinition

A gml:UnitDefinition is a general definition of a unit of measure. This generic element is used only for units for which no relationship with other units or units systems is known.
The content model of gml:UnitDefinition adds three additional properties to gml:Definition, gml:quantityType, gml:quantityTypeReference and gml:catalogSymbol.  
The gml:catalogSymbol property optionally gives the short symbol used for this unit. This element is usually used when the relationship of this unit to other units or units systems is unknown.

Element information

Content

• Sequence [1..1]
  from type gml:DefinitionBaseType
  gml:metaDataProperty [0..*]
  gml:description [0..1]The value of this property is a text description of the object. gml:description uses gml:StringOrRefType as its content model, so it may contain a simple text string content, or carry a reference to an external description. The use of gml:description to reference an external description has been deprecated and replaced by the gml:descriptionReference property.
  gml:descriptionReference [0..1]The value of this property is a remote text description of the object. The xlink:href attribute of the gml:descriptionReference property references the external description.
  gml:identifier [1..1]Often, a special identifier is assigned to an object by the maintaining authority with the intention that it is used in references to the object For such cases, the codeSpace shall be provided. That identifier is usually unique either globally or within an application domain. gml:identifier is a pre-defined property for such identifiers.
  gml:name [0..*]The gml:name property provides a label or identifier for the object, commonly a descriptive name. An object may have several names, typically assigned by different authorities. gml:name uses the gml:CodeType content model. The authority for a name is indicated by the value of its (optional) codeSpace attribute. The name may or may not be unique, as determined by the rules of the organization responsible for the codeSpace. In common usage there will be one name per authority, so a processing application may select the name from its preferred codeSpace.
  from type gml:DefinitionType
  gml:remarks [0..1]
  1. gml:quantityType [0..1]The gml:quantityType property indicates the phenomenon to which the units apply. This element contains an informal description of the phenomenon or type of physical quantity that is measured or observed. When the physical quantity is the result of an observation or measurement, this term is known as observable type or measurand. The use of gml:quantityType for references to remote values is deprecated.
  2. gml:quantityTypeReference [0..1]The gml:quantityTypeReference property indicates the phenomenon to which the units apply. The content is a reference to a remote value.
  3. gml:catalogSymbol [0..1]The catalogSymbol is the preferred lexical symbol used for this unit of measure. The codeSpace attribute in gml:CodeType identifies a namespace for the catalog symbol value, and might reference the external catalog. The string value in gml:CodeType contains the value of a symbol that should be unique within this catalog namespace. This symbol often appears explicitly in the catalog, but it could be a combination of symbols using a specified algebra of units.

Attributes

Used in

• Type gco:UnitOfMeasure_PropertyType (Element gmd:valueUnit)
• Type gco:UomAngle_PropertyType
• Type gco:UomArea_PropertyType
• Type gco:UomLength_PropertyType (Element gmd:units)
• Type gco:UomScale_PropertyType
• Type gco:UomTime_PropertyType
• Type gco:UomVelocity_PropertyType
• Type gco:UomVolume_PropertyType
• Type gml:ArrayAssociationType (Element gml:members)
• Type gml:DictionaryEntryType (Elements gml:definitionMember, gml:dictionaryEntry)
• Type gmx:UnitDefinition_PropertyType (Element gmx:uomItem)

Substitution hierarchy

• gml:AbstractObject
  • can be substituted with gml:AbstractGML
    • can be substituted with gml:Definition
      • can be substituted with gml:UnitDefinition
        • can be substituted with gml:BaseUnit
          • can be substituted with gmx:ML_BaseUnit
        • can be substituted with gml:DerivedUnit
          • can be substituted with gmx:ML_DerivedUnit
        • can be substituted with gml:ConventionalUnit
          • can be substituted with gmx:ML_ConventionalUnit
        • can be substituted with gmx:ML_UnitDefinition

Sample instance

<gml:UnitDefinition gml:id="ID">
   <gml:metaDataProperty>
      <gml:GenericMetaData>Any text, intermingled with:
         <!--any element-->
      </gml:GenericMetaData>
   </gml:metaDataProperty>
   <gml:description>string</gml:description>
   <gml:descriptionReference/>
   <gml:identifier codeSpace="http://www.example.com/">string</gml:identifier>
   <gml:name>string</gml:name>
   <gml:remarks>string</gml:remarks>
   <gml:quantityType>string</gml:quantityType>
   <gml:quantityTypeReference/>
   <gml:catalogSymbol>string</gml:catalogSymbol>
</gml:UnitDefinition>