org.apache.sis.referencing.operation.projection

Class ProjectionException

Object

Throwable

Exception

TransformException

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 can not 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 coordinate (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:

Serialized Form

Defined in the sis-referencing module

Constructor Summary

Constructors

Constructor and Description
ProjectionException() Constructs a new exception with no detail message.
ProjectionException(String message) Constructs a new exception with the specified detail message.
ProjectionException(String message, Throwable cause) Constructs a new exception with the specified detail message and cause.
ProjectionException(Throwable cause) Constructs a new exception with the specified cause.

Method Summary

Methods inherited from class TransformException

get­Last­Completed­Transform, set­Last­Completed­Transform

Methods inherited from class Throwable

add­Suppressed, fill­In­Stack­Trace, get­Cause, get­Localized­Message, get­Message, get­Stack­Trace, get­Suppressed, init­Cause, print­Stack­Trace, print­Stack­Trace, print­Stack­Trace, set­Stack­Trace, to­String

Methods inherited from class Object

clone, equals, finalize, get­Class, hash­Code, notify, notify­All, wait, wait, wait

Constructor Detail

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.