IonexHeader.hpp

Go to the documentation of this file.

#pragma ident "$Id: IonexHeader.hpp 3140 2012-06-18 15:03:02Z susancummins $"

#ifndef GPSTK_IONEXHEADER_HPP
#define GPSTK_IONEXHEADER_HPP

//============================================================================
//
//  This file is part of GPSTk, the GPS Toolkit.
//
//  The GPSTk 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 2.1 of the License, or
//  any later version.
//
//  The GPSTk 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 GPSTk; if not, write to the Free Software Foundation,
//  Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110, USA
//
//  Octavian Andrei - FGI ( http://www.fgi.fi ). 2008
//
//============================================================================


#include <string>
#include <vector>
#include <map>

#include "CommonTime.hpp"
#include "SatID.hpp"
#include "IonexBase.hpp"

namespace gpstk
{




   class IonexHeader : public IonexBase
   {
   public:

      IonexHeader() : version(1.0), exponent(-1), valid(false) {}


      void clear(void);


      static const std::string versionString;            
      static const std::string runByString;              
      static const std::string descriptionString;        
      static const std::string commentString;            
      static const std::string firstTimeString;          
      static const std::string lastTimeString;           
      static const std::string intervalString;           
      static const std::string numMapsString;            
      static const std::string mappingFunctionString;    
      static const std::string elevationString;          
      static const std::string observablesUsedString;    
      static const std::string numStationsString;        
      static const std::string numSatsString;            
      static const std::string baseRadiusString;         
      static const std::string mapDimensionString;       
      static const std::string hgtGridString;            
      static const std::string latGridString;            
      static const std::string lonGridString;            
      static const std::string exponentString;           
      static const std::string startAuxDataString;       
      static const std::string endAuxDataString;         
      static const std::string endOfHeader;              


         // Differential Code Bias structure
      struct DCB
      {

         char system;   


         int prn;       
         double bias;   
         double rms;    


         DCB() : system('U'), prn(-1), bias(0), rms(0.0) {};


         DCB(char s, int p, double b, double r)
            : system(s), prn(p), bias(b), rms(r)
         {};


         static const std::string svsAuxDataString;   
         static const std::string stationsAuxDataString;


         std::string toString() const throw()
         {
            std::string line(3, ' ');
            line += std::string(3, '0');

               // update with the system char
            line[3] = system;

               // convert the prn into 2-digit string
            std::string s = StringUtils::asString(prn);
            if (prn < 10)
            {
               line[5] = s[0];
            }
            else
            {
               line[4] = s[0];
               line[5] = s[1];
            }

               // append bias and rms
            line += StringUtils::rightJustify( 
                                 StringUtils::asString(bias,3), 10 );
            line += StringUtils::rightJustify( 
                                 StringUtils::asString(rms, 3), 10 );

            return line;

         }  // End of method 'DCB::toString()'

      }; // 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;

      SatDCBMap svsmap;    
      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(std::string &line)
         throw (FFStreamError);


      void ParseHeaderRecord(std::string& line)
         throw(FFStreamError);


      void WriteHeaderRecords(FFStream& s) const
         throw(FFStreamError, gpstk::StringUtils::StringException);



   protected:


      virtual void reallyPutRecord(FFStream& s) const
         throw( std::exception, FFStreamError, StringUtils::StringException );


      virtual void reallyGetRecord(FFStream& s)
         throw( std::exception, FFStreamError, StringUtils::StringException);


         // Not sure how it helps (seen in SP3Header and RinexObsHeader)
      friend class IonexData;



   private:
      std::string writeTime(const CommonTime& dt) const;


      CommonTime parseTime(const std::string& line) const;



   }; // End of class 'IonexHeader'




}  // End of namespace gpstk
#endif   // GPSTK_IONEXHEADER_HPP

---