org.esa.beam.framework.datamodel
Class MapGeoCoding

java.lang.Object
  org.esa.beam.framework.datamodel.AbstractGeoCoding
      org.esa.beam.framework.datamodel.MapGeoCoding

All Implemented Interfaces:

GeoCoding

Deprecated. since BEAM 4.8, use CrsGeoCoding instead.

public class MapGeoCoding
extends AbstractGeoCoding

A geo-coding based on a cartographic map.

Version:

$Revision$ $Date$

Author:

Norman Fomferra

Constructor Summary

MapGeoCoding(MapInfo mapInfo)
Deprecated. Constructs a map geo-coding based on the given map information.

Method Summary

boolean	canGetGeoPos() Deprecated. Checks whether this geo-coding can determine the geodetic position from a pixel position.
boolean	canGetPixelPos() Deprecated. Checks whether this geo-coding can determine the pixel position from a geodetic position.
MapGeoCoding	createDeepClone() Deprecated.
void	dispose() Deprecated. Releases all of the resources used by this geo-coding and all of its owned children.
Datum	getDatum() Deprecated. Gets the datum, the reference point or surface against which GeoPos measurements are made.
GeoPos	getGeoPos(PixelPos pixelPos, GeoPos geoPos) Deprecated. Returns the latitude and longitude value for a given pixel co-ordinate.
org.opengis.referencing.operation.MathTransform	getImageToMapTransform() Deprecated.
MapInfo	getMapInfo() Deprecated. Returns the map information on which this geo-coding is based.
PixelPos	getPixelPos(GeoPos geoPos, PixelPos pixelPos) Deprecated. Returns the pixel co-ordinates as x/y for a given geographical position given as lat/lon.
boolean	isCrossingMeridianAt180() Deprecated. Checks whether or not the longitudes of this geo-coding cross the +/- 180 degree meridian.
boolean	transferGeoCoding(Scene srcScene, Scene destScene, ProductSubsetDef subsetDef) Deprecated. Transfers the geo-coding of the srcScene to the destScene with respect to the given subsetDef.

Methods inherited from class org.esa.beam.framework.datamodel.AbstractGeoCoding

createImageCRS, getGeoCRS, getImageCRS, getMapCRS, setGeoCRS, setImageCRS, setMapCRS

Methods inherited from class java.lang.Object

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

Constructor Detail

MapGeoCoding

public MapGeoCoding(MapInfo mapInfo)

Deprecated.

Constructs a map geo-coding based on the given map information.

Parameters:

mapInfo - the map infomation

Throws:

IllegalArgumentException - if the given mapInfo is null.

Method Detail

getMapInfo

public MapInfo getMapInfo()

Deprecated.

Returns the map information on which this geo-coding is based.

Returns:

the map information

isCrossingMeridianAt180

public boolean isCrossingMeridianAt180()

Deprecated.

Checks whether or not the longitudes of this geo-coding cross the +/- 180 degree meridian. NOTE: This method is not implemented in this class.

Returns:

always false

canGetGeoPos

public boolean canGetGeoPos()

Deprecated.

Checks whether this geo-coding can determine the geodetic position from a pixel position.

Returns:

true, if so

canGetPixelPos

public boolean canGetPixelPos()

Deprecated.

Checks whether this geo-coding can determine the pixel position from a geodetic position.

Returns:

true, if so

getPixelPos

public final PixelPos getPixelPos(GeoPos geoPos,
                                  PixelPos pixelPos)

Deprecated.

Returns the pixel co-ordinates as x/y for a given geographical position given as lat/lon.

Parameters:

geoPos - the geographical position as lat/lon.

pixelPos - an instance of PixelPos to be used as retun value. If this parameter is null, the method creates a new instance which it then returns.

Returns:

the pixel co-ordinates as x/y

getGeoPos

public final GeoPos getGeoPos(PixelPos pixelPos,
                              GeoPos geoPos)

Deprecated.

Returns the latitude and longitude value for a given pixel co-ordinate.

Parameters:

pixelPos - the pixel's co-ordinates given as x,y

geoPos - an instance of GeoPos to be used as retun value. If this parameter is null, the method creates a new instance which it then returns.

Returns:

the geographical position as lat/lon.

dispose

public void dispose()

Deprecated.

Releases all of the resources used by this geo-coding and all of its owned children. Its primary use is to allow the garbage collector to perform a vanilla job.

This method should be called only if it is for sure that this object instance will never be used again. The results of referencing an instance of this class after a call to dispose() are undefined.

Overrides of this method should always call super.dispose(); after disposing this instance.

getDatum

public Datum getDatum()

Deprecated.

Gets the datum, the reference point or surface against which GeoPos measurements are made.

Returns:

the datum

createDeepClone

public MapGeoCoding createDeepClone()

Deprecated.

transferGeoCoding

public boolean transferGeoCoding(Scene srcScene,
                                 Scene destScene,
                                 ProductSubsetDef subsetDef)

Deprecated.

Transfers the geo-coding of the srcScene to the destScene with respect to the given subsetDef.

Specified by:

transferGeoCoding in class AbstractGeoCoding

Parameters:

srcScene - the source scene

destScene - the destination scene

subsetDef - the definition of the subset, may be null

Returns:

true, if the geo-coding could be transferred.

getImageToMapTransform

public org.opengis.referencing.operation.MathTransform getImageToMapTransform()

Deprecated.

Specified by:

getImageToMapTransform in interface GeoCoding

Overrides:

getImageToMapTransform in class AbstractGeoCoding

Returns:

The math transformation used to convert image coordinates to map coordinates.