Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Element Description

The characterizes the grid's X, Y, Time, and Other Dimensions.Grid DimensionScale is the X (rows) and Y (columns) of a grid square and Time and Other (examples are depth and altitude). Dimensions are optional sub-elements within the groupIt also defines the resolution of the grid. 

Best Practices

The specific purpose of this element is to provider provide the grid user dimensional information. Grid uses dimensional information placing items in rows, columns and other items, making it easier to create complex layoutsdimension scale information to create the grid. The provider should review the value condition patterns (example of the elements condition is DimensionScaleXUnitPatternDMS (DMS stands for Degrees-Minutes-Seconds)) within the GRID Schema to enter the acceptable metadata values needed for DimensionScale element group. An example of the Degree-Minutes-Seconds unit value pattern is shown below (360-00-00.00). If the correct value patterns are not used the schema validation will fail the grid record based on invalid metadata values.

Examples:

"DimensionScale": {
    "0_360_DegreeProjection": true,
    "X": {
        "Minimum": "-360-00-00.000",
        "Maximum": "360-00-00.00",
        "Unit": "Degrees-Minutes-Seconds",
        "Resolution": 0.125
    },
    "Y": {
        "Minimum": "-360-00-00.000",
        "Maximum": "360-00-00.00",
        "Unit": "Degrees-Minutes-Seconds",
        "Resolution": 0.5
    },
    "Time": {
        "Minimum": "2020-01-01T00:00:00.001Z",
        "Maximum": "2020-01-30T23:59:59Z",
        "Unit": "DateTime",
        "Resolution": 0.125
    },
    "Other": {
        "Minimum": 0,
        "Maximum": 44,
        "Unit": "Meter",
        "Resolution": 0.5
    }
}

Element Specification

DimensionScale is an required element. (Cardinality: 1)

Minutes 90-00 “90-00.000”
“-90 “90 90 “90Minutes 90-00 “90-00.000”
“-90 “90 90 “90Time  Required, if group is used

Model

Element

Type

Constraints

Required?

Cardinality

Notes

GRIDDimensionScale/0_360_DegreeProjectionboolean

true or false

No0..1
GRIDDimensionScale/Xobject

N/A

Yes1
GRIDDimensionScale/X/Minimumstring

Degrees-Minutes-Seconds:
        "Minimum": "-360-00-00.000"
        "Maximum": "360-00-00.000”

Degree:
        "Minimum":

"-

360.000"
        "Maximum": "360.000”
Kilometer:
        "Minimum": “0.000"
        "Maximum": “no limit”
Meter:
        "Minimum": “0.000"
        "Maximum": “no limit”

Yes1Pattern conditions are used for the format of the value. 
GRIDDimensionScale/X/Maximumstring

Degrees-Minutes-

Seconds:
        "Minimum":

"-360-00-00.000"
        "Maximum":

"360-00-00.000”
Degree:
        "Minimum": "-360.000"
        "Maximum": "360.000”
Kilometer:
        "Minimum": “0.000"
        "Maximum": “no limit”
Meter:
        "Minimum": “0.000"
        "Maximum": “no limit”

Yes1Pattern conditions are used for the format of the value. 
GRIDDimensionScale/X/Unitstring

Enumerations: "Kilometer","Meter","Degree"
"Degrees-Minutes-Seconds"

Yes1
GRIDDimensionScale/X/Resolutionnumber

No limit

Yes1
GRIDDimensionScale/Yobject

N/A

Yes1
GRIDDimensionScale/Y/Minimumstring

Degrees-Minutes-Seconds:
        "Minimum":

"-

360-00-00.000"
        "Maximum":

"360-00-00.000”

Degree:
        "Minimum":

"-

360.000"
        "Maximum":

"360.000”
Kilometer:
        "Minimum": “0.000"
        "Maximum": “no limit”
Meter:
        "Minimum": “0.000"
        "Maximum": “no limit”

Yes1Pattern conditions are used for the format of the value. 
GRIDDimensionScale/Y/Maximumstring

Degrees-Minutes-Seconds:
        "Minimum":

"-360-00-00.000"
        "Maximum":

"360-00-00.000”
Degree:
        "Minimum":

"-

360.000"
        "Maximum":

"360.000”
Kilometer:
        "Minimum": “0.000"
        "Maximum": “no limit”
Meter:
        "Minimum": “0.000"
        "Maximum": “no limit”

Yes1Pattern conditions are used for the format of the value. 
GRIDDimensionScale/Y/Unitstring

Enumerations: "Kilometer","Meter","Degree",
"Degrees-Minutes-Seconds"

Yes1
GRIDDimensionScale/Y/Resolutionnumber

No limit

Yes1
GRIDDimensionScale/TimeobjectN/ANo0..1
GRIDDimensionScale/Time/Minimumstring

Degrees-Minutes-Seconds:
        "Minimum": "-360-00-00.000"
        "Maximum": "360-00-00.000”
Minutes:
        "Minimum": “-90-00.000"
        "Maximum": “90-00.000”
Seconds:
        "Minimum": “-90.000"
        "Maximum": “90.000”

DateTime format:
    "YYYY-MM-DDThh:mm:ss.SSSZ"
Date format:
    "YYYY-MM-DD"
Time format:
    "hh:mm:ss.SSSZ"

and free text

No1Pattern conditions are used for the format of the value. 
GRIDDimensionScale/Time/Maximumstring

Degrees-Minutes-Seconds:
        "Minimum": "-360-00-00.000"
        "Maximum": "360-00-00.000”
Minutes:
        "Minimum": “-90-00.000"
        "Maximum": “90-00.000”
Seconds:
        "Minimum": “-90.000"
        "Maximum": “90.000”

DateTime format:
    "YYYY-MM-DDThh:mm:ss.SSSZ"
Date format:
    "YYYY-MM-DD"

Time format:
    "hh:mm:ss.SSSZ"

No1
Pattern conditions are used for the format of the value. 
GRIDDimensionScale/Time/Unitstring

Enumerations: "Hour", "Minutes", "Seconds", "Degrees-Minutes-Seconds", "Date", "Time", "DateTime"

Yes1
GRIDDimensionScale/Time/Resolutionnumber

No limit

Yes1
GRIDDimensionScale/OtherobjectN/ANo0..1
GRIDDimensionScale/Other/Minimumstring

Degrees-Minutes-Seconds:
        "Minimum": "-360-00-00.000"
        "Maximum": "360-00-00.000”
Degree:
        "Minimum": "-360.000"
        "Maximum": "360.000”
Kilometer:
        "Minimum": “0.000"
        "Maximum": “no limit”
Meter:
        "Minimum": “0.000"
        "Maximum": “no limit”

Yes1Pattern conditions are used for the format of the value
GRIDDimensionScale/Other/Maximumstring

Degrees-Minutes-Seconds:
        "Minimum": "-360-00-00.000"

-180 to 180 or 0 to 360

No1Required, if group is used. 

        "Maximum": "360-00-00.000”
Degree:
        "Minimum": "-360.000"
        "Maximum": "360.000”
Kilometer:
        "Minimum": “0.000"
        "Maximum": “no limit”
Meter:
        "Minimum": “0.000"
        "Maximum": “no limit”

Yes1Pattern conditions are used for the format of the value. 
GRIDDimensionScale/Other/Unitstring

Enumerations:

"Kilometer", "Meter", "Degree", "Hour", "Minutes", "Seconds", "Degrees-Minutes-Seconds", "Date", "Time"," DateTime"

Yes1
GRIDDimensionScale/Other/Resolutionnumber

No limit

Yes1

Metadata Validation

All records undergo schema and business rule validation before entering the system. 

  • This element is optional required.
  • The WestBoundingCoordinate and EastBoundingCoordinate DimensionScale sub-elements' Minimum and Maximum value ranges depends on the 0_360_DegreeProjection element's populated value. If the 0_360_DegreeProjection element is set to "true" than the WestBoundingCoordinate Minimum and EastBoundingCoordinate Maximum value ranges are set to 0 to 360 and are validated using the JSON Schema 7 Ifif-then-Else condition "CoordinateCondition"else conditions within the GRID schema.
  • The DimensionScale sub-elements' Unit must use an enumeration and the values will follow the enumeration unit's value pattern base on the GRID schema's if-then-else conditions.
  • The DimensionScale The SpatialResolution elements' value ranges are defined in the GRID schema's condition statements which also is using to validated the grid provider's entries.  

History

GRID Versioning

Version

Date

What Changed

0.0.12023-04-27First version published on wiki