org.esa.beam.framework.datamodel
Class CombinedFXYGeoCoding

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

All Implemented Interfaces:

GeoCoding

public class CombinedFXYGeoCoding
extends AbstractGeoCoding

A geo-coding based on a combination of GeoCodings. All the geocodings added must be wrapped in a CodingWrapper which describes the area in scene coordinates to which the geocoding is concerned.

Author:

Sabine Embacher

Nested Class Summary

static class

CombinedFXYGeoCoding.CodingWrapper

Constructor Summary

CombinedFXYGeoCoding(CombinedFXYGeoCoding.CodingWrapper[] codingWrappers)

Method Summary

boolean	canGetGeoPos() Checks whether or not this geo-coding can determine the geodetic position from a pixel position.
boolean	canGetPixelPos() Checks whether or not this geo-coding can determine the pixel position from a geodetic position.
void	dispose() Releases all of the resources used by this object instance and all of its owned children.
CombinedFXYGeoCoding.CodingWrapper[]	getCodingWrappers() Returns the CodingWrappers this GeoCoding consists of.
Datum	getDatum() Gets the datum, the reference point or surface against which GeoPos measurements are made.
GeoPos	getGeoPos(PixelPos pixelPos, GeoPos geoPos) Returns the latitude and longitude value for a given pixel co-ordinate.
PixelPos	getPixelPos(GeoPos geoPos, PixelPos pixelPos) Returns the pixel co-ordinates as x/y for a given geographical position given as lat/lon.
boolean	isCrossingMeridianAt180() Checks whether or not the longitudes of this geo-coding cross the +/- 180 degree meridian.
boolean	transferGeoCoding(Scene srcScene, Scene destScene, ProductSubsetDef subsetDef) 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, getImageToMapTransform, getMapCRS, setGeoCRS, setImageCRS, setMapCRS

Methods inherited from class java.lang.Object

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

Constructor Detail

CombinedFXYGeoCoding

public CombinedFXYGeoCoding(CombinedFXYGeoCoding.CodingWrapper[] codingWrappers)

Method Detail

getCodingWrappers

public CombinedFXYGeoCoding.CodingWrapper[] getCodingWrappers()

Returns the CodingWrappers this GeoCoding consists of.

Returns:

array of CodingWrappers.

transferGeoCoding

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

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.

isCrossingMeridianAt180

public boolean isCrossingMeridianAt180()

Description copied from interface: GeoCoding

Checks whether or not the longitudes of this geo-coding cross the +/- 180 degree meridian.

Returns:

true, if so

canGetPixelPos

public boolean canGetPixelPos()

Description copied from interface: GeoCoding

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

Returns:

true, if so

canGetGeoPos

public boolean canGetGeoPos()

Description copied from interface: GeoCoding

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

Returns:

true, if so

getPixelPos

public PixelPos getPixelPos(GeoPos geoPos,
                            PixelPos pixelPos)

Description copied from interface: GeoCoding

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 in the coodinate system determined by GeoCoding.getDatum()

pixelPos - an instance of Point 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 GeoPos getGeoPos(PixelPos pixelPos,
                        GeoPos geoPos)

Description copied from interface: GeoCoding

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 in the coodinate system determined by GeoCoding.getDatum()

getDatum

public Datum getDatum()

Description copied from interface: GeoCoding

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

Returns:

the datum

dispose

public void dispose()

Description copied from interface: GeoCoding

Releases all of the resources used by this object instance 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.