DimensionScale (GRID)

Element Description

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 group. It also defines the resolution of the grid.

Best Practices

The specific purpose of this element is to provider the grid user dimension 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)

Model	Element	Type	Constraints	Required?	Cardinality	Notes
GRID	DimensionScale/0_360_DegreeProjection	boolean	true or false	No	0..1
GRID	DimensionScale/X/Minimum	string	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”	Yes	1	Pattern conditions are used for the format of the value.
GRID	DimensionScale/X/Maximum	string	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”	Yes	1	Pattern conditions are used for the format of the value.
GRID	DimensionScale/X/Unit	string	Enumerations: "Kilometer","Meter","Degree" "Degrees-Minutes-Seconds"	Yes	1
GRID	DimensionScale/X/Resolution	number	No limit	Yes	1
GRID	DimensionScale/Y/Minimum	string	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”	Yes	1	Pattern conditions are used for the format of the value.
GRID	DimensionScale/Y/Maximum	string	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”	Yes	1	Pattern conditions are used for the format of the value.
GRID	DimensionScale/Y/Unit	string	Enumerations: "Kilometer","Meter","Degree", "Degrees-Minutes-Seconds"	Yes	1
GRID	DimensionScale/X/Resolution	number	No limit	Yes	1
GRID	DimensionScale/Time	string	DateTime format: "YYYY-MM-DDThh:mm:ss.SSSZ" Date format: "YYYY-MM-DD" Time format: "hh:mm:ss.SSSZ"	No	1	Pattern conditions are used for the format of the value.
GRID	DimensionScale/Other/Minimum	string	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” Degree: "Minimum": "-360.000" "Maximum": "360.000” Kilometer: "Minimum": “0.000" "Maximum": “no limit” Meter: "Minimum": “0.000" "Maximum": “no limit” DateTime format: "YYYY-MM-DDThh:mm:ss.SSSZ" Date format: "YYYY-MM-DD" Time format: "hh:mm:ss.SSSZ" and free text	No	1	Pattern conditions are used for the format of the value.
GRID	DimensionScale/Other/Maximum	string	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” Degree: "Minimum": "-360.000" "Maximum": "360.000” Kilometer: "Minimum": “0.000" "Maximum": “no limit” Meter: "Minimum": “0.000" "Maximum": “no limit” DateTime format: "YYYY-MM-DDThh:mm:ss.SSSZ" Date format: "YYYY-MM-DD" Time format: "hh:mm:ss.SSSZ" and free text	No	1	Pattern conditions are used for the format of the value.
GRID	DimensionScale/Other/Unit	string	Enumerations: "Kilometer", "Meter", "Degree", "Hour", "Minutes", "Seconds", "Degrees-Minutes-Seconds", "Date", "Time", "DateTime"	Yes	1
GRID	DimensionScale/Other/Resolution	number	No limit

Metadata Validation

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

This element is required.
The 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 Minimum and Maximum value ranges are set to 0 to 360 and are validated using the JSON Schema 7 If-then-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 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.1	2023-04-27	First version published on wiki

Page tree