# Transform Map

## Description

This functor re-projects the given map according to a set of parameters. It can also crop and re-project a map based on a given format map.

## Inputs

Name Type Description
Input Map Filename Map Filename Type The filename of the input map that will be re-projected.
Output Map Filename Map Filename Type The filename of the resulting re-projected map.

## Optional Inputs

Name Type Description Default Value
Output Format Map Filename Map Filename Type The filename of the format map. If the format map is provided, its projection, extents and cell size is used as the default attributes of the resulting re-projected map. This filename can not be used together with the “Output Map Projection”. null
Output Map Projection Projection Type If provided, this projection is used to re-project the input map and generate the resulting re-projected map. In this case, the extents and cell size of the resulting map are calculated automatically (their definitions can be overridden using the appropriate settings). The output projection can not be used together with the “Output Format Filename”. null
Output Map Cell Type Cell Type Type Data cell type of the resulting re-projected map. For this functor, the cell types Unsigned 1-Bit Integer and Signed 8-Bit Integer are just an alias for cell type Unsigned 8-Bit Integer. Signed 32-Bit Integer
Output Map Null Value Null Value Type Null value of the resulting re-projected map. .default
Resampling Method Enum Type Resampling method to use. Valid values are .nearest, .bilinear, .cubic, .spline, .lanzo, .average, .mode, .maximum, .minimum, .median, .1quartile and .3quartile .nearest
Additional Input Map Null Value Null Value Type Additional value representing null values in the input map that will be re-projected. Cells with such value are also treated as null cells. This is particularly useful for defining a null value for an image file that does not have this definition. null
Input Map Projection Projection Type If defined, the input map is assumed to have this projection. Otherwise, the projection provided by the input map itself is used. null
Output Map Lines Positive Integer Value Type The number of lines expected in the resulting re-projected map. Must be defined together with the number of columns. However, the definition of expected number of lines/columns and cell height/width are mutually exclusive. null
Output Map Columns Positive Integer Value Type The number of columns expected in the resulting re-projected map. Must be defined together with the number of lines. However, the definition of expected number of lines/columns and cell height/width are mutually exclusive. null
Output Map Cell Width Real Value Type The cell width in the resulting re-projected map. Must be defined together with the cell height. However, the definition of expected cell height/width and number of lines/columns are mutually exclusive. The cell width must be expressed in unit compatible with the projection of the resulting re-projected map. null
Output Map Cell Height Real Value Type The cell height in the resulting re-projected map. Must be defined together with the cell width. However, the definition of expected cell height/width and number of lines/columns are mutually exclusive. The cell height must be expressed in unit compatible with the projection of the resulting re-projected map. null
Use Compression Boolean Value Type If true, the resulting re-projected map is compressed. The map compression option only works for GeoTiff (.tif) and HFA (.img) file formats. For other file formats this option is ignored. true

## Outputs

Name Type Description
Output Map Filename Map Filename Type The filename of the resulting re-projected map. This is the same filename assigned to the corresponding input port.

## Notes

This functor is basically a wrap around the GDAL library utilities GDAL Warp and GDAL Translate. GDAL Warp is used to re-project the map and GDAL Translate is used to clip the map according to the boundaries of a given mask.

The information about the categories present in the input map are not preserved by the re-projection.

It is worth noting that, unlike most functors, this functor can not be bound to maps produced by other functors, unless they are saved to the disk first (by using Save Map). Unfortunately, the use of GDAL does not allow us to the use the maps produced by Dinamica EGO while they are still in memory, unless they are re-arranged in a way defined by their API, and such re-arrangement would heavily impact the execution performance and the amount of memory required to perform the re-projection of a map.

TransformMap