Class TimeDependentBWP

Object
FormattableObject
BursaWolfParameters
TimeDependentBWP
All Implemented Interfaces:
Serializable, Cloneable, Printable
public class TimeDependentBWP extends BursaWolfParameters
Parameters for a time-dependent geographic transformation between two datum. The t­X, t­Y, t­Z, r­X, r­Y, r­Z and d­S parameters inherited from the parent class are values at a point in time given by get­Time­Reference(). Those values vary at a rate given by the parameters listed in the table below (codes, names and abbreviations are from the EPSG database):
Parameters defined by EPSG
Code Name Abbr.
1040 Rate of change of X-axis translation dtX
1041 Rate of change of Y-axis translation dtY
1042 Rate of change of Z-axis translation dtZ
1043 Rate of change of X-axis rotation drX
1044 Rate of change of Y-axis rotation drY
1045 Rate of change of Z-axis rotation drZ
1046 Rate of change of scale difference ddS
The numerical fields in this Time­Dependent­BWP class uses the EPSG abbreviations with 4 additional constraints compared to the EPSG definitions:
  • Unit of dd­S is fixed to parts per million per year.
  • Unit of dt­X, dt­Y and dt­Z is fixed to millimetres per year.
  • Unit of dr­X, dr­Y and dr­Z is fixed to milli arc-seconds per year.
  • Sign of rotation terms is fixed to the Position Vector convention (EPSG operation method 1053). This is the opposite sign than the Coordinate Frame Rotation (EPSG operation method 1056. The Position Vector convention is used by IAG and recommended by ISO 19111.
Since:
0.4
See Also:

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    double
    dd­S
    Rate of change of the scale difference in parts per million per year (EPSG:1046).
    double
    dr­X
    Rate of change of X-axis rotation in milli arc-seconds per year (EPSG:1043), sign following the Position Vector convention.
    double
    dr­Y
    Rate of change of Y-axis rotation in milli arc-seconds per year (EPSG:1044), sign following the Position Vector convention.
    double
    dr­Z
    Rate of change of Z-axis rotation in milli arc-seconds per year (EPSG:1045), sign following the Position Vector convention.
    double
    dt­X
    Rate of change of X-axis translation in millimetres per year (EPSG:1040).
    double
    dt­Y
    Rate of change of Y-axis translation in millimetres per year (EPSG:1041).
    double
    dt­Z
    Rate of change of Z-axis translation in millimetres per year (EPSG:1042).

    Fields inherited from class BursaWolfParameters

    d­S, r­X, r­Y, r­Z, t­X, t­Y, t­Z
    Modifier and Type
    Field
    Description
    double
    d­S
    The scale difference in parts per million (EPSG:8611).
    double
    r­X
    X-axis rotation in arc-seconds (EPSG:8608), sign following the Position Vector convention.
    double
    r­Y
    Y-axis rotation in arc-seconds (EPSG:8609), sign following the Position Vector convention.
    double
    r­Z
    Z-axis rotation in arc-seconds (EPSG:8610), sign following the Position Vector convention.
    double
    t­X
    X-axis translation in metres (EPSG:8605).
    double
    t­Y
    Y-axis translation in metres (EPSG:8606).
    double
    t­Z
    Z-axis translation in metres (EPSG:8607).

  • Constructor Summary

    Constructors
    Constructor
    Description
    Time­Dependent­BWP(Geodetic­Datum target­Datum, Extent domain­Of­Validity, Temporal time­Reference)
    Creates a new instance for the given target datum, domain of validity and time reference.

  • Method Summary

    Modifier and Type
    Method
    Description
    Temporal
    get­Time­Reference()
    Returns the reference epoch for time-dependent parameters.
    double[]
    get­Values()
    Returns the parameter values.
    void
    reverse­Rotation()
    Inverts in-place the sign of rotation terms and their derivative.
    void
    set­Values(double... elements)
    Sets the parameters to the given values.

    Methods inherited from class BursaWolfParameters

    clone, format­To, get­Domain­Of­Validity, get­Position­Vector­Transformation, get­Target­Datum, invert, set­Position­Vector­Transformation
    Modifier and Type
    Method
    Description
    Bursa­Wolf­Parameters
    clone()
    Returns a copy of this object.
    protected String
    format­To(Formatter formatter)
    Formats this object as a Well Known Text To­WGS84[…] element.
    Extent
    get­Domain­Of­Validity()
    Returns the region or timeframe in which a coordinate transformation based on those Bursa-Wolf parameters is valid, or null if unspecified.
    Matrix
    get­Position­Vector­Transformation(Temporal time)
    Returns the position vector transformation (geocentric domain) as an affine transform.
    Geodetic­Datum
    get­Target­Datum()
    Returns the target datum for this set of parameters, or null if unknown.
    void
    invert()
    Inverts in-place the transformation by inverting the sign of all numerical parameters.
    void
    set­Position­Vector­Transformation(Matrix matrix, double tolerance)
    Sets all Bursa-Wolf parameters from the given Position Vector transformation matrix.

    Methods inherited from class FormattableObject

    print, to­String, to­String, to­WKT
    Modifier and Type
    Method
    Description
    void
    print()
    Prints a string representation of this object to the standard output stream.
    String
    to­String()
    Returns a Well Known Text (WKT) or an alternative text representation for this object.
    String
    to­String(Convention convention)
    Returns a Well Known Text (WKT) for this object using the specified convention.
    String
    to­WKT()
    Returns a strictly compliant Well Known Text (WKT) using the default convention, symbols and indentation.

    Methods inherited from class Object

    finalize, get­Class, notify, notify­All, wait, wait, wait

  • Field Details

    • dtX

      public double dtX
      Rate of change of X-axis translation in millimetres per year (EPSG:1040).

    • dtY

      public double dtY
      Rate of change of Y-axis translation in millimetres per year (EPSG:1041).

    • dtZ

      public double dtZ
      Rate of change of Z-axis translation in millimetres per year (EPSG:1042).

    • drX

      public double drX
      Rate of change of X-axis rotation in milli arc-seconds per year (EPSG:1043), sign following the Position Vector convention.

    • drY

      public double drY
      Rate of change of Y-axis rotation in milli arc-seconds per year (EPSG:1044), sign following the Position Vector convention.

    • drZ

      public double drZ
      Rate of change of Z-axis rotation in milli arc-seconds per year (EPSG:1045), sign following the Position Vector convention.

    • ddS

      public double ddS
      Rate of change of the scale difference in parts per million per year (EPSG:1046).

  • Constructor Details

    • TimeDependentBWP

      public TimeDependentBWP(GeodeticDatum targetDatum, Extent domainOfValidity, Temporal timeReference)
      Creates a new instance for the given target datum, domain of validity and time reference. All numerical parameters are initialized to 0, which correspond to an identity transform. Callers can assign numerical values to the public fields of interest after construction.
      Parameters:
      target­Datum - the target datum (usually WGS 84) for this set of parameters.
      domain­Of­Validity - area or region in which a coordinate transformation based on those Bursa-Wolf parameters is valid, or null if unspecified.
      time­Reference - the reference epoch for time-dependent parameters.
      Since:
      1.5

  • Method Details

    • getTimeReference

      public Temporal getTimeReference()
      Returns the reference epoch for time-dependent parameters.
      Returns:
      the reference epoch for time-dependent parameters.

    • getValues

      public double[] getValues()
      Returns the parameter values. The first 14 elements are always t­X, t­Y, t­Z, r­X, r­Y, r­Z, d­S, dt­X, dt­Y, dt­Z, dr­X, dr­Y, dr­Z and dd­S in that order.
      Overrides:
      get­Values in class Bursa­Wolf­Parameters
      Returns:
      the parameter values as an array of length 14.
      Since:
      0.6

    • setValues

      public void setValues(double... elements)
      Sets the parameters to the given values. The given array can have any length. The first array elements will be assigned to the t­X, t­Y, t­Z, r­X, r­Y, r­Z, d­S, dt­X, dt­Y, dt­Z, dr­X, dr­Y, dr­Z and dd­S fields in that order.
      Overrides:
      set­Values in class Bursa­Wolf­Parameters
      Parameters:
      elements - the new parameter values, as an array of any length.
      Since:
      0.6

    • reverseRotation

      public void reverseRotation()
      Inverts in-place the sign of rotation terms and their derivative. This method can be invoked for converting a Coordinate Frame Rotation transformation (EPSG operation method 9607) to a Position Vector transformation (EPSG operation method 9606). The latter convention is used by IAG and recommended by ISO 19111.
      Overrides:
      reverse­Rotation in class Bursa­Wolf­Parameters