public class AbstractDerivedCRS extends AbstractSingleCRS implements GeneralDerivedCRS
This class is conceptually abstract, even if it is technically possible to
instantiate it. Typical applications should create instances of the most specific subclass with
Default
prefix instead. An exception to this rule may occurs when it is not possible to
identify the exact type.
Modifier and Type | Field and Description |
---|---|
static ThreadLocal<Boolean> |
_COMPARING
A lock for avoiding never-ending recursivity in the
equals method. |
protected CoordinateReferenceSystem |
baseCRS
The base coordinate reference system.
|
static String |
CONVERSION_TYPE_KEY
Key for the
"conversionType" property to be given to the constructor. |
protected Conversion |
conversionFromBase
The conversion from the base CRS to this CRS.
|
datum
coordinateSystem
EMPTY_ALIAS_ARRAY, EMPTY_IDENTIFIER_ARRAY, IDENTIFIER_COMPARATOR, NAME_COMPARATOR, REMARKS_COMPARATOR
SINGLE_LINE
DOMAIN_OF_VALIDITY_KEY, SCOPE_KEY
ALIAS_KEY, IDENTIFIERS_KEY, NAME_KEY, REMARKS_KEY
Modifier | Constructor and Description |
---|---|
protected |
AbstractDerivedCRS(GeneralDerivedCRS crs)
Constructs a new derived CRS with the same values than the specified one.
|
protected |
AbstractDerivedCRS(Map<String,?> properties,
Conversion conversionFromBase,
CoordinateReferenceSystem base,
MathTransform baseToDerived,
CoordinateSystem derivedCS)
Constructs a derived CRS from a defining conversion.
|
protected |
AbstractDerivedCRS(Map<String,?> properties,
CoordinateReferenceSystem base,
MathTransform baseToDerived,
CoordinateSystem derivedCS)
Constructs a derived CRS from a set of properties.
|
Modifier and Type | Method and Description |
---|---|
boolean |
equals(AbstractIdentifiedObject object,
boolean compareMetadata)
Compare this coordinate reference system with the specified object for equality.
|
protected String |
formatWKT(Formatter formatter)
Format the inner part of a Well
Known Text (WKT) element.
|
CoordinateReferenceSystem |
getBaseCRS()
Returns the base coordinate reference system.
|
Conversion |
getConversionFromBase()
Returns the conversion from the base CRS to this CRS.
|
int |
hashCode()
Returns a hash value for this derived CRS.
|
getAxis, getDatum, getDimension
distance, getCoordinateSystem
getDomainOfValidity, getScope, getValidArea
asSet, ensureAngularUnit, ensureLinearUnit, ensureNonNull, ensureNonNull, ensureTimeUnit, equals, equals, equals, equals, getAlias, getIdentifier, getIdentifier, getIdentifiers, getName, getName, getName, getProperties, getProperties, getRemarks, nameMatches, nameMatches, nameMatches
cleanupThreadLocals, toString, toWKT, toWKT, toWKT, toWKT
getCoordinateSystem, getDatum
getDomainOfValidity, getScope
getAlias, getIdentifiers, getName, getRemarks, toWKT
public static final String CONVERSION_TYPE_KEY
"conversionType"
property to be given to the constructor. The value should
be one of PlanarProjection.class
,
CylindricalProjection.class
or
ConicProjection.class
.
This is a Geotools specific property used as a hint for creating a projection of proper type from a defining conversion. In many cases, this hint is not needed since Geotools is often capable to infer it. This hint is used mostly by advanced factories like the EPSG backed one.
DefaultConversion.create(org.opengis.referencing.operation.Conversion, org.opengis.referencing.crs.CoordinateReferenceSystem, org.opengis.referencing.crs.CoordinateReferenceSystem, org.opengis.referencing.operation.MathTransform, java.lang.Class<? extends org.opengis.referencing.operation.Conversion>)
,
Constant Field Valuespublic static final ThreadLocal<Boolean> _COMPARING
equals
method. This field
contains a boolean
flag set to true
when a comparaison is in progress. This
lock is necessary because AbstractDerivedCRS
objects contain a conversionFromBase
field, which contains a AbstractCoordinateOperation.targetCRS
field set to
this AbstractDerivedCRS
object.
DO NOT USE THIS FIELD. It is strictly for internal use by equals(org.geotools.referencing.AbstractIdentifiedObject, boolean)
and
AbstractCoordinateOperation.equals(org.geotools.referencing.AbstractIdentifiedObject, boolean)
methods.
protected final CoordinateReferenceSystem baseCRS
protected final Conversion conversionFromBase
protected AbstractDerivedCRS(GeneralDerivedCRS crs)
crs
- The coordinate reference system to copy.protected AbstractDerivedCRS(Map<String,?> properties, Conversion conversionFromBase, CoordinateReferenceSystem base, MathTransform baseToDerived, CoordinateSystem derivedCS) throws MismatchedDimensionException
properties
- Name and other properties to give to the new derived CRS object.conversionFromBase
- The defining 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
.MismatchedDimensionException
- if the source and target dimension of baseToDerived
don't match the dimension of base
and derivedCS
respectively.protected AbstractDerivedCRS(Map<String,?> properties, CoordinateReferenceSystem base, MathTransform baseToDerived, CoordinateSystem derivedCS) throws MismatchedDimensionException
The properties are given unchanged to the super-class constructor. The following optional properties are also understood:
Property name | Value type | Value given to |
---|---|---|
"conversion.name" |
String |
getConversionFromBase().getName() |
Additional properties for the DefaultConversion
object to be created can be
specified with the "conversion."
prefix added in front of property names
(example: "conversion.remarks"
). The same applies for operation method, using
the "method."
prefix.
properties
- Name and other properties to give to the new derived CRS object and to the
underlying 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
.MismatchedDimensionException
- if the source and target dimension of baseToDerived
don't match the dimension of base
and derivedCS
respectively.public CoordinateReferenceSystem getBaseCRS()
getBaseCRS
in interface GeneralDerivedCRS
public Conversion getConversionFromBase()
getConversionFromBase
in interface GeneralDerivedCRS
public boolean equals(AbstractIdentifiedObject object, boolean compareMetadata)
equals
in class AbstractSingleCRS
object
- The object to compare to this
.compareMetadata
- true
for performing a strict comparaison, or false
for
comparing only properties relevant to transformations.true
if both objects are equal.public int hashCode()
hashCode
in class AbstractSingleCRS
protected String formatWKT(Formatter formatter)
formatWKT
in class AbstractCRS
formatter
- The formatter to use."FITTED_CS"
.Formattable.toWKT()
,
Formattable.toString()
Copyright © 1996–2019 Geotools. All rights reserved.