Package org.geotools.referencing.crs
Class DefaultEngineeringCRS
- Object
-
- Formattable
-
- AbstractIdentifiedObject
-
- AbstractReferenceSystem
-
- AbstractCRS
-
- AbstractSingleCRS
-
- DefaultEngineeringCRS
-
- All Implemented Interfaces:
Serializable
,CoordinateReferenceSystem
,EngineeringCRS
,SingleCRS
,IdentifiedObject
,ReferenceSystem
public class DefaultEngineeringCRS extends AbstractSingleCRS implements EngineeringCRS
A contextually local coordinate reference system. It can be divided into two broad categories:- earth-fixed systems applied to engineering activities on or near the surface of the earth;
- CRSs on moving platforms such as road vehicles, vessels, aircraft, or spacecraft.
Used with CS type(s) Cartesian
,Affine
,Ellipsoidal
,Spherical
,Cylindrical
,Polar
,Vertical
,Linear
- Since:
- 2.1
- Author:
- Martin Desruisseaux (IRD)
- See Also:
- Serialized Form
-
-
Field Summary
Fields Modifier and Type Field Description static DefaultEngineeringCRS
CARTESIAN_2D
static DefaultEngineeringCRS
CARTESIAN_3D
static DefaultEngineeringCRS
GENERIC_2D
static DefaultEngineeringCRS
GENERIC_3D
protected boolean
wildcard
Marks the CRS as a wildcard one.-
Fields inherited from class AbstractSingleCRS
datum
-
Fields inherited from class AbstractCRS
coordinateSystem
-
Fields inherited from class AbstractIdentifiedObject
EMPTY_ALIAS_ARRAY, EMPTY_IDENTIFIER_ARRAY, IDENTIFIER_COMPARATOR, NAME_COMPARATOR, REMARKS_COMPARATOR
-
Fields inherited from class Formattable
SINGLE_LINE
-
Fields inherited from interface IdentifiedObject
ALIAS_KEY, IDENTIFIERS_KEY, NAME_KEY, REMARKS_KEY
-
Fields inherited from interface ReferenceSystem
DOMAIN_OF_VALIDITY_KEY, SCOPE_KEY
-
-
Constructor Summary
Constructors Constructor Description DefaultEngineeringCRS(String name, EngineeringDatum datum, CoordinateSystem cs)
Constructs an engineering CRS from a name.DefaultEngineeringCRS(Map<String,?> properties, EngineeringDatum datum, CoordinateSystem cs)
Constructs an engineering CRS from a set of properties.DefaultEngineeringCRS(Map<String,?> properties, EngineeringDatum datum, CoordinateSystem cs, boolean wildcard)
Constructs an engineering CRS from a set of properties.DefaultEngineeringCRS(EngineeringCRS crs)
Constructs a new enginnering CRS with the same values than the specified one.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description boolean
equals(AbstractIdentifiedObject object, boolean compareMetadata)
Compares the specified object to this CRS for equality.protected String
formatWKT(Formatter formatter)
Format the inner part of a Well Known Text (WKT) element.EngineeringDatum
getDatum()
Returns the datum.int
hashCode()
Returns a hash value for this derived CRS.boolean
isWildcard()
Returns true if this is a wildcard CRS, that is, one that will transform from and to any other CRS using the identity transformation-
Methods inherited from class AbstractSingleCRS
getAxis, getDimension
-
Methods inherited from class AbstractCRS
distance, getCoordinateSystem
-
Methods inherited from class AbstractReferenceSystem
getDomainOfValidity, getScope
-
Methods inherited from class AbstractIdentifiedObject
asSet, ensureAngularUnit, ensureLinearUnit, ensureNonNull, ensureNonNull, ensureTimeUnit, equals, equals, equals, equals, getAlias, getIdentifier, getIdentifier, getIdentifiers, getName, getName, getName, getProperties, getProperties, getRemarks, nameMatches, nameMatches, nameMatches
-
Methods inherited from class Formattable
cleanupThreadLocals, toString, toWKT, toWKT, toWKT, toWKT
-
Methods inherited from interface IdentifiedObject
getAlias, getIdentifiers, getName, getRemarks, toWKT
-
Methods inherited from interface ReferenceSystem
getDomainOfValidity, getScope
-
Methods inherited from interface SingleCRS
getCoordinateSystem
-
-
-
-
Field Detail
-
wildcard
protected boolean wildcard
Marks the CRS as a wildcard one. Wildcard CRS will transform to any other CRS with the identity transform
-
CARTESIAN_2D
public static final DefaultEngineeringCRS CARTESIAN_2D
A two-dimensional cartesian coordinate reference system with x, y axis in metres. By default, this CRS has no transformation path to any other CRS (i.e. a map using this CS can't be reprojected to a geographic coordinate reference system for example).
-
CARTESIAN_3D
public static final DefaultEngineeringCRS CARTESIAN_3D
A three-dimensional cartesian coordinate reference system with x, y, z axis in metres. By default, this CRS has no transformation path to any other CRS (i.e. a map using this CS can't be reprojected to a geographic coordinate reference system for example).
-
GENERIC_2D
public static final DefaultEngineeringCRS GENERIC_2D
A two-dimensional wildcard coordinate system with x, y axis in metres. At the difference ofCARTESIAN_2D
, this coordinate system is treated specially by the default coordinate operation factory with loose transformation rules: if no transformation path were found (for example through a derived CRS), then the transformation from this CRS to any CRS with a compatible number of dimensions is assumed to be the identity transform. This CRS is usefull as a kind of wildcard when no CRS were explicitly specified.
-
GENERIC_3D
public static final DefaultEngineeringCRS GENERIC_3D
A three-dimensional wildcard coordinate system with x, y, z axis in metres. At the difference ofCARTESIAN_3D
, this coordinate system is treated specially by the default coordinate operation factory with loose transformation rules: if no transformation path were found (for example through a derived CRS), then the transformation from this CRS to any CRS with a compatible number of dimensions is assumed to be the identity transform. This CRS is usefull as a kind of wildcard when no CRS were explicitly specified.
-
-
Constructor Detail
-
DefaultEngineeringCRS
public DefaultEngineeringCRS(EngineeringCRS crs)
Constructs a new enginnering 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 CRS to copy.- Since:
- 2.2
-
DefaultEngineeringCRS
public DefaultEngineeringCRS(String name, EngineeringDatum datum, CoordinateSystem cs)
Constructs an engineering CRS from a name.- Parameters:
name
- The name.datum
- The datum.cs
- The coordinate system.
-
DefaultEngineeringCRS
public DefaultEngineeringCRS(Map<String,?> properties, EngineeringDatum datum, CoordinateSystem cs)
Constructs an engineering CRS from a set of properties. The properties are given unchanged to the super-class constructor.- Parameters:
properties
- Set of properties. Should contains at least"name"
.datum
- The datum.cs
- The coordinate system.
-
DefaultEngineeringCRS
public DefaultEngineeringCRS(Map<String,?> properties, EngineeringDatum datum, CoordinateSystem cs, boolean wildcard)
Constructs an engineering CRS from a set of properties. The properties are given unchanged to the super-class constructor.- Parameters:
properties
- Set of properties. Should contains at least"name"
.datum
- The datum.cs
- The coordinate system.wildcard
- When true the CRS will transform to any other CRS with the identity transform
-
-
Method Detail
-
getDatum
public EngineeringDatum getDatum()
Returns the datum.- Specified by:
getDatum
in interfaceEngineeringCRS
- Specified by:
getDatum
in interfaceSingleCRS
- Overrides:
getDatum
in classAbstractSingleCRS
- Returns:
- The datum.
-
hashCode
public int hashCode()
Returns a hash value for this derived CRS.- Overrides:
hashCode
in classAbstractSingleCRS
- Returns:
- The hash code value. This value doesn't need to be the same in past or future versions of this class.
-
formatWKT
protected String formatWKT(Formatter formatter)
Format the inner part of a Well Known Text (WKT) element.- Overrides:
formatWKT
in classAbstractCRS
- Parameters:
formatter
- The formatter to use.- Returns:
- The name of the WKT element type, which is
"LOCAL_CS"
. - See Also:
Formattable.toWKT()
,Formattable.toString()
-
equals
public boolean equals(AbstractIdentifiedObject object, boolean compareMetadata)
Compares the specified object to this CRS for equality. This method is overridden because, otherwise,CARTESIAN_xD
andGENERIC_xD
would be considered equals when metadata are ignored.- Overrides:
equals
in classAbstractSingleCRS
- Parameters:
object
- The object to compare tothis
.compareMetadata
-true
for performing a strict comparaison, orfalse
for comparing only properties relevant to transformations.- Returns:
true
if both objects are equal.
-
isWildcard
public boolean isWildcard()
Returns true if this is a wildcard CRS, that is, one that will transform from and to any other CRS using the identity transformation
-
-