ilog.views.maps.srs.coordtrans

Class IlvAbridgedMolodenskyTransform

java.lang.Object

ilog.views.maps.srs.coordtrans.IlvAbridgedMolodenskyTransform

All Implemented Interfaces:

IlvPersistentObject, IlvMathTransform, Serializable

public class IlvAbridgedMolodenskyTransform
extends Object
implements IlvMathTransform, IlvPersistentObject

The Abridged Molodensky transformation transforms from and to datums using the horizontal shift datums.
The Abridged Molodensky only uses the 3 translation parameters of a datum transformation.

Since:

JViews 5.0

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
IlvAbridgedMolodenskyTransform(IlvGeographicCoordinateSystem gcs) Returns an abridged Molodensky transformation to transform geographic coordinates from the specified geographic coordinate system to the kernel geographic coordinate system.
IlvAbridgedMolodenskyTransform(IlvInputStream stream) Reads a GeocentricEllipsoidal from the specified input stream.

Method Summary

Modifier and Type	Method and Description
IlvMathTransform	getInverse() Returns the inverse transformation.
int	getSourceDimension() Returns the dimension of source coordinates.
int	getTargetDimension() Returns the dimension of target coordinates.
static boolean	isApplyToSphere() Indicates if the Abridged Molodensky transform should be applied to sphere.
boolean	isIdentity() Returns true if the transformation is an identity.
static void	setApplyToSphere(boolean applyToSphere) This method indicates if the transformation formulas should be applied for sphere datums.
IlvCoordinate[]	transform(IlvCoordinate[] sourceCP, IlvCoordinate[] result) Transforms the specified array of coordinate points, and puts the resulting coordinates in result.
IlvCoordinate	transform(IlvCoordinate sourceCP, IlvCoordinate result) Transforms the specified point sourceCP, stores the result in result and returns it.
void	write(IlvOutputStream stream) Writes this transformation to the specified output file.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

IlvAbridgedMolodenskyTransform

public IlvAbridgedMolodenskyTransform(IlvGeographicCoordinateSystem gcs)

Returns an abridged Molodensky transformation to transform geographic coordinates from the specified geographic coordinate system to the kernel geographic coordinate system.

IlvAbridgedMolodenskyTransform

public IlvAbridgedMolodenskyTransform(IlvInputStream stream)
                               throws IlvReadFileException

Reads a GeocentricEllipsoidal from the specified input stream.

Parameters:

stream - The IlvInputStream.

Throws:

IlvReadFileException - If a transformation cannot be read from the input stream.

Method Detail

write

public void write(IlvOutputStream stream)
           throws IOException

Writes this transformation to the specified output file.

Specified by:

write in interface IlvPersistentObject

Parameters:

stream - The IlvOutputStream.

Throws:

IOException - If an error occurs.

getSourceDimension

public int getSourceDimension()

Returns the dimension of source coordinates.

Specified by:

getSourceDimension in interface IlvMathTransform

getTargetDimension

public int getTargetDimension()

Returns the dimension of target coordinates.

Specified by:

getTargetDimension in interface IlvMathTransform

isIdentity

public boolean isIdentity()

Returns true if the transformation is an identity.

Specified by:

isIdentity in interface IlvMathTransform

getInverse

public IlvMathTransform getInverse()

Returns the inverse transformation.

Specified by:

getInverse in interface IlvMathTransform

transform

public IlvCoordinate transform(IlvCoordinate sourceCP,
                               IlvCoordinate result)
                        throws IlvCoordinateTransformationException

Transforms the specified point sourceCP, stores the result in result and returns it. If result is null, a new IlvCoordinate is allocated.

Specified by:

transform in interface IlvMathTransform

Throws:

IlvCoordinateTransformationException

transform

public IlvCoordinate[] transform(IlvCoordinate[] sourceCP,
                                 IlvCoordinate[] result)
                          throws IlvCoordinateTransformationException

Transforms the specified array of coordinate points, and puts the resulting coordinates in result. If result is null, a new array of coordinate is allocated.

Specified by:

transform in interface IlvMathTransform

Throws:

IlvCoordinateTransformationException

isApplyToSphere

public static boolean isApplyToSphere()

Indicates if the Abridged Molodensky transform should be applied to sphere.

Returns:

the applyToSphere

Since:

JViews 8.5

setApplyToSphere

public static void setApplyToSphere(boolean applyToSphere)

This method indicates if the transformation formulas should be applied for sphere datums. The Abridged Molodensky formulas are not valid when the datum is a sphere.
Before JViews 8.1, they were applied to sperical datum, witch could lead to badly placed elements on the map.
Since JViews 8.1, we do not apply the formulas anymore by default.
For compatibility reasons, it may be necessary to call this method, when reading maps that have been built and transformed with a previous version of JViews.

Parameters:

applyToSphere - Whether we should apply the formulas to sphere datum.

Since:

JViews 8.5