#include <ossimH5Reader.h>

Inheritance diagram for ossimH5ImageHandler:

Public Member Functions
	ossimH5ImageHandler ()
	default constructor More...

virtual	~ossimH5ImageHandler ()
	virtual destructor More...

virtual ossimString	getShortName () const

virtual ossimString	getLongName () const

virtual ossimString	getClassName () const

virtual ossimRefPtr< ossimImageData >	getTile (const ossimIrect &rect, ossim_uint32 resLevel=0)
	Returns a pointer to a tile given an origin representing the upper left corner of the tile to grab from the image. More...

virtual bool	getTile (ossimImageData *result, ossim_uint32 resLevel=0)
	Method to get a tile. More...

virtual ossim_uint32	getNumberOfInputBands () const
	Returns the number of bands in the image. More...

virtual ossim_uint32	getNumberOfOutputBands () const
	Returns the number of bands in a tile returned from this TileSource. More...

virtual ossim_uint32	getNumberOfLines (ossim_uint32 reduced_res_level=0) const
	Returns the number of lines in the image. More...

virtual ossim_uint32	getNumberOfSamples (ossim_uint32 reduced_res_level=0) const
	Returns the number of samples in the image. More...

virtual ossimIrect	getImageRectangle (ossim_uint32 reduced_res_level=0) const
	Returns the zero based image rectangle for the reduced resolution data set (rrds) passed in. More...

virtual bool	saveState (ossimKeywordlist &kwl, const char *prefix=0) const
	Method to save the state of an object to a keyword list. More...

virtual bool	loadState (const ossimKeywordlist &kwl, const char *prefix=0)
	Method to the load (recreate) the state of an object from a keyword list. More...

virtual ossimScalarType	getOutputScalarType () const
	Returns the output pixel type of the tile source. More...

virtual ossim_uint32	getImageTileWidth () const
	Returns the tile width of the image or 0 if the image is not tiled. More...

virtual ossim_uint32	getImageTileHeight () const
	Returns the tile width of the image or 0 if the image is not tiled. More...

bool	isOpen () const
	Derived classes must implement this method to be concrete. More...

virtual void	close ()
	Close method. More...

virtual ossim_uint32	getNumberOfEntries () const

virtual void	getEntryNames (std::vector< ossimString > &entryNames) const
	Get the name of entry as a string. More...

virtual void	getEntryList (std::vector< ossim_uint32 > &entryList) const

virtual bool	setCurrentEntry (ossim_uint32 entryIdx)

virtual ossim_uint32	getCurrentEntry () const

virtual ossimRefPtr< ossimImageGeometry >	getImageGeometry ()
	Returns the image geometry object associated with this tile source or NULL if non defined. More...

virtual double	getNullPixelValue (ossim_uint32 band=0) const

virtual void	setProperty (ossimRefPtr< ossimProperty > property)
	Set propterty method. More...

virtual ossimRefPtr< ossimProperty >	getProperty (const ossimString &name) const
	Get propterty method. More...

virtual void	getPropertyNames (std::vector< ossimString > &propertyNames) const
	Get propterty names. More...

virtual void	addMetadata (ossimKeywordlist *kwl, const std::string &prefix) const
	Adds metadata to keyword list. More...

Public Member Functions inherited from ossimImageHandler
	ossimImageHandler ()
	Constructor (default): More...

virtual	~ossimImageHandler ()
	Destructor: Derived classes should implement. More...

virtual void	initialize ()
	initialize Does nothing in this class. More...

virtual bool	openOverview ()
	Searches for an overview. More...

virtual bool	openOverview (const ossimFilename &overview_file)
	Calls closeOverview(), then attempts to open the overview_file. More...

virtual void	closeOverview ()
	If theOverview is initialized it will be deleted and set to NULL. More...

virtual const ossimImageHandler *	getOverview () const

virtual bool	hasOverviews () const

virtual ossimFilename	createDefaultOverviewFilename () const

virtual ossimFilename	createDefaultGeometryFilename () const

virtual ossimFilename	createDefaultMetadataFilename () const

virtual ossimFilename	createDefaultHistogramFilename () const

virtual ossimFilename	createDefaultValidVerticesFilename () const

virtual bool	writeValidImageVertices (const std::vector< ossimIpt > &vertices, const ossimFilename &file=ossimFilename(""))
	Outputs vertices to file and updates the internal vertex array variable "theValidImageVertices". More...

virtual bool	openValidVertices (const ossimFilename &vertices_file)
	Opens the valid image vertices file and sets theValidImageVerticesFile variable. More...

virtual bool	openValidVertices ()
	Creates vertices file name based on image, then tries to open. More...

virtual bool	open (const ossimFilename &imageFile, ossim_uint32 entryIndex)
	Opens the image file. More...

virtual bool	open (const ossimFilename &imageFile)

virtual bool	open (std::shared_ptr< ossim::ImageHandlerState > state)

virtual bool	buildHistogram (int numberOfRLevels=0, ossimHistogramMode mode=OSSIM_HISTO_MODE_NORMAL)
	Build a histogram for image file. More...

virtual bool	buildAllHistograms (int numberOfRLevels=0, ossimHistogramMode mode=OSSIM_HISTO_MODE_NORMAL)
	Build a histograms for all image entries. More...

virtual bool	buildOverview (ossimImageHandlerOverviewCompressionType compressionType=OSSIM_OVERVIEW_COMPRESSION_NONE, ossim_uint32 quality=75, ossimFilterResampler::ossimFilterResamplerType resampleType=ossimFilterResampler::ossimFilterResampler_BOX, bool includeFullResFlag=false)
	Will build over file for theImageFile. More...

virtual bool	buildAllOverviews (ossimImageHandlerOverviewCompressionType compressionType=OSSIM_OVERVIEW_COMPRESSION_NONE, ossim_uint32 quality=75, ossimFilterResampler::ossimFilterResamplerType resampleType=ossimFilterResampler::ossimFilterResampler_BOX, bool includeFullResFlag=false)
	Will build over file for all image entries. More...

virtual bool	buildOverview (const ossimFilename &filename, ossimImageHandlerOverviewCompressionType compressionType=OSSIM_OVERVIEW_COMPRESSION_NONE, ossim_uint32 quality=75, ossimFilterResampler::ossimFilterResamplerType resampleType=ossimFilterResampler::ossimFilterResampler_BOX, bool includeFullResFlag=false)
	Will build an over file for filename. More...

ossimRefPtr< ossimMultiResLevelHistogram >	getImageHistogram () const
	Fetches the current entry image's histogram. More...

virtual void	setImageGeometry (ossimImageGeometry *geom)
	Sets the image geometry object. More...

virtual void	saveImageGeometry () const
	Saves the image geometry to a file that will be made based on the image file name. More...

virtual void	saveImageGeometry (const ossimFilename &geometry_file) const
	Saves the image geometry to a file that will be made based on the image file name. More...

virtual ossimIrect	getBoundingRect (ossim_uint32 resLevel=0) const
	Returns zero-based bounding rectangle of the image. More...

virtual void	getDecimationFactor (ossim_uint32 resLevel, ossimDpt &result) const

virtual void	getDecimationFactors (vector< ossimDpt > &decimations) const
	This returns all decimation for all levels. More...

virtual ossim_uint32	getNumberOfDecimationLevels () const
	This returns the total number of decimation levels. More...

virtual ossim_uint32	getNumberOfReducedResSets () const
	This method is obsolete. More...

virtual void	setFilename (const ossimFilename &filename)
	Sets the filename. More...

virtual const ossimFilename &	getFilename () const
	Returns the filename. More...

virtual bool	isValidRLevel (ossim_uint32 resLevel) const
	Determines if the passed in reslution level is valid. More...

bool	canConnectMyInputTo (ossim_int32 inputIndex, const ossimConnectableObject *object) const
	Connection rule. More...

virtual void	getValidImageVertices (vector< ossimIpt > &validVertices, ossimVertexOrdering ordering=OSSIM_CLOCKWISE_ORDER, ossim_uint32 resLevel=0) const
	ordering specifies how the vertices should be arranged. More...

virtual bool	isBandSelector () const
	Indicates whether or not the image handler can control output band selection via the setOutputBandList method. More...

virtual bool	setOutputBandList (const std::vector< ossim_uint32 > &band_list)
	If the image handler "isBandSeletor()" then the band selection of the output chip can be controlled. More...

virtual bool	setOutputToInputBandList ()
	If the image handler "isBandSeletor()" then the band selection of the output are set to input or identity. More...

virtual bool	isIdentityBandList (const std::vector< ossim_uint32 > &bandList) const
	Convenience method to see if band list is identity. More...

virtual bool	isImageTiled () const
	Indicates whether or not the image is tiled internally. More...

virtual bool	hasMetaData () const

virtual ossimRefPtr< ossimNBandLutDataObject >	getLut () const

virtual bool	hasLut () const

virtual void	loadMetaData ()
	There is an external file with an omd extension. More...

virtual double	getMinPixelValue (ossim_uint32 band=0) const
	Retuns the min pixel value. More...

virtual double	getMaxPixelValue (ossim_uint32 band=0) const
	Returns the max pixel of the band. More...

virtual void	setMinPixelValue (ossim_uint32 band, const ossim_float64 &pix)
	convenience method to set min pixel value. More...

virtual void	setMaxPixelValue (ossim_uint32 band, const ossim_float64 &pix)
	convenience method to set max pixel value. More...

virtual void	setNullPixelValue (ossim_uint32 band, const ossim_float64 &pix)
	convenience method to set null pixel value. More...

virtual void	getEntryName (ossim_uint32 entryIdx, std::string &name) const
	Get the name of entry as a string. More...

bool	useEntryIndex () const
	Convenience method to determine if entry index should be used for support files, e.g. More...

ossimFilename	getOverviewFile () const

ossimFilename	getFilenameWithThisExtension (const ossimString &ext, bool set_e0_prefix=false) const
	Returns the image file with extension set using supplentary directory for dirname if set. More...

void	getFilenameWithThisExt (const ossimString &ext, ossimFilename &f) const
	Returns the image file with extension set using supplentary directory for dirname if set. More...

ossim_uint32	getStartingResLevel () const

void	setStartingResLevel (ossim_uint32 level)

bool	getOpenOverviewFlag () const

void	setOpenOverviewFlag (bool flag)
	Sets theOpenOverviewFlag. More...

virtual void	setSupplementaryDirectory (const ossimFilename &dir)
	Sets the supplementary directory. More...

virtual const ossimFilename &	getSupplementaryDirectory () const
	Returns the supplementary directory. More...

const ossimString &	getImageID () const
	Fetches the image ID. More...

void	setImageID (const ossimString &id)
	Sets the image ID in case it is externally generated. More...

ossimPixelType	getPixelType () const
	Returns the raster pixel alignment type. More...

virtual bool	getRgbBandList (std::vector< ossim_uint32 > &bandList) const
	Convenience method to get the zero based rgb output band list. More...

template<class T >
std::shared_ptr< T >	getStateAs ()

template<class T >
std::shared_ptr< const T >	getStateAs () const

std::shared_ptr< ossim::ImageHandlerState >	getState ()

std::shared_ptr< const ossim::ImageHandlerState >	getState () const

void	setState (std::shared_ptr< ossim::ImageHandlerState > state)

Public Member Functions inherited from ossimImageSource
	ossimImageSource (ossimObject *owner=0)

	ossimImageSource (ossimObject *owner, ossim_uint32 inputListSize, ossim_uint32 outputListSize, bool inputListIsFixedFlag=true, bool outputListIsFixedFlag=true)

virtual	~ossimImageSource ()

virtual ossimRefPtr< ossimImageData >	getTile (const ossimIpt &origin, ossim_uint32 resLevel=0)

virtual ossimObject *	getObject ()
	For RTTI support. More...

virtual const ossimObject *	getObject () const
	For RTTI support. More...

virtual void	getDecimationFactors (std::vector< ossimDpt > &decimations) const
	Will return an array of all decimations for each resolution level. More...

virtual void	getOutputBandList (std::vector< ossim_uint32 > &bandList) const
	Initializes bandList. More...

virtual ossim_uint32	getTileWidth () const
	Returns the default processing tile width. More...

virtual ossim_uint32	getTileHeight () const
	Returns the default processing tile height. More...

virtual void	getBoundingRect (ossimIrect &rect, ossim_uint32 resLevel=0) const
	Gets the bounding rectangle of the source. More...

virtual void	getValidImageVertices (std::vector< ossimIpt > &validVertices, ossimVertexOrdering ordering=OSSIM_CLOCKWISE_ORDER, ossim_uint32 resLevel=0) const
	ordering specifies how the vertices should be arranged. More...

virtual void	setImageGeometry (const ossimImageGeometry *geom)
	Default implementation sets geometry of the first input to the geometry specified. More...

virtual bool	isIndexedData () const

Public Member Functions inherited from ossimSource
	ossimSource (ossimObject *owner=0)

	ossimSource (ossimObject *owner, ossim_uint32 inputListSize, ossim_uint32 outputListSize, bool inputListIsFixedFlag=true, bool outputListIsFixedFlag=true)

virtual	~ossimSource ()

virtual bool	isSourceEnabled () const

virtual void	enableSource ()

virtual void	disableSource ()

virtual bool	getEnableFlag () const

virtual void	setEnableFlag (bool flag)

virtual bool	isInitialized () const

virtual void	setInitializedFlag (bool flag)

virtual std::ostream &	print (std::ostream &out) const
	Outputs theErrorStatus as an ossimErrorCode and an ossimString. More...

Public Member Functions inherited from ossimConnectableObject
	ossimConnectableObject (ossimObject *owner=0)
	Base constructor of this object. More...

	ossimConnectableObject (ossimObject *owner, ossim_int32 inputListSize, ossim_int32 outputListSize, bool inputListIsFixedFlag=true, bool outputListIsFixedFlag=true)

virtual	~ossimConnectableObject ()

void	setId (const ossimId &id)
	All connectable objects will have id's. More...

const ossimId &	getId () const
	Will allow us to get this object's id. More...

const ossimObject *	getOwner () const
	Fetches the current owner, most likely a container but not limited to one. More...

virtual void	changeOwner (ossimObject *owner)
	Permits changing the object's owner. More...

virtual void	setDescription (const ossimString &description)

virtual ossimString	getDescription () const

virtual bool	isConnected (ossimConnectableObjectDirectionType direction=CONNECTABLE_DIRECTION_INPUT) const
	will check the direction specified to see if all slots are full. More...

	OSSIM_DEPRECATE_METHOD (virtual ossimConnectableObject *findConnectableObject(const ossimId &id))

	OSSIM_DEPRECATE_METHOD (virtual ossimConnectableObject *findObjectOfType(RTTItypeid typeId, ossimConnectableObjectDirectionType directionType, bool recurse=true))

	OSSIM_DEPRECATE_METHOD (virtual ossimConnectableObject *findObjectOfType(const ossimString &obj, ossimConnectableObjectDirectionType directionType, bool recurse=true))

	OSSIM_DEPRECATE_METHOD (virtual ossimConnectableObject *findInputObjectOfType(const ossimString &className))

virtual ossim_int32	findInputIndex (const ossimConnectableObject *object)
	Return a valid index of the input list if the passed in object is found else return -1. More...

virtual ossim_int32	findInputIndex (const ossimId &id)
	Return a valid index of the input list if the passed id is found else return -1. More...

virtual ossim_int32	findOutputIndex (const ossimConnectableObject *object)
	Return a valid index of the output list if the passed in object is found else return -1. More...

virtual ossim_int32	findOutputIndex (const ossimId &id)
	Return a valid index of the output list if the passed in object is found else return -1. More...

virtual ossim_int32	getMyInputIndexToConnectTo (ossimConnectableObject *object) const
	Should return the first available index to connect to. More...

virtual ossim_int32	getMyOutputIndexToConnectTo (ossimConnectableObject *object) const
	Should return the first available index to connect to. More...

virtual bool	canConnectMyOutputTo (ossim_int32 myOutputIndex, const ossimConnectableObject *object) const
	default implementation is to allow anyone to connect to us. More...

virtual void	disconnect (ossimConnectableObject *object=0)
	Will disconnect the object passed in. More...

virtual void	disconnect (const ossimId &id)
	Will disconnect the object passed in. More...

virtual ossimRefPtr< ossimConnectableObject >	disconnectMyInput (ossim_int32 inputIndex, bool disconnectOutputFlag=true, bool createEventFlag=true)
	Will disconnect the object at the given input index and generate a connection event. More...

virtual void	disconnectMyInput (ossimConnectableObject *input, bool disconnectOutputFlag=true, bool createEventFlag=true)
	Finds the index of the passed in input and calls disconnectMyInput(inputIndex, disconnectOutputFlag, createEventFlag);. More...

virtual void	disconnectMyInputs (ConnectableObjectList &inputList, bool disconnectOutputFlag=true, bool createEventFlag=true)

virtual ossimRefPtr< ossimConnectableObject >	disconnectMyOutput (ossim_int32 outputIndex, bool disconnectInputFlag=true, bool createEventFlag=true)
	Will disconnect the object at the given output index and generate a connection event. More...

virtual void	disconnectMyOutput (ossimConnectableObject *output, bool disconnectInputFlag=true, bool createEventFlag=true)
	Will disconnect the output object. More...

virtual void	disconnectMyOutputs (ConnectableObjectList &outputList, bool disconnectOutputFlag=true, bool createEventFlag=true)

virtual void	disconnectAllInputs ()
	Will disconnect all of the input objects. More...

virtual void	disconnectAllOutputs ()
	Will disconnect all of the output objects. More...

virtual ossim_int32	connectMyInputTo (ossimConnectableObject *inputObject, bool makeOutputConnection=true, bool createEventFlag=true)
	Will try to connect this objects input to the passed in object. More...

virtual ossim_int32	connectMyInputTo (ossim_int32 inputIndex, ossimConnectableObject *inputObject, bool makeOutputConnection=true, bool createEventFlag=true)
	Will connect the specified input to the passed in object. More...

virtual bool	connectMyInputTo (ConnectableObjectList &inputList, bool makeOutputConnection=true, bool createEventFlag=true)

virtual ossim_int32	connectMyOutputTo (ossimConnectableObject *outputObject, bool makeInputConnection=true, bool createEventFlag=true)
	Will try to connect this objects output to the passed in object. More...

virtual bool	connectMyOutputTo (ConnectableObjectList &outputList, bool makeInputConnection=true, bool createEventFlag=true)

virtual bool	connectInputList (ConnectableObjectList &inputList)
	Will disconnect itself from all inputs and reset to the passed in input list. More...

virtual bool	connectOutputList (ConnectableObjectList &outputList)
	Will disconnect itself from all outputs and reset to the passed in output list. More...

virtual ossim_uint32	getNumberOfInputs () const
	Returns the number of input objects. More...

virtual ossim_uint32	getNumberOfOutputs () const
	Return the number of output objects. More...

ossimConnectableObject *	getInput (ossim_uint32 index=0)
	returns the object at the specified index. More...

const ossimConnectableObject *	getInput (ossim_uint32 index=0) const
	returns the object at the specified index. More...

ossimConnectableObject *	getOutput (ossim_uint32 index=0)
	returns the object at the specified index. More...

const ossimConnectableObject *	getOutput (ossim_uint32 index=0) const
	returns the object at the specified index. More...

virtual void	setNumberOfInputs (ossim_int32 numberOfInputs)
	Will set the number of inputs. More...

virtual bool	getInputListIsFixedFlag () const

virtual bool	getOutputListIsFixedFlag () const

virtual void	setNumberOfOutputs (ossim_int32 numberOfInputs)
	Will set the number of outputs. More...

const ConnectableObjectList &	getInputList () const

const ConnectableObjectList &	getOutputList () const

ConnectableObjectList &	getInputList ()

ConnectableObjectList &	getOutputList ()

	OSSIM_DEPRECATE_METHOD (virtual void findAllObjectsOfType(ConnectableObjectList &result, const RTTItypeid &typeInfo, bool recurse=true))

	OSSIM_DEPRECATE_METHOD (virtual void findAllObjectsOfType(ConnectableObjectList &result, const ossimString &className, bool recurse=true))

virtual void	propagateEventToOutputs (ossimEvent &event)

virtual void	propagateEventToInputs (ossimEvent &event)

virtual void	setProperty (const ossimString &name, const ossimString &value)

virtual ossim_uint32	saveStateOfAllInputs (ossimKeywordlist &kwl, bool saveThisStateFlag=true, ossim_uint32 objectIndex=1, const char *prefix=0) const
	Save the state of all inputs to a keyword list. More...

virtual bool	fillContainer (ossimConnectableContainer &container)
	Inserts this object and all of its children and inputs into the container provided. More...

bool	moveInputUp (const ossimId &id)
	Moves the input connection matching id up one in the connection list. More...

bool	moveInputDown (const ossimId &id)
	Moves the input connection matching id down one in the connection list. More...

bool	moveInputToTop (const ossimId &id)
	Moves the input connection matching id to the top of the connection list. More...

bool	moveInputToBottom (const ossimId &id)
	Moves the input connection matching id to the bottom of the connection list. More...

virtual void	accept (ossimVisitor &visitor)
	We will add a visitor interface for all connectable objects. More...

Public Member Functions inherited from ossimObject
	ossimObject ()

virtual	~ossimObject ()

virtual ossimObject *	dup () const

virtual RTTItypeid	getType () const

virtual bool	canCastTo (ossimObject *obj) const

virtual bool	canCastTo (const RTTItypeid &id) const

virtual bool	canCastTo (const ossimString &parentClassName) const

virtual bool	isEqualTo (const ossimObject &obj, ossimCompareType compareType=OSSIM_COMPARE_FULL) const

Public Member Functions inherited from ossimReferenced
	ossimReferenced ()

	ossimReferenced (const ossimReferenced &)

ossimReferenced &	operator= (const ossimReferenced &)

void	ref () const
	increment the reference count by one, indicating that this object has another pointer which is referencing it. More...

void	unref () const
	decrement the reference count by one, indicating that a pointer to this object is referencing it. More...

void	unref_nodelete () const
	decrement the reference count by one, indicating that a pointer to this object is referencing it. More...

int	referenceCount () const

Public Member Functions inherited from ossimListenerManager
	ossimListenerManager ()

virtual	~ossimListenerManager ()

virtual void	fireEvent (ossimEvent &event)

virtual bool	addListener (ossimListener *listener)

virtual bool	removeListener (ossimListener *listener)

virtual bool	findListener (ossimListener *listener)

Public Member Functions inherited from ossimPropertyInterface
	ossimPropertyInterface ()

virtual	~ossimPropertyInterface ()

virtual ossimString	getPropertyValueAsString (const ossimString &name) const

void	getPropertyList (std::vector< ossimRefPtr< ossimProperty > > &propertyList) const

void	setProperties (std::vector< ossimRefPtr< ossimProperty > > &propertyList)

Public Member Functions inherited from ossimErrorStatusInterface
	ossimErrorStatusInterface ()

virtual	~ossimErrorStatusInterface ()

virtual ossimErrorCode	getErrorStatus () const

virtual ossimString	getErrorStatusString () const

virtual void	setErrorStatus (ossimErrorCode error_status) const

virtual void	setErrorStatus () const

virtual void	clearErrorStatus () const

bool	hasError () const

Public Member Functions inherited from ossimMetadataInterface
	ossimMetadataInterface ()
	default constructor More...

virtual	~ossimMetadataInterface ()
	virtual destructor. More...

Protected Member Functions
virtual ossimRefPtr< ossimImageGeometry >	getInternalImageGeometry ()
	Method to get geometry from hdf file. More...

ossimRefPtr< ossimProjection >	processCoarseGridProjection (H5::DataSet &latDataSet, H5::DataSet &lonDataSet, const ossimIrect &validRect) const
	Gets projection from Latitude, Longitude, Height datasets if present. More...

bool	getLatLonDatasetNames (H5::H5File *h5File, std::string &latName, std::string &lonName) const
	Get dataset names for Latiitude and Longitude datasets. More...

bool	getLatLonDatasets (H5::H5File *h5File, H5::DataSet &latDataSet, H5::DataSet &lonDataSet) const

bool	getDataSetRect (std::string &name, std::string &lonName) const

virtual bool	open ()
	open method. More...

void	allocate ()
	Allocates the tile. More...

void	addImageDatasetEntries (const std::vector< std::string > &names)
	Adds image datasets from list of names. More...

bool	isNppMission (H5::H5File *h5File) const

Protected Member Functions inherited from ossimImageHandler
virtual ossimRefPtr< ossimImageGeometry >	getExternalImageGeometry () const
	Returns the image geometry object associated with this tile source or NULL if non defined. More...

virtual ossimRefPtr< ossimImageGeometry >	getInternalImageGeometry () const

virtual bool	getOverviewTile (ossim_uint32 resLevel, ossimImageData *result)
	Method to get an overview tile. More...

bool	initVertices (const char *file)
	Opens file and attempts to initialize the valid image vertices. More...

virtual void	completeOpen ()
	Will complete the opening process. More...

void	initImageParameters (ossimImageGeometry *geom) const
	Convenience method to set things needed in the image geometry from the image handler. More...

virtual void	establishDecimationFactors ()
	Virtual method determines the decimation factors at each resolution level. More...

virtual bool	setOutputBandList (const std::vector< ossim_uint32 > &inBandList, std::vector< ossim_uint32 > &outBandList)
	Convenience method to set output band list. More...

void	getFilenameWithNoExtension (ossimFilename &f) const
	Get filename with no extension, using supplentary directory for dirname if set. More...

Protected Member Functions inherited from ossimImageSource
	ossimImageSource (const ossimImageSource &rhs)

const ossimImageSource &	operator= (const ossimImageSource &)

Protected Member Functions inherited from ossimSource
	ossimSource (const ossimSource &rhs)

const ossimSource &	operator= (const ossimSource &rhs)

Protected Member Functions inherited from ossimConnectableObject
ossimConnectableObject *	findObjectOfType (ConnectableObjectList *connectableList, ossimVisitor &visitor)

Protected Member Functions inherited from ossimReferenced
virtual	~ossimReferenced ()

Protected Member Functions inherited from ossimListenerManager
	ossimListenerManager (const ossimListenerManager &rhs)

Protected Attributes
H5::H5File *	m_h5File

std::vector< ossimH5ImageDataset >	m_entries

ossim_uint32	m_currentEntry

ossimRefPtr< ossimImageData >	m_tile

ossimRefPtr< ossimProjection >	m_projection

std::mutex	m_mutex

Protected Attributes inherited from ossimImageHandler
ossimFilename	theImageFile

ossimFilename	theOverviewFile

ossimFilename	theSupplementaryDirectory

ossimRefPtr< ossimImageHandler >	theOverview

vector< ossimIpt >	theValidImageVertices

ossimImageMetaData	theMetaData

ossimRefPtr< ossimImageGeometry >	theGeometry

ossimRefPtr< ossimNBandLutDataObject >	theLut

std::vector< ossimDpt >	theDecimationFactors

ossimString	theImageID

ossim_uint32	theStartingResLevel
	theStartingResLevel If set to something other than zero(default) this is indicative that the reader is an overview. More...

bool	theOpenOverviewFlag
	If true opening of overviews will be attempted. More...

ossimPixelType	thePixelType

std::shared_ptr< ossim::ImageHandlerState >	m_state

Protected Attributes inherited from ossimSource
bool	theEnableFlag

bool	theInitializedFlag

Protected Attributes inherited from ossimConnectableObject
ossimId	theId

ossimString	theDescription

ossimObject *	theOwner

bool	theInputListIsFixedFlag
	Indicates whether the theInputObjectList is fixed. More...

bool	theOutputListIsFixedFlag
	Indicates whether the theOutputObjectList is fixed. More...

ConnectableObjectList	theInputObjectList
	Holds a list of input objects. More...

ConnectableObjectList	theOutputObjectList
	Holds a list of output objects. More...

Protected Attributes inherited from ossimListenerManager
std::list< ossimListener * >	theListenerList

bool	theEnabledFlag

std::list< ossimListener * >	theDelayedAdd

std::list< ossimListener * >	theDelayedRemove

bool	theFireEventFlag

Protected Attributes inherited from ossimErrorStatusInterface
ossimErrorCode	theErrorStatus

Additional Inherited Members
Public Types inherited from ossimImageHandler
enum	ossimImageHandlerOverviewCompressionType { OSSIM_OVERVIEW_COMPRESSION_NONE = 0, OSSIM_OVERVIEW_COMPRESSION_JPEG, OSSIM_OVERVIEW_COMPRESSION_LZW, OSSIM_OVERVIEW_COMPRESSION_DEFLATE, OSSIM_OVERVIEW_COMPRESSION_PACKBITS }

Public Types inherited from ossimConnectableObject
enum	ossimConnectableObjectDirectionType { CONNECTABLE_DIRECTION_NONE = 0, CONNECTABLE_DIRECTION_INPUT = 1, CONNECTABLE_DIRECTION_OUTPUT = 2 }

typedef std::vector< ossimRefPtr< ossimConnectableObject > >	ConnectableObjectList

Detailed Description

Definition at line 35 of file ossimH5Reader.h.

Constructor & Destructor Documentation

◆ ossimH5ImageHandler()

ossimH5ImageHandler::ossimH5ImageHandler ( )

default constructor

Definition at line 61 of file ossimH5Reader.cpp.

    :
       ossimImageHandler(),
       m_h5File(0),
       m_entries(),
       m_currentEntry(0),
       m_tile(0),
       m_projection(0),
       m_mutex()
 {
    // traceDebug.setTraceFlag(true);
    
    if (traceDebug())
    {
       ossimNotify(ossimNotifyLevel_DEBUG)
          << "ossimH5Reader::ossimH5Reader entered..." << std::endl;
 #ifdef OSSIM_ID_ENABLED
       ossimNotify(ossimNotifyLevel_DEBUG)
          << "OSSIM_ID:  " << OSSIM_ID << endl;
 #endif
    }
 }

◆ ~ossimH5ImageHandler()

ossimH5ImageHandler::~ossimH5ImageHandler ( )

virtual

virtual destructor

Definition at line 84 of file ossimH5Reader.cpp.

References close(), and isOpen().

 {
    if (isOpen())
    {
       close();
    }
 }

Member Function Documentation

◆ addImageDatasetEntries()

void ossimH5ImageHandler::addImageDatasetEntries ( const std::vector< std::string > & names )

protected

Adds image datasets from list of names.

Parameters

names List of dataset paths from hdf5 file.

Definition at line 370 of file ossimH5Reader.cpp.

References ossim_hdf5::getExtents(), ossimH5ImageDataset::initialize(), ossimH5Options::instance(), ossimH5Options::isDatasetRenderable(), m_entries, and m_h5File.

 {
    if ( m_h5File && names.size() )
    {
       std::vector<std::string>::const_iterator i = names.begin();
       while ( i != names.end() )
       {
          if ( ossimH5Options::instance()->isDatasetRenderable(*i))//ossim_hdf5::isExcludedDataset( *i ) == false )
          {
             H5::DataSet dataset = m_h5File->openDataSet( *i );
 
             // Get the class of the datatype that is used by the dataset.
             H5T_class_t type_class = dataset.getTypeClass();
             if ( ( type_class == H5T_INTEGER ) || ( type_class == H5T_FLOAT ) )
             {
                // Get the extents:
                std::vector<ossim_uint32> extents;
                ossim_hdf5::getExtents( &dataset, extents ); 
                if ( extents.size() >= 2 )
                {
                   if ( ( extents[0] > 1 ) && ( extents[1] > 1 ) )
                   {
                      ossimH5ImageDataset hids;
                      hids.initialize( dataset, *i );
                      m_entries.push_back( hids );
                   }     
                }
             }
 
             dataset.close();
          }
             
          ++i;
       }
    }
    
 #if 0 /* Please leave for debug. (drb) */
    std::vector<ossimH5ImageDataset>::const_iterator i = m_entries.begin();
    while ( i != m_entries.end() )
    {
       std::cout << (*i) << endl;
       ++i;
    }
 #endif
       
 } // End: ossimH5Reader::addImageDatasetEntries

◆ addMetadata()

void ossimH5ImageHandler::addMetadata	(	ossimKeywordlist *	kwl,
		const std::string &	prefix
	)		const

virtual

Adds metadata to keyword list.

This will add metadata to keyword list if found. Implemented to pass specific data to keyword list if found, e.g. acquisition_date, sensor_id, country_code

Satisfies pure virtual ossimMetadataInterface::addMetadata(...)

Parameters

kwl	Initialized by this.
prefix	e.g. "image0." (can be empty)

Implements ossimMetadataInterface.

Definition at line 920 of file ossimH5Reader.cpp.

References ossimKeywordlist::addPair(), ossim_hdf5::getDatasetAttributeValue(), ossim_hdf5::getGroupAttributeValue(), m_h5File, and ossimString::string().

 {
    // Note: hdf5 library throws exception if groupd is not found:
    
    if ( kwl && m_h5File )
    {
       // Look for country code(s): hdf5.CountryCodes: CA,MX,US
       std::string group = "/";
       std::string key = "CountryCodes";
       std::string value;
 
       if ( ossim_hdf5::getGroupAttributeValue( m_h5File, group, key, value ) )
       {
          key = "country_code";
          kwl->addPair( prefix, key, value );
       }
 
       // Look for mission id: hdf5.Mission_Name: NPP
       key = "Mission_Name";
       if ( ossim_hdf5::getGroupAttributeValue( m_h5File, group, key, value ) )
       {
          key = "mission_id";
          kwl->addPair( prefix, key, value );
       }
          
 
       //---
       // Look for sensor type:
       // hdf5.Data_Products.VIIRS-DNB-SDR.Instrument_Short_Name: VIIRS
       //---
       group = "/Data_Products/VIIRS-DNB-SDR";
       key = "Instrument_Short_Name";
       if ( ossim_hdf5::getGroupAttributeValue( m_h5File, group, key, value ) )
       {
          key = "sensor_id";
          kwl->addPair( prefix, key, value );
       }
       
       //---
       // Look for acquisition date:
       // hdf5.Data_Products.VIIRS-DNB-SDR.VIIRS-DNB-SDR_Aggr.AggregateBeginningDate: 20140113
       // hdf5.Data_Products.VIIRS-DNB-SDR.VIIRS-DNB-SDR_Aggr.AggregateBeginningTime: 082810.354645Z
       //---
       group = "Data_Products/VIIRS-DNB-SDR/VIIRS-DNB-SDR_Aggr";
       key = "AggregateBeginningDate";
       if ( ossim_hdf5::getDatasetAttributeValue( m_h5File, group, key, value ) )
       {
          std::string time;
          key = "AggregateBeginningTime";
          if ( ossim_hdf5::getDatasetAttributeValue( m_h5File, group, key, time ) )
          {
             // Only grab yyyymmddmmss in the form ISO 8601: 2014-01-26T10:32:28Z
             if ( (value.size() >= 8) && ( time.size() >= 6 ) )
             {
                std::string dateTime =
                   ossimString( ossimString(value.begin(), value.begin() + 4) + "-"
                                + ossimString(value.begin() + 4, value.begin() + 6) + "-"
                                + ossimString(value.begin() + 6, value.begin() + 8) + "T"
                                + ossimString(time.begin(), time.begin() + 2) + ":"
                                + ossimString(time.begin() + 2, time.begin() + 4) + ":"
                                + ossimString(time.begin() + 4, time.begin() + 6) + "Z" ).string();
                key = "acquisition_date";
                kwl->addPair( prefix, key, dateTime );
             }
          }
       }
    }
 }

◆ allocate()

void ossimH5ImageHandler::allocate ( )

protected

Allocates the tile.

Definition at line 92 of file ossimH5Reader.cpp.

References ossimImageDataFactory::create(), ossimImageData::initialize(), ossimImageDataFactory::instance(), m_mutex, and m_tile.

Referenced by getTile().

 {
    m_mutex.lock();
    m_tile = ossimImageDataFactory::instance()->create(this, this);
    m_tile->initialize();
    m_mutex.unlock();
 }

◆ close()

void ossimH5ImageHandler::close ( )

virtual

Close method.

Reimplemented from ossimImageHandler.

Definition at line 511 of file ossimH5Reader.cpp.

References ossimImageHandler::close(), m_entries, m_h5File, m_projection, and m_tile.

Referenced by ~ossimH5ImageHandler().

 {
    // Close the datasets.
    m_entries.clear();
 
    // Then the file.
    if ( m_h5File )
    {
       m_h5File->close();
       delete m_h5File;
       m_h5File = 0;
    }
 
    // ossimRefPtr so assign to 0(unreferencing) will handle memory.
    m_tile = 0;
    m_projection = 0;
 
    ossimImageHandler::close();
 }

◆ getClassName()

ossimString ossimH5ImageHandler::getClassName ( ) const

virtual

Returns: "ossimH5Reader"

Reimplemented from ossimObject.

Definition at line 469 of file ossimH5Reader.cpp.

 {
    return ossimString("ossimH5Reader");
 }

◆ getCurrentEntry()

ossim_uint32 ossimH5ImageHandler::getCurrentEntry ( ) const

virtual

Returns: The current entry number.

Reimplemented from ossimImageHandler.

Definition at line 602 of file ossimH5Reader.cpp.

References m_currentEntry.

 {
    return m_currentEntry;
 }

◆ getDataSetRect()

bool ossimH5ImageHandler::getDataSetRect	(	std::string &	name,
		std::string &	lonName
	)		const

protected

◆ getEntryList()

void ossimH5ImageHandler::getEntryList ( std::vector< ossim_uint32 > & entryList ) const

virtual

Parameters

entryList This is the list to initialize with entry indexes.

Note: This implementation returns puts one entry "0" in the list.

Reimplemented from ossimImageHandler.

Definition at line 545 of file ossimH5Reader.cpp.

References m_entries.

 {
    const ossim_uint32 SIZE = m_entries.size();
    entryList.resize( SIZE );
    for ( ossim_uint32 i = 0; i < SIZE; ++i )
    {
       entryList[i] = i; 
    }
 }

◆ getEntryNames()

void ossimH5ImageHandler::getEntryNames ( std::vector< ossimString > & entryNames ) const

virtual

Get the name of entry as a string.

Example given from HDF5 file:

entry_name: /All_Data/VIIRS-IMG-GTM-EDR-GEO_All/QF1_VIIRSGTMGEO

Parameters

entryIdx	Zero based entry index. If out of range name will be cleared.
name	Initialized by this.

Reimplemented from ossimImageHandler.

Definition at line 536 of file ossimH5Reader.cpp.

References m_entries.

 {
    entryNames.clear();
    for (ossim_uint32 i=0; i<m_entries.size(); ++i )
    {
       entryNames.push_back(m_entries[i].getName());
    }
 }

◆ getImageGeometry()

ossimRefPtr< ossimImageGeometry > ossimH5ImageHandler::getImageGeometry ( )

virtual

Returns the image geometry object associated with this tile source or NULL if non defined.

The geometry contains full-to-local image transform as well as projection (image-to-world).

Reimplemented from ossimImageHandler.

Definition at line 607 of file ossimH5Reader.cpp.

References ossimImageGeometryRegistry::extendGeometry(), ossimRefPtr< T >::get(), ossimImageHandler::getExternalImageGeometry(), getInternalImageGeometry(), ossimImageGeometry::getProjection(), ossimImageHandler::initImageParameters(), ossimImageGeometryRegistry::instance(), m_mutex, and ossimImageHandler::theGeometry.

 {
    if ( !theGeometry )
    {
       //---
       // Check for external geom:
       //---
       theGeometry = getExternalImageGeometry();
       
       if ( !theGeometry )
       {
          //---
          // WARNING:
          // Must create/set the geometry at this point or the next call to
          // ossimImageGeometryRegistry::extendGeometry will put us in an infinite loop
          // as it does a recursive call back to ossimImageHandler::getImageGeometry().
          //---
 
          // Check the internal geometry first to avoid a factory call.
          m_mutex.lock();
          theGeometry = getInternalImageGeometry();
          m_mutex.unlock();
 
          // At this point it is assured theGeometry is set.
 
          // Check for set projection.
          if ( !theGeometry->getProjection() )
          {
             // Try factories for projection.
             ossimImageGeometryRegistry::instance()->extendGeometry(this);
          }
       }
 
       // Set image things the geometry object should know about.
       initImageParameters( theGeometry.get() );
    }
 
    return theGeometry;
 }

◆ getImageRectangle()

ossimIrect ossimH5ImageHandler::getImageRectangle ( ossim_uint32 reduced_res_level = 0 ) const

virtual

Returns the zero based image rectangle for the reduced resolution data set (rrds) passed in.

Note that rrds 0 is the highest resolution rrds.

Reimplemented from ossimImageHandler.

Definition at line 222 of file ossimH5Reader.cpp.

References getNumberOfLines(), and getNumberOfSamples().

Referenced by getTile().

 {
    return ossimIrect(0,
                      0,
                      getNumberOfSamples(reduced_res_level) - 1,
                      getNumberOfLines(reduced_res_level)   - 1);
 }

◆ getImageTileHeight()

ossim_uint32 ossimH5ImageHandler::getImageTileHeight ( ) const

virtual

Returns the tile width of the image or 0 if the image is not tiled.

Note: this is not the same as the ossimImageSource::getTileWidth which returns the output tile width which can be different than the internal image tile width on disk.

Implements ossimImageHandler.

Definition at line 454 of file ossimH5Reader.cpp.

 {
    return 0; // Not tiled format.
 }

◆ getImageTileWidth()

ossim_uint32 ossimH5ImageHandler::getImageTileWidth ( ) const

virtual

Returns the tile width of the image or 0 if the image is not tiled.

Note: this is not the same as the ossimImageSource::getTileWidth which returns the output tile width which can be different than the internal image tile width on disk.

Implements ossimImageHandler.

Definition at line 449 of file ossimH5Reader.cpp.

 {
    return 0; // Not tiled format.
 }

◆ getInternalImageGeometry()

ossimRefPtr< ossimImageGeometry > ossimH5ImageHandler::getInternalImageGeometry ( )

protectedvirtual

Method to get geometry from hdf file.

Definition at line 647 of file ossimH5Reader.cpp.

References ossimRefPtr< T >::get(), ossim_hdf5::getBilinearProjection(), getLatLonDatasetNames(), isOpen(), m_currentEntry, m_entries, m_h5File, m_projection, processCoarseGridProjection(), ossimImageGeometry::setProjection(), and ossimRefPtr< T >::valid().

Referenced by getImageGeometry().

 {
    ossimRefPtr<ossimImageGeometry> geom = new ossimImageGeometry();
 
    if ( m_projection.valid() )
    {
       // Stored projection, currently shared by all entries.
       geom->setProjection( m_projection.get() );
    }
    else if ( isOpen() )
    {
       // Find the "Latitude" and "Longitude" datasets if present.
       std::string latName;
       std::string lonName;
       if ( getLatLonDatasetNames(  m_h5File, latName, lonName ) )
       {
          H5::DataSet latDataSet = m_h5File->openDataSet( latName );
          H5::DataSet lonDataSet = m_h5File->openDataSet( lonName );
 
          // Get the valid rectangle of the dataset.
          ossimIrect validRect = m_entries[m_currentEntry].getValidImageRect();
 
          // Try for a coarse projection first:
          ossimRefPtr<ossimProjection> proj =
             processCoarseGridProjection( latDataSet,
                                          lonDataSet,
                                          validRect );
          
          if ( proj.valid() == false )
          {
             ossimIrect rect;
             proj = ossim_hdf5::getBilinearProjection( latDataSet, lonDataSet, validRect );
          }
          
          if ( proj.valid() )
          {
             // Store it for next time:
             m_projection = proj;
             
             // Set the geometry projection
             geom->setProjection( proj.get() ); 
          }
                
          latDataSet.close();
          lonDataSet.close();
       }
    }
  
    return geom;
 }

◆ getLatLonDatasetNames()

bool ossimH5ImageHandler::getLatLonDatasetNames	(	H5::H5File *	h5File,
		std::string &	latName,
		std::string &	lonName
	)		const

protected

Get dataset names for Latiitude and Longitude datasets.

Parameters

h5File	Pointer to file.
latName	Initializes by this.
lonName	Initializes by this.

Returns: true on sucess, false on error.

Definition at line 729 of file ossimH5Reader.cpp.

References ossimString::contains(), and ossim_hdf5::getDatasetNames().

Referenced by getInternalImageGeometry(), and getLatLonDatasets().

 {
    bool result = false;
 
    if ( h5File )
    {
       latName.clear();
       lonName.clear();
       
       // Get the list of datasets.
       std::vector<std::string> datasetNames;
       ossim_hdf5::getDatasetNames( h5File, datasetNames );
 
       if ( datasetNames.size() )
       {
          std::vector<std::string>::const_iterator i = datasetNames.begin();
          while ( i != datasetNames.end() )
          {
             ossimString os = *i;
             if ( os.contains( "Latitude" ) )
             {
                latName = *i;
             }
             else if ( os.contains( "Longitude" ) )
             {
                lonName = *i;
             }
             
             if ( latName.size() && lonName.size() )
             {
                result = true;
                break;
             }
             
             ++i;
          }
       }
    }
    
    return result;
 
 } // End: ossimH5Reader::getLatLonDatasetNames

◆ getLatLonDatasets()

bool ossimH5ImageHandler::getLatLonDatasets	(	H5::H5File *	h5File,
		H5::DataSet &	latDataSet,
		H5::DataSet &	lonDataSet
	)		const

protected

Parameters

Initializes	lat and lon data sets.
h5File	Pointer to file.
latDataSet	Initialized by this.
lonDataSet	Initialized by this.

Definition at line 774 of file ossimH5Reader.cpp.

References ossimFilename::dirCat(), ossimFilename::exists(), ossim_hdf5::getGroupAttributeValue(), getLatLonDatasetNames(), ossimFilename::path(), status, ossimString::string(), and ossimImageHandler::theImageFile.

 {
    bool status = false;
 
    if ( h5File )
    {
       std::string latName;
       std::string lonName;
       if ( getLatLonDatasetNames( h5File, latName, lonName ) )
       {
          // Set the return status:
          status = true;
          latDataSet = h5File->openDataSet( latName );
          lonDataSet = h5File->openDataSet( lonName ); 
       }
       else
       {
          // Look for the key: /N_GEO_Ref
          std::string group = "/";
          std::string key   = "N_GEO_Ref";
          std::string value;
             
          if ( ossim_hdf5::getGroupAttributeValue( h5File, group, key, value ) )
          {
             ossimFilename f = value;
         ossimFilename latLonFile = theImageFile.path();
             latLonFile = latLonFile.dirCat( f );
 
             if ( latLonFile.exists() )
             {
                if ( H5::H5File::isHdf5( latLonFile.string() ) )
                {
                   H5::H5File* h5File = new H5::H5File();
                   
                   H5::FileAccPropList access_plist = H5::FileAccPropList::DEFAULT;
                   h5File->openFile( latLonFile.string(), H5F_ACC_RDONLY, access_plist );
 
                   if ( getLatLonDatasetNames( h5File, latName, lonName ) )
                   {
                      // Set the return status:
                      status = true;
                      latDataSet = h5File->openDataSet( latName );
                      lonDataSet = h5File->openDataSet( lonName ); 
                   }
                   h5File->close();
                   delete h5File;
                   h5File = 0;
                }
             }
          }
       }
    }
 
    return status;
    
 } // End: ossimH5Reader::getLatLonDatasets( ... )

◆ getLongName()

ossimString ossimH5ImageHandler::getLongName ( ) const

virtual

Returns: "ossim hdf5"

Reimplemented from ossimObject.

Definition at line 464 of file ossimH5Reader.cpp.

 {
    return ossimString("ossim hdf5 reader");
 }

◆ getNullPixelValue()

double ossimH5ImageHandler::getNullPixelValue ( ossim_uint32 band = 0 ) const

virtual

Returns: Null pixel value.

Reimplemented from ossimImageHandler.

Definition at line 853 of file ossimH5Reader.cpp.

References ossimImageHandler::getNullPixelValue(), getOutputScalarType(), and OSSIM_FLOAT32.

Referenced by getTile().

 {
    return ossimImageHandler::getNullPixelValue( band );
 #if 0
    double result;
    ossimScalarType scalar = getOutputScalarType();
    if ( scalar == OSSIM_FLOAT32 )
    {
       result = -9999.0;
    }
    else
    {
       result = ossimImageHandler::getNullPixelValue( band );
    }
    return result;
 #endif
 }

◆ getNumberOfEntries()

ossim_uint32 ossimH5ImageHandler::getNumberOfEntries ( ) const

virtual

Returns: The number of entries (images) in the image file.

Reimplemented from ossimImageHandler.

Definition at line 531 of file ossimH5Reader.cpp.

References m_entries.

 {
    return (ossim_uint32)m_entries.size();
 }

◆ getNumberOfInputBands()

ossim_uint32 ossimH5ImageHandler::getNumberOfInputBands ( ) const

virtual

Returns the number of bands in the image.

Satisfies pure virtual from ImageHandler class.

Implements ossimImageSource.

Definition at line 474 of file ossimH5Reader.cpp.

References m_currentEntry, and m_entries.

Referenced by getNumberOfOutputBands(), and getTile().

 {
    ossim_uint32 result = 1;
 
    if ( m_currentEntry < m_entries.size() )
    {
       result = m_entries[m_currentEntry].getNumberOfBands();
    }
 
    return result;
 }

◆ getNumberOfLines()

ossim_uint32 ossimH5ImageHandler::getNumberOfLines ( ossim_uint32 reduced_res_level = 0 ) const

virtual

Returns the number of lines in the image.

Satisfies pure virtual from ImageHandler class.

Implements ossimImageHandler.

Definition at line 417 of file ossimH5Reader.cpp.

References ossimImageHandler::getNumberOfLines(), m_currentEntry, m_entries, ossimImageHandler::theOverview, and ossimRefPtr< T >::valid().

Referenced by getImageRectangle().

 {
    ossim_uint32 result = 0;
    
    if ( (reduced_res_level == 0) && ( m_currentEntry < m_entries.size() ) )
    {
       result = m_entries[m_currentEntry].getNumberOfLines();
    }
    else if ( theOverview.valid() )
    {
       result = theOverview->getNumberOfLines(reduced_res_level);
    }
    
    return result;
 }

◆ getNumberOfOutputBands()

ossim_uint32 ossimH5ImageHandler::getNumberOfOutputBands ( ) const

virtual

Returns the number of bands in a tile returned from this TileSource.

Note: we are supporting sources that can have multiple data objects. If you want to know the scalar type of an object you can pass in the

Reimplemented from ossimImageSource.

Definition at line 486 of file ossimH5Reader.cpp.

References getNumberOfInputBands().

Referenced by getTile().

 {
    // Currently not band selectable.
    return getNumberOfInputBands();
 }

◆ getNumberOfSamples()

ossim_uint32 ossimH5ImageHandler::getNumberOfSamples ( ossim_uint32 reduced_res_level = 0 ) const

virtual

Returns the number of samples in the image.

Satisfies pure virtual from ImageHandler class.

Implements ossimImageHandler.

Definition at line 433 of file ossimH5Reader.cpp.

References ossimImageHandler::getNumberOfSamples(), m_currentEntry, m_entries, ossimImageHandler::theOverview, and ossimRefPtr< T >::valid().

Referenced by getImageRectangle().

 {
    ossim_uint32 result = 0;
    
    if ( (reduced_res_level == 0) && ( m_currentEntry < m_entries.size() ) )
    {
       result = m_entries[m_currentEntry].getNumberOfSamples();
    }
    else if ( theOverview.valid() )
    {
       result = theOverview->getNumberOfSamples(reduced_res_level);
    }
    
    return result; 
 }

◆ getOutputScalarType()

ossimScalarType ossimH5ImageHandler::getOutputScalarType ( ) const

virtual

Returns the output pixel type of the tile source.

Reimplemented from ossimImageSource.

Definition at line 492 of file ossimH5Reader.cpp.

References m_currentEntry, m_entries, and OSSIM_SCALAR_UNKNOWN.

Referenced by getNullPixelValue().

 {
    ossimScalarType result = OSSIM_SCALAR_UNKNOWN;
    
    if ( m_currentEntry < m_entries.size() )
    {
       result = m_entries[m_currentEntry].getScalarType();
    }
    
    return result;
 }

◆ getProperty()

ossimRefPtr< ossimProperty > ossimH5ImageHandler::getProperty ( const ossimString & name ) const

virtual

Get propterty method.

Overrides ossimImageHandler::getProperty.

Parameters

name	Property name to get.

Reimplemented from ossimImageHandler.

Definition at line 895 of file ossimH5Reader.cpp.

References ossimString::string().

 {
    ossimRefPtr<ossimProperty> prop = 0;
    if ( name.string() == LAYER_KW )
    {
       if ( m_currentEntry < m_entries.size() )
       {
          ossimString value = m_entries[m_currentEntry].getName();
          prop = new ossimStringProperty(name, value);
       }
    }
    else
    {
       prop = ossimImageHandler::getProperty(name);
    }
    return prop;
 }

◆ getPropertyNames()

void ossimH5ImageHandler::getPropertyNames ( std::vector< ossimString > & propertyNames ) const

virtual

Get propterty names.

Overrides ossimImageHandler::getPropertyNames.

Parameters

propertyNames Array to initialize.

Reimplemented from ossimImageHandler.

Definition at line 913 of file ossimH5Reader.cpp.

References ossimImageHandler::getPropertyNames().

 {
    propertyNames.push_back( ossimString("layer") );
    ossimImageHandler::getPropertyNames(propertyNames);
 }

◆ getShortName()

ossimString ossimH5ImageHandler::getShortName ( ) const

virtual

Returns: "hdf5"

Reimplemented from ossimObject.

Definition at line 459 of file ossimH5Reader.cpp.

 {
    return ossimString("ossim_hdf5_reader");
 }

◆ getTile() [1/2]

ossimRefPtr< ossimImageData > ossimH5ImageHandler::getTile	(	const ossimIrect &	rect,
		ossim_uint32	resLevel = `0`
	)

virtual

Returns a pointer to a tile given an origin representing the upper left corner of the tile to grab from the image.

Satisfies pure virtual from TileSource class.

Reimplemented from ossimImageSource.

Definition at line 100 of file ossimH5Reader.cpp.

References allocate(), ossimRefPtr< T >::get(), ossimDataObject::getDataObjectStatus(), m_mutex, m_tile, ossimImageData::makeBlank(), OSSIM_NULL, ossimImageData::setImageRectangle(), and ossimRefPtr< T >::valid().

 {
    if ( m_tile.valid() == false ) // First time through.
    {
       allocate();
    }
    
    if (m_tile.valid())
    {
       // Image rectangle must be set prior to calling getTile.
       m_mutex.lock();
       m_tile->setImageRectangle(rect);
       m_mutex.unlock();
       
       if ( getTile( m_tile.get(), resLevel ) == false )
       {
          m_mutex.lock();
          if (m_tile->getDataObjectStatus() != OSSIM_NULL)
          {
             m_tile->makeBlank();
          }
          m_mutex.unlock();
       }
    }
    
    return m_tile;
 }

◆ getTile() [2/2]

bool ossimH5ImageHandler::getTile	(	ossimImageData *	result,
		ossim_uint32	resLevel = `0`
	)

virtual

Method to get a tile.

Parameters

result The tile to stuff. Note The requested rectangle in full image space and bands should be set in the result tile prior to passing. It will be an error if: result.getNumberOfBands() != this->getNumberOfOutputBands()

Returns: true on success false on error. If return is false, result is undefined so caller should handle appropriately with makeBlank or whatever.

Reimplemented from ossimImageSource.

Definition at line 129 of file ossimH5Reader.cpp.

References ossimIrect::area(), ossimIrect::clipToRect(), ossimIrect::completely_within(), getImageRectangle(), ossimImageData::getImageRectangle(), getNullPixelValue(), ossimImageData::getNumberOfBands(), getNumberOfInputBands(), getNumberOfOutputBands(), ossimImageHandler::getOverviewTile(), ossim_hdf5::getScalarType(), isOpen(), ossimSource::isSourceEnabled(), ossimImageHandler::isValidRLevel(), ossimImageData::loadBand(), m_currentEntry, m_entries, m_mutex, ossimImageData::makeBlank(), OSSIM_FLOAT32, ossimReferenced::ref(), ossim::scalarSizeInBytes(), status, ossimReferenced::unref(), and ossimImageData::validate().

 {
    bool status = false;
 
    m_mutex.lock();
    
    //---
    // Not open, this tile source bypassed, or invalid res level,
    // return a blank tile.
    //---
    if( isOpen() && isSourceEnabled() && isValidRLevel(resLevel) &&
        result && (result->getNumberOfBands() == getNumberOfOutputBands()) )
    {
       result->ref(); // Increment ref count.
       
       //---
       // Check for overview tile.  Some overviews can contain r0 so always
       // call even if resLevel is 0.  Method returns true on success, false
       // on error.
       //---
       status = getOverviewTile(resLevel, result);
 
       if (!status) // Did not get an overview tile.
       {
          status = true;
          
          ossimIrect tile_rect = result->getImageRectangle();
 
          if ( ! tile_rect.completely_within(getImageRectangle(0)) )
          {
             // We won't fill totally so make blank first.
             result->makeBlank();
          }
          
          if (getImageRectangle(0).intersects(tile_rect))
          {
             // Make a clip rect.
             ossimIrect clipRect = tile_rect.clipToRect(getImageRectangle(0));
             
             if (tile_rect.completely_within( clipRect) == false)
             {
                // Not filling whole tile so blank it out first.
                result->makeBlank();
             }
 
             // Create buffer to hold the clip rect for a single band.
             ossim_uint32 clipRectSizeInBytes = clipRect.area() *
                ossim::scalarSizeInBytes( m_entries[m_currentEntry].getScalarType() );
             vector<char> dataBuffer(clipRectSizeInBytes);
 
             // Get the data.
             for (ossim_uint32 band = 0; band < getNumberOfInputBands(); ++band)
             {
                // Hdf5 file to buffer:
                m_entries[m_currentEntry].getTileBuf(&dataBuffer.front(), clipRect, band);
 
                if ( m_entries[m_currentEntry].getScalarType() == OSSIM_FLOAT32 )
                {
                   //---
                   // NPP VIIRS data has null of "-999.3".
                   // Scan and fix non-standard null value.
                   //---
                   const ossim_float32 NP = getNullPixelValue(band);
                   const ossim_uint32 COUNT = clipRect.area();
                   ossim_float32* float_buffer = (ossim_float32*)&dataBuffer.front();
                   for ( ossim_uint32 i = 0; i < COUNT; ++i )
                   {
                      if ( float_buffer[i] <= -999.0 ) float_buffer[i] = NP;
                   }
                }
 
                // Buffer to tile:
                result->loadBand((void*)&dataBuffer.front(), clipRect, band);
             }
 
             // Validate the tile, i.e. full, partial, empty.
             result->validate();
          }
          else // No intersection...
          {
             result->makeBlank();
          }
       }
 
       result->unref();  // Decrement ref count.
    }
 
    m_mutex.unlock();
 
    return status;
 }

◆ isNppMission()

bool ossimH5ImageHandler::isNppMission ( H5::H5File * h5File ) const

protected

Returns: true if key "Mission_Name" is equal to NPP.

Definition at line 833 of file ossimH5Reader.cpp.

References ossim_hdf5::getGroupAttributeValue().

 {
    bool result = false;
    
    // Look for "Mission_Name"
    const std::string GROUP = "/";
    const std::string KEY = "Mission_Name";
    std::string value;
    
    if ( ossim_hdf5::getGroupAttributeValue( h5File, GROUP, KEY, value ) )
    {
       if ( value == "NPP" )
       {
          result = true;
       }
    }
    
    return result;
 }

◆ isOpen()

bool ossimH5ImageHandler::isOpen ( ) const

virtual

Derived classes must implement this method to be concrete.

Returns: true if open, false if not.

Implements ossimImageHandler.

Definition at line 504 of file ossimH5Reader.cpp.

References m_currentEntry, m_entries, m_h5File, and true.

Referenced by getInternalImageGeometry(), getTile(), setCurrentEntry(), and ~ossimH5ImageHandler().

 {
    return ( ( m_h5File != 0 ) &&
             m_entries.size() &&
             ( m_currentEntry < m_entries.size() ) ) ? true : false ;
 }

◆ loadState()

bool ossimH5ImageHandler::loadState	(	const ossimKeywordlist &	kwl,
		const char *	prefix = `0`
	)

virtual

Method to the load (recreate) the state of an object from a keyword list.

Return true if ok or false on error.

Reimplemented from ossimImageHandler.

Definition at line 236 of file ossimH5Reader.cpp.

References ossimImageHandler::loadState(), and open().

 {
    if (ossimImageHandler::loadState(kwl, prefix))
    {
       return open();
    }
 
    return false;
 }

◆ open()

bool ossimH5ImageHandler::open ( )

protectedvirtual

open method.

Returns: true on success, false on error.

Implements ossimImageHandler.

Definition at line 247 of file ossimH5Reader.cpp.

Referenced by loadState().

 {
    static const char MODULE[] = "ossimH5Reader::open";
 
    if (traceDebug())
    {
       ossimNotify(ossimNotifyLevel_DEBUG)
          << MODULE << " entered..."
          << "File:  " << theImageFile.c_str()
          << std::endl;
    }
 
    bool status = false;
    
    // Start with a clean slate.
    if (isOpen())
    {
       close();
    }
 
    // Check for empty filename.
    if (theImageFile.size())
    {
       try
       {
          //--
          // Turn off the auto-printing when failure occurs so that we can
          // handle the errors appropriately
          //---
          // H5::Exception::dontPrint();
 
          theImageFile = theImageFile.expand();
 
          if ( H5::H5File::isHdf5( theImageFile.c_str() ) )
          {
             m_h5File = new H5::H5File();
 
             H5::FileAccPropList access_plist = H5::FileAccPropList::DEFAULT;
             
             m_h5File->openFile( theImageFile.string(), H5F_ACC_RDONLY, access_plist );
 
             std::vector<std::string> names;
             ossim_hdf5::getDatasetNames( m_h5File, names );
 
             if ( names.size() )
             {
                if ( traceDebug() )
                {
                   ossimNotify(ossimNotifyLevel_DEBUG)
                      << MODULE << " DEBUG\nDataset names:\n"; 
                   for ( ossim_uint32 i = 0; i < names.size(); ++i )
                   {
                      ossimNotify(ossimNotifyLevel_DEBUG)
                         << "dataset[" << i << "]: " << names[i] << "\n";
                   }
                }
 
                // Add the image dataset entries.
                addImageDatasetEntries( names );
                if ( m_entries.size() )
                {
                   // Set the return status.
                   status = true;
                }
                else
                {
                   m_h5File->close();
                   delete m_h5File;
                   m_h5File = 0;
                }
             }
          }
          
       } // End: try block
       
       catch( const H5::FileIException& error )
       {
          if ( traceDebug() )
          {
             error.printError();
          }
       }
       
       // catch failure caused by the DataSet operations
       catch( const H5::DataSetIException& error )
       {
          if ( traceDebug() )
          {
             error.printError();
          }
       }
       
       // catch failure caused by the DataSpace operations
       catch( const H5::DataSpaceIException& error )
       {
          if ( traceDebug() )
          {
             error.printError();
          }
       }
       
       // catch failure caused by the DataSpace operations
       catch( const H5::DataTypeIException& error )
       {
          if ( traceDebug() )
          {
             error.printError();
          }
       }
       catch( ... )
       {
          
       }
       
       if ( status )
       {
          completeOpen();
       }
    }
 
    return status;
 }

◆ processCoarseGridProjection()

ossimRefPtr< ossimProjection > ossimH5ImageHandler::processCoarseGridProjection	(	H5::DataSet &	latDataSet,
		H5::DataSet &	lonDataSet,
		const ossimIrect &	validRect
	)		const

protected

Gets projection from Latitude, Longitude, Height datasets if present.

Parameters

latDataSet	H5::DataSet& to layer, e.g. /All_Data/VIIRS-DNB-GEO_All/Latitude
lonDataSet	H5::DataSet& to layer, e.g. /All_Data/VIIRS-DNB-GEO_All/Longitude

Definition at line 698 of file ossimH5Reader.cpp.

References ossimRefPtr< T >::get().

Referenced by getInternalImageGeometry().

 {
    ossimRefPtr<ossimProjection> proj = 0;
 
    ossimRefPtr<ossimHdf5GridModel> model = new ossimHdf5GridModel();
    
    try
    {
       if ( model->setGridNodes( &latDataSet,
                                 &lonDataSet,
                                 validRect ) )
       {
          proj = model.get();
       }
    }
    catch ( const ossimException& e )
    {
       if ( traceDebug() )
       {
          ossimNotify(ossimNotifyLevel_WARN)
             << "ossimH5Reader::processCoarseGridProjection caught exception\n"
             << e.what() << std::endl;
       }
    }
 
    return proj;
 }

◆ saveState()

bool ossimH5ImageHandler::saveState	(	ossimKeywordlist &	kwl,
		const char *	prefix = `0`
	)		const

virtual

Method to save the state of an object to a keyword list.

Return true if ok or false on error.

Reimplemented from ossimImageHandler.

Definition at line 230 of file ossimH5Reader.cpp.

References ossimImageHandler::saveState().

 {
    return ossimImageHandler::saveState(kwl, prefix);
 }

◆ setCurrentEntry()

bool ossimH5ImageHandler::setCurrentEntry ( ossim_uint32 entryIdx )

virtual

Parameters

entryIdx Entry number to select.

Note: The implementation does nothing. Derived classes that handle multiple images should override.

Returns: true if it was able to set the current entry and false otherwise.

Reimplemented from ossimImageHandler.

Definition at line 555 of file ossimH5Reader.cpp.

References ossimString::clear(), ossimImageHandler::completeOpen(), isOpen(), m_currentEntry, m_entries, m_tile, ossimImageHandler::theGeometry, and ossimImageHandler::theOverviewFile.

 {
    bool result = true;
    if (m_currentEntry != entryIdx)
    {
       if ( isOpen() )
       {
          // Entries always start at zero and increment sequentially..
          if ( entryIdx < m_entries.size() )
          {
             // Clear the geometry.
             theGeometry = 0;
             
             // Must clear or openOverview will use last entries.
             theOverviewFile.clear();
             
             m_currentEntry = entryIdx;
             
             //---
             // Since we were previously open and the the entry has changed we
             // need to reinitialize some things. Setting tile to 0 will force an
             // allocate call on first getTile.
             //---
             
             // ossimRefPtr so assign to 0(unreferencing) will handle memory.
             m_tile = 0;
             
             completeOpen();
          }
          else
          {
             result = false; // Entry index out of range.
          }
       }
       else
       {
          //---
          // Not open.
          // Allow this knowing that open will check for out of range.
          //---
          m_currentEntry = entryIdx;
       }
    }
 
    return result;
 }

◆ setProperty()

void ossimH5ImageHandler::setProperty ( ossimRefPtr< ossimProperty > property )

virtual

Set propterty method.

Overrides ossimImageHandler::setProperty.

Current property name handled: "scale" One double value representing the scale in meters per pixel. It is assumed the scale is same for x and y direction.

Parameters

property to set.

Reimplemented from ossimImageHandler.

Definition at line 871 of file ossimH5Reader.cpp.

References ossimProperty::getName(), ossimString::string(), and ossimRefPtr< T >::valid().

 {
    if ( property.valid() )
    {
       if ( property->getName().string() == LAYER_KW )
       {
          ossimString s;
          property->valueToString(s);
          ossim_uint32 SIZE = (ossim_uint32)m_entries.size();
          for ( ossim_uint32 i = 0; i < SIZE; ++i )
          {
             if ( m_entries[i].getName() == s.string() )
             {
                setCurrentEntry( i );
             }
          }
       }
       else
       {
          ossimImageHandler::setProperty(property);
       }
    }
 }

Member Data Documentation

◆ m_currentEntry

ossim_uint32 ossimH5ImageHandler::m_currentEntry

protected

Definition at line 290 of file ossimH5Reader.h.

Referenced by getCurrentEntry(), getInternalImageGeometry(), getNumberOfInputBands(), getNumberOfLines(), getNumberOfSamples(), getOutputScalarType(), getTile(), isOpen(), and setCurrentEntry().

◆ m_entries

std::vector<ossimH5ImageDataset> ossimH5ImageHandler::m_entries

protected

Definition at line 289 of file ossimH5Reader.h.

Referenced by addImageDatasetEntries(), close(), getEntryList(), getEntryNames(), getInternalImageGeometry(), getNumberOfEntries(), getNumberOfInputBands(), getNumberOfLines(), getNumberOfSamples(), getOutputScalarType(), getTile(), isOpen(), and setCurrentEntry().

◆ m_h5File

H5::H5File* ossimH5ImageHandler::m_h5File

protected

Definition at line 288 of file ossimH5Reader.h.

Referenced by addImageDatasetEntries(), addMetadata(), close(), getInternalImageGeometry(), and isOpen().

◆ m_mutex

std::mutex ossimH5ImageHandler::m_mutex

protected

Definition at line 293 of file ossimH5Reader.h.

Referenced by allocate(), getImageGeometry(), and getTile().

◆ m_projection

ossimRefPtr<ossimProjection> ossimH5ImageHandler::m_projection

protected

Definition at line 292 of file ossimH5Reader.h.

Referenced by close(), and getInternalImageGeometry().

◆ m_tile

ossimRefPtr<ossimImageData> ossimH5ImageHandler::m_tile

protected

Definition at line 291 of file ossimH5Reader.h.

Referenced by allocate(), close(), getTile(), and setCurrentEntry().

The documentation for this class was generated from the following files:

Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ ossimH5ImageHandler()

◆ ~ossimH5ImageHandler()

Member Function Documentation

◆ addImageDatasetEntries()

◆ addMetadata()

◆ allocate()

◆ close()

◆ getClassName()

◆ getCurrentEntry()

◆ getDataSetRect()

◆ getEntryList()

◆ getEntryNames()

◆ getImageGeometry()

◆ getImageRectangle()

◆ getImageTileHeight()

◆ getImageTileWidth()

◆ getInternalImageGeometry()

◆ getLatLonDatasetNames()

◆ getLatLonDatasets()

◆ getLongName()

◆ getNullPixelValue()

◆ getNumberOfEntries()

◆ getNumberOfInputBands()

◆ getNumberOfLines()

◆ getNumberOfOutputBands()

◆ getNumberOfSamples()

◆ getOutputScalarType()

◆ getProperty()

◆ getPropertyNames()

◆ getShortName()

◆ getTile() [1/2]

◆ getTile() [2/2]

◆ isNppMission()

◆ isOpen()

◆ loadState()

◆ open()

◆ processCoarseGridProjection()

◆ saveState()

◆ setCurrentEntry()

◆ setProperty()

Member Data Documentation

◆ m_currentEntry

◆ m_entries

◆ m_h5File

◆ m_mutex

◆ m_projection

◆ m_tile