ilex.util.Location Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of opendcs Show documentation
A collection of software for aggregatting and processing environmental data such as from NOAA GOES satellites.
The newest version!
/**
 * $Id$
 * 
 * $Log$
 * Revision 1.2  2014/10/02 14:36:32  mmaloney
 * Added bean attributes and accessor methods.
 *
 * Revision 1.1.1.1  2014/05/19 15:28:59  mmaloney
 * OPENDCS 6.0 Initial Checkin
 *
 * Revision 1.1  2010/10/29 15:09:36  mmaloney
 * Created.
 *
 */
package ilex.util;


public class Location
{
	private double latitude = 0.0;
	private double longitude = 0.0;
	private double radius = 0.0;
	
	public String toString()
	{
		return "Loc: lat=" + latitude + ", lon=" + longitude + ", rad=" + radius;
	}
	
	/**
	 * Accept a string in decimal or deg/min/sec notation and return
	 * a decimal number representing the latitude.
	 * Southern latitudes are negative numbers
	 * @param lat the String representation of the latitude
	 * @return latitude as a number
	 * @throws ParseException
	 */
	public static double parseLatitude(String lat)
		throws NumberFormatException
	{
		if (lat == null || lat.trim().length() == 0)
			return 0.0;
		
		double ret = 0.0;
		// Try to trim any trailing characters like deg or N
		int n = lat.length()-1;
		while(n > 0 
		 && !Character.isDigit(lat.charAt(n)) && lat.charAt(n) != '.')
			n--;
		try 
		{
			ret = Double.parseDouble(lat.substring(0, n+1)); 
		}
		catch(NumberFormatException ex)
		{
			try { ret = degMinSec(lat); }
			catch(NumberFormatException ex2)
			{
				throw new NumberFormatException("Cannot parse latitude '" + lat + "'");
			}
		}
		// Default to NORTH latitude
		if (lat.toUpperCase().indexOf('S') >= 0 && ret > 0)
			ret = -ret;
		return ret;
	}
	
	/**
	 * Accept a string in decimal or deg/min/sec notation and return
	 * a decimal number representing the longitude.
	 * West longitudes are negative numbers
	 * @param lon the String representation of the latitude
	 * @return longitude as a number
	 * @throws ParseException
	 */
	public static double parseLongitude(String lon)
		throws NumberFormatException
	{
		if (lon == null || lon.trim().length() == 0)
			return 0.0;
		double ret = 0.0;
		
		// Try to trim any trailing characters like deg or N
		int n = lon.length()-1;
		while(n > 0 
		 && !Character.isDigit(lon.charAt(n)) && lon.charAt(n) != '.')
			n--;
		try
		{
			ret = Double.parseDouble(lon.substring(0, n+1));
		}
		catch(NumberFormatException ex)
		{
			try { ret = degMinSec(lon); }
			catch(NumberFormatException ex2)
			{
				throw new NumberFormatException("Cannot parse longitude '" + lon + "'");
			}
		}
		// Default to WEST longitude as a negative number.
		if (lon.toUpperCase().indexOf('E') == -1 && ret > 0)
			ret = -ret;
		return ret;
	}

	/**
	 * Try to convert a string in deg min sec format to a double precision. 
	 */
	private static double degMinSec(String dms)
		throws NumberFormatException
	{
		// Look for 3 integers separated by non integers
		int nstart = 0;
		for(nstart = 0; nstart < dms.length() 
			&& !Character.isDigit(dms.charAt(nstart)); nstart++);
		if (nstart == dms.length())
			throw new NumberFormatException("No degrees");
		int nend = nstart+1;
		for(; nend < dms.length() 
			&& Character.isDigit(dms.charAt(nend)); nend++);
		int deg = Integer.parseInt(dms.substring(nstart, nend));

		for(nstart = nend; nstart < dms.length() 
			&& !Character.isDigit(dms.charAt(nstart)); nstart++);
		if (nstart == dms.length())
			throw new NumberFormatException("No minutes");
		nend = nstart+1;
		for(; nend < dms.length() 
			&& Character.isDigit(dms.charAt(nend)); nend++);
		int min = Integer.parseInt(dms.substring(nstart, nend));

		for(nstart = nend; nstart < dms.length() 
			&& !Character.isDigit(dms.charAt(nstart)); nstart++);
		if (nstart == dms.length())
			throw new NumberFormatException("No seconds");
		nend = nstart+1;
		for(; nend < dms.length() 
			&& Character.isDigit(dms.charAt(nend)); nend++);
		int sec = Integer.parseInt(dms.substring(nstart, nend));
		
		return (double)deg + (double)min/60.0 + (double)sec/3600.0;
	}

	public double getLatitude()
	{
		return latitude;
	}

	public void setLatitude(double latitude)
	{
		this.latitude = latitude;
	}

	public double getLongitude()
	{
		return longitude;
	}

	public void setLongitude(double longitude)
	{
		this.longitude = longitude;
	}

	public double getRadius()
	{
		return radius;
	}

	public void setRadius(double radius)
	{
		this.radius = radius;
	}
}