Package org.esa.snap.core.dataop.maptransf

Class CartographicMapTransform

java.lang.Object

org.esa.snap.core.dataop.maptransf.CartographicMapTransform

All Implemented Interfaces:

MapTransform

Direct Known Subclasses:

AlbersEqualAreaConicDescriptor.AEAC, LambertConformalConicDescriptor.LCCT, StereographicDescriptor.ST, TransverseMercatorDescriptor.TMT

@Deprecated
public abstract class CartographicMapTransform
extends Object
implements MapTransform

Deprecated.

since BEAM 4.7, use geotools MapProjection instead.

An abstract base class for cartographic map-transformations.

Field Summary

Fields

Modifier and Type	Field	Description
protected double	_a	Deprecated. Semi-major parameter of ellipsoid (map scaling factor) in meter.
protected double	_centralMeridian	Deprecated. The central meridian value in degree.
protected double	_invA	Deprecated. Inverse semi-major parameter.
protected double	_x0	Deprecated. The false easting (map x-offset) in map units.
protected double	_y0	Deprecated. The false northing (map x-offset) in map units.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	CartographicMapTransform(double centralMeridian, double falseEasting, double falseNorthing, double semiMajor)	Deprecated. Constructs a new instance.

Method Summary

Modifier and Type	Method	Description
Point2D	forward(GeoPos geoPoint, Point2D mapPoint)	Deprecated. Forward project geographical co-ordinates into map co-ordinates.
protected abstract Point2D	forward_impl(double lat, double lon, Point2D mapPoint)	Deprecated. Worker method to be overridden by derived class.
double	getCentralMeridian()	Deprecated. Gets the central meridian parameter.
double	getFalseEasting()	Deprecated. Gets the map X-offset (false easting) parameter.
double	getFalseNorthing()	Deprecated. Gets the map Y-offset (false northing) parameter.
double	getInverseSemiMajor()	Deprecated. Gets the map scaling factor parameter.
double	getSemiMajor()	Deprecated. Gets the map scaling factor parameter.
GeoPos	inverse(Point2D mapPoint, GeoPos geoPoint)	Deprecated. Inverse project map co-ordinates into geographical co-ordinates.
protected abstract GeoPos	inverse_impl(double x, double y, GeoPos geoPoint)	Deprecated. Worker method to be overridden by derived class.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.esa.snap.core.dataop.maptransf.MapTransform

createDeepClone, getDescriptor, getParameterValues

Field Detail

_centralMeridian

protected final double _centralMeridian

Deprecated.

The central meridian value in degree.

_a

protected final double _a

Deprecated.

Semi-major parameter of ellipsoid (map scaling factor) in meter.

_invA

protected final double _invA

Deprecated.

Inverse semi-major parameter.

_x0

protected final double _x0

Deprecated.

The false easting (map x-offset) in map units.

_y0

protected final double _y0

Deprecated.

The false northing (map x-offset) in map units.

Constructor Detail

CartographicMapTransform

protected CartographicMapTransform(double centralMeridian,
                                   double falseEasting,
                                   double falseNorthing,
                                   double semiMajor)

Deprecated.

Constructs a new instance.

Parameters:

centralMeridian - central meridian in degree

falseEasting - false easting (map x-offset) in map units

falseNorthing - false northing (map y-offset) in map units

semiMajor - semi-major parameter of ellipsoid (map scaling factor) in map units

Method Detail

getCentralMeridian

public double getCentralMeridian()

Deprecated.

Gets the central meridian parameter.

Returns:

the central meridian

getSemiMajor

public double getSemiMajor()

Deprecated.

Gets the map scaling factor parameter.

Returns:

the map scaling factor

getInverseSemiMajor

public double getInverseSemiMajor()

Deprecated.

Gets the map scaling factor parameter.

Returns:

the map scaling factor

getFalseEasting

public double getFalseEasting()

Deprecated.

Gets the map X-offset (false easting) parameter.

Returns:

the map X-offset

getFalseNorthing

public double getFalseNorthing()

Deprecated.

Gets the map Y-offset (false northing) parameter.

Returns:

the map Y-offset

forward

public Point2D forward(GeoPos geoPoint,
                       Point2D mapPoint)

Deprecated.

Forward project geographical co-ordinates into map co-ordinates.

Specified by:

forward in interface MapTransform

Parameters:

geoPoint - the source position in lat/lon

mapPoint - the target map position in x/y (,ight be null, then a new object is created

inverse

public GeoPos inverse(Point2D mapPoint,
                      GeoPos geoPoint)

Deprecated.

Inverse project map co-ordinates into geographical co-ordinates.

Specified by:

inverse in interface MapTransform

Parameters:

mapPoint - the source location in x/y map coordinates

geoPoint - the target position in lat/lon (might be null, then a new object is created)

forward_impl

protected abstract Point2D forward_impl(double lat,
                                        double lon,
                                        Point2D mapPoint)

Deprecated.

Worker method to be overridden by derived class. Performs the pure transformation. Prescaling, northing, easting etc is calculated in this class.

Parameters:

lat - latitude of source location

lon - longitude of source location

mapPoint - point on the map

Returns:

the map coordinate

inverse_impl

protected abstract GeoPos inverse_impl(double x,
                                       double y,
                                       GeoPos geoPoint)

Deprecated.

Worker method to be overridden by derived class. Performs the pure transformation. Prescaling, northing, easting etc is calculated in this class.

Should be overridden in order to perform transformation in 64-bit accuracy.

The default implementation simple returns inverse_impl((float)x, (float)y, geoPoint).

Parameters:

geoPoint - point on the earth's surface

x - map x coordinate

y - map y coordinate

Returns:

the geodetic co-ordinate