ossimSpot6DimapSupportData.h

Go to the documentation of this file.

//*******************************************************************
// Copyright (C) 2014  Centre National Etudes Spatiales
//
// This library 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 of the License, or (at your option) any later version.
//
// This library 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 this library; if not, write to the Free Software
// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
//
// Author : Christophe Palmann (christophe.palmann@c-s.fr)
//
// Description:
//
// Contains declaration of class ossimSpot6DimapSupportData
//
//*****************************************************************************
#ifndef ossimSpot6DimapSupportData_HEADER
#define ossimSpot6DimapSupportData_HEADER 1

#include <ossim/plugin/ossimPluginConstants.h>

#include <ossim/base/ossimConstants.h>
#include <ossim/base/ossimIpt.h>
#include <ossim/base/ossimObject.h>
#include <ossim/base/ossimString.h>

#include <ossim/base/ossimErrorStatusInterface.h>

#include <ossim/base/ossimBooleanProperty.h>
#include <ossim/base/ossimFilename.h>

#include <ossim/base/ossimRefPtr.h>
#include <ossim/base/ossimDpt.h>
#include <ossim/base/ossimDpt3d.h>
#include <ossim/base/ossimDrect.h>
#include <ossim/base/ossimGpt.h>


#include <vector>
#include <iostream>


class ossimKeywordlist;
class ossimXmlDocument;

namespace ossimplugins
{
   class OSSIM_PLUGINS_DLL ossimSpot6DimapSupportData : public ossimObject,
      public ossimErrorStatusInterface
   {
   public:
      enum ossimSpot6DIMAPVersion
      {
         OSSIM_Spot6_UNKNOWN,
         OSSIM_Spot6_DIMAPv2
      };
      
      enum ossimSpot6MetadataSubProfile
      {
         OSSIM_Spot6_METADATA_SUBPROFILE_UNKNOWN = 0,
         OSSIM_Spot6_METADATA_SUBPROFILE_PRODUCT = 1,
         OSSIM_Spot6_METADATA_SUBPROFILE_RPC = 2
      };
      
      ossimSpot6DimapSupportData();
      
      virtual ~ossimSpot6DimapSupportData();
      
      void clearFields();

      bool parseXmlFile(const ossimFilename& file);

      //---
      // Convenient method to print important image info:
      //---
      void  printInfo (ostream& os) const;

      virtual bool saveState(ossimKeywordlist& kwl,
                             const char* prefix = 0)const;
      virtual bool loadState(const ossimKeywordlist& kwl,
                             const char* prefix = 0);

      ossimString   getSensorID()                            const;
      ossimString   getProcessingLevel()                     const;
      ossimString   getAcquisitionDate()                     const;
      ossimString   getProductionDate()                      const;
      ossimString   getImageID()                             const;
      ossimString   getInstrument()                          const;
      ossimString   getInstrumentIndex()                     const;

      ossim_uint32  getNumberOfBands()                       const;
      void          getSunAzimuth(std::vector<ossim_float64>& az)         const;
      void          getSunElevation(std::vector<ossim_float64>& el)       const;
      void          getImageSize(ossimIpt& sz)               const;

      void          getIncidenceAngle(std::vector<ossim_float64>& ia)     const;
      void          getViewingAngle(std::vector<ossim_float64>& va)       const;

      //---
      // Corner points:
      //---
      void getUlCorner(ossimGpt& pt) const;
      void getUrCorner(ossimGpt& pt) const;
      void getLrCorner(ossimGpt& pt) const;
      void getLlCorner(ossimGpt& pt) const;

      //---
      // Image center point:
      //---

      void getRefGroundPoint(ossimGpt& gp)         const;

      void getRefImagePoint(ossimDpt& rp)          const;

      void getImageRect(ossimDrect& rect)const;

      bool allMetadataRead(){return (theProductIsOk && theRpcIsOk);};

      std::vector<double> getLineNumCoeff() const {return theLineNumCoeff;};
      std::vector<double> getLineDenCoeff() const {return theLineDenCoeff;};
      std::vector<double> getSampNumCoeff() const {return theSampNumCoeff;};
      std::vector<double> getSampDenCoeff() const {return theSampDenCoeff;};

      ossim_int32 getLineOffset() const {return theLineOffset;};
      ossim_int32 getSampOffset() const {return theSampOffset;};
      double getLatOffset()       const {return theLatOffset;};
      double getLonOffset()       const {return theLonOffset;};
      double getHeightOffset()    const {return theHeightOffset;};
      double getLineScale()       const {return theLineScale;};
      double getSampScale()       const {return theSampScale;};
      double getLatScale()        const {return theLatScale;};
      double getLonScale()        const {return theLonScale;};
      double getHeightScale()     const {return theHeightScale;};



   private:
      ossimSpot6DIMAPVersion theDIMAPVersion;
      ossimSpot6MetadataSubProfile theMetadataSubProfile; // only for DIMAPv2
      bool theProductIsOk;
      bool theRpcIsOk;
      ossimString theXmlDocumentRoot;

      ossimString                 theSensorID;
      ossimString                 theImageID;
      ossimString                 theProductionDate;
      ossimString                 theAcquisitionDate;
      ossimString                 theInstrument;
      ossimString                 theInstrumentIndex;
      ossimString                 theProcessingLevelString;
      ossimString                 theSpectralProcessingString;

      std::vector<ossim_float64>  theSunAzimuth;
      std::vector<ossim_float64>  theSunElevation;
      std::vector<ossim_float64>  theIncidenceAngle;
      std::vector<ossim_float64>  theViewingAngle;
      std::vector<ossim_float64>  theAzimuthAngle;
   
      ossimIpt                    theImageSize;
      ossimIpt                    theTileSize;
      ossim_uint32                theNumberOfMegaTilesInRow;
      ossim_uint32                theNumberOfMegaTilesInCol;
      ossim_uint32                theNumberOfMegaTiles;
      ossimBooleanProperty        theMultiDataFile;

      ossim_uint32                theNumBands;
      std::vector<ossimString>    theBandOrder;

      std::vector<ossim_float64> thePhysicalBias;
      std::vector<ossim_float64> thePhysicalGain;
      std::vector<ossim_float64> theSolarIrradiance;

      //---
      // Corner points:
      //---
      ossimGpt theUlCorner;
      ossimGpt theUrCorner;
      ossimGpt theLrCorner;
      ossimGpt theLlCorner;

      // RPC parameters
      ossimString theSpecId;
      double    theErrBias;
      double    theErrBiasX;
      double    theErrBiasY;
      double    theErrRand;
      ossim_int32 theLineOffset;
      ossim_int32 theSampOffset;
      double    theLatOffset;
      double    theLonOffset;
      double    theHeightOffset;
      double    theLineScale;
      double    theSampScale;
      double    theLatScale;
      double    theLonScale;
      double    theHeightScale;

      std::vector<double> theLineNumCoeff;
      std::vector<double> theLineDenCoeff;
      std::vector<double> theSampNumCoeff;
      std::vector<double> theSampDenCoeff;


      //--- TODO MSD Check if it is necessary to keep that
      ossimGpt                    theRefGroundPoint;

      ossimDpt                    theRefImagePoint;


      ossimGpt createGround(const ossimString& s)const;
      ossimDpt createDpt(const ossimString& s)const;
      ossimIpt createIpt(const ossimString& s)const;
      //---

      bool parseRPCMetadata(ossimRefPtr<ossimXmlDocument> xmlDocument);

      bool parseMetadataIdentificationDIMAPv2(ossimRefPtr<ossimXmlDocument> xmlDocument);

      bool parseDatasetIdentification(ossimRefPtr<ossimXmlDocument> xmlDocument);

      bool parseDatasetContent(ossimRefPtr<ossimXmlDocument> xmlDocument);

      bool parseProductInformation(ossimRefPtr<ossimXmlDocument> xmlDocument);

      bool parseCoordinateReferenceSystem(ossimRefPtr<ossimXmlDocument> xmlDocument);

      bool parseGeoposition(ossimRefPtr<ossimXmlDocument> xmlDocument);

      bool parseProcessingInformation(ossimRefPtr<ossimXmlDocument> xmlDocument);

      bool parseRasterData(ossimRefPtr<ossimXmlDocument> xmlDocument);

      bool parseRadiometricData(ossimRefPtr<ossimXmlDocument> xmlDocument);

      bool parseGeometricData(ossimRefPtr<ossimXmlDocument> xmlDocument);

      bool parseQualityAssessment(ossimRefPtr<ossimXmlDocument> xmlDocument);

      bool parseDatasetSources(ossimRefPtr<ossimXmlDocument> xmlDocument);

   };
}
#endif /* #ifndef ossimSpot6DimapSupportData_HEADER */