BrcKeplerOrbit.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_BRCKEPLERORBIT_HPP
#define GNSSTK_BRCKEPLERORBIT_HPP
 
#include <string>
#include "Xvt.hpp"
#include "ObsID.hpp"
#include "EngNav.hpp"
#include "Exception.hpp"
#include "CommonTime.hpp"
#include "StringUtils.hpp"
#include "GNSSconstants.hpp"
#include "GPSEllipsoid.hpp"
#include "MathBase.hpp"
#include "TimeSystem.hpp"
#include "GPSWeekSecond.hpp"
#include "YDSTime.hpp"
#include "CivilTime.hpp"
#include "GPS_URA.hpp"
 
class BrcKeplerOrbit_T;
 
namespace gnsstk
{
 
 
   class BrcKeplerOrbit : public EngNav
   {
   public:
      BrcKeplerOrbit( ) noexcept;
 
      BrcKeplerOrbit( const std::string satSysArg, const ObsID obsIDArg,
                      const short PRNIDArg, const CommonTime beginFitArg,
                      const CommonTime endFitArg, const CommonTime ToeArg,
                      const short URAoeArg,
                      const bool healthyArg, const double CucArg,
                      const double CusArg, const double CrcArg,
                      const double CrsArg, const double CicArg,
                      const double CisArg, const double M0Arg,
                      const double dnArg, const double dndotArg,
                      const double eccArg, const double AArg,
                      const double AhalfArg, const double AdotArg,
                      const double OMEGA0Arg, const double i0Arg,
                      const double wArg, const double OMEGAdotARg,
                      const double idotArg );
 
      BrcKeplerOrbit( const ObsID obsIDArg,
                      const short PRNID,
                      const short fullweeknum,
                      const long subframe1[10],
                      const long subframe2[10],
                      const long subframe3[10] );
 
         // Add other constructors for other navigation message formats here...
 
      virtual ~BrcKeplerOrbit() {}
 
      bool operator==(const BrcKeplerOrbit& right) const noexcept;
      bool operator!=(const BrcKeplerOrbit& right) const noexcept
      { return !(operator==(right)); }
 
      void loadData(const std::string satSysArg, const ObsID obsIDArg,
                    const short PRNIDArg, const CommonTime beginFitArg,
                    const CommonTime endFitArg, const CommonTime ToeArg,
                    const short URAoeArg, const bool healthyArg,
                    const double CucArg,
                    const double CusArg, const double CrcArg,
                    const double CrsArg, const double CicArg,
                    const double CisArg, const double M0Arg,
                    const double dnArg, const double dndotArg,
                    const double eccArg, const double AArg,
                    const double AhalfArg, const double AdotArg,
                    const double OMEGA0Arg, const double i0Arg,
                    const double wArg, const double OMEGAdotARg,
                    const double idotArg );
 
      void loadData( const ObsID obsIDArg,
                     const short PRNID,
                     const short fullweeknum,
                     const long subframe1[10],
                     const long subframe2[10],
                     const long subframe3[10] );
 
      CommonTime getOrbitEpoch() const;
 
      CommonTime getBeginningOfFitInterval() const;
 
      CommonTime getEndOfFitInterval() const;
 
      bool hasData( ) const;
 
         //@note Determine if this function is needed, as it is never used
         //std::string getSatSystem() const;
 
         //@note Determine if this function is needed, as it is never used
         //std::string getSignal() const;
 
      short getPRNID() const;
 
      ObsID getObsID() const;
 
      bool isHealthy() const;
 
      bool withinFitInterval(const CommonTime) const;
 
      short getFullWeek() const;
 
      double getAccuracy() const;
 
 
      void setAccuracy(const double& acc);
 
      short getURAoe() const;
 
      double getCus() const;
 
      double getCrs() const;
 
      double getCis() const;
 
      double getCrc() const;
 
      double getCuc() const;
 
      double getCic() const;
 
      double getToe() const;
 
      double getM0() const;
 
      double getDn() const;
 
      double getDnDot() const;
 
      double getEcc() const;
 
      double getA() const;
 
      double getAhalf() const;
 
      double getAdot() const;
 
      double getOmega0() const;
 
      double getI0() const;
 
      double getW() const;
 
      double getOmegaDot() const;
 
      double getIDot() const;
 
      Xvt svXvt(const CommonTime& t) const;
 
      double svRelativity(const CommonTime& t) const;
 
      void dump(std::ostream& s = std::cout) const noexcept;
 
   protected:
 
      bool    dataLoaded;     
      std::string satSys;     
      ObsID   obsID;          
      short   PRNID;          
      CommonTime Toe;         
      short   URAoe;          
      bool    healthy;        
 
 
      double   Cuc;           
      double   Cus;           
      double   Crc;           
      double   Crs;           
      double   Cic;           
      double   Cis;           
 
 
      double   M0;            
      double   dn;            
      double   dndot;         
      double   ecc;           
      double   A;             
      double   Ahalf;         
      double   Adot;          
      double   OMEGA0;        
      double   i0;            
      double   w;             
      double   OMEGAdot;      
      double   idot;          
 
 
      CommonTime beginFit;    
      CommonTime endFit;      
 
      friend class ::BrcKeplerOrbit_T;
      friend std::ostream& operator<<(std::ostream& s,
                                      const BrcKeplerOrbit& eph);
 
   }; // class BrcKeplerOrbit
 
 
} // namespace
 
#endif