org.geotoolkit.referencing.operation.provider
Class EllipsoidToGeocentric

Object
  FormattableObject
      AbstractIdentifiedObject
          DefaultOperationMethod
              MathTransformProvider
                  EllipsoidToGeocentric

All Implemented Interfaces:

Serializable, Deprecable, LenientComparable, Formattable, IdentifiedObject, OperationMethod

@Immutable
public class EllipsoidToGeocentric
extends MathTransformProvider

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

By default, this provider creates a transform from a three-dimensional ellipsoidal coordinate system, which is the behavior implied in OGC's WKT. However a Geotk-specific "dim" parameter allows to transform from a two-dimensional ellipsoidal coordinate system instead.

WARNING: The EPSG code is the same than the GeocentricToEllipsoid one. To avoid ambiguity, use the OGC name instead: "Ellipsoid_To_Geocentric".

The following table summarizes the parameters recognized by this provider. For a more detailed parameter list, see the PARAMETERS constant.

Operation name: Ellipsoid_To_Geocentric

Parameter name	Default value
semi_major
semi_minor
dim	3

Since:

2.0

Version:

3.20

Author:

Martin Desruisseaux (IRD, Geomatys)

See Also:

GeocentricTransform, Geotk coordinate operations matrix, Serialized Form

Module:

referencing/geotk-referencing (download)

View source code for this class

Field Summary

static ParameterDescriptor<Integer>	DIM Deprecated. Invoke PARAMETERS.descriptor(String) instead.
static ParameterDescriptorGroup	PARAMETERS The group of all parameters expected by this coordinate operation.
static ParameterDescriptor<Double>	SEMI_MAJOR Deprecated. Invoke PARAMETERS.descriptor(String) instead.
static ParameterDescriptor<Double>	SEMI_MINOR Deprecated. Invoke PARAMETERS.descriptor(String) instead.

Fields inherited from class DefaultOperationMethod

sourceDimension, targetDimension

Fields inherited from interface OperationMethod

FORMULA_KEY

Fields inherited from interface IdentifiedObject

ALIAS_KEY, IDENTIFIERS_KEY, NAME_KEY, REMARKS_KEY

Constructor Summary

EllipsoidToGeocentric()
Constructs a provider with default parameters.

Method Summary

protected MathTransform	createMathTransform(ParameterValueGroup values) Creates a transform from the specified group of parameter values.
Class<Conversion>	getOperationType() Returns the operation type.

Methods inherited from class MathTransformProvider

ensureValidValues, formatWKT

Methods inherited from class DefaultOperationMethod

checkDimensions, computeHashCode, equals, getFormula, getParameters, getSourceDimensions, getTargetDimensions

Methods inherited from class AbstractIdentifiedObject

equals, getAlias, getIdentifier, getIdentifiers, getName, getName, getRemarks, hashCode, isDeprecated, nameMatches

Methods inherited from class FormattableObject

print, toString, toWKT, toWKT

Methods inherited from class Object

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

Methods inherited from interface IdentifiedObject

getAlias, getIdentifiers, getName, getRemarks, toWKT

Field Detail

SEMI_MAJOR

@Deprecated
public static final ParameterDescriptor<Double> SEMI_MAJOR

Deprecated. Invoke PARAMETERS.descriptor(String) instead.

The operation parameter descriptor for the "semi_major" parameter value. Valid values range from 0 to infinity. This parameter is mandatory and has no default value.

SEMI_MINOR

@Deprecated
public static final ParameterDescriptor<Double> SEMI_MINOR

Deprecated. Invoke PARAMETERS.descriptor(String) instead.

The operation parameter descriptor for the "semi_minor" parameter value. Valid values range from 0 to infinity. This parameter is mandatory and has no default value.

DIM

@Deprecated
public static final ParameterDescriptor<Integer> DIM

Deprecated. Invoke PARAMETERS.descriptor(String) instead.

The operation parameter descriptor for the number of geographic dimension (2 or 3). This is a Geotk-specific argument. The default value is 3, which is the value implied in OGC's WKT.

PARAMETERS

public static final ParameterDescriptorGroup PARAMETERS

The group of all parameters expected by this coordinate operation. The following table lists the operation names and the parameters recognized by Geotk:

Name:	OGC:	Ellipsoid_To_Geocentric
Alias:	EPSG:	Geographic/geocentric conversions
	Geotk:	Geocentric transform
Identifier:	EPSG:	9602

Name:	OGC:	semi_major
Alias:	EPSG:	Semi-major axis

Type:	Double
Obligation:	mandatory
Value range:	[0…∞) metres

Name:	OGC:	semi_minor
Alias:	EPSG:	Semi-minor axis

Type:	Double
Obligation:	mandatory
Value range:	[0…∞) metres

Name:

Geotk:

dim

Type:	Integer
Obligation:	optional
Value range:	[2…3]
Default value:	3

Constructor Detail

EllipsoidToGeocentric

public EllipsoidToGeocentric()

Constructs a provider with default parameters.

Method Detail

getOperationType

public Class<Conversion> getOperationType()

Returns the operation type.

Overrides:

getOperationType in class MathTransformProvider

Returns:

The GeoAPI interface implemented by this operation.

createMathTransform

protected MathTransform createMathTransform(ParameterValueGroup values)
                                     throws ParameterNotFoundException

Creates a transform from the specified group of parameter values.

Specified by:

createMathTransform in class MathTransformProvider

Parameters:

values - The group of parameter values.

Returns:

The created math transform.

Throws:

ParameterNotFoundException - if a required parameter was not found.