courselog.gpsutils
Class MeasuredPoint

java.lang.Object
  extended by courselog.gpsutils.GeoPoint
      extended by courselog.gpsutils.MeasuredPoint
All Implemented Interfaces:
ewe.util.Copyable
Direct Known Subclasses:
TrackPoint

public class MeasuredPoint
extends GeoPoint
implements ewe.util.Copyable

Measured location point from a GPS. Gathers all collected data and computed also.


Field Summary
 double altGeoid
          Altitude of the Mean Sea Level to the geoid (m).
 int date
          Date generated in GPS format (DDMMYY).
 double hDOP
          Horizontal Dilution Of Precision
 double heading
          Heading in degrees.
 boolean isDifferential
          True if was computed by differential GPS.
 ewe.sys.Time measureTime
          Measured time as a Time object for difference of dates calculations.
 int satsInSolution
          Number of satellites used to compute the point.
 double speed
          Measured speed at that point (km/h)
 double time
          UTC Time provided by the GPS (HHMMSS.SSS)
 double vDOP
          Vertical Dilution Of Precision.
 
Fields inherited from class courselog.gpsutils.GeoPoint
altSeaLevel, dummyAng, dummyCoord, ER, lat, lon, myX, myY, myZ, uTMEasting, uTMLatZone, uTMLonZone, uTMNorthing
 
Constructor Summary
MeasuredPoint()
          Creates a new empty instance of MeasuredPoint.
 
Method Summary
 void computeTime()
          Compute the measuredTime ewe.sys.Time object of this MeasuredPoint.
 void copyFrom(java.lang.Object param)
          Copy all elements of point param into this instance.
 java.lang.String formatHeading()
          Formats the heading of this point.
 java.lang.String formatSpeed()
          Formats the speed of this point.
 java.lang.Object getCopy()
          Copy all elements of this point in a new instance.
 void initialise()
          Put default (unusable values in this object so that it will be ready for reuse.
 double timeTo(MeasuredPoint pointTo)
          Compute the difference of time of measurement in seconds (decimal) between this point and the given point.
 
Methods inherited from class courselog.gpsutils.GeoPoint
computeCartesian, computeLatLonAlt, computeLatLonToUTMRef, computeUTMtoLatLng, coordinatesIn, ddmmssLat, ddmmssLon, directionTo, distance, formatAlt, formatInBuffer, getLat, getLon, getUTMLatitudeZoneLetter, headingTo, moveBy, readFromLogLine, toLatLonString, toString, toUTMString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

altGeoid

public double altGeoid
Altitude of the Mean Sea Level to the geoid (m).


date

public int date
Date generated in GPS format (DDMMYY).


measureTime

public ewe.sys.Time measureTime
Measured time as a Time object for difference of dates calculations.

See Also:
computeTime()

heading

public double heading
Heading in degrees.


speed

public double speed
Measured speed at that point (km/h)


time

public double time
UTC Time provided by the GPS (HHMMSS.SSS)


satsInSolution

public int satsInSolution
Number of satellites used to compute the point.


hDOP

public double hDOP
Horizontal Dilution Of Precision


vDOP

public double vDOP
Vertical Dilution Of Precision.


isDifferential

public boolean isDifferential
True if was computed by differential GPS. Configuration of receiver not yet implemented.

Constructor Detail

MeasuredPoint

public MeasuredPoint()
Creates a new empty instance of MeasuredPoint. The new point is initialised.

Method Detail

initialise

public void initialise()
Put default (unusable values in this object so that it will be ready for reuse.

Overrides:
initialise in class GeoPoint

getCopy

public java.lang.Object getCopy()
Copy all elements of this point in a new instance. The measured time is also copied in a new Time object.

Specified by:
getCopy in interface ewe.util.Copyable
Overrides:
getCopy in class GeoPoint
Returns:
New MeasuredPoint with identical data
See Also:
Copyable.getCopy()

copyFrom

public void copyFrom(java.lang.Object param)
Copy all elements of point param into this instance.

Overrides:
copyFrom in class GeoPoint
Parameters:
param - Point to copy from.

timeTo

public double timeTo(MeasuredPoint pointTo)
Compute the difference of time of measurement in seconds (decimal) between this point and the given point. Positive when this point is later than pointTo.

Parameters:
pointTo - Point of comparison. Its measuredTime field must be up to date.
Returns:
The time difference in seconds (with 3 decimals).
See Also:
computeTime()

computeTime

public void computeTime()
Compute the measuredTime ewe.sys.Time object of this MeasuredPoint.


formatHeading

public java.lang.String formatHeading()
Formats the heading of this point.

Returns:
Formatted heading.
See Also:
Converters.formatHeading(double)

formatSpeed

public java.lang.String formatSpeed()
Formats the speed of this point.

Returns:
Formatted speed.
See Also:
Converters.formatSpeed(double)