dods.clients.importwizard.TMAP.convert
Class ConvertLatitude

java.lang.Object
  extended by dods.clients.importwizard.TMAP.convert.Convert
      extended by dods.clients.importwizard.TMAP.convert.ConvertLatitude

public class ConvertLatitude
extends Convert

A class for conversions between double and String along a Latitude axis. The axis will have a range of acceptable values. This package is designed to be hooked up with TextInputFields for region specification on database servers.

Version:
0.1, Sep 03, 1997
Author:
Jonathan Callahan This class may change substantially when ported to JDK 1.1 which contains a java.text.Format class. In the future, Convert and its subclasses may extend that class. This class may change substantially when ported to JDK 1.1 which contains a java.text.Format class. In the future, Convert and its subclasses may extend that class. This software was developed by the Thermal Modeling and Analysis Project(TMAP) of the National Oceanographic and Atmospheric Administration's (NOAA) Pacific Marine Environmental Lab(PMEL), hereafter referred to as NOAA/PMEL/TMAP. Access and use of this software shall impose the following obligations and understandings on the user. The user is granted the right, without any fee or cost, to use, copy, modify, alter, enhance and distribute this software, and any derivative works thereof, and its supporting documentation for any purpose whatsoever, provided that this entire notice appears in all copies of the software, derivative works and supporting documentation. Further, the user agrees to credit NOAA/PMEL/TMAP in any publications that result from the use of this software or in any product that includes this software. The names TMAP, NOAA and/or PMEL, however, may not be used in any advertising or publicity to endorse or promote any products or commercial entity unless specific written permission is obtained from NOAA/PMEL/TMAP. The user also understands that NOAA/PMEL/TMAP is not obligated to provide the user with any support, consulting, training or assistance of any kind with regard to the use, operation and performance of this software nor to provide the user with any updates, revisions, new versions or "bug fixes". THIS SOFTWARE IS PROVIDED BY NOAA/PMEL/TMAP "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL NOAA/PMEL/TMAP BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTUOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE ACCESS, USE OR PERFORMANCE OF THIS SOFTWARE.

Field Summary
static int M90_90
           
static int N_S
           
static int SPACE_N_S
           
static int SPACE_NORTH_SOUTH
           
 
Fields inherited from class dods.clients.importwizard.TMAP.convert.Convert
HI, LO, outputStyle, range, units
 
Constructor Summary
ConvertLatitude()
          Creates a ConvertLatitude object.
ConvertLatitude(int style)
          Creates a ConvertLatitude object with a predefined outputStyle.
 
Method Summary
 void setOutputStyle(int style)
          Sets the output style for the toString() method.
 double toDouble(String s)
          Converts a latitude string to a double value.
 String toString(double val)
          Converts a double value to a Latitude String.
 
Methods inherited from class dods.clients.importwizard.TMAP.convert.Convert
getNearestValue, getNearestValue, getRange, getRange, getUnits, intersectRange, rangeTest, setRange, setUnits, toString, unitTest
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

M90_90

public static final int M90_90
See Also:
Constant Field Values

N_S

public static final int N_S
See Also:
Constant Field Values

SPACE_N_S

public static final int SPACE_N_S
See Also:
Constant Field Values

SPACE_NORTH_SOUTH

public static final int SPACE_NORTH_SOUTH
See Also:
Constant Field Values
Constructor Detail

ConvertLatitude

public ConvertLatitude()
Creates a ConvertLatitude object.


ConvertLatitude

public ConvertLatitude(int style)
Creates a ConvertLatitude object with a predefined outputStyle.

Parameters:
style - one of the supported output styles.
Method Detail

setOutputStyle

public void setOutputStyle(int style)
Sets the output style for the toString() method. Supported output styles are:

Parameters:
style - one of the supported output styles.

toDouble

public double toDouble(String s)
                throws IllegalArgumentException
Converts a latitude string to a double value. Examples of acceptable strings are:
"45"
"45.5"
"-45"
"45N"
"-45S" (same as 45N)
"45 54S" (= 45 degrees, 54 minutes South)
"45 54.5" (= 45 degrees, 54.5 minutes North)
"45 54 30" (= 45 degrees, 54 minutes, 30 seconds North)
"455430N" (= 45 degrees, 54 minutes, 30 seconds North (USGS format))

Specified by:
toDouble in class Convert
Parameters:
s - String representing the Latitude.
Returns:
The double represented by the String.
Throws:
IllegalArgumentException - if s cannot be interpreted.

toString

public String toString(double val)
                throws IllegalArgumentException
Converts a double value to a Latitude String.

Specified by:
toString in class Convert
Parameters:
val - the string to be converted.
Returns:
String the value converted to a String.
Throws:
IllegalArgumentException