A map projection between georeferenced rasters.
When no target raster is specified (i.e. the target field is
null), the map projection will transform raster coordinates to 3D geographic coordinates (latitude, longitude, ellipsoid height), based on the geodetic datum of this coordinate system of source. If a datum transform is given (i.e. the transform field is not
null), it will be applied to the 3D geographic coordinates. The method assumes that the user has chosen a datum transform that is consistent with the coordinate system of source.
If a target raster is given (i.e the target field is not
null), the map projection will transform source raster coordinates to target raster coordinates. If the source and target raster use different datums (geodetic and/or vertical), one or more additional datum transforms may be necessary. When the transform field is
null, the method tries to find a suitable composite datum transform in the georegistry. If no transform is found, it is silently assumed that no datum transformation is necessary. This behaviour can be overridden by providing a non-null value to the transform field, which will then be used instead (skipping the lookup).