org.geotoolkit.referencing.operation.provider
Class Affine

Object
  FormattableObject
      AbstractIdentifiedObject
          DefaultOperationMethod
              MathTransformProvider
                  Affine

All Implemented Interfaces:

Serializable, Formattable, Deprecable, LenientComparable, IdentifiedObject, OperationMethod

@Immutable
public class Affine
extends MathTransformProvider

The provider for "Affine general parametric transformation" (EPSG:9624). The set of available parameters depends on the matrix size, which is 3×3 by default.

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

Operation name: Affine

Parameter name	Default value
num_row	3
num_col	3
elt_0_0	1
elt_0_1	0
elt_0_2	0
elt_1_0	0
elt_1_1	1
elt_1_2	0
elt_2_0	0
elt_2_1	0
elt_2_2	1

Since:

2.0

Version:

3.20

Author:

Martin Desruisseaux (IRD, Geomatys)

See Also:

ProjectiveTransform, AffineTransform2D, LinearTransform1D, Geotk coordinate operations matrix, Serialized Form

Module:

referencing/geotk-referencing (download)

View source code for this class

Field Summary

static ParameterDescriptorGroup

PARAMETERS The group of all parameters expected by this coordinate operation.

Fields inherited from class DefaultOperationMethod

sourceDimension, targetDimension

Fields inherited from class FormattableObject

EPSG, GEOTIFF, INTERNAL, OGC, SINGLE_LINE

Fields inherited from interface OperationMethod

FORMULA_KEY

Fields inherited from interface IdentifiedObject

ALIAS_KEY, IDENTIFIERS_KEY, NAME_KEY, REMARKS_KEY

Constructor Summary

Affine()
Creates a provider for affine transform with a default matrix size.

Method Summary

protected MathTransform	createMathTransform(ParameterValueGroup values) Creates a projective transform from the specified group of parameter values.
Class<Conversion>	getOperationType() Returns the operation type.
static Affine	getProvider(int sourceDimension, int targetDimension) Returns the operation method for the specified source and target dimensions.

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

getDefaultIndentation, print, setDefaultIndentation, toString, toWKT, toWKT, 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

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:	Affine
Alias:	EPSG:	Affine parametric transformation
	Geotk:	Affine transform
Identifier:	EPSG:	9624

Name:

OGC:

num_row

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

Name:

OGC:

num_col

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

Name:	OGC:	elt_0_0
Alias:	EPSG:	A1

Type:	Double
Obligation:	mandatory
Value range:	(-∞ … ∞)
Default value:	1

Name:	OGC:	elt_0_1
Alias:	EPSG:	A2

Type:	Double
Obligation:	mandatory
Value range:	(-∞ … ∞)
Default value:	0

Name:	OGC:	elt_0_2
Alias:	EPSG:	A0

Type:	Double
Obligation:	mandatory
Value range:	(-∞ … ∞)
Default value:	0

Name:	OGC:	elt_1_0
Alias:	EPSG:	B1

Type:	Double
Obligation:	mandatory
Value range:	(-∞ … ∞)
Default value:	0

Name:	OGC:	elt_1_1
Alias:	EPSG:	B2

Type:	Double
Obligation:	mandatory
Value range:	(-∞ … ∞)
Default value:	1

Name:	OGC:	elt_1_2
Alias:	EPSG:	B0

Type:	Double
Obligation:	mandatory
Value range:	(-∞ … ∞)
Default value:	0

Name:

OGC:

elt_2_0

Type:	Double
Obligation:	mandatory
Value range:	(-∞ … ∞)
Default value:	0

Name:

OGC:

elt_2_1

Type:	Double
Obligation:	mandatory
Value range:	(-∞ … ∞)
Default value:	0

Name:

OGC:

elt_2_2

Type:	Double
Obligation:	mandatory
Value range:	(-∞ … ∞)
Default value:	1

Constructor Detail

Affine

public Affine()

Creates a provider for affine transform with a default matrix size.

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 projective 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.

getProvider

public static Affine getProvider(int sourceDimension,
                                 int targetDimension)

Returns the operation method for the specified source and target dimensions. This method provides different methods for different matrix sizes.

Parameters:

sourceDimension - The number of source dimensions.

targetDimension - The number of target dimensions.

Returns:

The provider for transforms of the given source and target dimensions.