FME Transformers: 2024.1

Related Transformers


Reprojects coordinates stored as attributes from one coordinate system to another using the CS-MAP library.

Jump to Configuration

Typical Uses

  • Reprojecting coordinates stored as attributes when explicitly using the CS-Map library is desired
  • Reprojecting coordinates stored as attributes with Z values
  • Performing reprojections with finer control than the AttributeReprojector transformer provides

How does it work?

The CsmapAttributeReprojector accepts any feature. The user specifies attributes containing X, Y, and optionally Z coordinates, and supplies both the Source and Destination Coordinate Systems.

The transformer reprojects the coordinates according to these selections, using the CS-Map library, and updates the X, Y, and Z Attributes to the new values. The original values are overwritten.

This transformer does not alter the feature’s geometry – only the values of the selected X, Y, and Z Attributes (if they contain coordinate values) are changed.

Accurate results depend on the user’s correct selection of the source coordinate system.

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.

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 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.


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 AttributeReprojector provides similar functionality, and will use the default library (CS-Map or Esri) set in FME. It does not handle z values.

Working With Coordinate System Transformers

FME inherently supports coordinate system transformations and reprojections.


Input Ports

Output Ports


Editing Transformer Parameters

Transformer parameters can be set by directly entering values, using expressions, or referencing other elements in the workspace such as attribute values or user parameters. Various editors and context menus are available to assist. To see what is available, click beside the applicable parameter.

For more information, see Transformer Parameter Menu Options.


Processing Behavior


Feature Holding


Dependencies Some reprojections may require additional grid files.

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 CsmapAttributeReprojector on the FME Community.


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