CoordinateSystemConversion
An activity which performs coordinate system conversion of points, point arrays and polygons.
General
The General tab contains the following fields.
Field | Module Property? | Description |
---|---|---|
Coordinate System | No | An OpenSpirit Coordinate Reference System (CRS) to convert the input points, point arrays, or polygons to. This is created by the OpenSpirit Coordinate System Selector. Note: when a CRS is specified a datum shift is also specified so datum shifts may be performed if required. Clicking on the edit button will prompt you to connect to OpenSpirit if a connection has not previously been made. Required unless TargetCRS is supplied in input. |
Vertical Unit | No | The unit to use on the vertical axis of the target compound (3d) CRS. If supplied this will override any vertical unit defined in the Coordinate System. |
Input
The following is the input for the activity.
Input Item | Data Type | Description |
---|---|---|
Parameters | Complex | Root element for all input elements |
TargetCRS | OspCRS | Required if the coordinate system not specified in the configuration panel. If the coordinate system is supplied in the configuration panel and as an input, the value specified in the input will override the configuration panel value. |
TransformEPSG | integer | An optional EPSG code to specify a geographic transform (datum shift) to use to transform the input coordinates' geographic system into the TargetCRS's geographic system. If supplied this will override any early bound datum shifts specified on the input and target CRS. |
Point* | A sequence of OspPoint's | A sequence of OspPoint elements, each of which specifies its CRS and x, y, z point location. These will be converted to the TargetCRS. |
Point2dArray | A sequence of OspPoint2DArray | A sequence of OspPoint2DArray elements, each contains a single CRS and a sequence of 2d points (x,y pairs). These will be converted to the TargetCRS. |
Point3dArray | A sequence of OspPoint2DArray | A sequence of OspPoint3DArray elements, each contains a single CRS and a sequence of 3d points (x,y,z triplets). These will be converted to the TargetCRS. |
Polygon | A sequence of OspPolygon | A sequence of OspPolygon elements, each contains a single CRS, one exterior ring and zero or more interior rings. These will be converted to the TargetCRS. |
Output
The following is the output for the activity. The output for this activity mirrors the input but all supplied input values have now been converted to the TargeCRS and all CRSs are now equal to the TargetCRS.
Output Item | Data Type | Description |
---|---|---|
OspOutput | Complex | Root element for all output elements |
TargetCRS | OspCRS | The CRS that all input geometries have been converted to. |
Vertical Unit | OspUnit | The unit for any z values in the converted Point* or Point3dArray elements. |
TransformEPSG | integer | The EPSG code, if supplied, for the geographic transform used to do a datum shift of the input geometries datum to the TargetCRS datum. |
Point* | A sequence of OspPoint's | The input points, if supplied, converted to the TargetCRS Coordinate System. |
Point2dArray | A sequence of OspPoint2DArray | The input Point2d Arrays, if supplied, converted to the TargetCRS Coordinate System. |
Point3dArray | A sequence of OspPoint3DArray | The input Point3d Arrays, if supplied, converted to the TargetCRS Coordinate System. |
Polygon | A sequence of OspPolygon | The input Polygons, if supplied, converted to the TargetCRS Coordinate System. |