ossimHdf5Info.h

Go to the documentation of this file.

//----------------------------------------------------------------------------
//
// License:  MIT
// 
// See LICENSE.txt file in the top level directory for more details.
//
// Author:  David Burken
//
// Description: HDF5 Info class.
// 
//----------------------------------------------------------------------------
// $Id$

#ifndef ossimH5Info_HEADER
#define ossimH5Info_HEADER 1

#include <ossim/base/ossimConstants.h>
#include <ossim/base/ossimKeywordlist.h>
#include <ossim/support_data/ossimInfoBase.h>
#include <ossim/base/ossimFilename.h>
#include <ossim/plugin/ossimPluginConstants.h>
#include <ossim/base/ossimRefPtr.h>
#include <ossim/hdf5/ossimHdf5.h>
#include <H5Cpp.h>

class ossimEndian;

class OSSIM_DLL ossimHdf5Info : public ossimInfoBase
{
public:
   
   ossimHdf5Info();

   ossimHdf5Info(ossimHdf5* hdf5);

   virtual ~ossimHdf5Info();

   virtual bool open(const ossimFilename& file);
   
   virtual std::ostream& print(std::ostream& out) const;

   virtual bool getKeywordlist(ossimKeywordlist& kwl) const;
   virtual bool getKeywordlistDataset(ossimKeywordlist& kwl, const std::string& datasetName) const;
   virtual bool getKeywordlistGroup(ossimKeywordlist& kwl, const std::string& groupName) const;

   // Methods for printing collections. These are public to enable dumping debug information:
   std::ostream& printSubGroups (std::ostream& out, const H5::Group& obj,    const ossimString& lm=ossimString()) const;
   std::ostream& printAttributes(std::ostream& out, const H5::H5Object& obj, const ossimString& lm=ossimString()) const;
   std::ostream& printDatasets  (std::ostream& out, const H5::Group& obj,    const ossimString& lm=ossimString()) const;

   // Methods for printing individual objects:
   std::ostream& print(std::ostream& out, const H5::Group&     obj, const ossimString& lm=ossimString()) const;
   std::ostream& print(std::ostream& out, const H5::DataSet&   obj, const ossimString& lm=ossimString()) const;
   std::ostream& print(std::ostream& out, const H5::DataType&  obj, const ossimString& lm=ossimString()) const;
   std::ostream& print(std::ostream& out, const H5::DataSpace& obj, const ossimString& lm=ossimString()) const;
   std::ostream& print(std::ostream& out, const H5::Attribute& obj, const ossimString& lm=ossimString()) const;


private:
   void dumpGroup(const H5::Group& group,
                  const std::string& prefix,
                  ossim_uint32& recursedCount) const;

   void dumpDataset(const H5::DataSet& dataset, const std::string& prefix) const;

   void dumpCompound(const H5::DataSet& dataset,
                     const H5::CompType& compound,
                     const std::string& prefix)const;
   void dumpCompoundTypeInfo(const H5::CompType& compound, 
                             const std::string& prefix) const;
   void dumpEnumTypeInfo(H5::EnumType datatype, const std::string& prefix) const;
   void dumpArrayTypeInfo(H5::ArrayType datatype, const std::string& prefix) const;
   void dumpNumericalTypeInfo(const H5::DataSet& dataset,
                              ossimByteOrder order,
                              const std::string& prefix) const;
   void dumpIntType( const H5::IntType& dataType,
                     const char* dataPtr,
                     const std::string& prefix)const;
   void dumpFloatType(const H5::FloatType& dataType,
                                  const char* dataPtr,
                                  const std::string& prefix)const;
   void dumpStringType(const H5::StrType& dataType,
                       const char* dataPtr,
                       const std::string& prefix)const;
   void dumpArrayType( H5::ArrayType& dataType,
                       const char* dataPtr,
                       const std::string& prefix)const;
   void dumpNumerical(const H5::DataSet& dataset,
                      const char* dataPtr,
                      const std::string& prefix) const;

   void dumpStr(const H5::DataSet& dataset,
                const H5::StrType& dataType,
                const char* dataPtr,
                const std::string& prefix) const;

   void dumpAttributes(const H5::H5Object& container, const std::string& prefix) const;
   void dumpAttribute(const H5::Attribute& attr, const std::string& prefix) const;

   bool getGroupAttributeValue(const std::string& group,
                               const std::string& key,
                               std::string& value ) const;

   bool getDatasetAttributeValue(const std::string& objectName,
                                const std::string& key,
                                std::string& value ) const;

   ossimString getObjectPrefix(const ossimString& prefix, const ossimString& fullPathName) const;

   ossimRefPtr<ossimHdf5>  m_hdf5;
   mutable ossimKeywordlist m_kwl;
   mutable bool m_byteOrder;
};

#endif