Enum Class DefiningConversion.SideProcessing

Object
Enum<DefiningConversion.SideProcessing>
SideProcessing
All Implemented Interfaces:
Serializable, Comparable<Defining­Conversion​.Side­Processing>, Constable
Enclosing class:
Defining­Conversion
public static enum DefiningConversion.SideProcessing extends Enum<DefiningConversion.SideProcessing>
The preprocessing and post-processing steps to apply before and after a defining conversion. Some Defining­Conversion implementations require a preprocessing step for expressing input coordinates in a conventional axis order and in predefined units of measurement, and a post-processing step for converting the output to the target CRS. This enumeration specifies which preprocessing and post-processing, if any, are required.
Since:
1.7

  • Enum Constant Details

    • NONE

      public static final DefiningConversion.SideProcessing NONE
      The defining conversion works on coordinates supplied as-is, with no side-processing. The most typical example is Affine Transform, which works on coordinates in any axis order and units of measurement. If, for example, a unit conversion is desired, that conversion should be bundled in the coefficients of the affine transform.

    • NORMALIZED

      public static final DefiningConversion.SideProcessing NORMALIZED
      The defining conversion is defined between a pair of normalized CRSs. The normalization is described in the Axes­Convention​.NORMALIZED documentation: right-handed source and target coordinate systems with predetermined units of measurement. Such defining conversions need to be completed with unit conversions and axis order changes. These preprocessing and post-processing steps can be added by invoking the Defining­Conversion​.specialize(…) method.

      They are the default side-processing expected by Apache SIS. For example, map projections are implemented by Math­Transform steps expecting (longitude, latitude) coordinates in degrees and returning (easting, northing) coordinates in metres. If the source CRS is EPSG:4326, the change of axis order must be applied before to execute the map projection.

  • Method Details

    • values

      public static DefiningConversion.SideProcessing[] values()
      Returns an array containing the constants of this enum class, in the order they are declared.
      Returns:
      an array containing the constants of this enum class, in the order they are declared

    • valueOf

      public static DefiningConversion.SideProcessing valueOf(String name)
      Returns the enum constant of this class with the specified name. The string must match exactly an identifier used to declare an enum constant in this class. (Extraneous whitespace characters are not permitted.)
      Parameters:
      name - the name of the enum constant to be returned.
      Returns:
      the enum constant with the specified name
      Throws:
      Illegal­Argument­Exception - if this enum class has no constant with the specified name
      Null­Pointer­Exception - if the argument is null