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.

Description

Provide a short description for the activity.

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.

Fault

The Fault tab lists exceptions that are thrown by this activity.

Error Schema Element Datatype Description
msg string The error message returned by the plug-in.
msgCode string The error code returned by the plug-in
Fault Thrown When...