CsmapReprojector

Reprojects feature coordinates from one coordinate system to another using the CS-MAP library.

Jump to Configuration

Typical Uses

  • Reprojecting features when explicitly using the CS-Map library is desired
  • Reprojecting coordinates with Z values (except raster)
  • Performing reprojections with finer control than the Reprojector or inherent reprojections provide

How does it work?

The CsmapReprojector receives vector, raster, or point cloud features and reprojects their coordinates from one coordinate system to another, using the CS-Map library.

The CS-Map library is FME’s default library, and so is generally used for most transformations. Using this transformer explicitly ensures that this library is used, and also provides options for handing Z (vertical) values.

The Source Coordinate System may be either read from the input feature or specified explicitly, and the Destination Coordinate System must be specified. Both may be set by selecting from the Coordinate System Gallery or by name via an attribute value or user parameter.

Dynamic Coordinate Systems

Features may be reprojected to a dynamic Destination Coordinate System - that is, a local coordinate system that is created specifically for each individual feature. This is often used for tasks such as taking measurements or creating geometry in meters or other ground units, on data with geographic (latitude and longitude) coordinates.

There are two types available:

  • _AZMEA_ (Dynamic Reprojection Equal Area) - Better for preserving area accuracy
  • _AZMED_ (Dynamic Reprojection Equal Distance) - Better for preserving distance accuracy

In either case, the input feature is reprojected to a local coordinate system centered on its bounding box. Though all the output features will be centered on a common origin (with the exception of features located very near the poles) and appear stacked on top of each other, each one retains the specifics of its reprojection (and so original position), and can be safely reprojected back into a projected or geographic coordinate system.

Note that Z values are not considered, so areas or distances are best preserved for geometry at an ellipsoid height of 0 meters.

Note: To calculate and reproject to a single AZMED or AZMEA coordinate system that encompasses all input features, consider using the CommonLocalReprojector.

Geographic Transformations

Geographic Transformations control how coordinates are converted between different datums.

The default Transformation is <Auto> (or blank), which will look for an appropriate transformation between datums, if one is needed.

If an explicitly selected pair of coordinate systems has one or more geographic transformations available, they will be provided for explicit selection.

If set to <None>, the NULL_FME transformation will be used which does not alter the value of any coordinates.

Rasters

Additional parameters are available for raster features, specifying how the reprojected cells are to be interpolated.

This transformer is not affected by raster band and palette selection.

Examples

Usage Notes

  • FME also has a Workspace Parameter, Reprojection Engine, that may be set to either FME (CS-Map) or Esri. This transformer will override this parameter setting.
  • The Reprojector provides similar functionality, and will use the default library (CS-Map or Esri) set in FME. It does not handle z values.
  • To reproject coordinates stored as attribute values, consider using the CsmapAttributeReprojector.

Working With Coordinate System Transformers

FME inherently supports coordinate system transformations and reprojections.

Configuration

Input Ports

Output Ports

Parameters

Editing Transformer Parameters

Using a set of menu options, transformer parameters can be assigned by referencing other elements in the workspace. More advanced functions, such as an advanced editor and an arithmetic editor, are also available in some transformers. To access a menu of these options, click beside the applicable parameter. For more information, see Transformer Parameter Menu Options.

Defining Values

There are several ways to define a value for use in a Transformer. The simplest is to simply type in a value or string, which can include functions of various types such as attribute references, math and string functions, and workspace parameters. There are a number of tools and shortcuts that can assist in constructing values, generally available from the drop-down context menu adjacent to the value field.

Dialog Options - Tables

Transformers with table-style parameters have additional tools for populating and manipulating values.

Reference

Processing Behavior

Feature-Based

Feature Holding

No

Dependencies Some reprojections may require additional grid files.
Aliases  
History  

FME Community

The FME Community is the place for demos, how-tos, articles, FAQs, and more. Get answers to your questions, learn from other users, and suggest, vote, and comment on new features.

Search for all results about the CsmapReprojector on the FME Community.

 

Examples may contain information licensed under the Open Government Licence – Vancouver and/or the Open Government Licence – Canada.