#include <ossimImageElevationDatabase.h>

Inheritance diagram for ossimImageElevationDatabase:

Classes
struct	ossimImageElevationFileEntry

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

virtual bool	open (const ossimString &connectionString)
	Open a connection to a database. More...

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

virtual ossimObject *	dup () const

void	mapRegion (const ossimGrect &region)
	Maps elevation data for region to a grid. More...

virtual double	getHeightAboveMSL (const ossimGpt &gpt)
	Get height above MSL for point. More...

virtual double	getHeightAboveEllipsoid (const ossimGpt &)
	Get height above ellipsoid for point. More...

virtual bool	pointHasCoverage (const ossimGpt &gpt) const
	Satisfies pure virtual ossimElevSource::pointHasCoverage. More...

virtual bool	getAccuracyInfo (ossimElevationAccuracyInfo &info, const ossimGpt &gpt) const

virtual bool	loadState (const ossimKeywordlist &kwl, const char *prefix=0)
	Statisfies pure virtual ossimElevSource::getAccuracyLE90. More...

virtual bool	saveState (ossimKeywordlist &kwl, const char *prefix=0) const
	Save the state to a keyword list. More...

void	getBoundingRect (ossimGrect &rect) const
	Gets the bounding rectangle/coverage of elevation. More...

virtual void	processFile (const ossimFilename &file)
	ProcessFile method. More...

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

Public Member Functions inherited from ossimElevationCellDatabase
	ossimElevationCellDatabase ()

	ossimElevationCellDatabase (const ossimElevationCellDatabase &src)

virtual ossim_uint32	getMinOpenCells () const

virtual ossim_uint32	getMaxOpenCells () const

virtual void	setMinMaxOpenCells (ossim_uint64 minCellCount, ossim_uint64 maxCellCount)

virtual bool	getMemoryMapCellsFlag () const

virtual void	setMemoryMapCellsFlag (bool flag)

virtual void	getOpenCellList (std::vector< ossimFilename > &list) const

void	getCellsForBounds (const ossim_float64 &minLat, const ossim_float64 &minLon, const ossim_float64 &maxLat, const ossim_float64 &maxLon, std::vector< ossimFilename > &cells, ossim_uint32 maxNumberOfCells=0)
	Gets a list of elevation cells needed to cover bounding box. More...

virtual ossim_uint64	createId (const ossimGpt &) const

Public Member Functions inherited from ossimElevationDatabase
	ossimElevationDatabase ()

	ossimElevationDatabase (const ossimElevationDatabase &src)

virtual double	getMeanSpacingMeters () const
	METHOD: meanSpacingMeters() This method returns the post spacing in the region of gpt: More...

virtual void	setGeoid (ossimGeoid *geoid)

ossimGeoid *	getGeoid ()

const ossimGeoid *	getGeoid () const

const ossimString &	getConnectionString () const

Public Member Functions inherited from ossimElevSource
bool	intersectRay (const ossimEcefRay &ray, ossimGpt &gpt, double defaultElevValue=0.0)
	METHOD: intersectRay() More...

virtual double	getMinHeightAboveMSL () const
	Access methods for the bounding elevations: More...

virtual double	getMaxHeightAboveMSL () const

double	getNullHeightValue () const
	Special numeric quantities as defined by this source: More...

double	getSeaLevelValue () const

virtual const ossimGrect &	getBoundingGndRect () const
	METHODS: accuracyLE90(), accuracyCE90() Returns the vertical and horizontal accuracy (90% confidence) in the region of gpt: More...

virtual bool	canConnectMyInputTo (ossim_int32 inputIndex, const ossimConnectableObject *object) const
	required to be overriden by derived classes More...

virtual void	initialize ()
	Implement ossimSource base-class pure virtuals: More...

virtual bool	getComputeStatisticsFlag () const
	Opens a stream to an elevation cell. More...

virtual void	setComputeStatisticsFlag (bool flag)
	Sets the flag which controls whether or not statistics will be computed upon opening a cell and not finding a corresponding statistics file. More...

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 void	setProperty (ossimRefPtr< ossimProperty > property)

virtual ossimRefPtr< ossimProperty >	getProperty (const ossimString &name) const

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

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 ossimString	getShortName () const

virtual ossimString	getLongName () const

virtual ossimString	getClassName () 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 ossimFileProcessorInterface
	ossimFileProcessorInterface ()
	default constructor More...

virtual	~ossimFileProcessorInterface ()
	virtual destructor. More...

Protected Member Functions
virtual	~ossimImageElevationDatabase ()
	Protected destructor. More...

virtual ossimRefPtr< ossimElevCellHandler >	createCell (const ossimGpt &gpt)

virtual ossimRefPtr< ossimElevCellHandler >	getOrCreateCellHandler (const ossimGpt &gpt)
	Gets cell for point. More...

virtual void	remove (ossim_uint64 id)
	Removes an entry from the m_cacheMap and m_entryMap maps. More...

Protected Member Functions inherited from ossimElevationCellDatabase
void	flushCacheToMinOpenCells ()

Protected Member Functions inherited from ossimElevationDatabase
virtual	~ossimElevationDatabase ()

virtual double	getOffsetFromEllipsoid (const ossimGpt &gpt)

Protected Member Functions inherited from ossimElevSource
virtual	~ossimElevSource ()

	ossimElevSource ()
	Constructors/Destructors: More...

	ossimElevSource (const ossimElevSource &src)

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)

Private Member Functions
void	loadFileMap ()
	Initializes m_entryMap with all loadable files from m_connectionString. More...

	ossimImageElevationDatabase (const ossimImageElevationDatabase &copy_this)
	Hidden from use copy constructor. More...

Private Attributes
std::map< ossim_uint64, ossimImageElevationFileEntry >	m_entryMap

ossim_uint64	m_lastMapKey

ossim_uint64	m_lastAccessedId

Additional Inherited Members
Public Types inherited from ossimElevationCellDatabase
typedef std::map< ossim_uint64, ossimRefPtr< CellInfo > >	CellMap

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

Protected Attributes inherited from ossimElevationCellDatabase
ossim_uint32	m_minOpenCells

ossim_uint32	m_maxOpenCells

std::mutex	m_cacheMapMutex

CellMap	m_cacheMap

ossim_uint32	m_memoryMapCellsFlag

	TYPE_DATA

Protected Attributes inherited from ossimElevationDatabase
ossimString	m_connectionString

ossimRefPtr< ossimGeoid >	m_geoid

ossim_float64	m_meanSpacing

Protected Attributes inherited from ossimElevSource
double	theMinHeightAboveMSL
	Data members: More...

double	theMaxHeightAboveMSL

double	theNullHeightValue

double	theSeaLevelValue

ossimGrect	theGroundRect

bool	theComputeStatsFlag

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

Detailed Description

Definition at line 37 of file ossimImageElevationDatabase.h.

Constructor & Destructor Documentation

◆ ossimImageElevationDatabase() [1/2]

ossimImageElevationDatabase::ossimImageElevationDatabase ( )

default constructor

Definition at line 28 of file ossimImageElevationDatabase.cpp.

    :
    ossimElevationCellDatabase(),
    ossimFileProcessorInterface(),
    m_entryMap(),
    m_lastMapKey(0),
    m_lastAccessedId(0)
 {
 }

◆ ~ossimImageElevationDatabase()

ossimImageElevationDatabase::~ossimImageElevationDatabase ( )

protectedvirtual

Protected destructor.

This class is derived from ossimReferenced so users should always use ossimRefPtr<ossimImageElevationDatabase> to hold instance.

Definition at line 39 of file ossimImageElevationDatabase.cpp.

40 {

41 }

◆ ossimImageElevationDatabase() [2/2]

ossimImageElevationDatabase::ossimImageElevationDatabase ( const ossimImageElevationDatabase & copy_this )

private

Hidden from use copy constructor.

Definition at line 431 of file ossimImageElevationDatabase.cpp.

References m_entryMap, m_lastAccessedId, and m_lastMapKey.

 : ossimElevationCellDatabase(copy)
 {
    m_entryMap = copy.m_entryMap;
    m_lastMapKey = copy.m_lastMapKey;
    m_lastAccessedId = copy.m_lastAccessedId;
 }

Member Function Documentation

◆ close()

void ossimImageElevationDatabase::close ( )

virtual

close method.

Unreferences all data.

Definition at line 83 of file ossimImageElevationDatabase.cpp.

References ossimString::clear(), ossimElevationDatabase::m_connectionString, ossimElevationDatabase::m_geoid, and ossimElevationDatabase::m_meanSpacing.

 {
    m_meanSpacing = 0.0;
    m_geoid = 0;
    m_connectionString.clear();
 }

◆ createCell()

ossimRefPtr< ossimElevCellHandler > ossimImageElevationDatabase::createCell ( const ossimGpt & gpt )

protectedvirtual

Reimplemented from ossimElevationCellDatabase.

Definition at line 118 of file ossimImageElevationDatabase.cpp.

References ossimSource::disableSource(), ossimSource::enableSource(), ossimRefPtr< T >::get(), ossimElevSource::getBoundingGndRect(), ossimImageElevationHandler::isOpen(), ossimElevationCellDatabase::m_cacheMapMutex, m_entryMap, m_lastAccessedId, ossimImageElevationHandler::open(), ossimNotify(), ossimNotifyLevel_WARN, and ossimImageElevationHandler::pointHasCoverage().

Referenced by getOrCreateCellHandler().

 {
    ossimRefPtr<ossimElevCellHandler> result = 0;
    
    // Need to disable elevation while loading the DEM image to prevent recursion:
    disableSource();
 
    std::map<ossim_uint64, ossimImageElevationFileEntry>::iterator i = m_entryMap.begin();
    while ( i != m_entryMap.end() )
    {
       if ( (*i).second.m_loadedFlag == false )
       {
          // not loaded
          ossimRefPtr<ossimImageElevationHandler> h = new ossimImageElevationHandler();
 
          if ( (*i).second.m_rect.isLonLatNan() )
          {
             if ( h->open( (*i).second.m_file ) )
             {
                // First time opened.  Capture the rectangle. for next time.
                (*i).second.m_rect = h->getBoundingGndRect();
             }
             else
             {
                ossimNotify(ossimNotifyLevel_WARN)
                   << "ossimImageElevationDatabase::createCell WARN:\nCould not open: "
                   << (*i).second.m_file << "\nRemoving file from map!" << std::endl;
 
                // Get a copy of the iterator to delet.
                std::map<ossim_uint64, ossimImageElevationFileEntry>::iterator badIter = i;
                
                ++i; // Go to next image.
 
                // Must put lock around erase.
                m_cacheMapMutex.lock();
                m_entryMap.erase(badIter);
                m_cacheMapMutex.unlock();
                
                continue; // Skip the rest of this loop.
             }
          }
 
          // Check the North up bounding rectangle for intersect.
          if ( (*i).second.m_rect.pointWithin(gpt) )
          {
             if ( h->isOpen() == false )
             {
                h->open( (*i).second.m_file );
             }
 
             if ( h->isOpen() )
             {
                //---
                // Check point coverage again as image may not be geographic and pointHasCoverage
                // has a check on worldToLocal point.
                //---
                if (  h->pointHasCoverage(gpt) )
                {
                   m_lastAccessedId = (*i).first;
                   (*i).second.m_loadedFlag = true;
                   result = h.get();
                   break;
                }
                else
                {
                   h = 0;
                }
             }
          }
          else
          {
             h = 0;
          }
       }
 
       ++i;
    }
    
    enableSource();
    return result;
 }

◆ dup()

virtual ossimObject* ossimImageElevationDatabase::dup ( ) const

inlinevirtual

Implements ossimElevSource.

Definition at line 59 of file ossimImageElevationDatabase.h.

References open().

    {
       ossimImageElevationDatabase* duped = new ossimImageElevationDatabase;
       duped->open(m_connectionString);
       return duped;
    }

◆ getAccuracyInfo()

bool ossimImageElevationDatabase::getAccuracyInfo	(	ossimElevationAccuracyInfo &	info,
		const ossimGpt &	gpt
	)		const

virtual

Reimplemented from ossimElevationDatabase.

Definition at line 342 of file ossimImageElevationDatabase.cpp.

References ossimElevationAccuracyInfo::m_surfaceName, and pointHasCoverage().

 {
    if(pointHasCoverage(gpt))
    {
      info.m_surfaceName = "Image Elevation";
    }
 
    return false;
 }

◆ getBoundingRect()

void ossimImageElevationDatabase::getBoundingRect ( ossimGrect & rect ) const

Gets the bounding rectangle/coverage of elevation.

Parameters

rect	Rectangle to initialize.

Definition at line 311 of file ossimImageElevationDatabase.cpp.

References ossimGrect::combine(), ossimElevSource::getBoundingGndRect(), ossimGrect::isLonLatNan(), m_entryMap, ossimGrect::makeNan(), and ossimImageElevationHandler::open().

 {
    // The bounding rect is the North up rectangle.  So if the underlying image projection is not
    // a geographic projection and there is a rotation this will include null coverage area.
    rect.makeNan();
    std::map<ossim_uint64, ossimImageElevationFileEntry>::const_iterator i = m_entryMap.begin();
    ossimGrect subRect;
    while ( i != m_entryMap.end() )
    {
       subRect = i->second.m_rect;
       if (subRect.isLonLatNan())
       {
          // The DEM source was not yet initialized:
          ossimRefPtr<ossimImageElevationHandler> h = new ossimImageElevationHandler();
          if ( h->open( i->second.m_file ) )
             subRect = h->getBoundingGndRect();
          else
          {
             ++i;
             continue;
          }
       }
       if (rect.isLonLatNan())
          rect = subRect;
       else
          rect = rect.combine(subRect);
       ++i;
    }
 }

◆ getHeightAboveEllipsoid()

double ossimImageElevationDatabase::getHeightAboveEllipsoid ( const ossimGpt & gpt )

virtual

Get height above ellipsoid for point.

Satisfies pure virtual ossimElevSource::getHeightAboveMSL().

Returns: Height above MSL.

Reimplemented from ossimElevSource.

Definition at line 108 of file ossimImageElevationDatabase.cpp.

References getHeightAboveMSL(), ossimElevationDatabase::getOffsetFromEllipsoid(), and ossim::isnan().

 {
    double h = getHeightAboveMSL(gpt);
    if(!ossim::isnan(h))
    {
       h += getOffsetFromEllipsoid(gpt);
    }
    return h;
 }

◆ getHeightAboveMSL()

double ossimImageElevationDatabase::getHeightAboveMSL ( const ossimGpt & gpt )

virtual

Get height above MSL for point.

Satisfies pure virtual ossimElevSource::getHeightAboveMSL().

Returns: Height above MSL.

Implements ossimElevSource.

Definition at line 90 of file ossimImageElevationDatabase.cpp.

References ossimElevSource::getHeightAboveMSL(), ossimElevCellHandler::getMeanSpacingMeters(), getOrCreateCellHandler(), ossimSource::isSourceEnabled(), ossimElevationDatabase::m_meanSpacing, ossim::nan(), and ossimRefPtr< T >::valid().

Referenced by getHeightAboveEllipsoid().

 {
    double h = ossim::nan();
    if(isSourceEnabled())
    {
       ossimRefPtr<ossimElevCellHandler> handler = getOrCreateCellHandler(gpt);
       if(handler.valid())
       {
          h = handler->getHeightAboveMSL(gpt); // still need to shift
 
          // Save the elev source's post spacing as the database's mean spacing:
          m_meanSpacing = handler->getMeanSpacingMeters();
       }
    }
 
    return h;
 }

◆ getOrCreateCellHandler()

ossimRefPtr< ossimElevCellHandler > ossimImageElevationDatabase::getOrCreateCellHandler ( const ossimGpt & gpt )

protectedvirtual

Gets cell for point.

This override ossimElevationCellDatabase::getOrCreateCellHandler as we cannot use the createId as our cells could be of any size.

Reimplemented from ossimElevationCellDatabase.

Definition at line 201 of file ossimImageElevationDatabase.cpp.

References createCell(), ossimElevationCellDatabase::flushCacheToMinOpenCells(), ossimRefPtr< T >::get(), ossimElevationCellDatabase::m_cacheMap, ossimElevationCellDatabase::m_cacheMapMutex, m_lastAccessedId, m_lastMapKey, ossimElevationCellDatabase::m_maxOpenCells, and ossimRefPtr< T >::valid().

Referenced by getHeightAboveMSL().

 {
    ossimRefPtr<ossimElevCellHandler> result = 0;
    
    // Note: Must do mutex lock / unlock around any cach map access.
    m_cacheMapMutex.lock();
 
    if ( m_cacheMap.size() )
    {
       //---
       // Look in existing map for handler.
       //
       // Note: Cannot key off of id from gpt as cells can be any arbituary dimensions.
       //---
 
       CellMap::iterator lastAccessedCellIter = m_cacheMap.find(m_lastAccessedId);
       CellMap::iterator iter = lastAccessedCellIter;
         
       // Check from last accessed to end.
       while ( iter != m_cacheMap.end() )
       {
          if ( iter->second->m_handler->pointHasCoverage(gpt) )
          {
             result = iter->second->m_handler.get();
             break;
          }
          ++iter;
       }
      
       if ( result.valid() == false )
       {
          iter = m_cacheMap.begin();
               
          // Beginning to last accessed.
          while ( iter != lastAccessedCellIter)
          {
             if ( iter->second->m_handler->pointHasCoverage(gpt) )
             {
                result = iter->second->m_handler.get();
                break;
             }
             ++iter;
          }
       }
 
       if ( result.valid() )
       {
          m_lastAccessedId  = iter->second->m_id;
          iter->second->updateTimestamp();
       }
    }
    m_cacheMapMutex.unlock();
   
    if ( result.valid() == false )
    {
       // Not in m_cacheMap.  Create a new cell for point if we have coverage.
       result = createCell(gpt);
 
       if(result.valid())
       {
          std::lock_guard<std::mutex> lock(m_cacheMapMutex);
 
          //---
          // Add the cell to map.
          // NOTE: ossimImageElevationDatabase::createCell sets m_lastAccessedId to that of
          // the entries map key.
          //---
          m_cacheMap.insert(std::make_pair(m_lastAccessedId,
                                           new CellInfo(m_lastAccessedId, result.get())));
 
          ++m_lastMapKey;
 
          // Check the map size and purge cells if needed.
          if(m_cacheMap.size() > m_maxOpenCells)
          {
             flushCacheToMinOpenCells();
          }
       }
    }
 
    return result;
 }

◆ loadFileMap()

void ossimImageElevationDatabase::loadFileMap ( )

private

Initializes m_entryMap with all loadable files from m_connectionString.

Definition at line 408 of file ossimImageElevationDatabase.cpp.

References ossimFileWalker::initializeDefaultFilterList(), ossimElevationDatabase::m_connectionString, ossimFileWalker::setFileProcessor(), ossimString::size(), and ossimFileWalker::walk().

 {
    if ( m_connectionString.size() )
    {
       // Create a file walker which will find files we can load from the connection string.
       ossimFileWalker* fw = new ossimFileWalker();
       
       fw->initializeDefaultFilterList();
 
       // This links the file walker back to our "processFile" method.
       fw->setFileProcessor( this );
       
       ossimFilename f = m_connectionString;
 
       // ossimFileWalker::walk will in turn call back to processFile method for each file it finds.
       fw->walk(f); 
       
       delete fw;
       fw = 0;
    }
 }

◆ loadState()

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

virtual

Statisfies pure virtual ossimElevSource::getAccuracyLE90.

Returns: The vertical accuracy (90% confidence) in the region of gpt: Statisfies pure virtual ossimElevSource::getAccuracyCE90.; The horizontal accuracy (90% confidence) in the region of gpt.Initialize from keyword list.

Reimplemented from ossimElevationCellDatabase.

Definition at line 352 of file ossimImageElevationDatabase.cpp.

 {
    static const char M[] = "ossimImageElevationDatabase::loadState";
    if(traceDebug())
    {
       ossimNotify(ossimNotifyLevel_DEBUG)
          << M << " entered..." << "\nkwl:\n" << kwl << "\n";
    }     
    bool result = false;
    const char* lookup = kwl.find(prefix, "type");
    if ( lookup )
    {
       std::string type = lookup;
       if ( ( type == "image_directory" ) || ( type == "ossimImageElevationDatabase" ) )
       {
          result = ossimElevationCellDatabase::loadState(kwl, prefix);
 
          if ( result )
          {
             loadFileMap();
          }
       }
    }
 
    if(traceDebug())
    {
       ossimNotify(ossimNotifyLevel_DEBUG) << M << " result=" << (result?"true\n":"false\n");
    }
 
    return result;
 }

◆ mapRegion()

void ossimImageElevationDatabase::mapRegion ( const ossimGrect & region )

Maps elevation data for region to a grid.

This uses connectionString passed to open method as starting point.

◆ open()

bool ossimImageElevationDatabase::open ( const ossimString & connectionString )

virtual

Open a connection to a database.

Parameters

connectionString File or directory to open. In most cases this will point to a directory containing DEMs. Satisfies pure virtual ossimElevationDatabase::open().

Returns: true on success, false on error.

Implements ossimElevationDatabase.

Definition at line 43 of file ossimImageElevationDatabase.cpp.

Referenced by dup(), and ossimPointCloudTool::loadDem().

 {
    // return false; // tmp drb...
    
    static const char M[] = "ossimImageElevationDatabase::open";
    if(traceDebug())
    {
       ossimNotify(ossimNotifyLevel_DEBUG)
          << M << " entered...\n"
          << "\nConnection string: " << connectionString << "\n";
    }                   
    
    bool result = false;
 
    close();
 
    if ( connectionString.size() )
    {
       m_connectionString = connectionString.c_str();
 
       loadFileMap();
 
       if ( m_entryMap.size() )
       {
          result = true;
       }
       else
       {
          m_connectionString.clear();
       }
    }
    
    if(traceDebug())
    {
       ossimNotify(ossimNotifyLevel_DEBUG) << M << " result=" << (result?"true\n":"false\n");
    }
 
    return result;
 }

◆ pointHasCoverage()

bool ossimImageElevationDatabase::pointHasCoverage ( const ossimGpt & gpt ) const

virtual

Satisfies pure virtual ossimElevSource::pointHasCoverage.

Returns: true if database has coverage for point.

Implements ossimElevSource.

Definition at line 285 of file ossimImageElevationDatabase.cpp.

References m_entryMap.

Referenced by getAccuracyInfo().

 {
    //---
    // NOTE:
    //
    // The bounding rect is the North up rectangle.  So if the underlying image projection is not
    // a geographic projection and there is a rotation this could return false positives.  Inside
    // the ossimImageElevationDatabase::createCell there is a call to
    // ossimImageElevationHandler::pointHasCoverage which does a real check from the
    // ossimImageGeometry of the image.
    //---
    bool result = false;
    std::map<ossim_uint64, ossimImageElevationFileEntry>::const_iterator i = m_entryMap.begin();
    while ( i != m_entryMap.end() )
    {
       if ( (*i).second.m_rect.pointWithin(gpt) )
       {
          result = true;
          break;
       }
       ++i;
    }
    return result;
 }

◆ print()

std::ostream & ossimImageElevationDatabase::print ( std::ostream & out ) const

virtual

Outputs theErrorStatus as an ossimErrorCode and an ossimString.

Returns: std::ostream&

Note: Derived classes should only have to implement a virtual print, not an operator<< funtion as it's implemented here.

Reimplemented from ossimElevationCellDatabase.

Definition at line 466 of file ossimImageElevationDatabase.cpp.

References saveState().

 {
    ossimKeywordlist kwl;
    saveState(kwl);
    out << "\nossimImageElevationDatabase @ "<< (ossim_uint64) this << "\n"
          << kwl <<ends;
    return out;
 }

◆ processFile()

void ossimImageElevationDatabase::processFile ( const ossimFilename & file )

virtual

ProcessFile method.

Satisfies pure virtual ossimFileProcessorInterface::processFile.

This method is linked to the ossimFileWalker::walk method via a pointer to this class.

Parameters

file	to process.

Implements ossimFileProcessorInterface.

Definition at line 389 of file ossimImageElevationDatabase.cpp.

 {
    static const char M[] = "ossimImageElevationDatabase::processFile";
    if(traceDebug())
    {
       ossimNotify(ossimNotifyLevel_DEBUG)
          << M << " entered...\n" << "file: " << file << "\n";
    }
 
    // Add the file.
    m_entryMap.insert( std::make_pair(m_lastMapKey++, ossimImageElevationFileEntry(file)) );
 
    if(traceDebug())
    {
       // Since ossimFileWalker is threaded output the file so we know which job exited.
       ossimNotify(ossimNotifyLevel_DEBUG) << M << "\nfile: " << file << "\nexited...\n";
    } 
 }

◆ remove()

void ossimImageElevationDatabase::remove ( ossim_uint64 id )

inlineprotectedvirtual

Removes an entry from the m_cacheMap and m_entryMap maps.

Reimplemented from ossimElevationCellDatabase.

Definition at line 209 of file ossimImageElevationDatabase.h.

References m_entryMap, and ossimElevationCellDatabase::remove().

 {
    std::map<ossim_uint64, ossimImageElevationFileEntry>::iterator entryIter = m_entryMap.find(id);
    if ( entryIter != m_entryMap.end() )
    {
       (*entryIter).second.m_loadedFlag = false;
    }
    ossimElevationCellDatabase::remove(id);
 }

◆ saveState()

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

virtual

Save the state to a keyword list.

Reimplemented from ossimElevationCellDatabase.

Definition at line 384 of file ossimImageElevationDatabase.cpp.

References ossimElevationCellDatabase::saveState().

Referenced by print().

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

Member Data Documentation

◆ m_entryMap

std::map<ossim_uint64, ossimImageElevationFileEntry> ossimImageElevationDatabase::m_entryMap

private

Definition at line 202 of file ossimImageElevationDatabase.h.

Referenced by createCell(), getBoundingRect(), ossimImageElevationDatabase(), pointHasCoverage(), and remove().

◆ m_lastAccessedId

ossim_uint64 ossimImageElevationDatabase::m_lastAccessedId

private

Definition at line 204 of file ossimImageElevationDatabase.h.

Referenced by createCell(), getOrCreateCellHandler(), and ossimImageElevationDatabase().

◆ m_lastMapKey

ossim_uint64 ossimImageElevationDatabase::m_lastMapKey

private

Definition at line 203 of file ossimImageElevationDatabase.h.

Referenced by getOrCreateCellHandler(), and ossimImageElevationDatabase().

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

Classes

Public Member Functions

Protected Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ ossimImageElevationDatabase() [1/2]

◆ ~ossimImageElevationDatabase()

◆ ossimImageElevationDatabase() [2/2]

Member Function Documentation

◆ close()

◆ createCell()

◆ dup()

◆ getAccuracyInfo()

◆ getBoundingRect()

◆ getHeightAboveEllipsoid()

◆ getHeightAboveMSL()

◆ getOrCreateCellHandler()

◆ loadFileMap()

◆ loadState()

◆ mapRegion()

◆ open()

◆ pointHasCoverage()

◆ print()

◆ processFile()

◆ remove()

◆ saveState()

Member Data Documentation

◆ m_entryMap

◆ m_lastAccessedId

◆ m_lastMapKey