ObsRngDev.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 OBSRNGDEV_HPP
#define OBSRNGDEV_HPP
 
#include <ostream>
 
#include "CommonTime.hpp"
#include "CarrierBand.hpp"
#include "NavLibrary.hpp"
#include "Exception.hpp"
#include "GPSEllipsoid.hpp"
#include "IonoModelStore.hpp"
#include "TropModel.hpp"
#include "NBTropModel.hpp"
#include "ValidType.hpp"
#include "SatID.hpp"
#include "GNSSconstants.hpp"
#include "gnsstk_export.h"
 
namespace gnsstk
{
 
 
   class ObsRngDev
   {
   public:
 
      ObsRngDev() noexcept
      : obstime(CommonTime::END_OF_TIME), wonky(0)
      {}
 
      ObsRngDev(const double prange,
                const SatID& svid,
                const CommonTime& time,
                const Position& rxpos,
                NavLibrary& navLib,
                EllipsoidModel& em,
                bool svTime = false,
                NavSearchOrder order = NavSearchOrder::User,
                SVHealth xmitHealth = SVHealth::Any,
                NavValidityType valid = NavValidityType::ValidOnly);
 
      ObsRngDev(const double prange,
                const SatID& svid,
                const CommonTime& time,
                const Position& rxpos,
                NavLibrary& navLib,
                EllipsoidModel& em,
                const IonoModelStore& ion,
                CarrierBand band,
                bool svTime = false,
                NavSearchOrder order = NavSearchOrder::User,
                SVHealth xmitHealth = SVHealth::Any,
                NavValidityType valid = NavValidityType::ValidOnly);
 
      ObsRngDev(const double prange,
                const SatID& svid,
                const CommonTime& time,
                const Position& rxpos,
                NavLibrary& navLib,
                EllipsoidModel& em,
                const TropModel& tm,
                bool svTime = false,
                NavSearchOrder order = NavSearchOrder::User,
                SVHealth xmitHealth = SVHealth::Any,
                NavValidityType valid = NavValidityType::ValidOnly);
 
      ObsRngDev(const double prange,
                const SatID& svid,
                const CommonTime& time,
                const Position& rxpos,
                NavLibrary& navLib,
                EllipsoidModel& em,
                const TropModel& tm,
                const IonoModelStore& ion,
                CarrierBand band,
                bool svTime = false,
                NavSearchOrder order = NavSearchOrder::User,
                SVHealth xmitHealth = SVHealth::Any,
                NavValidityType valid = NavValidityType::ValidOnly);
   
      ObsRngDev(const double prange1,
                const double prange2,
                const SatID& svid,
                const CommonTime& time,
                const Position& rxpos,
                NavLibrary& navLib,
                EllipsoidModel& em,
                bool svTime = false,
                double gamma = GAMMA_GPS,
                NavSearchOrder order = NavSearchOrder::User,
                SVHealth xmitHealth = SVHealth::Any,
                NavValidityType valid = NavValidityType::ValidOnly);
   
      ObsRngDev(const double prange1,
                const double prange2,
                const SatID& svid,
                const CommonTime& time,
                const Position& rxpos,
                NavLibrary& navLib,
                const EllipsoidModel& em,
                const TropModel& tm,
                bool svTime = false,
                double gamma = GAMMA_GPS,
                NavSearchOrder order = NavSearchOrder::User,
                SVHealth xmitHealth = SVHealth::Any,
                NavValidityType valid = NavValidityType::ValidOnly);
   
      virtual ~ObsRngDev() noexcept
      {}
 
         // get accessor methods ----------------------------------------------
      const CommonTime& getTime() const noexcept
      { return obstime; }
 
      SatID getSvID() const noexcept
      { return svid; }
 
      vfloat getAzimuth() const noexcept
      { return azimuth; }
 
      vfloat getElevation() const noexcept
      { return elevation; }
 
      vshort getHealth() const noexcept
      { return health; }
 
      vshort getIODC() const noexcept
      { return iodc; }
 
      double getORD() const noexcept
      { return ord; }
 
      vdouble getIono() const noexcept
      { return iono; }
 
      vdouble getTrop() const noexcept
      { return trop; }
 
      friend std::ostream& operator<<(std::ostream& s,
                                      const ObsRngDev& r) noexcept;
 
      void applyClockOffset(double clockOffset)
      { ord -= clockOffset; }
 
      GNSSTK_EXPORT static bool debug;
 
   private:
      void computeOrd(double obs,
                      const Position& rxpos,
                      NavLibrary& navLib,
                      const EllipsoidModel& em,
                      bool svTime,
                      NavSearchOrder order,
                      SVHealth xmitHealth,
                      NavValidityType valid)
      {
         if (svTime) 
            computeOrdTx(obs, rxpos, navLib, em, order, xmitHealth, valid);
         else 
            computeOrdRx(obs, rxpos, navLib, em, order, xmitHealth, valid);
         return;
      }
 
 
 
      void computeOrdTx(double obs,
                        const Position& rxpos,
                        NavLibrary& navLib,
                        const EllipsoidModel& em,
                        NavSearchOrder order,
                        SVHealth xmitHealth,
                        NavValidityType valid);
   
      void computeOrdRx(double obs,
                        const Position& rxpos,
                        NavLibrary& navLib,
                        const EllipsoidModel& em,
                        NavSearchOrder order,
                        SVHealth xmitHealth,
                        NavValidityType valid);
 
      void computeTrop(const TropModel& tm);
 
   public:
      CommonTime obstime;        
      SatID svid;                
      double ord;                
      unsigned wonky;            
 
      vfloat azimuth;            
      vfloat elevation;          
      vshort health;             
      vshort iodc;               
      vdouble rho;               
      vdouble iono;              
      vdouble trop;              
   };
 
 
}
#endif