EngAlmanac.hpp

Go to the documentation of this file.

//==============================================================================
//
//  This file is part of GNSSTk, the ARL:UT GNSS Toolkit.
//
//  The GNSSTk 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 3.0 of the License, or
//  any later version.
//
//  The GNSSTk 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 GNSSTk; if not, write to the Free Software Foundation,
//  Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110, USA
//
//  This software was developed by Applied Research Laboratories at the
//  University of Texas at Austin.
//  Copyright 2004-2022, The Board of Regents of The University of Texas System
//
//==============================================================================
 
//==============================================================================
//
//  This software was 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 GNSSTK_ENGALMANAC_HPP
#define GNSSTK_ENGALMANAC_HPP
 
#include "Exception.hpp"
#include "EngNav.hpp"
#include "AlmOrbit.hpp"
#include "Xvt.hpp"
#include "StringUtils.hpp"
 
namespace gnsstk
{
 
   NEW_EXCEPTION_CLASS(SVNotPresentException, gnsstk::InvalidRequest);
 
 
 
 
   class EngAlmanac : public EngNav
   {
   public:
 
      typedef std::map<short, unsigned char, std::less<short> > SVBitsMap;
 
      EngAlmanac() noexcept;
 
      virtual ~EngAlmanac() {}
 
      bool addSubframe(const long subframe[10], const int gpsWeek);
 
      bool addSubframe(const uint32_t subframe[10], const short gpsWeek);
 
      bool isData(SatID sat) const noexcept;
 
      double getEcc(SatID sat) const;
 
      double getIOffset(SatID sat) const;
 
      double getOmegadot(SatID sat) const;
 
      short get6bitHealth(SatID sat) const;
 
      short getSVHealth(SatID sat) const;
 
 
      short getSVConfig(SatID sat) const;
 
      double getAhalf(SatID sat) const;
 
      double getA(SatID sat) const;
 
      double getOmega0(SatID sat) const;
 
      double getW(SatID sat) const;
 
      double getM0(SatID sat) const;
 
      double getAf0(SatID sat) const;
 
      double getAf1(SatID sat) const;
 
      double getToa() const noexcept;
 
      double getToa(SatID sat) const;
 
      double getXmitTime(SatID sat) const;
 
      short getFullWeek(SatID sat) const;
 
      void getIon(double a[4], double b[4]) const;
 
      void getUTC(double& a0, double& a1, double& deltaTLS, long& tot,
                  int& WNt, int& WNLSF, int& DN, double& deltaTLSF) const;
 
      short getAlmWeek() const noexcept;
 
      AlmOrbit getAlmOrbElem(SatID sat) const;
 
      AlmOrbits getAlmOrbElems() const
      { return almPRN; }
 
      Xvt svXvt(SatID sat, const CommonTime& t) const;
 
      Xvt svXvt(short prn, const CommonTime& t) const
      { SatID sat(prn,SatelliteSystem::GPS); 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;
 
 
      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 wn_a;              
      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