IonexHeader.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_IONEXHEADER_HPP
#define GNSSTK_IONEXHEADER_HPP
 
#include <string>
#include <vector>
#include <map>
 
#include "CommonTime.hpp"
#include "SatID.hpp"
#include "IonexBase.hpp"
#include "gnsstk_export.h"
 
namespace gnsstk
{
 
 
 
 
 
   class IonexHeader : public IonexBase
   {
   public:
 
      IonexHeader();
 
 
      void clear();
 
 
      GNSSTK_EXPORT
      static const std::string versionString;         
      GNSSTK_EXPORT
      static const std::string runByString;           
      GNSSTK_EXPORT
      static const std::string descriptionString;     
      GNSSTK_EXPORT
      static const std::string commentString;         
      GNSSTK_EXPORT
      static const std::string firstTimeString;       
      GNSSTK_EXPORT
      static const std::string lastTimeString;        
      GNSSTK_EXPORT
      static const std::string intervalString;        
      GNSSTK_EXPORT
      static const std::string numMapsString;         
      GNSSTK_EXPORT
      static const std::string mappingFunctionString; 
      GNSSTK_EXPORT
      static const std::string elevationString;       
      GNSSTK_EXPORT
      static const std::string observablesUsedString; 
      GNSSTK_EXPORT
      static const std::string numStationsString;     
      GNSSTK_EXPORT
      static const std::string numSatsString;         
      GNSSTK_EXPORT
      static const std::string baseRadiusString;      
      GNSSTK_EXPORT
      static const std::string mapDimensionString;    
      GNSSTK_EXPORT
      static const std::string hgtGridString;         
      GNSSTK_EXPORT
      static const std::string latGridString;         
      GNSSTK_EXPORT
      static const std::string lonGridString;         
      GNSSTK_EXPORT
      static const std::string exponentString;        
      GNSSTK_EXPORT
      static const std::string startAuxDataString;    
      GNSSTK_EXPORT
      static const std::string endAuxDataString;      
      GNSSTK_EXPORT
      static const std::string endOfHeader;           
 
 
         // Differential Code Bias structure
      struct DCB
      {
            // If isPRN is true, system and prn are set, otherwise
            // name and number are set.  bias and rms should always be
            // set.
         char system;   
         int prn;       
         double bias;   
         double rms;    
         bool isPRN;    
         std::string name;   
         std::string number; 
 
         DCB();
 
         DCB(char s, int p, double b, double r);
 
         DCB(const std::string& s, const std::string& n, double b, double r);
 
         GNSSTK_EXPORT
         static const std::string svsAuxDataString;      
         GNSSTK_EXPORT
         static const std::string stationsAuxDataString; 
 
 
         std::string toString() const;
      }; // End of 'DCB' data structure
 
 
      double version;            
 
      std::string fileType;      
      std::string system;        
      std::string fileProgram;   
      std::string fileAgency;    
      std::string date;          
 
      std::vector<std::string> descriptionList;
      std::vector<std::string> commentList;    
 
      CommonTime firstEpoch;           
      CommonTime lastEpoch;            
 
      int interval;                 
      size_t numMaps;               
      std::string mappingFunction;  
      double elevation;             
      std::string observablesUsed;  
 
      size_t numStations;       
      size_t numSVs;            
 
      double baseRadius;  
      size_t mapDims;     
 
      double hgt[3];    
      double lat[3];    
      double lon[3];    
 
      int exponent;    
      std::string auxData;          
 
      typedef std::map<SatID,DCB> SatDCBMap;
      typedef std::map<std::string,DCB> StaDCBMap;
 
      SatDCBMap svsmap;    
      StaDCBMap stamap;    
      bool auxDataFlag;    
 
      bool valid;
 
      virtual ~IonexHeader();
 
 
         // IonexHeader is a "header" so this function always returns true.
      virtual bool isHeader() const
      { return true; }
 
 
      virtual void dump(std::ostream& s = std::cout) const;
 
 
      void parseDcbRecord(const std::string& line);
 
 
      void parseHeaderRecord(const std::string& line);
 
 
      void writeHeaderRecords(FFStream& s) const;
 
 
 
   protected:
 
 
      void reallyPutRecord(FFStream& s) const override;
 
 
      void reallyGetRecord(FFStream& s) override;
 
   private:
      std::string writeTime(const CommonTime& dt) const;
 
 
      CommonTime parseTime(const std::string& line) const;
   }; // End of class 'IonexHeader'
 
 
}  // End of namespace gnsstk
#endif   // GNSSTK_IONEXHEADER_HPP