Class ProjectionException

All Implemented Interfaces:
Serializable

public class ProjectionException extends TransformException
Thrown by Normalized­Projection when a map projection failed.

When this exception is thrown

Apache SIS implementations of map projections return a finite number under normal conditions, but may also return an infinite number or NaN value, or throw this exception. The behavior depends on the reason why the projection cannot return a finite number:
  • If the expected mathematical value is infinite (for example the Mercator projection at ±90° of latitude), then the map projection should return a Double​.POSITIVE_INFINITY or Double​.NEGATIVE_INFINITY, depending on the sign of the correct mathematical answer.
  • If no real number is expected to exist for the input coordinates (for example at a latitude greater than 90°), then the map projection should return Double​.Na­N.
  • If a real number is expected to exist but the map projection fails to compute it (for example because an iterative algorithm does not converge), then the projection should throw Projection­Exception.
Since:
0.6
See Also:

Defined in the sis-referencing module

  • Constructor Details

    • ProjectionException

      public ProjectionException()
      Constructs a new exception with no detail message.
    • ProjectionException

      public ProjectionException(String message)
      Constructs a new exception with the specified detail message.
      Parameters:
      message - the details message, or null if none.
    • ProjectionException

      public ProjectionException(Throwable cause)
      Constructs a new exception with the specified cause. The details message is copied from the cause.
      Parameters:
      cause - the cause, or null if none.
    • ProjectionException

      public ProjectionException(String message, Throwable cause)
      Constructs a new exception with the specified detail message and cause.
      Parameters:
      message - the details message, or null if none.
      cause - the cause, or null if none.