EngAlmanac.hpp

Go to the documentation of this file.

#pragma ident "$Id: EngAlmanac.hpp 3140 2012-06-18 15:03:02Z susancummins $"

//============================================================================
//
//  This file is part of GPSTk, the GPS Toolkit.
//
//  The GPSTk is free software; you can redistribute it and/or modify
//  it under the terms of the GNU Lesser General Public License as published
//  by the Free Software Foundation; either version 2.1 of the License, or
//  any later version.
//
//  The GPSTk is distributed in the hope that it will be useful,
//  but WITHOUT ANY WARRANTY; without even the implied warranty of
//  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
//  GNU Lesser General Public License for more details.
//
//  You should have received a copy of the GNU Lesser General Public
//  License along with GPSTk; if not, write to the Free Software Foundation,
//  Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110, USA
//  
//  Copyright 2004, The University of Texas at Austin
//
//============================================================================
//============================================================================
//
//This software developed by Applied Research Laboratories at the University of
//Texas at Austin, under contract to an agency or agencies within the U.S. 
//Department of Defense. The U.S. Government retains all rights to use,
//duplicate, distribute, disclose, or release this software. 
//
//Pursuant to DoD Directive 523024 
//
// DISTRIBUTION STATEMENT A: This software has been approved for public 
//                           release, distribution is unlimited.
//
//=============================================================================

#ifndef GPSTK_ENGALMANAC_HPP
#define GPSTK_ENGALMANAC_HPP

#include "Exception.hpp"
#include "EngNav.hpp"
#include "AlmOrbit.hpp"
#include "Xvt.hpp"
#include "StringUtils.hpp"

namespace gpstk
{

   class EngAlmanac : public EngNav
   {
   public:
      NEW_EXCEPTION_CLASS(SVNotPresentException, gpstk::InvalidRequest);

      typedef std::map<short, unsigned char, std::less<short> > SVBitsMap;

      EngAlmanac() throw();

      virtual ~EngAlmanac() {}

      bool addSubframe(const long subframe[10], const int gpsWeek)
         throw(gpstk::InvalidParameter);

      bool isData(SatID sat) const throw();
      
      double getEcc(SatID sat) const throw(SVNotPresentException);
      
      double getIOffset(SatID sat) const throw(SVNotPresentException);
      
      double getOmegadot(SatID sat) const throw(SVNotPresentException);
      
      short get6bitHealth(SatID sat) const throw(SVNotPresentException);
      
      short getSVHealth(SatID sat) const throw(SVNotPresentException);
      

      short getSVConfig(SatID sat) const throw(SVNotPresentException);

      double getAhalf(SatID sat) const throw(SVNotPresentException);
      
      double getA(SatID sat) const throw(SVNotPresentException);
      
      double getOmega0(SatID sat) const throw(SVNotPresentException);
      
      double getW(SatID sat) const throw(SVNotPresentException);
      
      double getM0(SatID sat) const throw(SVNotPresentException);
      
      double getAf0(SatID sat) const throw(SVNotPresentException);
      
      double getAf1(SatID sat) const throw(SVNotPresentException);
      
      double getToa() const throw();
      
      double getToa(SatID sat) const throw(SVNotPresentException);
      
      double getXmitTime(SatID sat) const throw(SVNotPresentException);
      
      short getFullWeek(SatID sat) const throw(SVNotPresentException);
      
      void getIon(double a[4], double b[4]) const
         throw(InvalidRequest);

      void getUTC(double& a0, double& a1, double& deltaTLS, long& tot,
                  int& WNt, int& WNLSF, int& DN, double& deltaTLSF) const
         throw(InvalidRequest);
      
      short getAlmWeek() const throw();

      AlmOrbit getAlmOrbElem(SatID sat) const
         throw(SVNotPresentException);

      AlmOrbits getAlmOrbElems() const
      { return almPRN; }
      
      Xvt svXvt(SatID sat, const CommonTime& t) const
         throw(SVNotPresentException);

      Xvt svXvt(short prn, const CommonTime& t) const
         throw(SVNotPresentException)
         { SatID sat(prn,SatID::systemGPS); return svXvt(sat,t); }

      void dump(std::ostream& s = std::cout, bool checkFlag=true) const;

      bool check(std::ostream& s) const;

   protected:
      void checkSVHere(SatID sat) const throw(SVNotPresentException);
      
      
      double alpha[4];
      double beta[4];

      double A0;                   
      double A1;                   
      double dt_ls;                
      double dt_lsf;               
      long t_ot;                   
      long t_oa;                   
      int wn_t;                    
      int wn_lsf;                  
      short alm_wk;                
      unsigned char dn;            
      SVBitsMap health;            
      std::string special_msg;     
      SVBitsMap SV_config;         
   
      AlmOrbits almPRN;
      bool haveUTC;

   private:
      bool operator==(const EngAlmanac&);
      bool operator!=(const EngAlmanac&);
      bool operator<(const EngAlmanac&);
      bool operator>(const EngAlmanac&);
   }; // class EngAlmanac


   std::ostream& operator<<(std::ostream& s, const EngAlmanac& alm);

} // namespace

#endif

---