com.bigdata.rdf.internal.gis

Class CoordinateDDM

java.lang.Object

com.bigdata.rdf.internal.gis.CoordinateDDM

All Implemented Interfaces:

ICoordinate

public class CoordinateDDM
extends Object
implements ICoordinate

An immutable coordinate expressed as degrees and decimal minutes with 3 digits after the decimal.

        Degrees and Decimal Minutes
       
        DDD� MM.MMM'
        32� 18.385' N 122� 36.875' W
 

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	thousandthsOfMinutesEast
int	thousandthsOfMinutesNorth

Constructor Summary

Constructors

Constructor and Description
CoordinateDDM(int degreesNorth, int thousandthsOfMinutesNorth, int degreesEast, int thousandthsOfMinutesEast)

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(CoordinateDDM o) Equal if the coordinates are exactly the same (precision to thousandths of a minute).
boolean	equals(ICoordinate o) Return true if two coordinates are exactly the same.
static CoordinateDDM	parse(String text) Some formats that are accepted: 32� 18.385' N 122� 36.875' W 32 18.385N 122 36.875W 32 18.385 N 122 36.875 W 32:18.385N 122:36.875W 32:18:23.1N/122:36:52.5W
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 and (thousandths of) decimal minutes.

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

thousandthsOfMinutesNorth

public final int thousandthsOfMinutesNorth

degreesEast

public final int degreesEast

thousandthsOfMinutesEast

public final int thousandthsOfMinutesEast

Constructor Detail

CoordinateDDM

public CoordinateDDM(int degreesNorth,
             int thousandthsOfMinutesNorth,
             int degreesEast,
             int thousandthsOfMinutesEast)

Parameters:

degreesNorth - Degrees north/south.

thousandthsOfMinutesNorth - Decimal minutes north/south expressed as minutes * 1000.

degreesEast - Degrees east/west.

thousandthsOfMinutesEast - Decimal minutes east/west expressed as minutes * 1000.

Method Detail

toString

public String toString()

Representation of the coordinate in degrees and (thousandths of) decimal minutes. For example:

   32 18.385N 122 36.875W
 

Overrides:

toString in class Object

parse

public static CoordinateDDM parse(String text)
                           throws ParseException

Some formats that are accepted:

• 32� 18.385' N 122� 36.875' W
• 32 18.385N 122 36.875W
• 32 18.385 N 122 36.875 W
• 32:18.385N 122:36.875W
• 32:18:23.1N/122:36:52.5W

Throws:

ParseException

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(CoordinateDDM o)

Equal if the coordinates are exactly the same (precision to thousandths of a minute).

Parameters:

o - Another coordinate expressed in decimal minutes.

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()

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.

toDD

public CoordinateDD toDD()

Convert to decimal degrees.

Specified by:

toDD in interface ICoordinate

Returns:

The coordinate expressed as decimal degrees.

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.