Package org.apache.sis.referencing.datum
Class TimeDependentBWP
Object
FormattableObject
BursaWolfParameters
TimeDependentBWP
- All Implemented Interfaces:
- Serializable,- Cloneable
Parameters for a time-dependent geographic transformation between two datum.
 The 
   
 The numerical fields in this 
tX, tY, tZ, rX, rY, rZ
 and dS parameters inherited from the parent class are values at a point in time given
 by getTimeReference(). Those values vary at a rate given by the parameters listed in the
 table below (codes, names and abbreviations are from the EPSG database):
 | 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 | 
TimeDependentBWP class uses the EPSG abbreviations
 with 4 additional constraints compared to the EPSG definitions:
 - Unit of ddSis fixed to parts per million per year.
- Unit of dtX,dtYanddtZis fixed to millimetres per year.
- Unit of drX,drYanddrZis 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:
Defined in the sis-referencing module
- 
Field SummaryFieldsModifier and TypeFieldDescriptiondoubleRate of change of the scale difference in parts per million per year (EPSG:1046).doubleRate of change of X-axis rotation in milli arc-seconds per year (EPSG:1043), sign following the Position Vector convention.doubleRate of change of Y-axis rotation in milli arc-seconds per year (EPSG:1044), sign following the Position Vector convention.doubleRate of change of Z-axis rotation in milli arc-seconds per year (EPSG:1045), sign following the Position Vector convention.doubleRate of change of X-axis translation in millimetres per year (EPSG:1040).doubleRate of change of Y-axis translation in millimetres per year (EPSG:1041).doubleRate of change of Z-axis translation in millimetres per year (EPSG:1042).
- 
Constructor SummaryConstructorsConstructorDescriptionTimeDependentBWP(GeodeticDatum targetDatum, Extent domainOfValidity, Date timeReference) Creates a new instance for the given target datum, domain of validity and time reference.
- 
Method SummaryModifier and TypeMethodDescriptionbooleanCompares the specified object with this object for equality.Returns the reference epoch for time-dependent parameters.double[]Returns the parameter values.intReturns a hash value for this object.booleanReturnstrueif a transformation built from this set of parameters would perform no operation.booleanReturnstrueif a transformation built from this set of parameters would perform only a translation.voidInverts in-place the sign of rotation terms and their derivative.voidsetValues(double... elements) Sets the parameters to the given values.Methods inherited from class BursaWolfParametersclone, formatTo, getDomainOfValidity, getPositionVectorTransformation, getTargetDatum, invert, setPositionVectorTransformationMethods inherited from class FormattableObjectprint, toString, toString, toWKT
- 
Field Details- 
dtXpublic double dtXRate of change of X-axis translation in millimetres per year (EPSG:1040).
- 
dtYpublic double dtYRate of change of Y-axis translation in millimetres per year (EPSG:1041).
- 
dtZpublic double dtZRate of change of Z-axis translation in millimetres per year (EPSG:1042).
- 
drXpublic double drXRate of change of X-axis rotation in milli arc-seconds per year (EPSG:1043), sign following the Position Vector convention.
- 
drYpublic double drYRate of change of Y-axis rotation in milli arc-seconds per year (EPSG:1044), sign following the Position Vector convention.
- 
drZpublic double drZRate of change of Z-axis rotation in milli arc-seconds per year (EPSG:1045), sign following the Position Vector convention.
- 
ddSpublic double ddSRate of change of the scale difference in parts per million per year (EPSG:1046).
 
- 
- 
Constructor Details- 
TimeDependentBWPCreates 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:
- targetDatum- the target datum (usually WGS 84) for this set of parameters.
- domainOfValidity- area or region in which a coordinate transformation based on those Bursa-Wolf parameters is valid, or- nullis unspecified.
- timeReference- the reference epoch for time-dependent parameters.
 
 
- 
- 
Method Details- 
getTimeReferenceReturns the reference epoch for time-dependent parameters.- Returns:
- the reference epoch for time-dependent parameters.
 
- 
getValuespublic double[] getValues()Returns the parameter values. The first 14 elements are alwaystX,tY,tZ,rX,rY,rZ,dS,dtX,dtY,dtZ,drX,drY,drZandddSin that order.- Overrides:
- getValuesin class- BursaWolfParameters
- Returns:
- the parameter values as an array of length 14.
- Since:
- 0.6
 
- 
setValuespublic 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 thetX,tY,tZ,rX,rY,rZ,dS,dtX,dtY,dtZ,drX,drY,drZandddSfields in that order.- Overrides:
- setValuesin class- BursaWolfParameters
- Parameters:
- elements- the new parameter values, as an array of any length.
- Since:
- 0.6
 
- 
isIdentitypublic boolean isIdentity()Returnstrueif a transformation built from this set of parameters would perform no operation. This is true when the value of all parameters is zero.- Overrides:
- isIdentityin class- BursaWolfParameters
- Returns:
- trueif the parameters describe no operation.
 
- 
isTranslationpublic boolean isTranslation()Returnstrueif a transformation built from this set of parameters would perform only a translation.- Overrides:
- isTranslationin class- BursaWolfParameters
- Returns:
- trueif the parameters describe a translation only.
 
- 
reverseRotationpublic 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:
- reverseRotationin class- BursaWolfParameters
 
- 
equalsCompares the specified object with this object for equality.- Overrides:
- equalsin class- BursaWolfParameters
- Parameters:
- object- the object to compare with the parameters.
- Returns:
- trueif the given object is equal to this- TimeDependentBWP.
 
- 
hashCodepublic int hashCode()Returns a hash value for this object.- Overrides:
- hashCodein class- BursaWolfParameters
- Returns:
- the hash code value. This value does not need to be the same in past or future versions of this class.
 
 
-