EngEphemeris.hpp

Go to the documentation of this file.

#pragma ident "$Id: EngEphemeris.hpp 2368 2010-03-25 18:56:06Z renfroba $"



#ifndef GPSTK_ENGEPHEMERIS_HPP
#define GPSTK_ENGEPHEMERIS_HPP

//============================================================================
//
//  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., 59 Temple Place, Suite 330, Boston, MA  02111-1307  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.
//
//=============================================================================






#include "EngNav.hpp"
#include "Exception.hpp"
#include "DayTime.hpp"
#include "Xvt.hpp"

namespace gpstk
{

   class EngEphemeris : public EngNav
   {
   public:
      EngEphemeris() throw();

      virtual ~EngEphemeris() {}

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

      bool addIncompleteSF1Thru3(
         const long sf1[8], const long sf2[8], const long sf3[8], 
         const long sf1TransmitSOW, const int gpsWeek,
         const short PRN, const short track);

      bool isData(short subframe) const throw(gpstk::InvalidRequest);

      void setAccuracy(const double& acc) throw(gpstk::InvalidParameter);
      
      short getFitInterval() const throw(gpstk::InvalidRequest);

         // kinda pointless, huh?
      unsigned char getTLMPreamble() const throw() { return 0x8b; }

      unsigned getTLMMessage(short subframe) const 
         throw(gpstk::InvalidRequest);
            
      DayTime getEphemerisEpoch() const throw(InvalidRequest);

      DayTime getEpochTime() const throw(gpstk::InvalidRequest);

      DayTime getTransmitTime() const throw(gpstk::InvalidRequest);
      
      DayTime getTimestamp() const throw(gpstk::InvalidRequest)
         { return getEpochTime(); }
     
      short getPRNID() const throw(gpstk::InvalidRequest);
      
      short getTracker() const throw(gpstk::InvalidRequest);

      double getHOWTime(short subframe) const throw(gpstk::InvalidRequest);
      
      short getASAlert(short subframe) const throw(gpstk::InvalidRequest);
      
      short getFullWeek() const throw(gpstk::InvalidRequest);
      
      short getCodeFlags() const throw(gpstk::InvalidRequest);
      
      double getAccuracy() const throw(gpstk::InvalidRequest);

      short getAccFlag() const throw(gpstk::InvalidRequest);
      
      short getHealth() const throw(gpstk::InvalidRequest);
      
      short getL2Pdata() const throw(gpstk::InvalidRequest);
      
      short getIODC() const throw(gpstk::InvalidRequest);
      
      short getIODE() const throw(gpstk::InvalidRequest);
      
      long getAODO() const throw(gpstk::InvalidRequest);
      
      double getToc() const throw(gpstk::InvalidRequest);
      
      double getAf0() const throw(gpstk::InvalidRequest);
      
      double getAf1() const throw(gpstk::InvalidRequest);
      
      double getAf2() const throw(gpstk::InvalidRequest);
      
      double getTgd() const throw(gpstk::InvalidRequest);
      
      double getCus() const throw(gpstk::InvalidRequest);
      
      double getCrs() const throw(gpstk::InvalidRequest);
      
      double getCis() const throw(gpstk::InvalidRequest);
      
      double getCrc() const throw(gpstk::InvalidRequest);
      
      double getCuc() const throw(gpstk::InvalidRequest);
      
      double getCic() const throw(gpstk::InvalidRequest);
      
      double getToe() const throw(gpstk::InvalidRequest);
      
      double getM0() const throw(gpstk::InvalidRequest);
      
      double getDn() const throw(gpstk::InvalidRequest);
      
      double getEcc() const throw(gpstk::InvalidRequest);
      
      double getAhalf() const throw(gpstk::InvalidRequest);
      
      double getA() const throw(gpstk::InvalidRequest);
      
      double getOmega0() const throw(gpstk::InvalidRequest);
      
      double getI0() const throw(gpstk::InvalidRequest);
      
      double getW() const throw(gpstk::InvalidRequest);
      
      double getOmegaDot() const throw(gpstk::InvalidRequest);
      
      double getIDot() const throw(gpstk::InvalidRequest);
      
      Xvt svXvt(const DayTime& t) const throw(gpstk::InvalidRequest);

      double svRelativity(const DayTime& t) const throw(gpstk::InvalidRequest);

      double svClockBias(const DayTime& t) const throw(gpstk::InvalidRequest);

      double svClockDrift(const DayTime& t) const throw(gpstk::InvalidRequest);

      short getFitInt() const throw(gpstk::InvalidRequest);
      
      double getEphkey() const throw(gpstk::InvalidRequest);

      long getTot() const throw(gpstk::InvalidRequest);
      
      EngEphemeris& setSF1( unsigned tlm, double how, short asalert, short fullweek,
                            short cflags, short acc, short svhealth, short iodc,
                            short l2pdata, double tgd, double toc, double Af2,
                            double Af1, double Af0, short Tracker, short prn )
         throw();

      
      EngEphemeris& setSF2( unsigned tlm, double how, short asalert, short iode,
                            double crs, double Dn, double m0, double cuc, double Ecc,
                            double cus, double ahalf, double toe, short fitInt )
         throw();
      
      EngEphemeris& setSF3( unsigned tlm, double how, short asalert, double cic,
                            double Omega0, double cis, double I0, double crc,
                            double W, double OmegaDot, double IDot )
         throw();
      
      void dump(std::ostream& s = std::cout) const;

   protected:
      bool haveSubframe[3];


      unsigned short tlm_message[3];
      short PRNID;         
      short tracker;       
      long HOWtime[3];     
      short ASalert[3];    
      short weeknum;       
      short codeflags;     
      double accuracy;      
      short accFlag;       
      short health;        
      short L2Pdata;       
      short IODC;         
      short IODE;         
      long  AODO;         
      

      double   Toc;           
      double   af0;           
      double   af1;           
      double   af2;           
      double   Tgd;           


      double   Cuc;           
      double   Cus;           
      double   Crc;           
      double   Crs;           
      double   Cic;           
      double   Cis;           


      double   Toe;           
      double   M0;            
      double   dn;            
      double   ecc;           
      double   Ahalf;         
      double   OMEGA0;        
      double   i0;            
      double   w;             
      double   OMEGAdot;      
      double   idot;          
      short fitint;           

      friend std::ostream& operator<<(std::ostream& s, 
                                      const EngEphemeris& eph);

   }; // class EngEphemeris


} // namespace

#endif

---