org.esa.beam.framework.dataop.maptransf
Class CartographicMapTransform

java.lang.Object
  org.esa.beam.framework.dataop.maptransf.CartographicMapTransform

All Implemented Interfaces:

MapTransform

Direct Known Subclasses:

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

Deprecated. since BEAM 4.7, use geotools MapProjection instead.

@Deprecated
public abstract class CartographicMapTransform
extends Object
implements MapTransform

An abstract base class for cartographic map-transformations.

Field Summary

protected double	_a Deprecated. Semi-major parameter of ellipsoid (map scaling factor) in meter.
protected float	_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

protected

CartographicMapTransform(double centralMeridian, double falseEasting, double falseNorthing, double semiMajor) Deprecated. Constructs a new instance.

Method Summary

protected abstract Point2D	forward_impl(float lat, float lon, Point2D mapPoint) Deprecated. Worker method to be overridden by derived class.
Point2D	forward(GeoPos geoPoint, Point2D mapPoint) Deprecated. Forward project geographical co-ordinates into map co-ordinates.
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.
protected GeoPos	inverse_impl(double x, double y, GeoPos geoPoint) Deprecated. Worker method to be overridden by derived class.
protected abstract GeoPos	inverse_impl(float x, float y, GeoPos geoPoint) Deprecated. Worker method to be overridden by derived class.
GeoPos	inverse(Point2D mapPoint, GeoPos geoPoint) Deprecated. Inverse project map co-ordinates into geographical co-ordinates.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.esa.beam.framework.dataop.maptransf.MapTransform

createDeepClone, getDescriptor, getParameterValues

Field Detail

_centralMeridian

protected final float _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(float lat,
                                        float 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(float x,
                                       float 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 delegate to inverse_impl(double, double, org.esa.beam.framework.datamodel.GeoPos) if transformation is performed is in 64-bit accuracy. Override inverse_impl(double, double, org.esa.beam.framework.datamodel.GeoPos) instead in order to perform the actual transformation.

Parameters:

geoPoint - point on the earth's surface

x - map x coordinate

y - map y coordinate

Returns:

the geodetic co-ordinate

inverse_impl

protected 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