Main Page | Modules | Namespace List | Class Hierarchy | Class List | Directories | File List | Namespace Members | Class Members | File Members | Related Pages | Examples | Search for 

GPSAlmanacStore Class Reference
[Ephemstore]

#include <GPSAlmanacStore.hpp>

Inheritance diagram for GPSAlmanacStore:

Inheritance graph
[legend]
Collaboration diagram for GPSAlmanacStore:

Collaboration graph
[legend]
List of all members.

Detailed Description

Store GPS almanac information (i.e.

like the data in subframes 4&5) and compute satellite Xvt based upon this data and the algorithms defined in the IS-GPS-200.

Definition at line 65 of file GPSAlmanacStore.hpp.

Public Member Functions

 GPSAlmanacStore () throw ()
virtual ~GPSAlmanacStore ()
virtual Xvt getXvt (const SatID id, const DayTime &t) const throw (InvalidRequest)
 Returns the position, velocity, and clock offset of the indicated object in ECEF coordinates (meters) at the indicated time.
virtual Xvt getXvtMostRecentXmit (const SatID id, const DayTime &t) const throw (InvalidRequest)
 Returns the position, velocity, and clock offset of the indicated object in ECEF coordinates (meters) at the indicated time.
virtual void dump (std::ostream &s=std::cout, short detail=0) const throw ()
 A debugging function that outputs in human readable form, all data stored in this object.
virtual void edit (const DayTime &tmin, const DayTime &tmax=DayTime(DayTime::END_OF_TIME)) throw ()
 Edit the dataset, removing data outside the indicated time interval.
virtual DayTime getInitialTime () const throw (InvalidRequest)
 Determine the earliest time for which this object can successfully determine the Xvt for any object.
virtual DayTime getFinalTime () const throw (InvalidRequest)
 Determine the latest time for which this object can successfully determine the Xvt for any object.
virtual bool velocityIsPresent () const throw ()
virtual bool clockIsPresent () const throw ()
short getSatHealth (const SatID sat, const DayTime &t) const throw (InvalidRequest)
 Returns the health of an SV for a particular time.
bool addAlmanac (const AlmOrbit &alm) throw ()
bool addAlmanac (const EngAlmanac &alm) throw ()
AlmOrbit findAlmanac (const SatID sat, const DayTime &t) const throw (InvalidRequest)
 gets the closest almanac for the given time and satellite, closest being in the past or future.
AlmOrbit findMostRecentAlmanac (const SatID sat, const DayTime &t) const throw (InvalidRequest)
 gets the most recent almanac for the given time and satellite id, most recent meaning it must have a transmit time before the specified time.
AlmOrbits findAlmanacs (const DayTime &t) const throw (InvalidRequest)
 returns all almanacs closest to t for all satellites

Protected Types

typedef std::map< DayTime,
AlmOrbit > 		EngAlmMap
 This is intended to just store weekly sets of unique EngAlmanacs for a single SV.
typedef std::map< SatID, EngAlmMap > UBAMap
 This is intended to hold all unique EngEphemerises for each SV The key is the SatID of the SV.

Protected Attributes

UBAMap uba
 The map where all EngAlmanacs are stored.
DayTime initialTime
DayTime finalTime

Member Typedef Documentation

typedef std::map<DayTime, AlmOrbit> EngAlmMap [protected]
 

This is intended to just store weekly sets of unique EngAlmanacs for a single SV.

The key is ToA

Definition at line 187 of file GPSAlmanacStore.hpp.

typedef std::map<SatID, EngAlmMap> UBAMap [protected]
 

This is intended to hold all unique EngEphemerises for each SV The key is the SatID of the SV.

Definition at line 191 of file GPSAlmanacStore.hpp.

Constructor & Destructor Documentation

GPSAlmanacStore (   )  throw () [inline]
 

Definition at line 69 of file GPSAlmanacStore.hpp.

virtual ~GPSAlmanacStore (   )  [inline, virtual]
 

Definition at line 75 of file GPSAlmanacStore.hpp.

Member Function Documentation

bool addAlmanac (  const EngAlmanac &  alm  )  throw ()
 

Definition at line 91 of file GPSAlmanacStore.cpp.

References gpstk::AlmOrbits.

bool addAlmanac (  const AlmOrbit &  alm  )  throw ()
 

Definition at line 73 of file GPSAlmanacStore.cpp.

References AlmOrbit::getToaTime().

virtual bool clockIsPresent (   )  const throw () [inline, virtual]
 

Implements XvtStore< SatID >.

Definition at line 143 of file GPSAlmanacStore.hpp.

void dump (  std::ostream &  s = std::cout,
short  detail = 0
)  const throw () [virtual]
 

A debugging function that outputs in human readable form, all data stored in this object.

Parameters:
[in] s the stream to receive the output; defaults to cout
[in] detail the level of detail to provide

Reimplemented from XvtStore< SatID >.

Definition at line 217 of file GPSAlmanacStore.cpp.

References AlmOrbit::dump().

void edit (  const DayTime &  tmin,
const DayTime &  tmax = DayTime(DayTime::END_OF_TIME)
)  throw () [virtual]
 

Edit the dataset, removing data outside the indicated time interval.

Parameters:
[in] tmin defines the beginning of the time interval
[in] tmax defines the end of the time interval

Implements XvtStore< SatID >.

Definition at line 210 of file GPSAlmanacStore.cpp.

AlmOrbit findAlmanac (  const SatID  sat,
const DayTime &  t
)  const throw (InvalidRequest)
 

gets the closest almanac for the given time and satellite, closest being in the past or future.

Parameters:
sat the satellite's SatID
t the time of interest

Definition at line 103 of file GPSAlmanacStore.cpp.

References GPSTK_THROW, and DayTime::second().

AlmOrbits findAlmanacs (  const DayTime &  t  )  const throw (InvalidRequest)
 

returns all almanacs closest to t for all satellites

who cares about exceptions - the map will be empty if there are no alms...

Definition at line 187 of file GPSAlmanacStore.cpp.

References gpstk::AlmOrbits.

AlmOrbit findMostRecentAlmanac (  const SatID  sat,
const DayTime &  t
)  const throw (InvalidRequest)
 

gets the most recent almanac for the given time and satellite id, most recent meaning it must have a transmit time before the specified time.

Parameters:
sat the satellite's SatID
t the time of interest

Definition at line 149 of file GPSAlmanacStore.cpp.

References GPSTK_THROW, and DayTime::second().

virtual DayTime getFinalTime (   )  const throw (InvalidRequest) [inline, virtual]
 

Determine the latest time for which this object can successfully determine the Xvt for any object.

Returns:
The final time
Exceptions:
InvalidRequest This is thrown if the object has no data.

Implements XvtStore< SatID >.

Definition at line 134 of file GPSAlmanacStore.hpp.

virtual DayTime getInitialTime (   )  const throw (InvalidRequest) [inline, virtual]
 

Determine the earliest time for which this object can successfully determine the Xvt for any object.

Returns:
The initial time
Exceptions:
InvalidRequest This is thrown if the object has no data.

Implements XvtStore< SatID >.

Definition at line 125 of file GPSAlmanacStore.hpp.

short getSatHealth (  const SatID  sat,
const DayTime &  t
)  const throw (InvalidRequest)
 

Returns the health of an SV for a particular time.

Parameters:
sat the satellite's SatID
t the time to look up
Returns:
the SV health bits
Exceptions:
InvalidRequest no data found in store

Definition at line 66 of file GPSAlmanacStore.cpp.

References AlmOrbit::getSVHealth().

Xvt getXvt (  const SatID  id,
const DayTime &  t
)  const throw (InvalidRequest) [virtual]
 

Returns the position, velocity, and clock offset of the indicated object in ECEF coordinates (meters) at the indicated time.

Parameters:
[in] id the object's identifier
[in] t the time to look up
Returns:
the Xvt of the object at the indicated time
Exceptions:
InvalidRequest If the request can not be completed for any reason, this is thrown. The text may have additional information as to why the request failed.

Implements XvtStore< SatID >.

Definition at line 52 of file GPSAlmanacStore.cpp.

References AlmOrbit::svXvt().

Xvt getXvtMostRecentXmit (  const SatID  id,
const DayTime &  t
)  const throw (InvalidRequest) [virtual]
 

Returns the position, velocity, and clock offset of the indicated object in ECEF coordinates (meters) at the indicated time.

It differs from getXvt in that it uses a different search algorithm - It will use the most recently received almanac information, thereby imitating what a receiver would be doing in real-time. If there is no almanac data for that object prior to the requested time, InvalidRequest will be thrown.

Parameters:
[in] id the object's identifier
[in] t the time to look up
Returns:
the Xvt of the object at the indicated time
Exceptions:
InvalidRequest If the request can not be completed for any reason, this is thrown. The text may have additional information as to why the request failed.

Definition at line 59 of file GPSAlmanacStore.cpp.

References AlmOrbit::svXvt().

virtual bool velocityIsPresent (   )  const throw () [inline, virtual]
 

Implements XvtStore< SatID >.

Definition at line 138 of file GPSAlmanacStore.hpp.

Member Data Documentation

DayTime finalTime [protected]
 

Definition at line 197 of file GPSAlmanacStore.hpp.

DayTime initialTime [protected]
 

Definition at line 196 of file GPSAlmanacStore.hpp.

UBAMap uba [protected]
 

The map where all EngAlmanacs are stored.

Definition at line 194 of file GPSAlmanacStore.hpp.

The documentation for this class was generated from the following files:
Generated on Wed Feb 8 03:31:38 2012 for GPS ToolKit Software Library by  doxygen 1.3.9.1