Package org.apache.sis.internal.referencing.provider

Class GeographicToGeocentric

java.lang.Object

org.apache.sis.io.wkt.FormattableObject

org.apache.sis.referencing.AbstractIdentifiedObject

org.apache.sis.referencing.operation.DefaultOperationMethod

org.apache.sis.internal.referencing.provider.AbstractProvider

org.apache.sis.internal.referencing.provider.GeographicToGeocentric

All Implemented Interfaces:

Serializable, Formattable, MathTransformProvider, Deprecable, LenientComparable, org.opengis.referencing.IdentifiedObject, org.opengis.referencing.operation.OperationMethod

public final class GeographicToGeocentric
extends AbstractProvider

The provider for "Geographic/geocentric conversions" (EPSG:9602). This provider creates transforms from geographic to geocentric coordinate reference systems.

Since:

0.7

Version:

1.3

Author:

Martin Desruisseaux (IRD, Geomatys)

See Also:

• GeocentricToGeographic
• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static final org.opengis.parameter.ParameterDescriptor<Integer>	DIMENSION	An Apache SIS specific parameter for the number of dimensions (2 or 3).
static final String	NAME	The OGC name used for this operation method.
static final org.opengis.parameter.ParameterDescriptorGroup	PARAMETERS	The group of all parameters expected by this coordinate operation.

Fields inherited from class org.apache.sis.internal.referencing.provider.AbstractProvider

sourceCSType, sourceOnEllipsoid, targetCSType, targetOnEllipsoid

Fields inherited from class org.apache.sis.referencing.AbstractIdentifiedObject

DEPRECATED_KEY, LOCALE_KEY

Fields inherited from interface org.opengis.referencing.IdentifiedObject

ALIAS_KEY, IDENTIFIERS_KEY, NAME_KEY, REMARKS_KEY

Fields inherited from interface org.opengis.referencing.operation.OperationMethod

FORMULA_KEY

Constructor Summary

Constructors

Constructor	Description
GeographicToGeocentric()	Constructs a provider for the 3-dimensional case.

Method Summary

Modifier and Type	Method	Description
org.opengis.referencing.operation.MathTransform	createMathTransform(org.opengis.referencing.operation.MathTransformFactory factory, org.opengis.parameter.ParameterValueGroup values)	Creates a transform from the specified group of parameter values.
AbstractProvider	inverse()	Specifies that the inverse of this operation is a different kind of operation.
final org.opengis.referencing.operation.OperationMethod	redimension(int sourceDimensions, int targetDimensions)	Deprecated. ISO 19111:2019 removed source/target dimensions attributes.
String	resolveAmbiguity(DefaultMathTransformFactory.Context context)	If the user asked for the "Geographic/geocentric conversions" operation but the parameter types suggest that (s)he intended to convert in the opposite direction, return the name of operation method to use.

Methods inherited from class org.apache.sis.internal.referencing.provider.AbstractProvider

getOperationType

Methods inherited from class org.apache.sis.referencing.operation.DefaultOperationMethod

castOrCopy, computeHashCode, equals, formatTo, getFormula, getInterface, getParameters, getSourceDimensions, getTargetDimensions, redimension

Methods inherited from class org.apache.sis.referencing.AbstractIdentifiedObject

castOrCopy, equals, formatTo, getAlias, getDescription, getIdentifiers, getName, getRemarks, hashCode, isDeprecated, isHeuristicMatchForName

Methods inherited from class org.apache.sis.io.wkt.FormattableObject

print, toString, toString, toWKT

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.opengis.referencing.IdentifiedObject

getAlias, getIdentifiers, getName, getRemarks, toWKT

Field Details

NAME

public static final String NAME

The OGC name used for this operation method. The OGC name is preferred to the EPSG name in Apache SIS implementation because it allows to distinguish between the forward and the inverse conversion.

See Also:

• Constant Field Values

DIMENSION

public static final org.opengis.parameter.ParameterDescriptor<Integer> DIMENSION

An Apache SIS specific parameter for the number of dimensions (2 or 3). This parameter is practically the same than GeocentricAffineBetweenGeographic.DIMENSION except:

• The code space is "SIS" instead of "OGC" since this parameter is not defined in OGC 01-009.
• The default number of dimensions is 3 instead of unspecified.

See Also:

• Parameter names

  SIS:

  dim

  Notes:
  • Value domain: [2…3]
  • Default value: 3
  • Optional

PARAMETERS

public static final org.opengis.parameter.ParameterDescriptorGroup PARAMETERS

The group of all parameters expected by this coordinate operation.

Constructor Details

GeographicToGeocentric

public GeographicToGeocentric()

Constructs a provider for the 3-dimensional case.

Method Details

resolveAmbiguity

public String resolveAmbiguity(DefaultMathTransformFactory.Context context)

If the user asked for the "Geographic/geocentric conversions" operation but the parameter types suggest that (s)he intended to convert in the opposite direction, return the name of operation method to use. We need this check because EPSG defines a single operation method for both "Ellipsoid_To_Geocentric" and "Geocentric_To_Ellipsoid" methods.

Note: we do not define similar method in GeocentricToGeographic class because the only way to obtain that operation method is to ask explicitly for "Geocentric_To_Ellipsoid" operation. The ambiguity that we try to resolve here exists only if the user asked for the EPSG:9602 operation, which is defined only in this class.

Overrides:

resolveAmbiguity in class AbstractProvider

Parameters:

context - the potentially ambiguous context.

Returns:

"Geocentric_To_Ellipsoid" if the user apparently wanted to get the inverse of this "Ellipsoid_To_Geocentric" operation, or null if none.

inverse

public AbstractProvider inverse()

Specifies that the inverse of this operation is a different kind of operation.

Returns:

null.

See Also:

• SignReversalComment

createMathTransform

public org.opengis.referencing.operation.MathTransform createMathTransform(org.opengis.referencing.operation.MathTransformFactory factory,
 org.opengis.parameter.ParameterValueGroup values)
                                                                    throws org.opengis.util.FactoryException

Creates a transform from the specified group of parameter values.

Parameters:

factory - the factory to use for creating the transform.

values - the parameter values that define the transform to create.

Returns:

the conversion from geographic to geocentric coordinates.

Throws:

org.opengis.util.FactoryException - if an error occurred while creating a transform.

redimension

@Deprecated
public final org.opengis.referencing.operation.OperationMethod redimension(int sourceDimensions,
 int targetDimensions)

Deprecated.

ISO 19111:2019 removed source/target dimensions attributes.

Returns the elements of the given array at an index computed from the given dimensions.

Overrides:

redimension in class DefaultOperationMethod

Parameters:

sourceDimensions - the desired number of input dimensions.

targetDimensions - the desired number of output dimensions.

Returns:

the redimensioned operation method, or null if none.