Class UTM


  • @Deprecated
    public class UTM
    extends Object
    Deprecated.
    since BEAM 4.7, use geotools instead.
    The UTM class provides useful, static methods for dealing with the UTM map-projection.
    • 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​(double 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.