Skip to content

AGSi Standard / Project

agsProjectCoordinateSystem

Object description

Defines the spatial coordinate system(s) used by the models. The coordinate system(s) used by the model is considered to be the model coordinate system, although this could be an established regional or national system. A secondary global coordinate system, which will normally be an established regional or national system, may also be defined (for each model system) but this will only exist via transformation from the model coordinate system. Refer to Project Rules for further details.

The parent object of agsProjectCoordinateSystem is agsProject

agsProjectCoordinateSystem has associations (reference links) with the following objects:

agsProjectCoordinateSystem has the following attributes:

Attributes

systemID

Internal identifier for this coordinate system. Not required if only one system is being used.
Type: string
Example: MetroXYZ

description

Name or short description for this coordinate system.
Type: string
Example: 3D [model coordinate system](./Standard_General_Definitions.md#model-coordinate-system): Gotham Metro Grid + OS elevations

systemType

Type of system. Only cartesian systems fully supported at present: XYZ (3D), XZ (2D vertical section), XY (2D map), Z (elevation only, i.e.. simple layer profiles). For other types of system input Other and describe in name or remarks.
Type: string (enum from list below)
- None
Example: XYZ

systemNameXY

Name/description of horizontal coordinate (XY) reference system used for model system
Type: string
Condition: Recommended
Example: Gotham Metro Grid

systemNameZ

Name/description of vertical coordinate (Z) reference system used for model system.
Type: string
Condition: Recommended
Example: Ordnance Datum Newlyn

axisNameX

Axis name for X axis of model coordinate system
Type: string
Condition: Recommended
Example: Easting

axisNameY

Axis name for Y axis of model coordinate system
Type: string
Condition: Recommended
Example: Northing

axisNameZ

Axis name for Z axis of model coordinate system
Type: string
Condition: Recommended
Example: Elevation

axisUnitsXY

Units for X and Y axis (or X axis only if no Y axis). Units are considered to be case sensitive.
Type: string (units)
Condition: Required
Example: m

axisUnitsZ

Units for Z axis (elevation). May include optional prefix and/or suffix as commonly used to identify the datum used. Considered to be case sensitive.
Type: string (units)
Condition: Required
Example: mOD

globalXYSystem

Recognised national or regional horizontal coordinate system that the model coordinate system can be mapped to. This is intended to facilitate co-ordination with data sets in alternative systems and, in particular, encourage legacy use from archive. Transformation information provided in relevant attributes.
Type: string
Example: British National Grid

globalZSystem

Recognised national or regional vertical coordinate system that the model coordinate system can be mapped to. This is intended to facilitate co-ordination with data sets in alternative systems and, in particular, encourage legacy use from archive. Transformation information provided in relevant attributes.
Type: string
Example: Ordnance Datum Newlyn

transformShiftX

Shift in X (or Easting) direction of origin of model coordinate system relative to global coordinate system, i.e. X value of the model origin in the global system.
Type: number
Example: 450000

transformShiftY

Shift in Y (or Northing) direction of origin of model coordinate system relative to global coordinate system, i.e. Y value of the model origin in the global system.
Type: number
Example: 125000

transformXYRotation

Rotation in anticlockwise direction of model coordinate system XY axes relative to global coordinate system XY axes. Units of rotation are decimal degrees.
Type: number (anticlockwise in decimal degrees)
Example: 1.44450116

transformXYScaleFactor

Scale factor as ratio of distance in global coordinate system to model coordinate system, i.e. global distance divided by model distance
Type: number
Example: 0.9999745653

transformshiftZ

Shift in Z (or Elevation) direction of origin of model coordinate system relative to global coordinate system, i.e. Z value of the model origin in the global system.
Type: number
Example: -100

remarks

Additional remarks if required
Type: string
Example: Some remarks if required