GPSWeek.hpp

Go to the documentation of this file.

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

#ifndef GPSTK_GPSWEEK_HPP
#define GPSTK_GPSWEEK_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
//  
//  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 "TimeTag.hpp"

namespace gpstk
{
   class GPSWeek : public TimeTag
   {
   public:
      static const int bits10 = 0x3FF;
      static const int MAX_WEEK;

      GPSWeek( int w = 0,
               TimeSystem ts = TimeSystem::Unknown )
         throw()
            : week(w) 
      { timeSystem = ts; }
      
      virtual ~GPSWeek()
         throw()
      {}
      
      GPSWeek& operator=(const GPSWeek& right)
         throw();
      

      inline bool operator==(const GPSWeek& right) const
         throw()
      {
         if ((timeSystem != TimeSystem::Any &&
              right.timeSystem != TimeSystem::Any) &&
             timeSystem != right.timeSystem)
            return false;

         return week == right.week;
      }
      
      inline bool operator!=(const GPSWeek& right) const
         throw( gpstk::InvalidRequest )
      {
         if ((timeSystem != TimeSystem::Any &&
              right.timeSystem != TimeSystem::Any) &&
             timeSystem != right.timeSystem)
         {
            gpstk::InvalidRequest ir("CommonTime objects not in same time system, cannot be compared");
            GPSTK_THROW(ir);
         }

         return week != right.week;
      }
      
      inline bool operator<(const GPSWeek& right) const
         throw( gpstk::InvalidRequest )
      {
         if ((timeSystem != TimeSystem::Any &&
              right.timeSystem != TimeSystem::Any) &&
             timeSystem != right.timeSystem)
         {
            gpstk::InvalidRequest ir("CommonTime objects not in same time system, cannot be compared");
            GPSTK_THROW(ir);
         }

         return week < right.week;
      }
      
      inline bool operator<=(const GPSWeek& right) const
         throw( gpstk::InvalidRequest )
      {
         if ((timeSystem != TimeSystem::Any &&
              right.timeSystem != TimeSystem::Any) &&
             timeSystem != right.timeSystem)
         {
            gpstk::InvalidRequest ir("CommonTime objects not in same time system, cannot be compared");
            GPSTK_THROW(ir);
         }

         return week <= right.week;
      }
      
      inline bool operator>(const GPSWeek& right) const
         throw( gpstk::InvalidRequest )
      {
         if ((timeSystem != TimeSystem::Any &&
              right.timeSystem != TimeSystem::Any) &&
             timeSystem != right.timeSystem)
         {
            gpstk::InvalidRequest ir("CommonTime objects not in same time system, cannot be compared");
            GPSTK_THROW(ir);
         }

         return week > right.week;
      }
      
      inline bool operator>=(const GPSWeek& right) const
         throw( gpstk::InvalidRequest )
      {
         if ((timeSystem != TimeSystem::Any &&
              right.timeSystem != TimeSystem::Any) &&
             timeSystem != right.timeSystem)
         {
            gpstk::InvalidRequest ir("CommonTime objects not in same time system, cannot be compared");
            GPSTK_THROW(ir);
         }

         return week >= right.week;
      }


      inline virtual unsigned int getEpoch() const
         throw()
      {
         return week >> 10;
      }
      
      inline virtual unsigned int getWeek10() const
         throw()
      {
         return week & bits10;
      }
      
      inline virtual void getEpochWeek10(unsigned int& e, 
                                         unsigned int& w) const
         throw()
      {
         e = getEpoch(); 
         w = getWeek10();
      }
      
      inline virtual void setEpoch(unsigned int e)
         throw()
      {
         week &= bits10;
         week |= e << 10;
      }

      inline virtual void setWeek10(unsigned int w)
         throw()
      { 
         week &= ~bits10; 
         week |= w & bits10;
      }
      
      inline virtual void setEpochWeek10(unsigned int e,
                                         unsigned int w)
         throw()
      {
         setEpoch(e);
         setWeek10(w);
      }
      
      virtual std::string printf( const std::string& fmt ) const
         throw( gpstk::StringUtils::StringException );
      
      virtual std::string printError( const std::string& fmt ) const
         throw( gpstk::StringUtils::StringException );

      virtual bool setFromInfo( const IdToValue& info )
         throw();

      inline virtual std::string getPrintChars() const
         throw()
      { 
         return "EFGP";
      }
         
      inline virtual std::string getDefaultFormat() const
         throw()
      {
         return "%04F";
      }

      virtual bool isValid() const
         throw()
      {
         return (week >= 0 && week <= MAX_WEEK);
      }
      
      inline virtual void reset()
         throw()
      {
         week = 0;
      }
      
      virtual unsigned int getDayOfWeek() const
         throw() = 0;

      int week;
   };

} // namespace

#endif // GPSTK_GPSTIME_HPP

---