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

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

Deprecated. since BEAM 4.7, use geotools instead.

@Deprecated
public class UTM
extends Object

The UTM class provides useful, static methods for dealing with the UTM map-projection.

Field Summary

static String	AUTO_PROJECTION_NAME Deprecated. The name of the automatic zone projection.
static int	MAX_UTM_ZONE Deprecated. The maximum UTM zone number.
static int	MAX_UTM_ZONE_INDEX Deprecated. The maximum zone index.
static int	MIN_UTM_ZONE_INDEX Deprecated. The minimum zone index.

Method Summary

static UTMProjection	createAutoZoneProjection() Deprecated. Creates an automatic-zone UTM map projection.
static UTMProjection	createProjection(int zoneIndex, boolean south) Deprecated. Creates an UTM map projection for the specified parameters.
static UTMProjection	createProjection(String projName, int zoneIndex, boolean south) Deprecated. Creates a predefined UTM map projection for the specified parameters.
static double	getCentralMeridian(int zoneIndex) Deprecated. Computes the central meridian from the given UTM zone index.
static String	getProjectionName(int zoneIndex, boolean south) Deprecated. Gets a suitable name for the projection given by the specified UTM projection parameters.
static double[]	getProjectionParams(int zoneIndex, boolean south) Deprecated. Gets the UTM projection parameters for the transverse mercator transformation.
static MapProjection	getSuitableProjection(GeoPos geoPos) Deprecated. Gets the UTM projection suitable for the given geodetic coordinate.
static int	getZoneIndex(float longitude) Deprecated. Computes the UTM zone index from the longitude value.
static boolean	isAutoZoneProjection(MapProjection mapProjection) Deprecated. Checks whether or not the given map projection is an automatic UTM projection.
static void	registerProjections() Deprecated. Registers all possible UTM projections in the MapProjectionRegistry.

Methods inherited from class java.lang.Object

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

Field Detail

AUTO_PROJECTION_NAME

public static final String AUTO_PROJECTION_NAME

Deprecated.

The name of the automatic zone projection.

See Also:

Constant Field Values

MIN_UTM_ZONE_INDEX

public static final int MIN_UTM_ZONE_INDEX

Deprecated.

The minimum zone index.

See Also:

Constant Field Values

MAX_UTM_ZONE_INDEX

public static final int MAX_UTM_ZONE_INDEX

Deprecated.

The maximum zone index.

See Also:

Constant Field Values

MAX_UTM_ZONE

public static final int MAX_UTM_ZONE

Deprecated.

The maximum UTM zone number.

See Also:

Constant Field Values

Method Detail

isAutoZoneProjection

public static boolean isAutoZoneProjection(MapProjection mapProjection)

Deprecated.

Checks whether or not the given map projection is an automatic UTM projection.

Parameters:

mapProjection - the map projection, must not be null

Returns:

true if so

createAutoZoneProjection

public static UTMProjection createAutoZoneProjection()

Deprecated.

Creates an automatic-zone UTM map projection.

Returns:

an automatic-zone UTM map projection

createProjection

public static UTMProjection createProjection(int zoneIndex,
                                             boolean south)

Deprecated.

Creates an UTM map projection for the specified parameters.

Parameters:

zoneIndex - the zone index in the range 0 to MAX_UTM_ZONE - 1.

south - whether or not the projection is defined for the southern hemispere

Returns:

an UTM map projection

See Also:

getProjectionName(int, boolean)

createProjection

public static UTMProjection createProjection(String projName,
                                             int zoneIndex,
                                             boolean south)

Deprecated.

Creates a predefined UTM map projection for the specified parameters.

Parameters:

projName - a name for the projection, e.g. "UTM 33"

zoneIndex - the zone index in the range 0 to MAX_UTM_ZONE - 1.

south - whether or not the projection is defined for the southern hemispere

Returns:

an UTM map projection

getProjectionName

public static String getProjectionName(int zoneIndex,
                                       boolean south)

Deprecated.

Gets a suitable name for the projection given by the specified UTM projection parameters.

Parameters:

zoneIndex - the zone index in the range 0 to MAX_UTM_ZONE - 1.

south - whether or not the projection is defined for the southern hemispere

Returns:

a suitable projection name

getProjectionParams

public static double[] getProjectionParams(int zoneIndex,
                                           boolean south)

Deprecated.

Gets the UTM projection parameters for the transverse mercator transformation.

Parameters:

zoneIndex - the zone index in the range 0 to MAX_UTM_ZONE - 1.

south - whether or not the projection is defined for the southern hemispere

Returns:

the UTM projection parameters

getSuitableProjection

public static MapProjection getSuitableProjection(GeoPos geoPos)

Deprecated.

Gets the UTM projection suitable for the given geodetic coordinate.

Parameters:

geoPos - a geodetic coordinate

Returns:

a suitable UTM projection

getCentralMeridian

public static double getCentralMeridian(int zoneIndex)

Deprecated.

Computes the central meridian from the given UTM zone index.

Parameters:

zoneIndex - the zone index in the range 0 to MAX_UTM_ZONE - 1.

Returns:

the central meridian in the range -180 to +180 degree.

getZoneIndex

public static int getZoneIndex(float longitude)

Deprecated.

Computes the UTM zone index from the longitude value.

Parameters:

longitude - the longitude in the range -180 to +180 degrees.

Returns:

the zone index in the range 0 to MAX_UTM_ZONE - 1.

registerProjections

public static void registerProjections()

Deprecated.

Registers all possible UTM projections in the MapProjectionRegistry. The projection names have the form "UTM Zone 1" to "UTM Zone 64" for the northern hemisphere and "UTM Zone 1, South" to "UTM Zone 64, South" for the southern. Also contained is the special auto-UTM projection with the name AUTO_PROJECTION_NAME.