Class DefaultProjectedCRS

All Implemented Interfaces:
Serializable, CoordinateReferenceSystem, GeneralDerivedCRS, ProjectedCRS, SingleCRS, IdentifiedObject, ReferenceSystem, PROJFormattable

public class DefaultProjectedCRS extends AbstractDerivedCRS implements ProjectedCRS, PROJFormattable
A 2D coordinate reference system used to approximate the shape of the earth on a planar surface. It is done in such a way that the distortion that is inherent to the approximation is carefully controlled and known. Distortion correction is commonly applied to calculated bearings and distances to produce values that are a close match to actual field values.
Used with CS type(s)
Cartesian
Since:
2.1
Author:
Martin Desruisseaux (IRD)
See Also:
  • Constructor Details

    • DefaultProjectedCRS

      public DefaultProjectedCRS(ProjectedCRS crs)
      Constructs a new projected CRS with the same values than the specified one. This copy constructor provides a way to wrap an arbitrary implementation into a Geotools one or a user-defined one (as a subclass), usually in order to leverage some implementation-specific API. This constructor performs a shallow copy, i.e. the properties are not cloned.
      Parameters:
      crs - The coordinate reference system to copy.
      Since:
      2.2
    • DefaultProjectedCRS

      public DefaultProjectedCRS(String name, GeographicCRS base, MathTransform baseToDerived, CartesianCS derivedCS) throws MismatchedDimensionException
      Constructs a projected CRS from a name. A default operation method is inferred from the math transform. This is a convenience constructor that is not garanteed to work reliably for non-GeoTools implementations. Use the constructor expecting a defining conversion for more determinist result.
      Parameters:
      name - The name.
      base - Coordinate reference system to base the derived CRS on.
      baseToDerived - The transform from the base CRS to returned CRS.
      derivedCS - The coordinate system for the derived CRS. The number of axes must match the target dimension of the transform baseToDerived.
      Throws:
      MismatchedDimensionException - if the source and target dimension of baseToDerived don't match the dimension of base and derivedCS respectively.
      Since:
      2.5
    • DefaultProjectedCRS

      public DefaultProjectedCRS(Map<String,Object> properties, GeographicCRS base, MathTransform baseToDerived, CartesianCS derivedCS) throws MismatchedDimensionException
      Constructs a projected CRS from a set of properties. A default operation method is inferred from the math transform. This is a convenience constructor that is not garanteed to work reliably for non-GeoTools implementations. Use the constructor expecting a defining conversion for more determinist result.

      The properties are given unchanged to the super-class constructor.

      Parameters:
      properties - Name and other properties to give to the new derived CRS object and to the underlying projection.
      base - Coordinate reference system to base the derived CRS on.
      baseToDerived - The transform from the base CRS to returned CRS.
      derivedCS - The coordinate system for the derived CRS. The number of axes must match the target dimension of the transform baseToDerived.
      Throws:
      MismatchedDimensionException - if the source and target dimension of baseToDerived don't match the dimension of base and derivedCS respectively.
      Since:
      2.5
    • DefaultProjectedCRS

      public DefaultProjectedCRS(Map<String,Object> properties, OperationMethod method, GeographicCRS base, MathTransform baseToDerived, CartesianCS derivedCS) throws MismatchedDimensionException
      Constructs a projected CRS from a set of properties. The properties are given unchanged to the super-class constructor.
      Parameters:
      properties - Name and other properties to give to the new derived CRS object and to the underlying projection.
      method - A description of the method for the conversion.
      base - Coordinate reference system to base the derived CRS on.
      baseToDerived - The transform from the base CRS to returned CRS.
      derivedCS - The coordinate system for the derived CRS. The number of axes must match the target dimension of the transform baseToDerived.
      Throws:
      MismatchedDimensionException - if the source and target dimension of baseToDerived don't match the dimension of base and derivedCS respectively.
    • DefaultProjectedCRS

      public DefaultProjectedCRS(Map<String,?> properties, Conversion conversionFromBase, GeographicCRS base, MathTransform baseToDerived, CartesianCS derivedCS) throws MismatchedDimensionException
      Constructs a projected CRS from a defining conversion. The properties are given unchanged to the super-class constructor.
      Parameters:
      properties - Name and other properties to give to the new projected CRS object.
      conversionFromBase - The defining conversion.
      base - Coordinate reference system to base the projected CRS on.
      baseToDerived - The transform from the base CRS to returned CRS.
      derivedCS - The coordinate system for the projected CRS. The number of axes must match the target dimension of the transform baseToDerived.
      Throws:
      MismatchedDimensionException - if the source and target dimension of baseToDerived don't match the dimension of base and derivedCS respectively.
  • Method Details