com.luciad.geodesy

Class Transformation

java.lang.Object

com.luciad.geodesy.Transformation

All Implemented Interfaces:

AutoCloseable

public final class Transformation
extends Object
implements AutoCloseable

Provides transformations between a source and a target coordinate reference.

Method Summary

Modifier and Type	Method and Description
void	close()
static Transformation	create(CoordinateReference source, CoordinateReference target) Creates a transformation for the given references.
protected void	finalize()
CoordinateReference	getSourceReference() Returns the source coordinate reference.
CoordinateReference	getTargetReference() Returns the target coordinate reference.
boolean	isIdentity()
Bounds	transform(Bounds bounds) Transforms the bounds from the source reference to the target reference.
Coordinate	transform(Coordinate point) Transforms a point from the source reference to the target reference.
Point	transform(Point point) Transforms a point from the source reference to the target reference.

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

finalize

protected void finalize()

Overrides:

finalize in class Object

close

public void close()

Specified by:

close in interface AutoCloseable

getSourceReference

@NotNull
public CoordinateReference getSourceReference()

Returns the source coordinate reference.

Returns:

the source coordinate reference.

getTargetReference

@NotNull
public CoordinateReference getTargetReference()

Returns the target coordinate reference.

Returns:

the target coordinate reference.

transform

@Nullable
public Coordinate transform(@NotNull
                                      Coordinate point)

Transforms a point from the source reference to the target reference.

Parameters:

point - Point.

Returns:

transformed point in the target reference, null if the point does not exist in the target reference.

transform

@Nullable
public Point transform(@NotNull
                                 Point point)

Transforms a point from the source reference to the target reference.

Parameters:

point - Point.

Returns:

transformed point in the target reference, null if the point does not exist in the target reference, null if the point is not defined in the source reference

transform

@Nullable
public Bounds transform(@NotNull
                                  Bounds bounds)

Transforms the bounds from the source reference to the target reference.

Parameters:

bounds - Bounds.

Returns:

transformed bounds in the target reference, null if the bounds does not exist in the target reference, null if the bounds is not defined in the source reference.

isIdentity

public boolean isIdentity()

Returns:

if this transformation is an identity transformation, i.e. if the output to the transform methods is exactly the same as the input.

create

@NotNull
public static Transformation create(@NotNull
                                             CoordinateReference source,
                                             @NotNull
                                             CoordinateReference target)
                                      throws IllegalArgumentException

Creates a transformation for the given references.

Parameters:

source - Source coordinate reference.

target - Target coordinate reference.

Returns:

transformation for the given references.

Throws:

IllegalArgumentException - when no transformation can be set up.