SP3Header.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_SP3HEADER_HPP
#define GNSSTK_SP3HEADER_HPP
 
#include <string>
#include <map>
#include <vector>
#include "SP3Base.hpp"
#include "SP3SatID.hpp"
#include "CommonTime.hpp"
#include "TimeSystem.hpp"
 
namespace gnsstk
{
 
 
   class SP3Header : public SP3Base
   {
   public:
 
      enum Version
      {
         undefined,        
         SP3a,             
         SP3b,             
         SP3c,             
         SP3d              
      };
 
      SP3Header() : version(undefined), numberOfEpochs(0),
                    system(1, SatelliteSystem::GPS), timeSystem(TimeSystem::Any),
                    basePV(0.0), baseClk(0.0), allowSP3aEvents(false)
      {}
 
      virtual ~SP3Header() {}
 
      Version getVersion(void) const noexcept { return version; }
 
      char versionChar(void) const noexcept
      {
         return versionChar(version);
      }
 
      static char versionChar(Version ver) noexcept
      {
         char ch;
         switch(ver) {
            case SP3a:
               ch = 'a'; break;
            case SP3b:
               ch = 'b'; break;
            case SP3c:
               ch = 'c'; break;
            case SP3d:
               ch = 'd'; break;
            case undefined: default:
               ch = 'U'; break;
         };
         return ch;
      }
 
      std::string versionString(void) const noexcept
      {
         return versionString(version);
      }
 
      static std::string versionString(Version ver) noexcept
      {
         std::string str;
         switch(ver) {
            case SP3a:
               str = std::string("SP3a"); break;
            case SP3b:
               str = std::string("SP3b"); break;
            case SP3c:
               str = std::string("SP3c"); break;
            case SP3d:
               str = std::string("SP3d"); break;
            case undefined: default:
               str = std::string("Undefined"); break;
         };
         return str;
      }
 
      Version setVersion(const Version ver) noexcept
      {
         Version oldFormat = version;
         version = ver;
         return oldFormat;
      }
 
      std::string timeSystemString() const noexcept
      { return gnsstk::StringUtils::asString(timeSystem); };
 
         // The next four lines is our common interface
      virtual bool isHeader() const { return true; }
 
      virtual void dump(std::ostream& s=std::cout) const noexcept;
 
      Version version;           
      bool containsVelocity;     
      bool allowSP3aEvents;      
      CommonTime time;           
      double epochInterval;      
      int numberOfEpochs;        
      std::string dataUsed;      
      std::string coordSystem;   
      std::string orbitType;     
      std::string agency;        
 
         // the following are specific to version 'c'
      SP3SatID system;        
      TimeSystem timeSystem;  
      double basePV;          
      double baseClk;         
      std::map<SP3SatID, short> satList;
      std::vector<std::string> comments;
 
      friend class SP3Data;
 
   protected:
      virtual void reallyPutRecord(FFStream& s) const;
 
      virtual void reallyGetRecord(FFStream& s);
 
   }; // end class SP3Header
 
 
}  // namespace
 
#endif