Package org.geotools.referencing.datum
Class BursaWolfParameters
Object
Formattable
BursaWolfParameters
- All Implemented Interfaces:
Serializable
,Cloneable
,Cloneable
Parameters for a geographic transformation between two datum. The Bursa Wolf parameters should be applied to
geocentric coordinates, where the X axis points towards the Greenwich Prime Meridian, the Y
axis points East, and the Z axis points North. The "Bursa-Wolf" formula is expressed in matrix form with 7
parameters:
- Since:
- 2.1
- Author:
- Martin Desruisseaux (IRD)
- See Also:
-
Field Summary
FieldsModifier and TypeFieldDescriptiondouble
Bursa Wolf shift in meters.double
Bursa Wolf shift in meters.double
Bursa Wolf shift in meters.double
Bursa Wolf rotation in arc seconds.double
Bursa Wolf rotation in arc seconds.double
Bursa Wolf rotation in arc seconds.double
Bursa Wolf scaling in parts per million.final GeodeticDatum
The target datum for this parameters.Fields inherited from class Formattable
SINGLE_LINE
-
Constructor Summary
ConstructorsConstructorDescriptionBursaWolfParameters
(GeodeticDatum target) Constructs a transformation info with all parameters set to 0. -
Method Summary
Modifier and TypeMethodDescriptionclone()
Returns a copy of this object.boolean
Compares the specified object with this object for equality.protected String
Format the inner part of a Well Known Text (WKT) element.Returns an affine transform that can be used to define this Bursa Wolf transformation.int
hashCode()
Returns a hash value for this object.boolean
Returnstrue
if this Bursa Wolf parameters performs no operation.boolean
Returnstrue
if this Bursa Wolf parameters contains only translation terms.void
setAffineTransform
(Matrix matrix, double eps) Sets transformation info from the specified matrix, which must be affine.Methods inherited from class Formattable
cleanupThreadLocals, toString, toWKT, toWKT, toWKT, toWKT
-
Field Details
-
dx
public double dxBursa Wolf shift in meters. -
dy
public double dyBursa Wolf shift in meters. -
dz
public double dzBursa Wolf shift in meters. -
ex
public double exBursa Wolf rotation in arc seconds. -
ey
public double eyBursa Wolf rotation in arc seconds. -
ez
public double ezBursa Wolf rotation in arc seconds. -
ppm
public double ppmBursa Wolf scaling in parts per million. -
targetDatum
The target datum for this parameters.
-
-
Constructor Details
-
BursaWolfParameters
Constructs a transformation info with all parameters set to 0.- Parameters:
target
- The target datum for this parameters.
-
-
Method Details
-
isIdentity
public boolean isIdentity()Returnstrue
if this Bursa Wolf parameters performs no operation. This is true when all parameters are set to zero.- Returns:
true
if the parameters describe no operation.
-
isTranslation
public boolean isTranslation()Returnstrue
if this Bursa Wolf parameters contains only translation terms.- Returns:
true
if the parameters describe to a translation only.
-
getAffineTransform
Returns an affine transform that can be used to define this Bursa Wolf transformation. The formula is as follows:S = 1 +
ppm
/1000000 [ X ] [ S -ez
*S +ey
*Sdx
] [ X ] [ Y ] = [ +ez
*S S -ex
*Sdy
] [ Y } [ Z ] [ -ey
*S +ex
*S Sdz
] [ Z ] [ 1 ] [ 0 0 0 1 ] [ 1 ]- Returns:
- An affine transform created from the parameters.
-
setAffineTransform
Sets transformation info from the specified matrix, which must be affine. In addition, the matrix minus the last row and last column must be antisymmetric.- Parameters:
matrix
- The matrix to fit as a Bursa-Wolf construct.eps
- The tolerance error for the antisymmetric matrix test. Should be a small number like1E-4
.- Throws:
IllegalArgumentException
- if the specified matrix doesn't meet the conditions.- Since:
- 2.2
-
hashCode
public int hashCode()Returns a hash value for this object. -
clone
Returns a copy of this object. -
equals
Compares the specified object with this object for equality. -
formatWKT
Format the inner part of a Well Known Text (WKT) element. The WKT contains the parameters in translation, rotation, scale order, as inTOWGS84[dx, dy, dz, ex, ey, ez, ppm]
.- Overrides:
formatWKT
in classFormattable
- Parameters:
formatter
- The formatter to use.- Returns:
- The WKT element name.
- See Also:
-