Package 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 Details

    • 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 whether this transformation is an identity transformation, i.e.

      if the output to the transform methods is exactly the same as the input.

      Returns:
      whether this transformation is an identity transformation.

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