Module org.opengis.geoapi

Package org.opengis.referencing.operation

Interface MathTransform1D

All Superinterfaces:

MathTransform

public interface MathTransform1D
extends MathTransform

Transforms one-dimensional coordinate points. CoordinateOperation.getMathTransform() may return instance of this interface when source and destination coordinate systems are both one dimensional. MathTransform1D extends MathTransform by adding a simple method transforming a value without the overhead of creating data array.

Since:

1.0

Extension to OGC/ISO standard

This interface is not part of the OGC specification. It has been added as a complement of MathTransform2D and because the 1D case provides opportunities for optimization through a transform method accepting a single double primitive type.

Method Summary

Modifier and Type	Method	Description
double	derivative(double value)	Gets the derivative of this function at a value.
default int	getSourceDimensions()	Returns the number of dimensions of input points, which shall be 1.
default int	getTargetDimensions()	Returns the number of dimensions of output points, which shall be 1.
default MathTransform1D	inverse()	Returns the inverse transform of this object.
double	transform(double value)	Transforms the specified value.

Methods inherited from interface org.opengis.referencing.operation.MathTransform

derivative, isIdentity, toWKT, transform, transform, transform, transform, transform, transform, transform, transform, transform

Method Details

getSourceDimensions

default int getSourceDimensions()

Returns the number of dimensions of input points, which shall be 1.

Specified by:

getSourceDimensions in interface MathTransform

Returns:

always 1.

getTargetDimensions

default int getTargetDimensions()

Returns the number of dimensions of output points, which shall be 1.

Specified by:

getTargetDimensions in interface MathTransform

Returns:

always 1.

transform

double transform(double value)
          throws TransformException

Transforms the specified value.

Parameters:

value - the value to transform.

Returns:

the transformed value.

Throws:

TransformException - if the value cannot be transformed.

derivative

double derivative(double value)
           throws TransformException

Gets the derivative of this function at a value. The derivative is the 1×1 matrix of the non-translating portion of the approximate affine map at the value.

Parameters:

value - the value where to evaluate the derivative.

Returns:

the derivative at the specified point.

Throws:

TransformException - if the derivative cannot be evaluated at the specified point.

inverse

default MathTransform1D inverse()
                         throws NoninvertibleTransformException

Returns the inverse transform of this object.

Specified by:

inverse in interface MathTransform

Returns:

the inverse transform.

Throws:

NoninvertibleTransformException - if the transform cannot be inverted.

See Also:

• AffineTransform.createInverse()