Package org.geotools.referencing.crs
Class DefaultEngineeringCRS
Object
Formattable
AbstractIdentifiedObject
AbstractReferenceSystem
AbstractCRS
AbstractSingleCRS
DefaultEngineeringCRS
- All Implemented Interfaces:
Serializable
,CoordinateReferenceSystem
,EngineeringCRS
,SingleCRS
,IdentifiedObject
,ReferenceSystem
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:
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final DefaultEngineeringCRS
static final DefaultEngineeringCRS
static final DefaultEngineeringCRS
static final DefaultEngineeringCRS
protected boolean
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
ConstructorsConstructorDescriptionDefaultEngineeringCRS
(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.Constructs a new enginnering CRS with the same values than the specified one. -
Method Summary
Modifier and TypeMethodDescriptionint
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
Format the inner part of a Well Known Text (WKT) element.getDatum()
Returns the datum.boolean
Returns true if this is a wildcard CRS, that is, one that will transform from and to any other CRS using the identity transformationMethods 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 Details
-
wildcard
protected boolean wildcardMarks the CRS as a wildcard one. Wildcard CRS will transform to any other CRS with the identity transform -
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
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
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
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 Details
-
DefaultEngineeringCRS
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
Constructs an engineering CRS from a name.- Parameters:
name
- The name.datum
- The datum.cs
- The coordinate system.
-
DefaultEngineeringCRS
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 Details
-
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
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:
-
equals
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
-