An
activity which performs coordinate system conversion of points, point
arrays and polygons.Activity
An
activity which performs coordinate system conversion of points, point
arrays and polygons.
OpenSpirit Coordinate System Conversion Configuration Fields
| Field | Global Var? | Optional? | Description |
| Name | No | No | User assigned name given to the Coordinate System activity |
| Description | No | Yes | User assigned description (optional) |
| Coordinate System | No | Required unless TargetCRS is supplied in input | 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. |
| Vertical Unit | No | 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 Item | Datatype | 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 CRSs. |
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 | OspPoint2DArray | A OspPoint2DArray which contains a single CRS and a sequence of 2d points (x,y pairs). This will be converted to the TargetCRS. |
| Point3dArray | OspPoint3DArray | A OspPoint3DArray which contains a single CRS and a sequence of 3d points (x,y,z triplets). This will be converted to the TargetCRS. |
| Polygon | OspPolygon | A OspPolygon which contains a single CRS, one exterior ring and zero or more interior rings. This will be converted to the TargetCRS. |
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 | Datatype | 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 | OspPoint2DArray | The input Point2dArray, if supplied, converted to the TargetCRS Coordinate System. |
| Point3dArray | OspPoint3DArray | The input Point3dArray, if supplied, converted to the TargetCRS Coordinate System. |
| Polygon | OspPolygon | The input Polygon, if supplied, converted to the TargetCRS Coordinate System. |
The Error Output tab lists the possible exceptions that can be thrown by this activity.
| Exception | Thrown When ... |
OspException msg msgCode |
The coordinate conversion could
not be successfully performed.
The msg element should contain some indication of the reason. The error code (see list of possible codes) |