GSatID.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 CLASS_GEOMATIC_SATELLITE_ID_INCLUDE
#define CLASS_GEOMATIC_SATELLITE_ID_INCLUDE
 
#include "gnsstk_export.h"
#include "Exception.hpp"
#include "SatID.hpp"
 
namespace gnsstk
{
   class GSatID : public SatID
   {
   public:
      GSatID()
      {
         id     = -1;
         system = SatelliteSystem::GPS;
      }
 
      GSatID(int p, SatelliteSystem s)
      {
         id     = p;
         system = s;
         switch (system)
         {
            case SatelliteSystem::GPS:
            case SatelliteSystem::Galileo:
            case SatelliteSystem::Glonass:
            case SatelliteSystem::Geosync:
            case SatelliteSystem::LEO:
            case SatelliteSystem::Transit:
            case SatelliteSystem::QZSS:
            case SatelliteSystem::BeiDou:
            case SatelliteSystem::IRNSS:
               break;
            default:
               system = SatelliteSystem::GPS;
               id     = -1;
         }
      }
 
      GSatID(std::string& str)
      {
         try
         {
            this->fromString(str);
         }
         catch (Exception& e)
         {
            GNSSTK_RETHROW(e);
         }
      }
 
      GSatID(const SatID& sat) { *this = GSatID(sat.id, sat.system); }
 
      char setfill(char c)
      {
         char csave = fillchar;
         fillchar   = c;
         return csave;
      }
 
      char getfill() { return fillchar; }
 
      // operator=, copy constructor and destructor built by compiler
 
      bool operator==(const GSatID& right) const
      {
         return ((system == right.system) && (id == right.id));
      }
 
      bool operator<(const GSatID& right) const
      {
         if (system == right.system)
         {
            return (id < right.id);
         }
         return (system < right.system);
      }
 
      // the rest follow from Boolean algebra...
      bool operator!=(const GSatID& right) const
      {
         return !operator==(right);
      }
 
      bool operator>=(const GSatID& right) const
      {
         return !operator<(right);
      }
 
      bool operator<=(const GSatID& right) const
      {
         return (operator<(right) || operator==(right));
      }
 
      bool operator>(const GSatID& right) const
      {
         return (!operator<(right) && !operator==(right));
      }
 
      char systemChar() const
      {
         switch (system)
         {
            case SatelliteSystem::GPS:
               return 'G';
            case SatelliteSystem::Galileo:
               return 'E';
            case SatelliteSystem::Glonass:
               return 'R';
            case SatelliteSystem::Geosync:
               return 'S';
            case SatelliteSystem::Transit:
               return 'T';
            case SatelliteSystem::LEO:
               return 'L';
            case SatelliteSystem::QZSS:
               return 'J';
            case SatelliteSystem::BeiDou:
               return 'C';
            case SatelliteSystem::IRNSS:
               return 'I';
            default:
               return '?';
         }
      };
 
      std::string systemString() const
      {
         switch (system)
         {
            case SatelliteSystem::GPS:
               return "GPS";
            case SatelliteSystem::Galileo:
               return "Galileo";
            case SatelliteSystem::Glonass:
               return "Glonass";
            case SatelliteSystem::Geosync:
               return "Geosync";
            case SatelliteSystem::Transit:
               return "Transit";
            case SatelliteSystem::LEO:
               return "LEO";
            case SatelliteSystem::QZSS:
               return "QZSS";
            case SatelliteSystem::BeiDou:
               return "BeiDou";
            case SatelliteSystem::IRNSS:
               return "IRNSS";
            default:
               return "Unknown";
         }
      };
 
      void fromString(const std::string& s)
      {
         char c;
         std::istringstream iss(s);
 
         id     = -1;
         system = SatelliteSystem::GPS; // default
         if (s.find_first_not_of(std::string(" \t\n"), 0) == std::string::npos)
         {
            return; // all whitespace yields the default
         }
 
         iss >> c; // read one character (non-whitespace)
         switch (c)
         {
               // no leading system character
            case '0':
            case '1':
            case '2':
            case '3':
            case '4':
            case '5':
            case '6':
            case '7':
            case '8':
            case '9':
               iss.putback(c);
               system = SatelliteSystem::GPS;
               break;
            case 'R':
            case 'r':
               system = SatelliteSystem::Glonass;
               break;
            case 'T':
            case 't':
               system = SatelliteSystem::Transit;
               break;
            case 'S':
            case 's':
               system = SatelliteSystem::Geosync;
               break;
            case 'E':
            case 'e':
               system = SatelliteSystem::Galileo;
               break;
            case 'L':
            case 'l':
               system = SatelliteSystem::LEO;
               break;
            case ' ':
            case 'G':
            case 'g':
               system = SatelliteSystem::GPS;
               break;
            case 'J':
            case 'j':
               system = SatelliteSystem::QZSS;
               break;
            case 'C':
            case 'c':
               system = SatelliteSystem::BeiDou;
               break;
            case 'I':
            case 'i':
               system = SatelliteSystem::IRNSS;
               break;
            default: // invalid system character
               Exception e(std::string("Invalid system character \"") + c +
                           std::string("\""));
               GNSSTK_THROW(e);
         }
         iss >> id;
         if (id <= 0)
         {
            id = -1;
         }
      }
 
      std::string toString() const
      {
         std::ostringstream oss;
         char savechar = oss.fill(fillchar);
         oss << systemChar() << std::setw(2) << id << std::setfill(savechar);
         return oss.str();
      }
 
   private:
 
      GNSSTK_EXPORT
      static char fillchar;  
 
   }; // class GSatID
 
   inline std::ostream& operator<<(std::ostream& s, const GSatID& sat)
   {
      s << sat.toString();
      return s;
   }
 
} // namespace gnsstk
 
#endif
// nothing below this