RinexObsID.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_RINEXOBSID_HPP
#define GNSSTK_RINEXOBSID_HPP
 
#include "gnsstk_export.h"
#include "ObsID.hpp"
#include "RinexObsHeader.hpp"
 
namespace gnsstk
{
 
 
 
   bool isValidRinexObsID(const std::string& id);
 
   bool isValidRinexObsID(const std::string& id, const char syschar);
 
   class RinexObsID : public ObsID
   {
   public:
      RinexObsID()
            : ObsID(),
              rinexVersion(Rinex3ObsBase::currentVersion)
      {}
 
      RinexObsID(ObservationType ot, CarrierBand cb, TrackingCode tc,
                 double version = Rinex3ObsBase::currentVersion)
            : ObsID(ot, cb, tc),
              rinexVersion(version)
      {}
 
      explicit RinexObsID(const std::string& strID, double version);
 
      explicit RinexObsID(const char* id, double version)
            : RinexObsID(std::string(id), version)
      {}
 
      RinexObsID(const ObsID& oid,
                 double version = Rinex3ObsBase::currentVersion)
            : rinexVersion(version)
      {
         type=oid.type; band=oid.band; code=oid.code;
         std::string str(this->asString());
         if(!isValidRinexObsID(str))
         {
            InvalidParameter ip("Invalid RinexObsID: " + str);
            GNSSTK_THROW(ip);
         }
      }
 
      RinexObsID(const RinexObsType& rot);
 
      std::string asString() const
      { return asString(rinexVersion); }
 
      std::string asString(double version) const;
 
      bool equalIndex(const RinexObsID& right) const;
 
      static RinexObsID newID(const std::string& id,
                              const std::string& desc="");
 
      static std::ostream& dumpCheck(std::ostream& s);
 
      double rinexVersion;
 
      GNSSTK_EXPORT static std::string validRinexSystems;
 
      GNSSTK_EXPORT static std::map<std::string, std::string> map1to3sys;
      GNSSTK_EXPORT static std::map<std::string, std::string> map3to1sys;
 
      GNSSTK_EXPORT static std::string validRinexFrequencies;
 
      GNSSTK_EXPORT static std::map<char, std::map<char, std::string> > validRinexTrackingCodes;
 
      GNSSTK_EXPORT static std::map< char, ObservationType> char2ot;
      GNSSTK_EXPORT static std::map< char, CarrierBand> char2cb;
      GNSSTK_EXPORT static std::map< char, TrackingCode> char2tc;
      GNSSTK_EXPORT static std::map< ObservationType, char > ot2char;
      GNSSTK_EXPORT static std::map< CarrierBand, char > cb2char;
      GNSSTK_EXPORT static std::map< TrackingCode, char> tc2char;
 
      static std::string getOTChars();
      static std::string getOTDescFromChar(char c)
      { return otDesc[char2ot[c]]; }
      static std::string getCBChars();
      static std::string getCBDescFromChar(char c)
      { return cbDesc[char2cb[c]]; }
      static std::string getTCChars();
      static std::string getTCDescFromChar(char c)
      { return tcDesc[char2tc[c]]; }
 
   private:
      static RinexObsID idCreator(const std::string& id,
                                  const std::string& desc="");
 
   }; // end class RinexObsID
 
 
} // namespace gnsstk
 
#endif