Enum DatumShiftMethod

java.lang.Object
java.lang.Enum<DatumShiftMethod>
org.apache.sis.internal.referencing.provider.DatumShiftMethod
All Implemented Interfaces:
Serializable, Comparable<DatumShiftMethod>, java.lang.constant.Constable

public enum DatumShiftMethod extends Enum<DatumShiftMethod>
The method to use for applying a datum shift. Values are ordered from most accurate method to less accurate. This enumeration does not include datum shift based on grid files.
Since:
0.8
Version:
0.8
  • Enum Constant Details

    • GEOCENTRIC_DOMAIN

      public static final DatumShiftMethod GEOCENTRIC_DOMAIN
      Transformation in geocentric domain (translation or position vector 7-parameters).
    • MOLODENSKY

      public static final DatumShiftMethod MOLODENSKY
      Approximation of geocentric translations.
    • ABRIDGED_MOLODENSKY

      public static final DatumShiftMethod ABRIDGED_MOLODENSKY
      Approximation of Molodensky transformations, which is itself an approximation of geocentric translations.
    • NONE

      public static final DatumShiftMethod NONE
      No datum shift applied (not even a change of ellipsoid). This method should be used only when a coarse accuracy (at least 3 km) is sufficient.
  • Constructor Details

    • DatumShiftMethod

      private DatumShiftMethod()
  • Method Details

    • values

      public static DatumShiftMethod[] values()
      Returns an array containing the constants of this enum type, in the order they are declared.
      Returns:
      an array containing the constants of this enum type, in the order they are declared
    • valueOf

      public static DatumShiftMethod valueOf(String name)
      Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (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:
      IllegalArgumentException - if this enum type has no constant with the specified name
      NullPointerException - if the argument is null
    • forAccuracy

      public static DatumShiftMethod forAccuracy(double desired)
      Suggests an operation method for the given accuracy. This method contains accuracy threshold (in metres) for allowing the use of Molodensky approximation instead of the Geocentric Translation method. The accuracy of datum shifts with Molodensky approximation is about 5 or 10 metres. However for this method, we are not interested in absolute accuracy but rather in the difference between Molodensky and Geocentric Translation methods, which is much lower (less than 1 m). We nevertheless use a relatively high threshold as a conservative approach.
      Parameters:
      desired - desired accuracy on Earth (metres).
      Returns:
      suggested datum shift method for an accuracy equals or better than the given value.
      See Also: