gml:rangeSet

The gml:rangeSet property element contains the values of the coverage (sometimes called the attribute values).  Its content model is given by gml:RangeSetType.
This content model supports a structural description of the range.  The semantic information describing the range set is embedded using a uniform method, as part of the explicit values, or as a template value accompanying the representation using gml:DataBlock and gml:File.
The values from each component (or "band") in the range may be encoded within a gml:ValueArray element or a concrete member of the gml:AbstractScalarValueList substitution group . Use of these elements satisfies the value-type homogeneity requirement.

Element information

Content

• Choice [1..1]
  • gml:ValueArray [1..*]A Value Array is used for homogeneous arrays of primitive and aggregate values. The member values may be scalars, composites, arrays or lists. ValueArray has the same content model as CompositeValue, but the member values shall be homogeneous. The element declaration contains a Schematron constraint which expresses this restriction precisely. Since the members are homogeneous, the gml:referenceSystem (uom, codeSpace) may be specified on the gml:ValueArray itself and inherited by all the members if desired.
  • Choice [1..*]
    from subst. group gml:AbstractScalarValueList
    gml:BooleanList
    gml:CategoryList
    gml:CountList
    gml:QuantityList
  • gml:DataBlockgml:DataBlock describes the Range as a block of text encoded values similar to a Common Separated Value (CSV) representation. The range set parameterization is described by the property gml:rangeParameters.
  • gml:Filefor efficiency reasons, GML also provides a means of encoding the range set in an arbitrary external encoding, such as a binary file. This encoding may be "well-known" but this is not required. This mode uses the gml:File element. The values of the coverage (attribute values in the range set) are transmitted in a external file that is referenced from the XML structure described by gml:FileType. The external file is referenced by the gml:fileReference property that is an anyURI (the gml:fileName property has been deprecated). This means that the external file may be located remotely from the referencing GML instance. The gml:compression property points to a definition of a compression algorithm through an anyURI. This may be a retrievable, computable definition or simply a reference to an unambiguous name for the compression method. The gml:mimeType property points to a definition of the file mime type. The gml:fileStructure property is defined by a codelist. Note further that all values shall be enclosed in a single file. Multi-file structures for values are not supported in GML. The semantics of the range set is described as above using the gml:rangeParameters property. Note that if any compression algorithm is applied, the structure above applies only to the pre-compression or post-decompression structure of the file. Note that the fields within a record match the gml:valueComponents of the gml:CompositeValue in document order.

Attributes

None

Used in

• Type gml:AbstractContinuousCoverageType via extension of gml:AbstractCoverageType (Element gml:AbstractContinuousCoverage)
• Type gml:AbstractCoverageType (Element gml:AbstractCoverage)
• Type gml:DiscreteCoverageType via extension of gml:AbstractCoverageType (Elements gml:AbstractDiscreteCoverage, gml:MultiPointCoverage, gml:MultiCurveCoverage, gml:MultiSurfaceCoverage, gml:MultiSolidCoverage, gml:GridCoverage, gml:RectifiedGridCoverage)

Sample instance

<gml:rangeSet>
   <gml:ValueArray gml:id="ID" uom="">
      <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:valueComponent>
         <gml:Boolean>true</gml:Boolean>
      </gml:valueComponent>
      <gml:valueComponents>
         <gml:Boolean>true</gml:Boolean>
      </gml:valueComponents>
   </gml:ValueArray>
</gml:rangeSet>