RinexMetHeader.hpp

Go to the documentation of this file.

#pragma ident "$Id: RinexMetHeader.hpp 438 2007-03-21 17:22:21Z btolman $"



#ifndef GPSTK_RINEXMETHEADER_HPP
#define GPSTK_RINEXMETHEADER_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., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
//  
//  Copyright 2004, The University of Texas at Austin
//
//============================================================================

//============================================================================
//
//This software 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.
//
//=============================================================================






#include "StringUtils.hpp"
#include "FFStream.hpp"
#include "RinexMetBase.hpp"

#include "Triple.hpp"

namespace gpstk
{

   class RinexMetHeader : public RinexMetBase
   {
   public:
      enum RinexMetType 
      {
         PR,        
         TD,        
         HR,        
         ZW,        
         ZD,        
         ZT,        
         WD,        
         WS,        
         RI,        
         HI         
      };

      RinexMetHeader() : valid(0), version(2.1) {}

      virtual ~RinexMetHeader() {}

         // The next four lines is our common interface
      virtual bool isHeader(void) const {return true;}

      virtual void dump(std::ostream& s) const;

      static RinexMetType convertObsType(const std::string& oneObs) 
         throw(FFStreamError);
      
      static std::string convertObsType(const RinexMetType& oneObs)
         throw(FFStreamError);
   
      unsigned long valid;

      enum validBits
      {
         versionValid = 0x01,        
         runByValid = 0x02,          
         commentValid = 0x04,        
         markerNameValid = 0x08,     
         markerNumberValid = 0x010,  
         obsTypeValid = 0x020,        
         sensorTypeValid = 0x040,    
         sensorPosValid = 0x080,     


         endValid = 0x080000000,          

         allValid20 = 0x0800000EB,
         allValid21 = 0x0800000EB
      };


      static inline std::string bitsAsString(validBits b)
      {
         switch (b)
         {
            case versionValid:
               return versionString;
            case runByValid:
               return runByString;
            case commentValid:
               return commentString;
            case markerNameValid:
               return markerNameString;
            case markerNumberValid:
               return markerNumberString;
            case obsTypeValid:
               return obsTypeString;
            case sensorTypeValid:
               return sensorTypeString;
            case sensorPosValid:
               return sensorPosString;
            case endValid:
               return endOfHeader;
         }

         return "*UNKNOWN/INVALID BITS*";
      }

         /* @return a string composed the RINEX header strings
          * represented by the validBits set in vb, surrounded by the
          * quote character, separated by sep.
          * @param vb bit field with valid bits set
          * @param quote quote character to use around RINEX header strings.
          * @param sep separator used between rinex header strings.
          */
      static std::string bitString(unsigned long vb, char quote='\"',
                                   std::string sep=", ");


      struct sensorType
      {
         std::string model;         
         std::string type;          
         double accuracy;      
         RinexMetType obsType; 
      };

      struct sensorPosType
      {
         gpstk::Triple position;   
         double height;
         RinexMetType obsType;
      };

      double version;           

      std::string fileType;                      
      std::string fileProgram;                   
      std::string fileAgency;                    
      std::string date;                          
      std::vector<std::string> commentList;           
      std::string markerName;                    
      std::string markerNumber;                  

      std::vector<RinexMetType> obsTypeList;
      std::vector<sensorType> sensorTypeList;    
      std::vector<sensorPosType> sensorPosList;  


      static const int maxObsPerLine;       

      static const std::string versionString;       
      static const std::string runByString;         
      static const std::string commentString;       
      static const std::string markerNameString;    
      static const std::string markerNumberString;  
      static const std::string obsTypeString;       
      static const std::string sensorTypeString;    
      static const std::string sensorPosString;     
      static const std::string endOfHeader;         


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

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


   }; // class RinexMetHeader


} // namespace

#endif

---