com.bigdata.rdf.internal.gis

Class CoordinateDMS

java.lang.Object

com.bigdata.rdf.internal.gis.CoordinateDMS

All Implemented Interfaces:

ICoordinate

public class CoordinateDMS
extends Object
implements ICoordinate

An immutable coordinate expressed in degrees, minutes and (tenths of) seconds.

Note: When the angle is negative, all components must be negative. For example, 0794731W corresponds to -79 deg 47' 31.111439999999998", but the individual components are actually -79, -47, and -31.1...

Version:

$Id$

Author:

Bryan Thompson

Nested Class Summary

Nested classes/interfaces inherited from interface com.bigdata.rdf.internal.gis.ICoordinate

ICoordinate.UNITS

Field Summary

Fields

Modifier and Type	Field and Description
int	degreesEast
int	degreesNorth
static Logger	log
int	minutesEast
int	minutesNorth
int	tenthsOfSecondsEast
int	tenthsOfSecondsNorth

Constructor Summary

Constructors

Constructor and Description
CoordinateDMS(int degreesNorth, int minutesNorth, int tenthsOfSecondsNorth, int degreesEast, int minutesEast, int tenthsOfSecondsEast)

Method Summary

Methods

Modifier and Type	Method and Description
double	distance(ICoordinate o, ICoordinate.UNITS units) Computes the distance to the specified coordinate and returns that distance in the specified units.
boolean	equals(CoordinateDMS o) True iff the two coordinates are exactly the same (to the tenths of the second).
boolean	equals(ICoordinate o) Return true if two coordinates are exactly the same.
static CoordinateDMS	parse(String text) Some formats that are accepted: 32� 18' 23.1" N 122� 36' 52.5" W 32 18 23.1N 122 36 52.5 W 32 18 23.1N/122 36 52.5W 32:18:23N/122:36:52W 32:18:23.1N/122:36:52.5W 321823N/1223652W (zeros would need to go in front of single digits and two zeros in front of the longitude degrees because it�s range is up to 180 � the latitude range is only up to 90) 3218N/12236W
CoordinateDMS	roundMinutes() Rounds off the coordinate to the nearest minutes (rounds up at 30.0 seconds to the next highest minute).
CoordinateDMS	roundSeconds() Rounds off the coordinate to the nearest seconds.
CoordinateDD	toDD() Convert to decimal degrees.
CoordinateDDM	toDDM() Convert to degrees and decimal minutes.
CoordinateDMS	toDMS() Convert to degrees, minutes and (tenths of) seconds.
String	toString() Representation of the coordinate in degrees, minutes, and (tenths of) seconds.

Methods inherited from class java.lang.Object

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

Field Detail

log

public static Logger log

degreesNorth

public final int degreesNorth

minutesNorth

public final int minutesNorth

tenthsOfSecondsNorth

public final int tenthsOfSecondsNorth

degreesEast

public final int degreesEast

minutesEast

public final int minutesEast

tenthsOfSecondsEast

public final int tenthsOfSecondsEast

Constructor Detail

CoordinateDMS

public CoordinateDMS(int degreesNorth,
             int minutesNorth,
             int tenthsOfSecondsNorth,
             int degreesEast,
             int minutesEast,
             int tenthsOfSecondsEast)

Method Detail

toString

public String toString()

Representation of the coordinate in degrees, minutes, and (tenths of) seconds. For example:

  32 18 23.1N 122 36 52.5W
 

Overrides:

toString in class Object

roundSeconds

public CoordinateDMS roundSeconds()

Rounds off the coordinate to the nearest seconds.

Returns:

A new coordinate that has been rounded off to the nearest seconds.

roundMinutes

public CoordinateDMS roundMinutes()

Rounds off the coordinate to the nearest minutes (rounds up at 30.0 seconds to the next highest minute).

Returns:

A new coordinate that has been rounded off to the nearest minutes.

equals

public boolean equals(ICoordinate o)

Description copied from interface: ICoordinate

Return true if two coordinates are exactly the same.

Note: Coordinates MUST be expressed in the same system before they may be compared. E.g., Degrees, Minutes and Seconds or Degrees and Decimal Minutes or Decimal Degrees.

Specified by:

equals in interface ICoordinate

Parameters:

o - Another coordinate.

equals

public boolean equals(CoordinateDMS o)

True iff the two coordinates are exactly the same (to the tenths of the second).

Parameters:

o - Another coordinate.

Returns:

True if the coordinates are exactly the same.

parse

public static CoordinateDMS parse(String text)
                           throws ParseException

Some formats that are accepted:

• 32� 18' 23.1" N 122� 36' 52.5" W
• 32 18 23.1N 122 36 52.5 W
• 32 18 23.1N/122 36 52.5W
• 32:18:23N/122:36:52W
• 32:18:23.1N/122:36:52.5W
• 321823N/1223652W
  (zeros would need to go in front of single digits and two zeros in front of the longitude degrees because it�s range is up to 180 � the latitude range is only up to 90)
• 3218N/12236W

Throws:

ParseException

toDD

public CoordinateDD toDD()

Convert to decimal degrees.

Decimal degrees = whole number of degrees, plus minutes divided by 60, plus seconds divided by 3600.

Specified by:

toDD in interface ICoordinate

Returns:

The coordinate expressed as decimal degrees.

distance

public double distance(ICoordinate o,
              ICoordinate.UNITS units)

Description copied from interface: ICoordinate

Computes the distance to the specified coordinate and returns that distance in the specified units.

Specified by:

distance in interface ICoordinate

Parameters:

o - Another coordinate.

units - The units in which the distance will be reported.

Returns:

The distance in the specified units.

toDMS

public CoordinateDMS toDMS()

Description copied from interface: ICoordinate

Convert to degrees, minutes and (tenths of) seconds.

Specified by:

toDMS in interface ICoordinate

Returns:

The coordinate expressed as degrees, minutes and (tenths of) seconds.

toDDM

public CoordinateDDM toDDM()

Description copied from interface: ICoordinate

Convert to degrees and decimal minutes.

Specified by:

toDDM in interface ICoordinate

Returns:

The coordinate expressed as degrees and decimal minutes.