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 int
calculateHashCode()
Returns a hash value for this derived CRS.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.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, hashCode
-
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.
-
calculateHashCode
public int calculateHashCode()
Returns a hash value for this derived CRS.- Overrides:
calculateHashCode
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
-
-