#include <ossimHistogramRemapper.h>

Inheritance diagram for ossimHistogramRemapper:

Public Types
enum	StretchMode { LINEAR_ONE_PIECE = 0, LINEAR_1STD_FROM_MEAN = 1, LINEAR_2STD_FROM_MEAN = 2, LINEAR_3STD_FROM_MEAN = 3, LINEAR_AUTO_MIN_MAX = 4, LINEAR_AUTO_PERCENTILE = 5, STRETCH_UNKNOWN = 6 }

Public Types inherited from ossimTableRemapper
enum	RemapTableType { UKNOWN = 0, NATIVE = 1, MIN_MAX = 2, NORMALIZED = 3 }

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

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

virtual ossimString	getLongName () const

virtual ossimString	getShortName () const

virtual ossimRefPtr< ossimImageData >	getTile (const ossimIrect &tile_rect, ossim_uint32 resLevel=0)

virtual void	initialize ()

void	reset ()

void	setStretchMode (StretchMode mode, bool rebuildTableFlag=false)
	Sets remap mode to mode. More...

void	setStretchModeAsString (const ossimString &mode, bool rebuildTableFlag=false)
	Stretch mode values can be linear_one_piece, linear_1std_from_mean, linear_2std_from_mean, linear_3std_from_mean, linear_auto_min_max, If rebuildTableFlag is true, the table will be built at this time; else just the dirty flag is set. More...

StretchMode	getStretchMode () const
	Returns the current enumerated node. More...

ossimString	getStretchModeString () const
	Returns the string for current remap mode. More...

ossim_uint32	getNumberOfStretchModes () const
	Returns the number of stretch modes. More...

ossimString	getStretchModeString (ossim_uint32 index) const
	Returns the mode string for a given index. More...

void	setLowNormalizedClipPoint (const ossim_float64 &clip)
	Sets the low clip point. More...

void	setLowNormalizedClipPoint (const ossim_float64 &clip, ossim_uint32 zero_based_band)
	Sets the low clip point for band. More...

void	setHighNormalizedClipPoint (const ossim_float64 &clip)
	Sets the high clip point. More...

void	setHighNormalizedClipPoint (const ossim_float64 &clip, ossim_uint32 zero_based_band)
	Sets the high clip point. More...

void	setLowClipPoint (const ossim_float64 &clip)
	Sets the low clip point. More...

void	setLowClipPoint (const ossim_float64 &clip, ossim_uint32 zero_based_band)
	Sets the low clip point for band. More...

void	setHighClipPoint (const ossim_float64 &clip)
	Sets the high clip point. More...

void	setHighClipPoint (const ossim_float64 &clip, ossim_uint32 zero_based_band)
	Sets the high clip point. More...

void	setMidPoint (const ossim_float64 &value)
	Sets the mid clip point. More...

void	setMidPoint (const ossim_float64 &value, ossim_uint32 zero_based_band)
	Sets the mid clip point for band. More...

void	setMinOutputValue (const ossim_float64 &value)
	Sets the min output value. More...

void	setMinOutputValue (const ossim_float64 &value, ossim_uint32 zero_based_band)
	Sets the min output value for band. More...

void	setMaxOutputValue (const ossim_float64 &value)
	Sets the max output value. More...

void	setMaxOutputValue (const ossim_float64 &value, ossim_uint32 zero_based_band)
	Sets the min output value for band. More...

ossim_float64	getLowNormalizedClipPoint (ossim_uint32 zero_based_band) const
	Returns the normalized low clip point for band. More...

ossim_float64	getLowNormalizedClipPoint () const
	Returns the normalized low clip point which is the average of all bands. More...

ossim_float64	getHighNormalizedClipPoint (ossim_uint32 zero_based_band) const
	Returns the normalized high clip point for band. More...

ossim_float64	getHighNormalizedClipPoint () const
	Returns the normalized High clip point which is the average of all bands. More...

ossim_float64	getLowClipPoint (ossim_uint32 zero_based_band) const
	Returns the low clip point for band. More...

ossim_float64	getLowClipPoint () const
	Returns the low clip point which is the average of all bands. More...

ossim_float64	getHighClipPoint (ossim_uint32 zero_based_band) const
	Returns the high clip point for band. More...

ossim_float64	getHighClipPoint () const
	Returns the high clip point which is the average of all bands. More...

ossim_float64	getMidPoint (ossim_uint32 zero_based_band) const
	Returns the mid point for band. More...

ossim_float64	getMidPoint () const
	Returns the mid clip point which is the average of all bands. More...

ossim_float64	getMinOutputValue (ossim_uint32 zero_based_band) const
	Returns the minimum output value for band. More...

ossim_float64	getMinOutputValue () const
	Returns the minimum output value which is the average of all bands. More...

ossim_float64	getMaxOutputValue (ossim_uint32 zero_based_band) const
	Returns the maximum output value for band. More...

ossim_float64	getMaxOutputValue () const
	Returns the maximum output value which is the average of all bands. More...

void	setHistogram (ossimRefPtr< ossimMultiResLevelHistogram > histogram)
	Sets the histogram. More...

ossimRefPtr< ossimMultiResLevelHistogram >	getHistogram ()

ossimRefPtr< const ossimMultiResLevelHistogram >	getHistogram () const

ossimRefPtr< ossimHistogram >	getHistogram (ossim_uint32 zero_based_band, ossim_uint32 res_level=0) const
	Returns pointer to histogram for band and reduced res level. More...

bool	openHistogram (const ossimFilename &histogram_file)
	Open the histogram file. More...

bool	computeHistogram (const ossimIrect &roi)
	Compute the histogram from input connection and region of interest. More...

ossimFilename	getHistogramFile () const
	Returns the currently opened histogram. More...

virtual bool	saveState (ossimKeywordlist &kwl, const char *prefix=0) const
	Method to the save the state 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 ostream &	print (ostream &os) const
	Outputs theErrorStatus as an ossimErrorCode and an ossimString. More...

virtual double	getMinPixelValue (ossim_uint32 band=0) const
	Returns the min pixel of the band. More...

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

bool	canConnectMyInputTo (ossim_int32 inputIndex, const ossimConnectableObject *object) const
	Will test for the input being a ossimHistogramSource and allow pulling the histogram from a histogram source. More...

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

virtual ossimScalarType	getOutputScalarType () const
	This will be used to query the output pixel type of the tile source. More...

Public Member Functions inherited from ossimImageSourceFilter
	ossimImageSourceFilter (ossimObject *owner=NULL)

	ossimImageSourceFilter (ossimImageSource *inputSource)

	ossimImageSourceFilter (ossimObject owner, ossimImageSource inputSource)

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

virtual ossim_uint32	getNumberOfInputBands () const

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

virtual void	connectInputEvent (ossimConnectionEvent &event)

virtual void	disconnectInputEvent (ossimConnectionEvent &event)

virtual void	propertyEvent (ossimPropertyEvent &event)

virtual void	refreshEvent (ossimRefreshEvent &event)

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 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 bool	getTile (ossimImageData *result, ossim_uint32 resLevel=0)
	Method to get a tile. More...

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

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

virtual void	getDecimationFactor (ossim_uint32 resLevel, ossimDpt &result) const
	Will return the decimation factor for the given resolution level. More...

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

virtual ossim_uint32	getNumberOfDecimationLevels () const
	Will return the number of resolution levels. More...

virtual ossim_uint32	getNumberOfOutputBands () const
	Returns the number of bands in a tile returned from this TileSource. 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 double	getNullPixelValue (ossim_uint32 band=0) const
	Each band has a null pixel associated with it. More...

virtual ossimIrect	getBoundingRect (ossim_uint32 resLevel=0) const
	This will return the bounding rect of the source. 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 ossimRefPtr< ossimImageGeometry >	getImageGeometry ()
	Returns the image geometry object associated with this tile source or NULL if not defined. More...

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

virtual void	saveImageGeometry () const
	Default method to call input's saveImageGeometry. More...

virtual void	saveImageGeometry (const ossimFilename &geometry_file) const
	Default method to call input's saveImageGeometry. 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)

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 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 ossimConnectableObjectListener
	ossimConnectableObjectListener ()

virtual	~ossimConnectableObjectListener ()

virtual void	processEvent (ossimEvent &event)
	ProcessEvent. More...

virtual void	objectDestructingEvent (ossimObjectDestructingEvent &)

virtual void	connectionEvent (ossimConnectionEvent &)

virtual void	disconnectOutputEvent (ossimConnectionEvent &)

virtual void	connectOutputEvent (ossimConnectionEvent &)

virtual void	addObjectEvent (ossimContainerEvent &)

virtual void	removeObjectEvent (ossimContainerEvent &)

virtual void	containerEvent (ossimContainerEvent &)

Public Member Functions inherited from ossimListener
	ossimListener ()

virtual	~ossimListener ()

void	enableListener ()

void	disableListener ()

void	setListenerEnableFlag (bool flag)

bool	isListenerEnabled () const

bool	getListenerEnableFlag () const

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

Protected Member Functions inherited from ossimTableRemapper
virtual	~ossimTableRemapper ()
	virtual destructor More...

void	allocate (const ossimIrect &rect)

void	destroy ()

void	remapFromNativeTable (ossimRefPtr< ossimImageData > &inputTile)

template<class T >
void	remapFromNativeTable (T dummy, ossimRefPtr< ossimImageData > &inputTile)

void	remapFromNormalizedTable (ossimRefPtr< ossimImageData > &inputTile)

template<class T >
void	dumpTable (T dummy, ostream &os) const

	ossimTableRemapper (const ossimTableRemapper &tr)

ossimTableRemapper &	operator= (const ossimTableRemapper &tr)

Protected Member Functions inherited from ossimImageSourceFilter
virtual	~ossimImageSourceFilter ()

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)

Private Member Functions
	ossimHistogramRemapper (const ossimHistogramRemapper &hr)

ossimHistogramRemapper &	operator= (const ossimHistogramRemapper &hr)

void	buildTable ()

void	buildLinearTable ()

void	buildAutoLinearMinMaxTable ()

void	buildAutoLinearPercentileTable ()

template<class T >
void	buildLinearTable (T dummy)

template<class T >
void	buildAutoLinearMinMaxTableTemplate (T dummy)

template<class T >
void	buildAutoLinearPercentileTableTemplate (T dummy)

void	buildLinearTableStdFromMean ()
	Sets clip points using mean and standard deviations then calls buildLinearTable method. More...

void	initializeClips ()
	Uses getNumberOfInputBands() to determine BANDS then calls initializeClips(BANDS) More...

void	initializeClips (ossim_uint32 bands)
	Initializes data members to some default state and size. More...

void	setNullCount ()

void	initializeMinMaxOutput ()

void	setupTable ()
	Initialized base class (ossimTableRemapper) values: More...

void	verifyEnabled ()
	This set theBypassFlag. More...

ossim_uint32	getHistogramBand (ossim_uint32 input_band) const
	Returns the histogram band that maps to the input band. More...

void	setBypassFlag (bool flag)
	Sets theBypassFlag. More...

void	makeClean ()
	If we are dirty then it will init what it needs and then set the dirty back to false;. More...

template<class T >
void	applyLinearStretch (T dummy, ossimRefPtr< ossimImageData > &inputTile)

Private Attributes
StretchMode	theStretchMode

bool	theDirtyFlag

ossimRefPtr< ossimMultiResLevelHistogram >	theHistogram

vector< ossim_float64 >	theNormalizedLowClipPoint

vector< ossim_float64 >	theNormalizedHighClipPoint

vector< ossim_float64 >	theMidPoint

vector< ossim_float64 >	theMinOutputValue

vector< ossim_float64 >	theMaxOutputValue

vector< ossim_uint32 >	theBandList

bool	theBypassFlag

bool	theResetBandIndicesFlag

Additional Inherited Members
Protected Attributes inherited from ossimTableRemapper
ossimRefPtr< ossimImageData >	theTile

ossimRefPtr< ossimImageData >	theTmpTile

std::vector< ossim_uint8 >	theTable

ossim_float64 *	theNormBuf

ossim_uint32	theTableBinCount

ossim_uint32	theTableBandCount

RemapTableType	theTableType

ossimScalarType	theInputScalarType

ossimScalarType	theOutputScalarType

Protected Attributes inherited from ossimImageSourceFilter
ossimImageSource *	theInputConnection

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

Protected Attributes inherited from ossimListener
bool	theListenerEnableFlag

Detailed Description

Definition at line 39 of file ossimHistogramRemapper.h.

Member Enumeration Documentation

◆ StretchMode

enum ossimHistogramRemapper::StretchMode

Enumerator
LINEAR_ONE_PIECE
LINEAR_1STD_FROM_MEAN
LINEAR_2STD_FROM_MEAN
LINEAR_3STD_FROM_MEAN
LINEAR_AUTO_MIN_MAX
LINEAR_AUTO_PERCENTILE
STRETCH_UNKNOWN

Definition at line 42 of file ossimHistogramRemapper.h.

    {
       LINEAR_ONE_PIECE       = 0,
       LINEAR_1STD_FROM_MEAN  = 1,
       LINEAR_2STD_FROM_MEAN  = 2,
       LINEAR_3STD_FROM_MEAN  = 3,
       LINEAR_AUTO_MIN_MAX    = 4,
       LINEAR_AUTO_PERCENTILE = 5,
       STRETCH_UNKNOWN = 6 // Alway last as used for number of modes method.
    };

Constructor & Destructor Documentation

◆ ossimHistogramRemapper() [1/2]

ossimHistogramRemapper::ossimHistogramRemapper ( )

default constructor

Definition at line 52 of file ossimHistogramRemapper.cpp.

References ossimConnectableObject::setNumberOfInputs().

    :
    ossimTableRemapper(),  // base class
    theStretchMode(ossimHistogramRemapper::LINEAR_ONE_PIECE),
    theDirtyFlag(false),
    theHistogram(0),
    theNormalizedLowClipPoint(),
    theNormalizedHighClipPoint(),
    theMidPoint(),
    theMinOutputValue(),
    theMaxOutputValue(),
    theBandList(),
    theBypassFlag(true),
    theResetBandIndicesFlag(false)
 {
    setNumberOfInputs(2);
    if (traceDebug())
    {
       ossimNotify(ossimNotifyLevel_DEBUG)
          << "ossimHistogramRemapper::ossimHistogramRemapper entered...\n";
 #ifdef OSSIM_ID_ENABLED
       ossimNotify(ossimNotifyLevel_DEBUG)
          << "OSSIM_ID:  " << OSSIM_ID << "\n";
 #endif      
    }
 }

◆ ~ossimHistogramRemapper()

ossimHistogramRemapper::~ossimHistogramRemapper ( )

protectedvirtual

virtual destructor

Definition at line 79 of file ossimHistogramRemapper.cpp.

80 {

81 }

◆ ossimHistogramRemapper() [2/2]

ossimHistogramRemapper::ossimHistogramRemapper ( const ossimHistogramRemapper & hr )

private

Definition at line 2239 of file ossimHistogramRemapper.cpp.

2240 {

2241 }

Member Function Documentation

◆ applyLinearStretch()

template<class T >

void ossimHistogramRemapper::applyLinearStretch	(	T	dummy,
		ossimRefPtr< ossimImageData > &	inputTile
	)

private

Definition at line 295 of file ossimHistogramRemapper.cpp.

References getHistogram(), ossimImageData::getNumberOfBands(), theNormalizedLowClipPoint, and ossimRefPtr< T >::valid().

Referenced by getTile().

 {
    const ossim_uint32 BANDS = inputTile->getNumberOfBands();
 
    // Sanity check.
    if (theNormalizedLowClipPoint.size() != BANDS || !getHistogram(0).valid())
    {
       if(traceDebug())
       {
          ossimNotify(ossimNotifyLevel_WARN)
             << "ossimHistogramRemapper::buildTable ERROR!"
             << " Line:  " << __LINE__ << endl;
       }
       return;
    }
 
 
    
 //   T* table = reinterpret_cast<T*>(&theTable.front());
 //   ossim_uint32 index = 0;
    
    // Finally, build the table...
    for (ossim_uint32 band = 0; band < BANDS; ++band)
    {
       ossimRefPtr<ossimHistogram> h  = getHistogram(band);
       T* bandPtr = static_cast<T*>(inputTile->getBuf(band));
       T* outputPtr = static_cast<T*>(theTile->getBuf(band));
       if (h.get()&&bandPtr&&outputPtr)
       {
          if (traceDebug())
          {
             ossimNotify(ossimNotifyLevel_DEBUG)
                << "ossimHistogramRemapper::buildLinearTable DEBUG:"
                << "\nband:  " << band
                << "\nmean:  " << h->GetMean()
                << "\nstddev:  " << h->GetStandardDev()
                << endl;
          }
       }
       else
       {
          if(traceDebug())
          {
             ossimNotify(ossimNotifyLevel_WARN)
             << "ossimHistogramRemapper::buildTable ERROR!"
             << " Line:  " << __LINE__ << endl;
          }
          return; 
       }
       //std::cout << "MIN OUTPUT ==== " << theMinOutputValue[band] << std::endl;
       const T NULL_PIX = static_cast<T>(getNullPixelValue(band));
       const T MIN_PIX  = static_cast<T>(theMinOutputValue[band]);
       const T MAX_PIX  = static_cast<T>(theMaxOutputValue[band]);
 //std::cout <<"theMinOutputValue[band]: " << theMinOutputValue[band] << "\n";
 //std::cout <<"theMaxOutputValue[band]: " << theMaxOutputValue[band] << "\n";
 //std::cout <<"theNormalizedLowClipPoint[band]: " << theNormalizedLowClipPoint[band] << "\n";
 //std::cout <<"theNormalizedHighClipPoint[band]: " << theNormalizedHighClipPoint[band] << "\n";
 //std::cout <<"MIN_PIX: " << MIN_PIX << "\n";
 //std::cout <<"MAX_PIX: " << MAX_PIX << "\n";
       ossim_float64 min_clip_value =
          h->LowClipVal(theNormalizedLowClipPoint[band]);
       ossim_float64 max_clip_value =
          h->HighClipVal(1.0-theNormalizedHighClipPoint[band]);
 
       if(theTableType == ossimTableRemapper::NATIVE)
       {
          min_clip_value = floor(min_clip_value);
          max_clip_value = ceil(max_clip_value); 
       }
       //ossim_float64 gain = (MAX_PIX-MIN_PIX+1)/(max_clip_value-min_clip_value);
       ossim_float64 gain = 1.0;
 
       if(theTableType == ossimTableRemapper::NATIVE)
       {
          gain = (MAX_PIX-MIN_PIX+1)/(max_clip_value-min_clip_value);
       }
       else
       {
          gain = (MAX_PIX-MIN_PIX)/(max_clip_value-min_clip_value);         
       }
       const ossim_uint32 PPB   = inputTile->getSizePerBand(); // pixels per band
 
       ossim_uint32 idx = 0;
       for(idx = 0; idx < PPB;++idx)
       {
          if ( bandPtr[idx] != NULL_PIX )
          {
             ossim_float64 p = bandPtr[idx];
             if (p < min_clip_value)
             {
                p = MIN_PIX;
             }
             else if (p > max_clip_value)
             {
                p = MAX_PIX;
             }
             else
             {
                p = ((p - min_clip_value) * gain) + MIN_PIX;// - 1.0;
             }
             // Final range check:
             outputPtr[idx] =
                static_cast<T>( p >= MIN_PIX ? ( p <= MAX_PIX ? p : MAX_PIX ) : MIN_PIX );
          }
          else
          {
             outputPtr[idx] = NULL_PIX;
          }
       }
 
    } // End of band loop.
 
 }

◆ buildAutoLinearMinMaxTable()

void ossimHistogramRemapper::buildAutoLinearMinMaxTable ( )

private

Definition at line 1362 of file ossimHistogramRemapper.cpp.

References buildAutoLinearMinMaxTableTemplate(), ossimTableRemapper::getOutputScalarType(), OSSIM_DOUBLE, OSSIM_FLOAT, OSSIM_NORMALIZED_DOUBLE, OSSIM_NORMALIZED_FLOAT, OSSIM_SCALAR_UNKNOWN, OSSIM_SINT16, OSSIM_UINT16, OSSIM_UINT8, OSSIM_USHORT11, OSSIM_USHORT12, OSSIM_USHORT13, OSSIM_USHORT14, and OSSIM_USHORT15.

Referenced by buildTable().

 {
    switch (getOutputScalarType())
    {
       case OSSIM_UINT8:
       {
          buildAutoLinearMinMaxTableTemplate(ossim_uint8(0));
          break;
       }
          
       case OSSIM_USHORT11:
       case OSSIM_USHORT12:
       case OSSIM_USHORT13:
       case OSSIM_USHORT14:
       case OSSIM_USHORT15:
       case OSSIM_UINT16:
       {
          buildAutoLinearMinMaxTableTemplate(ossim_uint16(0));
          break;
       }
          
       case OSSIM_SINT16:
       {
          buildAutoLinearMinMaxTableTemplate(ossim_sint16(0));
          break;
       }
          
       case OSSIM_NORMALIZED_FLOAT:      
       case OSSIM_FLOAT:
       {
          buildAutoLinearMinMaxTableTemplate(ossim_float32(0));
          break;
       }
          
       case OSSIM_NORMALIZED_DOUBLE:
       case OSSIM_DOUBLE:
       {
          buildAutoLinearMinMaxTableTemplate(ossim_float64(0));
          break;
       }
          
       case OSSIM_SCALAR_UNKNOWN:
       default:
       {
          if(traceDebug())
          {
          // Shouldn't hit this.
             ossimNotify(ossimNotifyLevel_WARN)
                << "ossimTableRemapper::buildTable OSSIM_SCALAR_UNKNOWN!"
                << endl;
          }
          break;
       }
          
    } // End of "switch (theTableType)"
 }

◆ buildAutoLinearMinMaxTableTemplate()

template<class T >

void ossimHistogramRemapper::buildAutoLinearMinMaxTableTemplate ( T dummy )

private

Definition at line 1590 of file ossimHistogramRemapper.cpp.

References getHistogram(), ossimImageSourceFilter::getNumberOfInputBands(), theNormalizedLowClipPoint, and ossimRefPtr< T >::valid().

Referenced by buildAutoLinearMinMaxTable().

 {
    const ossim_uint32 BANDS = getNumberOfInputBands();
 
    // Sanity check.
    if (theNormalizedLowClipPoint.size() != BANDS || !getHistogram(0).valid())
    {
       if(traceDebug())
       {
          ossimNotify(ossimNotifyLevel_WARN)
             << "ossimHistogramRemapper::buildAutoLinearMinMaxTableTemplate ERROR!"
             << " Line:  " << __LINE__ << endl;
       }
       return;
    }
    for (ossim_uint32 band = 0; band < BANDS; ++band)
    {
       ossimRefPtr<ossimHistogram> h  = getHistogram(band);
       T nullPix = static_cast<T>(getNullPixelValue(band));
       //h->fillInteriorEmptyBins();
       // std::cout << "************************\n";
 
       if(h.valid())
       {
 
          ossim_uint32 n     = h->GetRes();
          ossim_float64 low  = h->GetIndex(h->GetMinVal());
          ossim_float64 high = h->GetIndex(h->GetMaxVal());
          double bias = .006;//.006;
          if(n > 0)
          {
             double newCount       = 0.0;
             double nextPercentage = 0.0;
             double percentage = 0.0;
             int idx = 0;
             const float * counts = h->GetCounts();
             double count   = h->ComputeArea();
             for(idx = 0; idx < (ossim_int32)(n-1); ++idx)
             {
                bool hasValue = (counts[idx] > 0)&&(counts[idx+1]);
                if(nullPix != idx)
                {
                   newCount += counts[idx];
                }
                percentage = newCount / count;
                nextPercentage = (newCount + counts[idx+1]) / count;
 //               if (std::fabs(percentage - 0.006) <
 //                   std::fabs(nextPercentage - 0.006))
                if (hasValue &&((std::fabs(percentage - bias) <
                    std::fabs(nextPercentage - bias))))
                {
                   low = idx+1;
                   break;
                }
                
             }
             newCount = 0.0;
             for (idx = n-1; idx > 0; idx--)
             {
                bool hasValue = (counts[idx] > 0)&&(counts[idx-1]);
                newCount += counts[idx];
                percentage = newCount / count;
                nextPercentage = (newCount + counts[idx-1]) / count;
                if (hasValue && ((std::fabs(percentage - bias) <
                    std::fabs(nextPercentage - bias))))
                {
                   high=idx-1;
                   break;
                }
             }
             if(low > high)
             {
                low = 0;
                high = n - 1;
             }
 
             if(theTableType == ossimTableRemapper::NATIVE)
             {
                setLowClipPoint(low, band);
                setHighClipPoint(high, band);
             }
             else
             {
                setLowClipPoint(h->GetMinValFromIndex(low), band);
                setHighClipPoint(h->GetMaxValFromIndex(high), band);
             }
         }
       }
    }
    
    buildLinearTable();
 }

◆ buildAutoLinearPercentileTable()

void ossimHistogramRemapper::buildAutoLinearPercentileTable ( )

private

Definition at line 1419 of file ossimHistogramRemapper.cpp.

References buildAutoLinearPercentileTableTemplate(), ossimTableRemapper::getOutputScalarType(), OSSIM_DOUBLE, OSSIM_FLOAT, OSSIM_NORMALIZED_DOUBLE, OSSIM_NORMALIZED_FLOAT, OSSIM_SCALAR_UNKNOWN, OSSIM_SINT16, OSSIM_UINT16, OSSIM_UINT8, OSSIM_USHORT11, OSSIM_USHORT12, OSSIM_USHORT13, OSSIM_USHORT14, and OSSIM_USHORT15.

Referenced by buildTable().

 {
    switch (getOutputScalarType())
    {
       case OSSIM_UINT8:
       {
          buildAutoLinearPercentileTableTemplate(ossim_uint8(0));
          break;
       }
          
       case OSSIM_USHORT11:
       case OSSIM_USHORT12:
       case OSSIM_USHORT13:
       case OSSIM_USHORT14:
       case OSSIM_USHORT15:
       case OSSIM_UINT16:
       {
          buildAutoLinearPercentileTableTemplate(ossim_uint16(0));
          break;
       }
          
       case OSSIM_SINT16:
       {
          buildAutoLinearPercentileTableTemplate(ossim_sint16(0));
          break;
       }
          
       case OSSIM_NORMALIZED_FLOAT:      
       case OSSIM_FLOAT:
       {
          buildAutoLinearPercentileTableTemplate(ossim_float32(0));
          break;
       }
          
       case OSSIM_NORMALIZED_DOUBLE:
       case OSSIM_DOUBLE:
       {
          buildAutoLinearPercentileTableTemplate(ossim_float64(0));
          break;
       }
          
       case OSSIM_SCALAR_UNKNOWN:
       default:
       {
          if(traceDebug())
          {
          // Shouldn't hit this.
             ossimNotify(ossimNotifyLevel_WARN)
                << "ossimHistogramRemapper::buildAutoLinearPercentileTableTemplate OSSIM_SCALAR_UNKNOWN!"
                << endl;
          }
          break;
       }
          
    } // End of "switch (theTableType)"
 }

◆ buildAutoLinearPercentileTableTemplate()

template<class T >

void ossimHistogramRemapper::buildAutoLinearPercentileTableTemplate ( T dummy )

private

Definition at line 1753 of file ossimHistogramRemapper.cpp.

References getHistogram(), ossimImageSourceFilter::getNumberOfInputBands(), theNormalizedLowClipPoint, and ossimRefPtr< T >::valid().

Referenced by buildAutoLinearPercentileTable().

 {
    const ossim_uint32 BANDS = getNumberOfInputBands();
 
    // Sanity check.
    if (theNormalizedLowClipPoint.size() != BANDS || !getHistogram(0).valid())
    {
       if(traceDebug())
       {
          ossimNotify(ossimNotifyLevel_WARN)
             << "ossimHistogramRemapper::buildAutoLinearMinMaxTableTemplate ERROR!"
             << " Line:  " << __LINE__ << endl;
       }
       return;
    }
    for (ossim_uint32 band = 0; band < BANDS; ++band)
    {
       ossimRefPtr<ossimHistogram> h  = getHistogram(band);
       // T nullPix = static_cast<T>(getNullPixelValue(band));
       // h->fillInteriorEmptyBins();
       if(h.valid())
       {
          ossim_uint32 n     = h->GetRes();
          ossim_float64 low  = h->GetIndex(h->LowClipVal(0.05));
          ossim_float64 high = h->GetIndex(h->HighClipVal(0.05));
          if(low > high)
          {
             low = 0;
             high = n - 1;
          }
          if(low < 0) low = 0;
          if(high < 0) high = n-1;
 
          if(theTableType == ossimTableRemapper::NATIVE)
          {
             setLowClipPoint(low, band);
             setHighClipPoint(high, band);
          }
          else
          {
             setLowClipPoint(h->GetValFromIndex(static_cast<ossim_uint32>(low)), band);
             setHighClipPoint(h->GetValFromIndex(static_cast<ossim_uint32>(high)), band);
          }
       }
    }
    
    buildLinearTable();
 }

◆ buildLinearTable() [1/2]

void ossimHistogramRemapper::buildLinearTable ( )

private

Definition at line 1295 of file ossimHistogramRemapper.cpp.

References ossimTableRemapper::getOutputScalarType(), OSSIM_DOUBLE, OSSIM_FLOAT, OSSIM_NORMALIZED_DOUBLE, OSSIM_NORMALIZED_FLOAT, OSSIM_SCALAR_UNKNOWN, OSSIM_SINT16, OSSIM_SINT32, OSSIM_UINT16, OSSIM_UINT32, OSSIM_UINT8, OSSIM_USHORT11, OSSIM_USHORT12, OSSIM_USHORT13, OSSIM_USHORT14, and OSSIM_USHORT15.

Referenced by buildTable().

 {
    switch (getOutputScalarType())
    {
       case OSSIM_UINT8:
       {
          buildLinearTable(ossim_uint8(0));
          break;
       }
          
       case OSSIM_USHORT11:
       case OSSIM_USHORT12:
       case OSSIM_USHORT13:
       case OSSIM_USHORT14:
       case OSSIM_USHORT15:
       case OSSIM_UINT16:
       {
          buildLinearTable(ossim_uint16(0));
          break;
       }
          
       case OSSIM_SINT16:
       {
          buildLinearTable(ossim_sint16(0));
          break;
       }
 
       case OSSIM_UINT32:
       {
          buildLinearTable(ossim_uint32(0));
          break;
       }
          
       case OSSIM_SINT32:
       {
          buildLinearTable(ossim_sint32(0));
          break;
       }
          
       case OSSIM_NORMALIZED_FLOAT:      
       case OSSIM_FLOAT:
       {
          buildLinearTable(ossim_float32(0));
          break;
       }
       case OSSIM_NORMALIZED_DOUBLE:
       case OSSIM_DOUBLE:
       {
          buildLinearTable(ossim_float64(0));
          break;
       }
          
       case OSSIM_SCALAR_UNKNOWN:
       default:
       {
          if(traceDebug())
          {
             // Shouldn't hit this.
             ossimNotify(ossimNotifyLevel_WARN)
                << "ossimHistogramRemapper::buildLinearTable OSSIM_SCALAR_UNKNOWN!" << endl;
          }
          break;
       }
          
    } // End of "switch (theTableType)"
 }

◆ buildLinearTable() [2/2]

template<class T >

void ossimHistogramRemapper::buildLinearTable ( T dummy )

private

Definition at line 1476 of file ossimHistogramRemapper.cpp.

References getHistogram(), ossimImageSourceFilter::getNumberOfInputBands(), theDirtyFlag, theNormalizedLowClipPoint, and ossimRefPtr< T >::valid().

 {
    #if 1
    // for now we are not using the lookup
       theDirtyFlag = false;
       return;
 #else
 
    // This builds a native table.
    //theTableType = ossimTableRemapper::NATIVE;
    
    const ossim_uint32 BANDS = getNumberOfInputBands();
 
    // Sanity check.
    if (theNormalizedLowClipPoint.size() != BANDS || !getHistogram(0).valid())
    {
       if(traceDebug())
       {
          ossimNotify(ossimNotifyLevel_WARN)
             << "ossimHistogramRemapper::buildTable ERROR!"
             << " Line:  " << __LINE__ << endl;
       }
       return;
    }
    
    T* table = reinterpret_cast<T*>(&theTable.front());
    ossim_uint32 index = 0;
    
    // Finally, build the table...
    for (ossim_uint32 band = 0; band < BANDS; ++band)
    {
       ossimRefPtr<ossimHistogram> h  = getHistogram(band);
       if (h.get())
       {
          if (traceDebug())
          {
             ossimNotify(ossimNotifyLevel_DEBUG)
                << "ossimHistogramRemapper::buildLinearTable DEBUG:"
                << "\nband:  " << band
                << "\nmean:  " << h->GetMean()
                << "\nstddev:  " << h->GetStandardDev()
                << endl;
          }
       }
       else
       {
          if(traceDebug())
          {
             ossimNotify(ossimNotifyLevel_WARN)
             << "ossimHistogramRemapper::buildTable ERROR!"
             << " Line:  " << __LINE__ << endl;
          }
          return; 
       }
       //std::cout << "MIN OUTPUT ==== " << theMinOutputValue[band] << std::endl;
       const T NULL_PIX = static_cast<T>(getNullPixelValue(band));
       const T MIN_PIX  = static_cast<T>(theMinOutputValue[band]);
       const T MAX_PIX  = static_cast<T>(theMaxOutputValue[band]);
       ossim_float64 min_clip_value =
       h->LowClipVal(theNormalizedLowClipPoint[band]);
       ossim_float64 max_clip_value =
       h->HighClipVal(1.0-theNormalizedHighClipPoint[band]);
       ossim_float64 gain = 1.0;
       if(theTableType == ossimTableRemapper::NATIVE)
       {
          min_clip_value = floor(min_clip_value);
          max_clip_value = ceil(max_clip_value);
          gain = (MAX_PIX-MIN_PIX)/(max_clip_value-min_clip_value);
         // gain = (MAX_PIX-MIN_PIX+1)/(max_clip_value-min_clip_value);
 
       }
       else
       {
          gain = ((MAX_PIX-MIN_PIX)+1)/(max_clip_value-min_clip_value);
       }
       
       table[index] = NULL_PIX;
       ++index;
 // std::cout  << "min_clip_value === " << min_clip_value << "\n";
 // std::cout  << "max_clip_value === " << max_clip_value << "\n";
 // std::cout  << "MIN_PIX === " << MIN_PIX << "\n";
 // std::cout  << "MAX_PIX === " << MAX_PIX << "\n";
 // std::cout  << "GAIN === " << gain << "\n";
       for (ossim_uint32 pix = 1; pix < theTableBinCount; ++pix)
       {
          ossim_float64 p = pix;
          if (p <= min_clip_value)
          {
             p = MIN_PIX;
          }
          else if (p >= max_clip_value)
          {
             p = MAX_PIX;
          }
          else
          {
             p = ((p - min_clip_value) * gain) + MIN_PIX - 1.0;
          }
 
          if(p == NULL_PIX)
          {
             p = MIN_PIX;
          }
          table[index] = static_cast<T>(p+0.5);
          
          ++index;
       }
    } // End of band loop.
 
    // Clear the dirty flag so the table's not rebuilt on the next getTile.
    theDirtyFlag = false;
 #endif
 }

◆ buildLinearTableStdFromMean()

void ossimHistogramRemapper::buildLinearTableStdFromMean ( )

private

Sets clip points using mean and standard deviations then calls buildLinearTable method.

Definition at line 1683 of file ossimHistogramRemapper.cpp.

References getHistogram(), ossimImageSourceFilter::getNumberOfInputBands(), theNormalizedLowClipPoint, and ossimRefPtr< T >::valid().

Referenced by buildTable().

 {
    const ossim_uint32 BANDS = getNumberOfInputBands();
    
    // Sanity check.
    if (theNormalizedLowClipPoint.size() != BANDS || !getHistogram(0).valid())
    {
       if(traceDebug())
       {
          ossimNotify(ossimNotifyLevel_WARN)
             << "ossimHistogramRemapper::buildTable ERROR!"
             << " Line:  " << __LINE__ << endl;
       }
       return;
    }
    
    ossim_float64 multiplier = 1.0;
    if (theStretchMode == LINEAR_2STD_FROM_MEAN)
    {
       multiplier =  2.0;
    }
    else if (theStretchMode == LINEAR_3STD_FROM_MEAN)
    {
       multiplier =  3.0;
    }
    
    // Finally, build the table...
    for (ossim_uint32 band = 0; band < BANDS; ++band)
    {
       ossimRefPtr<ossimHistogram> h      = getHistogram(band);
       ossim_float64 mean = 0.0;
       ossim_float64 stdDev = 0.0;
       if(h.valid())
       {
          mean     = h->GetMean();
          stdDev   = h->GetStandardDev();
       }
       ossim_float64 lowClip  = mean - (stdDev * multiplier);
       ossim_float64 highClip = mean + (stdDev * multiplier);
       
       // Clamp to min/max.
       if (lowClip < theMinOutputValue[band])
       {
          lowClip = theMinOutputValue[band];
       }
       if (highClip > theMaxOutputValue[band])
       {
          highClip = theMaxOutputValue[band];
       }
       
       setLowClipPoint(lowClip, band);
       setMidPoint(mean, band);
       setHighClipPoint(highClip, band);
       
       if (traceDebug())
       {
          ossimNotify(ossimNotifyLevel_DEBUG)
             << "ossimHistogramRemapper::buildLinearStdFromMean DEBUG:"
             << "\nband:       " << band
             << "\nmean:       " << mean
             << "\nstddev:     " << stdDev
             << "\nlow clip:   " << lowClip
             << "\nhigh clip:  " << highClip
             << endl;
       }
    }
    
    buildLinearTable();
 }

◆ buildTable()

void ossimHistogramRemapper::buildTable ( )

private

Definition at line 1251 of file ossimHistogramRemapper.cpp.

References buildAutoLinearMinMaxTable(), buildAutoLinearPercentileTable(), buildLinearTable(), buildLinearTableStdFromMean(), LINEAR_1STD_FROM_MEAN, LINEAR_2STD_FROM_MEAN, LINEAR_3STD_FROM_MEAN, LINEAR_AUTO_MIN_MAX, LINEAR_AUTO_PERCENTILE, LINEAR_ONE_PIECE, setupTable(), and theStretchMode.

Referenced by makeClean(), and setStretchMode().

 {
    setupTable();
    switch(theStretchMode)
    {
       case ossimHistogramRemapper::LINEAR_ONE_PIECE:
       {
          buildLinearTable();
          break;
       }
       case ossimHistogramRemapper::LINEAR_AUTO_MIN_MAX:
       {
          buildAutoLinearMinMaxTable();
          break;
       }
       case ossimHistogramRemapper::LINEAR_AUTO_PERCENTILE:
       {
          buildAutoLinearPercentileTable();
          break;
       }
       case ossimHistogramRemapper::LINEAR_1STD_FROM_MEAN:
       case ossimHistogramRemapper::LINEAR_2STD_FROM_MEAN:
       case ossimHistogramRemapper::LINEAR_3STD_FROM_MEAN:
          buildLinearTableStdFromMean();
          break;
          
       default:
          if(traceDebug())
          {
             ossimNotify(ossimNotifyLevel_WARN)
                << "ossimHistogramRemapper::buildTable ERROR!"
                << "\nUnknown stretch type!" << endl;
          }
          break;
    }
 
    if (traceDebug())
    {
       ossimNotify(ossimNotifyLevel_DEBUG)
          << "ossimHistogramRemapper::buildTable DEBUG:\n" << endl;
       print(ossimNotify(ossimNotifyLevel_DEBUG));
    }
 }

◆ canConnectMyInputTo()

bool ossimHistogramRemapper::canConnectMyInputTo	(	ossim_int32	inputIndex,
		const ossimConnectableObject *	object
	)		const

virtual

Will test for the input being a ossimHistogramSource and allow pulling the histogram from a histogram source.

Implements ossimConnectableObject.

Definition at line 2296 of file ossimHistogramRemapper.cpp.

 {
    // we will alloe the histogram source only to be connected to input slot 2 and
    // the first slot will be reserved for the ossimImageSource.
    //
    bool result = false;
    if(inputIndex == 0) result = dynamic_cast<const ossimImageSource*>(object)!=0;
    if(inputIndex == 1) result = dynamic_cast<const ossimHistogramSource*>(object)!=0;
    
    return result;
 }

◆ computeHistogram()

bool ossimHistogramRemapper::computeHistogram ( const ossimIrect & roi )

Compute the histogram from input connection and region of interest.

With this method the histogram is owned by this object.

Parameters

roi	Region of inte Returns true on success, false on error.

Definition at line 186 of file ossimHistogramRemapper.cpp.

References ossimMultiResLevelHistogram::addHistogram(), ossimMultiBandHistogram::create(), ossimRefPtr< T >::get(), ossimDataObject::getDataObjectStatus(), ossimImageSource::getTile(), OSSIM_EMPTY, OSSIM_NULL, ossimImageData::populateHistogram(), setHistogram(), ossimImageSourceFilter::theInputConnection, and ossimRefPtr< T >::valid().

 {
    bool result = false;
    if ( theInputConnection )
    {
       ossimRefPtr<ossimImageData> tile = theInputConnection->getTile(roi, 0);
       if ( tile.valid() )
       {
          ossimDataObjectStatus tile_status = tile->getDataObjectStatus();
          if ( (tile_status != OSSIM_NULL) && (tile_status != OSSIM_EMPTY) )
          {
             ossimRefPtr<ossimMultiBandHistogram> h = new ossimMultiBandHistogram;
             h->create( theInputConnection );
 
             tile->populateHistogram(h);
 
             ossimRefPtr<ossimMultiResLevelHistogram> histo = new ossimMultiResLevelHistogram();
 
             histo->addHistogram( h.get() );
 
             setHistogram( histo );
             result = true;
          }
       }
    }
    return result;
 }

◆ getHighClipPoint() [1/2]

ossim_float64 ossimHistogramRemapper::getHighClipPoint ( ossim_uint32 zero_based_band ) const

Returns the high clip point for band.

Clip points are DN values relative to the scalar type.

Will return OSSIM_DBL_NAN if:

Band is out of range.
Connection is not complete.
Histogram has not been set.

Definition at line 784 of file ossimHistogramRemapper.cpp.

References getHistogram(), getMaxPixelValue(), ossimImageSourceFilter::getNumberOfInputBands(), ossimHistogram::HighClipVal(), ossim::nan(), theHistogram, theNormalizedHighClipPoint, and ossimRefPtr< T >::valid().

 {
    if(zero_based_band >= getNumberOfInputBands() ||
       !theHistogram || zero_based_band >= theNormalizedHighClipPoint.size())
    {
       return ossim::nan();
    }
    
    if (theNormalizedHighClipPoint[zero_based_band] == 1.0)
    {
       return getMaxPixelValue(zero_based_band);
    }
    
    ossimRefPtr<ossimHistogram> h = getHistogram(zero_based_band);
    if (h.valid())
    {
       ossim_float64 d =
          h->HighClipVal(1.0-theNormalizedHighClipPoint[zero_based_band]);
       return (d);//ceil(d);
    }
    
    return ossim::nan();
 }

◆ getHighClipPoint() [2/2]

ossim_float64 ossimHistogramRemapper::getHighClipPoint ( ) const

Returns the high clip point which is the average of all bands.

Will return OSSIM_DBL_NAN if:

Band is out of range.
Connection is not complete.
Histogram has not been set.

Definition at line 808 of file ossimHistogramRemapper.cpp.

References ossimImageSourceFilter::getNumberOfInputBands(), ossim::nan(), theHistogram, and theNormalizedHighClipPoint.

 {
    if (theNormalizedHighClipPoint.size() == 0 || !theHistogram)
    {
       return ossim::nan();
    }
    
    ossim_float64 d = 0.0;
    const ossim_uint32 BANDS = getNumberOfInputBands();
    for (ossim_uint32 band = 0; band < BANDS; ++band)
    {
       d += getHighClipPoint(band);
    }
    
    return (d / BANDS);
 }

◆ getHighNormalizedClipPoint() [1/2]

ossim_float64 ossimHistogramRemapper::getHighNormalizedClipPoint ( ossim_uint32 zero_based_band ) const

Returns the normalized high clip point for band.

Will return OSSIM_DBL_NAN if:

Band is out of range.
Connection is not complete.
Histogram has not been set.

Definition at line 704 of file ossimHistogramRemapper.cpp.

References ossimImageSourceFilter::getNumberOfInputBands(), ossim::nan(), ossimNotify(), ossimNotifyLevel_WARN, and theNormalizedHighClipPoint.

 {
    if (theNormalizedHighClipPoint.size() == 0 ||
        zero_based_band >= getNumberOfInputBands())
    {
       return ossim::nan();
    }
    
    if (zero_based_band >= theNormalizedHighClipPoint.size())
    {
       ossimNotify(ossimNotifyLevel_WARN)
          << "ossimHistogramRemapper::getHighNormalizedClipPoint ERROR:"
          << "\nband " << zero_based_band << " is out of range!"
          << "\nhighest band:  " << (theNormalizedHighClipPoint.size()-1)
          << endl;
       return ossim::nan();
    }
    
    return theNormalizedHighClipPoint[zero_based_band];
 }

◆ getHighNormalizedClipPoint() [2/2]

ossim_float64 ossimHistogramRemapper::getHighNormalizedClipPoint ( ) const

Returns the normalized High clip point which is the average of all bands.

Will return OSSIM_DBL_NAN if:

Band is out of range.
Connection is not complete.
Histogram has not been set.

Definition at line 725 of file ossimHistogramRemapper.cpp.

References ossim::nan(), and theNormalizedHighClipPoint.

 {
    if (theNormalizedHighClipPoint.size() == 0)
    {
       return ossim::nan();
    }
    
    ossim_float64 d = 0.0;
    const ossim_uint32 BANDS = (ossim_uint32)theNormalizedHighClipPoint.size();
    for (ossim_uint32 band = 0; band < BANDS; ++band)
    {
       d += getHighNormalizedClipPoint(band);
    }
    
    return (d / BANDS);
 }

◆ getHistogram() [1/3]

ossimRefPtr< ossimMultiResLevelHistogram > ossimHistogramRemapper::getHistogram ( )

Definition at line 2165 of file ossimHistogramRemapper.cpp.

References ossimRefPtr< T >::get(), and theHistogram.

Referenced by applyLinearStretch(), buildAutoLinearMinMaxTableTemplate(), buildAutoLinearPercentileTableTemplate(), buildLinearTable(), buildLinearTableStdFromMean(), getHighClipPoint(), getHistogram(), getLowClipPoint(), setHighClipPoint(), setLowClipPoint(), setNullCount(), and setupTable().

 {
    return ossimRefPtr<ossimMultiResLevelHistogram>(theHistogram.get());
 }

◆ getHistogram() [2/3]

ossimRefPtr< const ossimMultiResLevelHistogram > ossimHistogramRemapper::getHistogram ( ) const

Definition at line 2170 of file ossimHistogramRemapper.cpp.

References ossimRefPtr< T >::get(), and theHistogram.

 {
    return ossimRefPtr<const ossimMultiResLevelHistogram>(theHistogram.get());
 }

◆ getHistogram() [3/3]

ossimRefPtr< ossimHistogram > ossimHistogramRemapper::getHistogram	(	ossim_uint32	zero_based_band,
		ossim_uint32	res_level = `0`
	)		const

Returns pointer to histogram for band and reduced res level.

Band is zero based relative to the input connection. This will be remapped to the histogram band using the "getOutputBandList()" to get the correct histogram band.

Will return NULL if:

band is out range
res_level is out of range
theHistogram has not been initialized yet.

Definition at line 2176 of file ossimHistogramRemapper.cpp.

References ossimMultiResLevelHistogram::getHistogram(), getHistogram(), getHistogramBand(), ossimConnectableObject::getInput(), theHistogram, and ossimRefPtr< T >::valid().

 {
    ossim_uint32 histogram_band = getHistogramBand(zero_based_band);
    
    if(!theHistogram.valid())
    {
       const ossimHistogramSource* source = dynamic_cast<const ossimHistogramSource*>(getInput(1));
       if(source)
       {
          theHistogram = const_cast<ossimHistogramSource*>(source)->getHistogram();
       }      
    }
    
    if (theHistogram.valid())
    {
       if (histogram_band < theHistogram->getNumberOfBands())
       {
          return theHistogram->getHistogram(histogram_band, res_level);
       }
    }
    
    return 0;
 }

◆ getHistogramBand()

ossim_uint32 ossimHistogramRemapper::getHistogramBand ( ossim_uint32 input_band ) const

private

Returns the histogram band that maps to the input band.

Note:

This uses the current band list from "getOutputBandList()".

Definition at line 2212 of file ossimHistogramRemapper.cpp.

References ossimImageSourceFilter::getOutputBandList(), and theResetBandIndicesFlag.

Referenced by getHistogram().

 {
    if(theResetBandIndicesFlag) return input_band;
    vector<ossim_uint32> bandList;
    getOutputBandList(bandList);
    
    const ossim_uint32 BANDS = (ossim_uint32)bandList.size();
    
    if (BANDS == 0)
    {
       return 0;
    }
    
    return bandList[input_band];
 }

◆ getHistogramFile()

ossimFilename ossimHistogramRemapper::getHistogramFile ( ) const

Returns the currently opened histogram.

Returns ossimFilename::NIL if no histogram is loaded.

Definition at line 2201 of file ossimHistogramRemapper.cpp.

References ossimMultiResLevelHistogram::getHistogramFile(), ossimFilename::NIL, theHistogram, and ossimRefPtr< T >::valid().

Referenced by ossimSingleImageChain::addHistogramRemapper().

 {
    if (theHistogram.valid())
    {
       return theHistogram->getHistogramFile();
    }
    
    return ossimFilename::NIL;
 }

◆ getLongName()

ossimString ossimHistogramRemapper::getLongName ( ) const

virtual

Reimplemented from ossimObject.

Definition at line 2228 of file ossimHistogramRemapper.cpp.

 {
    return ossimString("Histogram Remapper, filter with controls for histogram stretching.");
 }

◆ getLowClipPoint() [1/2]

ossim_float64 ossimHistogramRemapper::getLowClipPoint ( ossim_uint32 zero_based_band ) const

Returns the low clip point for band.

Clip points are DN values relative to the scalar type.

Will return OSSIM_DBL_NAN if:

Band is out of range.
Connection is not complete.
Histogram has not been set.

Definition at line 742 of file ossimHistogramRemapper.cpp.

References getHistogram(), getMinPixelValue(), ossimImageSourceFilter::getNumberOfInputBands(), ossimHistogram::LowClipVal(), ossim::nan(), theHistogram, theNormalizedLowClipPoint, and ossimRefPtr< T >::valid().

 {
    if(zero_based_band >= getNumberOfInputBands() ||
       !theHistogram || zero_based_band >= theNormalizedLowClipPoint.size())
    {
       return ossim::nan();
    }
    
    if (theNormalizedLowClipPoint[zero_based_band] == 0.0)
    {
       return getMinPixelValue(zero_based_band);
    }   
    
    ossimRefPtr<ossimHistogram> h = getHistogram(zero_based_band);
    if (h.valid())
    {
       ossim_float64 d =
          h->LowClipVal(theNormalizedLowClipPoint[zero_based_band]);
       
       return d;//floor(d);
    }
    
    return ossim::nan();
 }

◆ getLowClipPoint() [2/2]

ossim_float64 ossimHistogramRemapper::getLowClipPoint ( ) const

Returns the low clip point which is the average of all bands.

Will return OSSIM_DBL_NAN if:

Band is out of range.
Connection is not complete.
Histogram has not been set.

Definition at line 767 of file ossimHistogramRemapper.cpp.

References ossimImageSourceFilter::getNumberOfInputBands(), ossim::nan(), theHistogram, and theNormalizedLowClipPoint.

 {
    if (theNormalizedLowClipPoint.size() == 0 || !theHistogram)
    {
       return ossim::nan();
    }
    
    ossim_float64 d = 0.0;
    const ossim_uint32 BANDS = getNumberOfInputBands();
    for (ossim_uint32 band = 0; band < BANDS; ++band)
    {
       d += getLowClipPoint(band);
    }
    
    return (d / BANDS);
 }

◆ getLowNormalizedClipPoint() [1/2]

ossim_float64 ossimHistogramRemapper::getLowNormalizedClipPoint ( ossim_uint32 zero_based_band ) const

Returns the normalized low clip point for band.

Will return OSSIM_DBL_NAN if:

Band is out of range.
Connection is not complete.
Histogram has not been set.

Definition at line 666 of file ossimHistogramRemapper.cpp.

References ossimImageSourceFilter::getNumberOfInputBands(), ossim::nan(), ossimNotify(), ossimNotifyLevel_WARN, and theNormalizedLowClipPoint.

 {
    if (theNormalizedLowClipPoint.size() == 0 ||
        zero_based_band >= getNumberOfInputBands())
    {
       return ossim::nan();
    }
    
    if (zero_based_band >= theNormalizedLowClipPoint.size())
    {
       ossimNotify(ossimNotifyLevel_WARN)
          << "ossimHistogramRemapper::getLowNormalizedClipPoint ERROR:"
          << "\nband " << zero_based_band << " is out of range!"
          << "\nhighest band:  " << (theNormalizedLowClipPoint.size()-1)
          << endl;
       return ossim::nan();
    }
    
    return theNormalizedLowClipPoint[zero_based_band];
 }

◆ getLowNormalizedClipPoint() [2/2]

ossim_float64 ossimHistogramRemapper::getLowNormalizedClipPoint ( ) const

Returns the normalized low clip point which is the average of all bands.

Will return OSSIM_DBL_NAN if:

Band is out of range.
Connection is not complete.
Histogram has not been set.

Definition at line 687 of file ossimHistogramRemapper.cpp.

References ossim::nan(), and theNormalizedLowClipPoint.

 {
    if (theNormalizedLowClipPoint.size() == 0)
    {
       return ossim::nan();
    }
    
    ossim_float64 d = 0.0;
    const ossim_uint32 BANDS = (ossim_uint32)theNormalizedLowClipPoint.size();
    for (ossim_uint32 band = 0; band < BANDS; ++band)
    {
       d += getLowNormalizedClipPoint(band);
    }
    
    return (d / BANDS);
 }

◆ getMaxOutputValue() [1/2]

ossim_float64 ossimHistogramRemapper::getMaxOutputValue ( ossim_uint32 zero_based_band ) const

Returns the maximum output value for band.

Will return OSSIM_DBL_NAN if:

Band is out of range.
Connection is not complete.

Definition at line 901 of file ossimHistogramRemapper.cpp.

References ossimImageSourceFilter::getNumberOfInputBands(), ossim::nan(), ossimNotify(), ossimNotifyLevel_WARN, and theMaxOutputValue.

 {
    if (theMaxOutputValue.size() == 0 ||
        zero_based_band >= getNumberOfInputBands())
    {
       return ossim::nan();
    }
    
    if (zero_based_band >= theMaxOutputValue.size())
    {
       ossimNotify(ossimNotifyLevel_WARN)
          << "ossimHistogramRemapper::getMaxOutputValue ERROR:"
          << "\nband " << zero_based_band << " is out of range!"
          << "\nhighest band:  " << (theMaxOutputValue.size()-1)
          << endl;
       return ossim::nan();
    }
    
    return theMaxOutputValue[zero_based_band];
 }

◆ getMaxOutputValue() [2/2]

ossim_float64 ossimHistogramRemapper::getMaxOutputValue ( ) const

Returns the maximum output value which is the average of all bands.

Will return OSSIM_DBL_NAN if:

Band is out of range.
Connection is not complete.

Definition at line 922 of file ossimHistogramRemapper.cpp.

References ossim::nan(), and theMaxOutputValue.

 {
    if (theMaxOutputValue.size() == 0)
    {
       return ossim::nan();
    }
    
    ossim_float64 d = 0.0;
    const ossim_uint32 BANDS = (ossim_uint32)theMaxOutputValue.size();
    for (ossim_uint32 band = 0; band < BANDS; ++band)
    {
       d += getMaxOutputValue(band);
    }
    
    return (d / BANDS); 
 }

◆ getMaxPixelValue()

double ossimHistogramRemapper::getMaxPixelValue ( ossim_uint32 band = 0 ) const

virtual

Returns the max pixel of the band.

Reimplemented from ossimImageSource.

Definition at line 2280 of file ossimHistogramRemapper.cpp.

References ossimImageSource::getMaxPixelValue(), theBypassFlag, ossimSource::theEnableFlag, and theMaxOutputValue.

Referenced by getHighClipPoint(), initializeClips(), and setMaxOutputValue().

 {
    double result = ossimTableRemapper::getMaxPixelValue(band);
 
    if(theEnableFlag&&!theBypassFlag &&(band < theMaxOutputValue.size()))
    {
       result = theMaxOutputValue[band];
    }
    //if(theOutputScalarType != OSSIM_SCALAR_UNKNOWN)
   // {
   //    result = ossim::defaultMax(theOutputScalarType);
   // }
 
    return result;
 }

◆ getMidPoint() [1/2]

ossim_float64 ossimHistogramRemapper::getMidPoint ( ossim_uint32 zero_based_band ) const

Returns the mid point for band.

Will return OSSIM_DBL_NAN if:

Band is out of range.
Connection is not complete.
Histogram has not been set.

Definition at line 825 of file ossimHistogramRemapper.cpp.

References ossimImageSourceFilter::getNumberOfInputBands(), ossim::nan(), ossimNotify(), ossimNotifyLevel_WARN, and theMidPoint.

 {
    if (theMidPoint.size() == 0 ||
        zero_based_band >= getNumberOfInputBands())
    {
       return ossim::nan();
    }
    
    if (zero_based_band >= theMidPoint.size())
    {
       ossimNotify(ossimNotifyLevel_WARN)
          << "ossimHistogramRemapper::getMidPoint ERROR:"
          << "\nband " << zero_based_band << " is out of range!"
          << "\nhighest band:  " << (theMidPoint.size()-1)
          << endl;
       return ossim::nan();
    }
    
    return theMidPoint[zero_based_band];
 }

◆ getMidPoint() [2/2]

ossim_float64 ossimHistogramRemapper::getMidPoint ( ) const

Returns the mid clip point which is the average of all bands.

Will return OSSIM_DBL_NAN if:

Band is out of range.
Connection is not complete.
Histogram has not been set.

Definition at line 846 of file ossimHistogramRemapper.cpp.

References ossim::nan(), and theMidPoint.

 {
    if (theMidPoint.size() == 0)
    {
       return ossim::nan();
    }
    
    ossim_float64 d = 0.0;
    const ossim_uint32 BANDS = (ossim_uint32)theMidPoint.size();
    for (ossim_uint32 band = 0; band < BANDS; ++band)
    {
       d += getMidPoint(band);
    }
    
    return (d / BANDS);
 }

◆ getMinOutputValue() [1/2]

ossim_float64 ossimHistogramRemapper::getMinOutputValue ( ossim_uint32 zero_based_band ) const

Returns the minimum output value for band.

Will return OSSIM_DBL_NAN if:

Band is out of range.
Connection is not complete.

Definition at line 863 of file ossimHistogramRemapper.cpp.

References ossimImageSourceFilter::getNumberOfInputBands(), ossim::nan(), ossimNotify(), ossimNotifyLevel_WARN, and theMinOutputValue.

 {
    if (theMinOutputValue.size() == 0 ||
        zero_based_band >= getNumberOfInputBands())
    {
       return ossim::nan();
    }
    
    if (zero_based_band >= theMinOutputValue.size())
    {
       ossimNotify(ossimNotifyLevel_WARN)
          << "ossimHistogramRemapper::getMinOutputValue ERROR:"
          << "\nband " << zero_based_band << " is out of range!"
          << "\nhighest band:  " << (theMinOutputValue.size()-1)
          << endl;
       return ossim::nan();
    }
    
    return theMinOutputValue[zero_based_band];
 }

◆ getMinOutputValue() [2/2]

ossim_float64 ossimHistogramRemapper::getMinOutputValue ( ) const

Returns the minimum output value which is the average of all bands.

Will return OSSIM_DBL_NAN if:

Band is out of range.
Connection is not complete.

Definition at line 884 of file ossimHistogramRemapper.cpp.

References ossim::nan(), and theMinOutputValue.

 {
    if (theMinOutputValue.size() == 0)
    {
       return ossim::nan();
    }
    
    ossim_float64 d = 0.0;
    const ossim_uint32 BANDS = (ossim_uint32)theMinOutputValue.size();
    for (ossim_uint32 band = 0; band < BANDS; ++band)
    {
       d += getMinOutputValue(band);
    }
    
    return (d / BANDS);
 }

◆ getMinPixelValue()

double ossimHistogramRemapper::getMinPixelValue ( ossim_uint32 band = 0 ) const

virtual

Returns the min pixel of the band.

Reimplemented from ossimImageSource.

Definition at line 2265 of file ossimHistogramRemapper.cpp.

References ossimImageSource::getMinPixelValue(), theBypassFlag, ossimSource::theEnableFlag, and theMinOutputValue.

Referenced by getLowClipPoint(), and initializeClips().

 {
    double result = ossimTableRemapper::getMinPixelValue(band);
    if(theEnableFlag&&!theBypassFlag &&(band < theMinOutputValue.size()))
    {
       result = theMinOutputValue[band];
    }
   // if(theOutputScalarType != OSSIM_SCALAR_UNKNOWN)
   // {
   //    return ossim::defaultMin(theOutputScalarType);
   // }
 
    return result;
 }

◆ getNumberOfStretchModes()

ossim_uint32 ossimHistogramRemapper::getNumberOfStretchModes ( ) const

Returns the number of stretch modes.

Definition at line 1900 of file ossimHistogramRemapper.cpp.

References STRETCH_UNKNOWN.

 {
    return ossimHistogramRemapper::STRETCH_UNKNOWN; // last index
 }

◆ getShortName()

ossimString ossimHistogramRemapper::getShortName ( ) const

virtual

Reimplemented from ossimObject.

Definition at line 2233 of file ossimHistogramRemapper.cpp.

 {
    return ossimString("Histogram Remapper");
 }

◆ getStretchMode()

ossimHistogramRemapper::StretchMode ossimHistogramRemapper::getStretchMode ( ) const

Returns the current enumerated node.

Definition at line 1890 of file ossimHistogramRemapper.cpp.

References theStretchMode.

 {
    return theStretchMode;
 }

◆ getStretchModeString() [1/2]

ossimString ossimHistogramRemapper::getStretchModeString ( ) const

Returns the string for current remap mode.

Definition at line 1895 of file ossimHistogramRemapper.cpp.

Referenced by print().

 {
    return ossimString(STRETCH_MODE[theStretchMode]);
 }

◆ getStretchModeString() [2/2]

ossimString ossimHistogramRemapper::getStretchModeString ( ossim_uint32 index ) const

Returns the mode string for a given index.

Returns "stretch_unknown" if index is out of range.

NOTE:

If you're building gui buttons you can: // pseudo code... ossim_uint32 number_of_modes = remapper->getNumberOfModes() for (ossim_uint32 i = 0; i < number_of_modes; ++i) { addButton(getModeString(i).c_str()); }

Definition at line 1906 of file ossimHistogramRemapper.cpp.

References STRETCH_UNKNOWN.

 {
    if (index < ossimHistogramRemapper::STRETCH_UNKNOWN)
    {
       return ossimString(STRETCH_MODE[index]);
    }
    
    return ossimString(STRETCH_MODE[ossimHistogramRemapper::STRETCH_UNKNOWN]);
    
 }

◆ getTile()

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

virtual

Returns: the requested region of interest

Reimplemented from ossimTableRemapper.

Definition at line 214 of file ossimHistogramRemapper.cpp.

References ossimTableRemapper::allocate(), applyLinearStretch(), ossimDataObject::getDataObjectStatus(), ossimImageSource::getTile(), ossimImageData::makeBlank(), makeClean(), OSSIM_DOUBLE, OSSIM_EMPTY, OSSIM_FLOAT, OSSIM_NORMALIZED_DOUBLE, OSSIM_NORMALIZED_FLOAT, OSSIM_NULL, OSSIM_SCALAR_UNKNOWN, OSSIM_SSHORT16, OSSIM_UINT16, OSSIM_UINT8, OSSIM_USHORT11, OSSIM_USHORT12, OSSIM_USHORT13, OSSIM_USHORT14, OSSIM_USHORT15, ossimImageData::setImageRectangle(), theBypassFlag, theDirtyFlag, ossimSource::theEnableFlag, ossimImageSourceFilter::theInputConnection, ossimTableRemapper::theOutputScalarType, ossimTableRemapper::theTile, and ossimRefPtr< T >::valid().

 {
    
 #if 0 /* Please leave for debug. (drb) */
    cout << "\ntheEnableFlag: " << theEnableFlag
         << "\ntheBypassFlag: " << theBypassFlag
         << "\ntheDirtyFlag:  " << theDirtyFlag
         << endl;
 #endif
    
    if ( !theInputConnection )
       return 0;
 
    // Rebuild the table if dirty flag set:
    if ( theDirtyFlag )
       makeClean();
 
    if ( !theEnableFlag || theBypassFlag )
       return theInputConnection->getTile(tile_rect, resLevel);
 
    ossimRefPtr<ossimImageData> inputTile = theInputConnection->getTile(tile_rect, resLevel);
    if(!inputTile.valid())
       return 0;
 
    ossimDataObjectStatus tile_status = inputTile->getDataObjectStatus();
    if ( (tile_status == OSSIM_NULL) || (tile_status == OSSIM_EMPTY) )
       return inputTile;
 
    if (!theTile)
       allocate(tile_rect);
 
    theTile->setImageRectangle(tile_rect);
    theTile->makeBlank();
    switch (theOutputScalarType)
    {
    case OSSIM_UINT8:
       applyLinearStretch(ossim_uint8(0), inputTile);
       break;
 
    case OSSIM_USHORT11:
    case OSSIM_USHORT12:
    case OSSIM_USHORT13:
    case OSSIM_USHORT14:
    case OSSIM_USHORT15:
    case OSSIM_UINT16:
       applyLinearStretch(ossim_uint16(0), inputTile);
       break;
 
    case OSSIM_SSHORT16:
       applyLinearStretch(ossim_sint16(0), inputTile);
       //remapFromNativeTable(ossim_sint16(0), inputTile);
       break;
 
    case OSSIM_NORMALIZED_FLOAT:
    case OSSIM_FLOAT:
       applyLinearStretch(ossim_float32(0), inputTile);
       //remapFromNativeTable(ossim_float32(0), inputTile);
       break;
 
    case OSSIM_NORMALIZED_DOUBLE:
    case OSSIM_DOUBLE:
       applyLinearStretch(ossim_float64(0), inputTile);
       //remapFromNativeTable(ossim_float64(0), inputTile);
       break;
 
    case OSSIM_SCALAR_UNKNOWN:
    default:
       // Shouldn't hit this.
       if(traceDebug())
       {
          ossimNotify(ossimNotifyLevel_WARN) << "ossimHistogramRemapper::getTile"
          << "\nOutput scalar type is OSSIM_SCALAR_UNKNOWN!\n";
       }
    } // End of "switch (theTableType)"
 
    theTile->validate();
    return theTile;
 }

◆ initialize()

void ossimHistogramRemapper::initialize ( )

virtual

Reimplemented from ossimTableRemapper.

Definition at line 83 of file ossimHistogramRemapper.cpp.

Referenced by ossimSingleImageChain::setBandSelection(), and ossimSingleImageChain::setToThreeBands().

 {
    if (traceDebug())
    {
       ossimNotify(ossimNotifyLevel_DEBUG)
          << "ossimHistogramRemapper::initialize entered..." << endl;
    }
 
    theResetBandIndicesFlag = (dynamic_cast<const ossimHistogramSource*>(getInput(1))!=0);
 
    //---
    // Call the base class initialize.
    // Note:  This will reset "theInputConnection" if it changed...
    //---
    ossimTableRemapper::initialize();
    
    // Check the band list to see if it's changes.
    vector<ossim_uint32> bandList;
    getOutputBandList(bandList);
    ossim_uint32 idx = 0;
    // bool emptyOutput = theBandList.empty();
 
    if(theResetBandIndicesFlag)
    {
       for(idx = 0; idx < bandList.size();++idx)
       {
          bandList[idx] = idx;
       }
    }
    if (theBandList.size() != 0 && bandList.size())
    {
       if (theBandList.size() != bandList.size())
       {
          // Somethings changed.  Set everthing back.
          initializeClips();
          setNullCount();
          theTable.clear();
          theDirtyFlag = true;
       }
       else
       {
          // Sizes same check the order.
          for(ossim_uint32 band = 0; band < theBandList.size(); ++band)
          {
             if (theBandList[band] != bandList[band])
             {
                //initializeClips();
                //setNullCount();
                theDirtyFlag = true;
                break;
             }            
          }
       }
    }
    else
    {
       initializeMinMaxOutput();
    }
 
    // Update the band list with the latest.
    theBandList = bandList;
 
    verifyEnabled();
    
    if (traceDebug())
    {
       ossimNotify(ossimNotifyLevel_DEBUG)
          << "ossimHistogramRemapper::initialize exited..." << endl;
    }
 }

◆ initializeClips() [1/2]

void ossimHistogramRemapper::initializeClips ( )

private

Uses getNumberOfInputBands() to determine BANDS then calls initializeClips(BANDS)

Definition at line 1802 of file ossimHistogramRemapper.cpp.

References ossimImageSourceFilter::getNumberOfInputBands().

Referenced by reset(), setHighNormalizedClipPoint(), setHistogram(), setLowNormalizedClipPoint(), setMaxOutputValue(), setMidPoint(), setMinOutputValue(), and setupTable().

 {
    initializeClips(getNumberOfInputBands());
 }

◆ initializeClips() [2/2]

void ossimHistogramRemapper::initializeClips ( ossim_uint32 bands )

private

Initializes data members to some default state and size.

Definition at line 1807 of file ossimHistogramRemapper.cpp.

References ossim::defaultMax(), ossim::defaultMin(), getMaxPixelValue(), getMinPixelValue(), OSSIM_FLOAT32, OSSIM_FLOAT64, OSSIM_SCALAR_UNKNOWN, theMaxOutputValue, theMidPoint, theMinOutputValue, theNormalizedHighClipPoint, theNormalizedLowClipPoint, and ossimTableRemapper::theOutputScalarType.

 {
    //---
    // NOTE: This method deoes not set theDirtyFlag by design.
    //---
    if (bands)
    {
       theNormalizedLowClipPoint.resize(bands);
       theNormalizedHighClipPoint.resize(bands);
       theMidPoint.resize(bands);
       theMinOutputValue.resize(bands);
       theMaxOutputValue.resize(bands);
       
       for (ossim_uint32 band = 0; band < bands; ++band)
       {
          theNormalizedLowClipPoint[band]  = 0.0;
          theNormalizedHighClipPoint[band] = 1.0;
          theMidPoint[band] = 0.0;
          
          switch(theOutputScalarType)
          {
             case OSSIM_FLOAT32:
             case OSSIM_FLOAT64:
             {
                theMinOutputValue[band] = getMinPixelValue(band);
                theMaxOutputValue[band] = getMaxPixelValue(band);
                break;
             }
             case OSSIM_SCALAR_UNKNOWN:
             {
                theMinOutputValue[band] = 0.0;
                theMaxOutputValue[band] = 0.0;
             }
             default:
             {
                theMinOutputValue[band] = ossim::defaultMin(theOutputScalarType);//getMinPixelValue(band);
                theMaxOutputValue[band] = ossim::defaultMax(theOutputScalarType);//getMaxPixelValue(band);
                break;
             }
          }
       }
    }
 }

◆ initializeMinMaxOutput()

void ossimHistogramRemapper::initializeMinMaxOutput ( )

private

Definition at line 1851 of file ossimHistogramRemapper.cpp.

References ossim::defaultMax(), ossim::defaultMin(), ossimImageSourceFilter::getNumberOfInputBands(), OSSIM_SCALAR_UNKNOWN, theMaxOutputValue, theMinOutputValue, and ossimTableRemapper::theOutputScalarType.

 {
    ossim_uint32 nBands = getNumberOfInputBands();
    theMinOutputValue.resize(nBands);
    theMaxOutputValue.resize(nBands);
    for (ossim_uint32 band = 0; band < nBands; ++band)
    {
          // Must have an output scalar type for getMin/Max call.
          if (theOutputScalarType != OSSIM_SCALAR_UNKNOWN)
          {
             theMinOutputValue[band] = ossim::defaultMin(theOutputScalarType);//getMinPixelValue(band);
             theMaxOutputValue[band] = ossim::defaultMax(theOutputScalarType);//getMaxPixelValue(band);
          }
          else
          {
             theMinOutputValue[band] = 0.0;
             theMaxOutputValue[band] = 0.0;
          }
   }
 
 }

◆ loadState()

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

virtual

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

Returns true if ok or false on error.

Reimplemented from ossimTableRemapper.

Definition at line 939 of file ossimHistogramRemapper.cpp.

 {
    static const char MODULE[] = "ossimHistogramRemapper::loadState";
    if (traceDebug())
    {
       CLOG << " Entered..."
            << "\nprefix:  " << prefix << endl;
    }
    // Load the base class states...
    bool status = ossimTableRemapper::loadState(kwl, prefix);
    if (status)
    {
       const char* lookup = 0;
       ossimString keyword;
       
       lookup = kwl.find(prefix, HISTOGRAM_FILENAME_KW);
       if (lookup)
       {
          if ( !openHistogram(ossimFilename(lookup)) )
          {
             ossimNotify(ossimNotifyLevel_WARN)
                << "ossimHistogramRemapper::loadState ERROR!"
                << "\nCould not open file:  " << lookup
                << "\nReturning..." << endl;
             return false;
          }
       }
      
       //---
       // Get the band specific keywords.
       // NOTES:
       // -  This loadState assumes the all keywords will have the same number
       //    of bands.
       // -  The set methods cannot be used here as there may not be a connection
       //    yet that they need.
       //---
       ossim_uint32 bands = 0;
       lookup = kwl.find(prefix, ossimKeywordNames::NUMBER_BANDS_KW);
       if (lookup)
       {
          bands = ossimString::toUInt32(lookup);
       }
       else  // For backwards compatibility.
       {
          // Use the low clip to find number of bands...
          keyword = NORMALIZED_LOW_CLIP_POINT_KW;
          bands = kwl.numberOf(prefix, keyword);
       }
       //if(!bands&&theHistogram.valid())
      // {
      //    bands = theHistogram->getNumberOfBands();
      // }
 
       if (traceDebug())
       {
          ossimNotify(ossimNotifyLevel_DEBUG)
             << "ossimHistogramRemapper::loadState DEBUG:"
             << "\nBands:  " << bands
             << endl;
       }
       if (bands)
       {
          // Start with fresh clips.
          initializeClips(bands);
         for (ossim_uint32 band = 0; band < bands; ++band)
          {
             // Get the low clip.
             keyword = NORMALIZED_LOW_CLIP_POINT_KW;
             keyword += ".";
             keyword += ossimKeywordNames::BAND_KW;
             keyword += ossimString::toString(band+1);
             lookup = kwl.find(prefix, keyword);
             if(lookup)
             {
                theNormalizedLowClipPoint[band] = atof(lookup);
             }
             
             // Get the high clip.
             keyword = NORMALIZED_HIGH_CLIP_POINT_KW;
             keyword += ".";
             keyword += ossimKeywordNames::BAND_KW;
             keyword += ossimString::toString(band+1);
             lookup = kwl.find(prefix, keyword);
             if(lookup)
             {
                theNormalizedHighClipPoint[band] = atof(lookup);
             }
             
             // Get the mid point.
             keyword = MID_POINT_KW;
             keyword += ".";
             keyword += ossimKeywordNames::BAND_KW;
             keyword += ossimString::toString(band+1);
             lookup = kwl.find(prefix, keyword);
             if(lookup)
             {
                theMidPoint[band] = atof(lookup);
             }
             
             // Get the min output value.
             keyword = MIN_OUTPUT_VALUE_KW;
             keyword += ".";
             keyword += ossimKeywordNames::BAND_KW;
             keyword += ossimString::toString(band+1);
             lookup = kwl.find(prefix, keyword);
             if(lookup)
             {
                theMinOutputValue[band] = atof(lookup);
             }
             
             // Get the max output value.
             keyword = MAX_OUTPUT_VALUE_KW;
             keyword += ".";
             keyword += ossimKeywordNames::BAND_KW;
             keyword += ossimString::toString(band+1);
             lookup = kwl.find(prefix, keyword);
             if(lookup)
             {
                theMaxOutputValue[band] = atof(lookup);
             }      
          }
      }
      
       lookup = kwl.find(prefix, STRETCH_MODE_KW);
       if (lookup)
       {
          ossimString s = lookup;
          s.downcase();
          if (s == STRETCH_MODE[ossimHistogramRemapper::LINEAR_ONE_PIECE])
          {
             theStretchMode = ossimHistogramRemapper::LINEAR_ONE_PIECE;
          }
          else if (s == STRETCH_MODE[ossimHistogramRemapper::LINEAR_1STD_FROM_MEAN])
          {
             theStretchMode = ossimHistogramRemapper::LINEAR_1STD_FROM_MEAN;
          }
          else if (s == STRETCH_MODE[ossimHistogramRemapper::LINEAR_2STD_FROM_MEAN])
          {
             theStretchMode = ossimHistogramRemapper::LINEAR_2STD_FROM_MEAN;
          }
          else if (s == STRETCH_MODE[ossimHistogramRemapper::LINEAR_3STD_FROM_MEAN])
          {
             theStretchMode = ossimHistogramRemapper::LINEAR_3STD_FROM_MEAN;
          }
          else if (s == STRETCH_MODE[ossimHistogramRemapper::LINEAR_AUTO_MIN_MAX])
          {
             theStretchMode = ossimHistogramRemapper::LINEAR_AUTO_MIN_MAX;
          }
          else if (s == STRETCH_MODE[ossimHistogramRemapper::LINEAR_AUTO_PERCENTILE])
          {
             theStretchMode = ossimHistogramRemapper::LINEAR_AUTO_PERCENTILE;
          }
          else
          {
             theStretchMode = ossimHistogramRemapper::STRETCH_UNKNOWN;
          }
       }
 
       // Always set the dirty flag.
       theDirtyFlag = true;
    }
    verifyEnabled();
 
    if (traceDebug())
    {
       CLOG << "ossimHistogramRemapper::loadState DEBUG:"
            << *this
            << "\nExited..." << endl;
    }
    return status;
 }

◆ makeClean()

void ossimHistogramRemapper::makeClean ( )

private

If we are dirty then it will init what it needs and then set the dirty back to false;.

Definition at line 420 of file ossimHistogramRemapper.cpp.

References buildTable(), theDirtyFlag, ossimSource::theEnableFlag, and verifyEnabled().

Referenced by getTile().

 {
    if (theEnableFlag && theDirtyFlag) // Enabled and dirty.
    {
       // Always rebuild table if dirty.
       buildTable();
       
       // Check for internal bypass.
       verifyEnabled();
 
       // Always clear the dirty flag.
       theDirtyFlag = false;
    }
 }

◆ openHistogram()

bool ossimHistogramRemapper::openHistogram ( const ossimFilename & histogram_file )

Open the histogram file.

With this method the histogram is owned by this object. Returns true on success, false on error.

Definition at line 173 of file ossimHistogramRemapper.cpp.

References ossimMultiResLevelHistogram::importHistogram(), and setHistogram().

Referenced by ossimSingleImageChain::addHistogramRemapper(), and ossimSingleImageChain::openHistogram().

 {
    ossimRefPtr<ossimMultiResLevelHistogram> h = new ossimMultiResLevelHistogram();
    if (h->importHistogram(histogram_file))
    {
       setHistogram(h);
       return true;
    }
    
    // Import failed if here!
    return false;
 }

◆ operator=()

ossimHistogramRemapper & ossimHistogramRemapper::operator= ( const ossimHistogramRemapper & hr )

private

Definition at line 2244 of file ossimHistogramRemapper.cpp.

 {
    return *this;
 }

◆ print()

ostream & ossimHistogramRemapper::print ( 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 ossimTableRemapper.

Definition at line 1917 of file ossimHistogramRemapper.cpp.

References ossimString::c_str(), getStretchModeString(), theBandList, theBypassFlag, theDirtyFlag, theHistogram, theMaxOutputValue, theMidPoint, theMinOutputValue, theNormalizedHighClipPoint, theNormalizedLowClipPoint, ossimTableRemapper::theTable, and ossimRefPtr< T >::valid().

 {
    os << setiosflags(ios::fixed) << setprecision(15)
       << "\nossimHistogramRemapper::print:"
       << "\ntheStretchMode:         " << getStretchModeString().c_str()
       << "\ntheDirtyFlag:           " << (theDirtyFlag?"true":"false")
       << "\ntheBypassFlag:          " << (theBypassFlag?"true":"false")
       
       << "\ntheHistogram:           " << (theHistogram.valid()?"initialized":"null")
       << "\ntheTableSizeInBytes:    " << theTable.size()
       << endl;
    
    const ossim_uint32 BANDS = (ossim_uint32)theNormalizedLowClipPoint.size();
    for (ossim_uint32 band = 0; band < BANDS; ++band)
    {
       os << "\ntheNormalizedLowClipPoint[" << band << "]:   "
          << theNormalizedLowClipPoint[band]
          << "\ntheNormalizedHighClipPoint[" << band << "]:  "
          << theNormalizedHighClipPoint[band]
          << "\ntheMidPoint[" << band << "]:                 "
          << theMidPoint[band]
          << "\ntheMinOutputValue[" << band << "]:           "
          << theMinOutputValue[band]
          << "\ntheMaxOutputValue[" << band << "]:           "
          << theMaxOutputValue[band]
          << endl;
    }
    
    for (ossim_uint32 i = 0; i < theBandList.size(); ++i)
    {
       os << "theBandList[" << i << "]:  " << theBandList[i] << endl;
    }
 
    // Note: To set table call ossimTableRemapper::print or turn trace on
    // for "ossimTableRemapper:debug"
    
    return os;
 }

◆ reset()

void ossimHistogramRemapper::reset ( void )

Disables this source.
Sets all clip points to default.
Removes current table.

Definition at line 154 of file ossimHistogramRemapper.cpp.

References initializeClips(), LINEAR_ONE_PIECE, setStretchMode(), and verifyEnabled().

 {
    // We could delete theTable to free up memory???
    setStretchMode(LINEAR_ONE_PIECE, false);
    initializeClips();
    verifyEnabled();
 }

◆ saveState()

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

virtual

Method to the save the state to a keyword list.

Returns true if ok or false on error.

Reimplemented from ossimTableRemapper.

Definition at line 1112 of file ossimHistogramRemapper.cpp.

References ossimKeywordlist::add(), theHistogram, and ossimRefPtr< T >::valid().

 {
    if (theHistogram.valid())
    {
       kwl.add(prefix,
               HISTOGRAM_FILENAME_KW,
               theHistogram->getHistogramFile().c_str(),
               true);
    }
    kwl.add(prefix,
            STRETCH_MODE_KW,
            getStretchModeString().c_str(),
            true);
    
    const ossim_uint32 BANDS = (ossim_uint32)theNormalizedLowClipPoint.size();
    
    kwl.add(prefix,
            ossimKeywordNames::NUMBER_BANDS_KW,
            BANDS,
            true);
    
    for (ossim_uint32 band = 0; band < BANDS; ++band)
    {
       ossimString keyword;
       
       // Save the low clip.
       keyword = NORMALIZED_LOW_CLIP_POINT_KW;
       keyword += ".";
       keyword += ossimKeywordNames::BAND_KW;
       keyword += ossimString::toString(band+1);
       kwl.add(prefix,
               keyword,
               theNormalizedLowClipPoint[band],
               true);
       
       // Save the high clip.
       keyword = NORMALIZED_HIGH_CLIP_POINT_KW;
       keyword += ".";
       keyword += ossimKeywordNames::BAND_KW;
       keyword += ossimString::toString(band+1);
       kwl.add(prefix,
               keyword,
               theNormalizedHighClipPoint[band],
               true);
       
       // Save the mid point.
       keyword = MID_POINT_KW;
       keyword += ".";
       keyword += ossimKeywordNames::BAND_KW;
       keyword += ossimString::toString(band+1);
       kwl.add(prefix,
               keyword,
               theMidPoint[band],
               true);
       
       // Save the min output value.
 
       keyword = MIN_OUTPUT_VALUE_KW;
       keyword += ".";
       keyword += ossimKeywordNames::BAND_KW;
       keyword += ossimString::toString(band+1);
       kwl.add(prefix,
               keyword,
               theMinOutputValue[band],
               true);
       
       // Save the max output value.
       keyword = MAX_OUTPUT_VALUE_KW;
       keyword += ".";
       keyword += ossimKeywordNames::BAND_KW;
       keyword += ossimString::toString(band+1);
 
       kwl.add(prefix,
               keyword,
               theMaxOutputValue[band],
               true);
    }
 
    return ossimTableRemapper::saveState(kwl, prefix);
 }

◆ setBypassFlag()

void ossimHistogramRemapper::setBypassFlag ( bool flag )

private

Sets theBypassFlag.

If the start changes from bypassed to not bypassed this will set theDirtyFlag to true.

Definition at line 2249 of file ossimHistogramRemapper.cpp.

References theBypassFlag, and theDirtyFlag.

Referenced by verifyEnabled().

 {
    if (theBypassFlag != flag)
    {
       //---
       // If switching from bypassed to enabled set
       // the dirty flag.  We don't care about going the other way.
       //---
       if ( theBypassFlag && !flag )
       {
          theDirtyFlag = true;
       }
       theBypassFlag = flag;
    }
 }

◆ setHighClipPoint() [1/2]

void ossimHistogramRemapper::setHighClipPoint ( const ossim_float64 & clip )

Sets the high clip point.

Notes on clip points:

If input chip source is mutiband this will set all band to same percentage of clip.
Clip points are DN values.
If histogram is not set no action is taken.

Definition at line 525 of file ossimHistogramRemapper.cpp.

References ossimImageSourceFilter::getNumberOfInputBands().

 {
    const ossim_uint32 BANDS = getNumberOfInputBands();
    for (ossim_uint32 band = 0; band < BANDS; ++band)
    {
       setHighClipPoint(clip, band);
    }
 }

◆ setHighClipPoint() [2/2]

void ossimHistogramRemapper::setHighClipPoint	(	const ossim_float64 &	clip,
		ossim_uint32	zero_based_band
	)

Sets the high clip point.

Notes on clip points:

Clip points are DN values.
If histogram is not set no action is taken.

Definition at line 534 of file ossimHistogramRemapper.cpp.

References ossimHistogram::getHighFractionFromValue(), getHistogram(), ossim::isnan(), setHighNormalizedClipPoint(), and ossimRefPtr< T >::valid().

 {
    // allow the call to getHistogram to happen this way we can calculate a histogram if 
    // a histosource is connected to this object
    //
    //   if (!theHistogram) return;
    
    ossimRefPtr<ossimHistogram> h = getHistogram(zero_based_band);
    if (h.valid())
    {
       ossim_float64 d = h->getHighFractionFromValue(clip);
       if (ossim::isnan(d) == false)
       {
          d = 1.0-d;
          setHighNormalizedClipPoint(d, zero_based_band);
       }
    }
 }

◆ setHighNormalizedClipPoint() [1/2]

void ossimHistogramRemapper::setHighNormalizedClipPoint ( const ossim_float64 & clip )

Sets the high clip point.

Notes on clip points:

If input chip source is mutiband this will set all band to same percentage of clip.
Clip point should be normalized between zero and one.
A high clip point of 1.0 means no penetration.
A high clip point of .98 mean a 2 % penetration from the high end.

Definition at line 462 of file ossimHistogramRemapper.cpp.

References ossimImageSourceFilter::getNumberOfInputBands().

Referenced by setHighClipPoint().

 {
    const ossim_uint32 BANDS = getNumberOfInputBands();
    for (ossim_uint32 band = 0; band < BANDS; ++band)
    {
       setHighNormalizedClipPoint(clip, band);
    }
 }

◆ setHighNormalizedClipPoint() [2/2]

void ossimHistogramRemapper::setHighNormalizedClipPoint	(	const ossim_float64 &	clip,
		ossim_uint32	zero_based_band
	)

Sets the high clip point.

Notes on clip points:

Clip point should be normalized between zero and one.
A high clip point of 1.0 means no penetration.
A high clip point of .98 mean a 2 % penetration from the high end.

Definition at line 471 of file ossimHistogramRemapper.cpp.

References ossimImageSourceFilter::getNumberOfInputBands(), initializeClips(), ossimNotify(), ossimNotifyLevel_WARN, theDirtyFlag, theNormalizedHighClipPoint, and theNormalizedLowClipPoint.

 {
    const ossim_uint32 BANDS = getNumberOfInputBands();
    
    if (zero_based_band >= BANDS)
    {
       ossimNotify(ossimNotifyLevel_WARN)
          << "ossimHistogramRemapper::setHighNormalizedClipPoint ERROR:"
          << "\nband " << zero_based_band << " is out of range!"
          << "\nhighest band:  " << (BANDS-1) << endl;
    }
    
    if (theNormalizedHighClipPoint.size() != BANDS)
    {
       initializeClips();
    }
    
    if ( clip != theNormalizedHighClipPoint[zero_based_band] &&
         clip > theNormalizedLowClipPoint[zero_based_band] )
    {
       theDirtyFlag = true;
       theNormalizedHighClipPoint[zero_based_band] = clip;
    }
 }

◆ setHistogram()

void ossimHistogramRemapper::setHistogram ( ossimRefPtr< ossimMultiResLevelHistogram > histogram )

Sets the histogram.

If (own_histogram == true) this object will delete theHistogram on destruction.

Definition at line 162 of file ossimHistogramRemapper.cpp.

References initializeClips(), setNullCount(), theDirtyFlag, theHistogram, and ossimTableRemapper::theTable.

Referenced by computeHistogram(), ATP::AtpGenerator::constructChain(), ossimBandMergeTool::initHistogramStretch(), and openHistogram().

 {
    theHistogram = histogram;
    setNullCount();
    
    // Note: initializeClips before setNullCount since it relies on clips.
    initializeClips();
    theTable.clear();
    theDirtyFlag = true;
 }

◆ setLowClipPoint() [1/2]

void ossimHistogramRemapper::setLowClipPoint ( const ossim_float64 & clip )

Sets the low clip point.

Notes on clip point:

If input chip source is mutiband this will set all band to same percentage of clip.
Clip points are in DN values.
If histogram is not set no action is taken.

Definition at line 497 of file ossimHistogramRemapper.cpp.

References ossimImageSourceFilter::getNumberOfInputBands().

 {
    const ossim_uint32 BANDS = getNumberOfInputBands();
    for (ossim_uint32 band = 0; band < BANDS; ++band)
    {
       setLowClipPoint(clip, band);
    }
 }

◆ setLowClipPoint() [2/2]

void ossimHistogramRemapper::setLowClipPoint	(	const ossim_float64 &	clip,
		ossim_uint32	zero_based_band
	)

Sets the low clip point for band.

Notes on clip points:

Clip points are DN values.
If histogram is not set no action is taken.

Definition at line 506 of file ossimHistogramRemapper.cpp.

References getHistogram(), ossimHistogram::getLowFractionFromValue(), ossim::isnan(), setLowNormalizedClipPoint(), and ossimRefPtr< T >::valid().

 {
    // allow the call to getHistogram to happen this way we can calculate a histogram if 
    // a histosource is connected to this object
    //
    //   if (!theHistogram) return;
    
    ossimRefPtr<ossimHistogram> h = getHistogram(zero_based_band);
    if (h.valid())
    {
       ossim_float64 d = h->getLowFractionFromValue(clip);
       if (ossim::isnan(d) == false)
       {
          setLowNormalizedClipPoint(d, zero_based_band);
       }
    }
 }

◆ setLowNormalizedClipPoint() [1/2]

void ossimHistogramRemapper::setLowNormalizedClipPoint ( const ossim_float64 & clip )

Sets the low clip point.

Note on null bin:

The null bin is ignored when considering a percent of penetration from the low end.

Notes on clip point:

If input chip source is mutiband this will set all band to same percentage of clip.
Clip points should be normalized between zero and one.
A low clip point of 0.0 means no penetration.
A low clip point of 0.02 means penetrate in two percent.

Definition at line 411 of file ossimHistogramRemapper.cpp.

References ossimImageSourceFilter::getNumberOfInputBands().

Referenced by setLowClipPoint().

 {
    const ossim_uint32 BANDS = getNumberOfInputBands();
    for (ossim_uint32 band = 0; band < BANDS; ++band)
    {
       setLowNormalizedClipPoint(clip, band);
    }
 }

◆ setLowNormalizedClipPoint() [2/2]

void ossimHistogramRemapper::setLowNormalizedClipPoint	(	const ossim_float64 &	clip,
		ossim_uint32	zero_based_band
	)

Sets the low clip point for band.

Note on null bin:

The null bin is ignored when considering a percent of penetration from the low end.

Notes on clip points:

Clip point should be normalized between zero and one.
A low clip point of 0.0 means no penetration.
A low clip point of 0.02 means penetrate in two percent.

Definition at line 435 of file ossimHistogramRemapper.cpp.

References ossimImageSourceFilter::getNumberOfInputBands(), initializeClips(), ossimNotify(), ossimNotifyLevel_WARN, theDirtyFlag, theNormalizedHighClipPoint, and theNormalizedLowClipPoint.

 {
    const ossim_uint32 BANDS = getNumberOfInputBands();
    
    if (zero_based_band >= BANDS)
    {
       ossimNotify(ossimNotifyLevel_WARN)
          << "ossimHistogramRemapper::setLowNormalizedClipPoint ERROR:"
          << "\nband " << zero_based_band << " is out of range!"
          << "\nhighest band:  " << (BANDS-1) << endl;
    }
    
    if (theNormalizedLowClipPoint.size() != BANDS)
    {
       initializeClips();
    }
    
    if ( clip != theNormalizedLowClipPoint[zero_based_band] &&
         clip < theNormalizedHighClipPoint[zero_based_band] )
    {
       theDirtyFlag = true;
       theNormalizedLowClipPoint[zero_based_band] = clip;
    }
 }

◆ setMaxOutputValue() [1/2]

void ossimHistogramRemapper::setMaxOutputValue ( const ossim_float64 & value )

Sets the max output value.

Notes on clip points:

If input chip source is mutiband this will set all band to same percentage of clip.

Definition at line 627 of file ossimHistogramRemapper.cpp.

References ossimImageSourceFilter::getNumberOfInputBands().

 {
    const ossim_uint32 BANDS = getNumberOfInputBands();
    for (ossim_uint32 band = 0; band < BANDS; ++band)
    {
       setMaxOutputValue(value, band);
    }
 }

◆ setMaxOutputValue() [2/2]

void ossimHistogramRemapper::setMaxOutputValue	(	const ossim_float64 &	value,
		ossim_uint32	zero_based_band
	)

Sets the min output value for band.

Definition at line 636 of file ossimHistogramRemapper.cpp.

References getMaxPixelValue(), ossimImageSourceFilter::getNumberOfInputBands(), initializeClips(), ossimNotify(), ossimNotifyLevel_WARN, theDirtyFlag, ossimImageSourceFilter::theInputConnection, theMaxOutputValue, and theMinOutputValue.

 {
    if (theInputConnection)
    {
       const ossim_uint32 BANDS = getNumberOfInputBands();
       
       if (zero_based_band >= BANDS)
       {
          ossimNotify(ossimNotifyLevel_WARN)
             << "ossimHistogramRemapper::setMidPoint ERROR:"
             << "\nband " << zero_based_band << " is out of range!"
             << "\nhighest band:  " << (BANDS-1) << endl;
       }
       
       if (theMaxOutputValue.size() != BANDS)
       {
          initializeClips();
       }
       
       if ( value != theMaxOutputValue[zero_based_band] &&
            value <= theInputConnection->getMaxPixelValue(zero_based_band) &&
            value >  theMinOutputValue[zero_based_band] )
       {
          theDirtyFlag = true;
          theMaxOutputValue[zero_based_band] = value;
       }
    }
 }

◆ setMidPoint() [1/2]

void ossimHistogramRemapper::setMidPoint ( const ossim_float64 & value )

Sets the mid clip point.

Notes on clip points:

If input chip source is mutiband this will set all band to same percentage of clip.

Definition at line 554 of file ossimHistogramRemapper.cpp.

References ossimImageSourceFilter::getNumberOfInputBands().

 {
    const ossim_uint32 BANDS = getNumberOfInputBands();
    for (ossim_uint32 band = 0; band < BANDS; ++band)
    {
       setMidPoint(value, band);
    }
 }

◆ setMidPoint() [2/2]

void ossimHistogramRemapper::setMidPoint	(	const ossim_float64 &	value,
		ossim_uint32	zero_based_band
	)

Sets the mid clip point for band.

Definition at line 563 of file ossimHistogramRemapper.cpp.

References ossimImageSourceFilter::getNumberOfInputBands(), initializeClips(), ossimNotify(), ossimNotifyLevel_WARN, theDirtyFlag, and theMidPoint.

 {
    const ossim_uint32 BANDS = getNumberOfInputBands();
    
    if (zero_based_band >= BANDS)
    {
       ossimNotify(ossimNotifyLevel_WARN)
          << "ossimHistogramRemapper::setMidPoint ERROR:"
          << "\nband " << zero_based_band << " is out of range!"
          << "\nhighest band:  " << (BANDS-1) << endl;
    }
    
    if (theMidPoint.size() != BANDS)
    {
       initializeClips();
    }
    
    if (theMidPoint[zero_based_band] != value)
    {
       theDirtyFlag = true;
       theMidPoint[zero_based_band] = value;
    }
 }

◆ setMinOutputValue() [1/2]

void ossimHistogramRemapper::setMinOutputValue ( const ossim_float64 & value )

Sets the min output value.

Notes on clip points:

If input chip source is mutiband this will set all band to same percentage of clip.

Definition at line 588 of file ossimHistogramRemapper.cpp.

References ossimImageSourceFilter::getNumberOfInputBands().

 {
    const ossim_uint32 BANDS = getNumberOfInputBands();
    for (ossim_uint32 band = 0; band < BANDS; ++band)
    {
       setMinOutputValue(value, band);
    }
 }

◆ setMinOutputValue() [2/2]

void ossimHistogramRemapper::setMinOutputValue	(	const ossim_float64 &	value,
		ossim_uint32	zero_based_band
	)

Sets the min output value for band.

Definition at line 597 of file ossimHistogramRemapper.cpp.

References ossimImageSource::getMinPixelValue(), ossimImageSourceFilter::getNumberOfInputBands(), initializeClips(), ossimNotify(), ossimNotifyLevel_WARN, theDirtyFlag, ossimImageSourceFilter::theInputConnection, theMaxOutputValue, and theMinOutputValue.

 {
    if (theInputConnection)
    {
       const ossim_uint32 BANDS = getNumberOfInputBands();
       
       if (zero_based_band >= BANDS)
       {
          ossimNotify(ossimNotifyLevel_WARN)
             << "ossimHistogramRemapper::setMinOutputValue ERROR:"
             << "\nband " << zero_based_band << " is out of range!"
             << "\nhighest band:  " << (BANDS-1) << endl;
       }
       
       if (theMinOutputValue.size() != BANDS)
       {
          initializeClips();
       }
       
       if ( value != theMinOutputValue[zero_based_band] &&
            value >= theInputConnection->getMinPixelValue(zero_based_band) &&
            value < theMaxOutputValue[zero_based_band] )
       {
          theDirtyFlag = true;
          theMinOutputValue[zero_based_band] = value;
       }
    }
 }

◆ setNullCount()

void ossimHistogramRemapper::setNullCount ( )

private

Definition at line 1873 of file ossimHistogramRemapper.cpp.

References ossimMultiResLevelHistogram::getHistogram(), getHistogram(), ossimMultiResLevelHistogram::getNumberOfBands(), ossimHistogram::SetCount(), theHistogram, and ossimRefPtr< T >::valid().

Referenced by setHistogram().

 {
    // This will set the null bucket for all res zero bands to zero!
    if (getHistogram(0).valid())
    {
       const ossim_uint32 BANDS = theHistogram->getNumberOfBands();
       for (ossim_uint32 band = 0; band < BANDS; ++band)
       {
          ossimRefPtr<ossimHistogram> h = theHistogram->getHistogram(band);
          if (h.valid())
          {
             h->SetCount(0, 0);
          }
       }
    }
 }

◆ setStretchMode()

void ossimHistogramRemapper::setStretchMode	(	StretchMode	mode,
		bool	rebuildTableFlag = `false`
	)

Sets remap mode to mode.

If rebuildTableFlag is true, the table will be built at this time; else just the dirty flag is set.

Parameters

mode	The stretch mode.
rebuildTableFlag	If the true the table will be rebuilt; else, just the dirty flag will be set.

Definition at line 1194 of file ossimHistogramRemapper.cpp.

References buildTable(), theDirtyFlag, theStretchMode, and verifyEnabled().

Referenced by ossimSingleImageChain::addHistogramRemapper(), ATP::AtpGenerator::constructChain(), ossimBandMergeTool::initHistogramStretch(), ossimSingleImageChain::openHistogram(), reset(), and setStretchModeAsString().

 {
    if (theStretchMode != mode)
    {
       theStretchMode = mode;
 
       if (rebuildTable)
       {
          buildTable();
 
          // Check for internal bypass.
          verifyEnabled();
 
          // Clear the dirty flag.
          theDirtyFlag = false;
       }
       else
       {
          theDirtyFlag = true;
       }
    }
 }

◆ setStretchModeAsString()

void ossimHistogramRemapper::setStretchModeAsString	(	const ossimString &	mode,
		bool	rebuildTableFlag = `false`
	)

Stretch mode values can be linear_one_piece, linear_1std_from_mean, linear_2std_from_mean, linear_3std_from_mean, linear_auto_min_max, If rebuildTableFlag is true, the table will be built at this time; else just the dirty flag is set.

Parameters

mode	The stretch mode.
rebuildTableFlag	If the true the table will be rebuilt; else, just the dirty flag will be set.

Definition at line 1218 of file ossimHistogramRemapper.cpp.

References LINEAR_1STD_FROM_MEAN, LINEAR_2STD_FROM_MEAN, LINEAR_3STD_FROM_MEAN, LINEAR_AUTO_MIN_MAX, LINEAR_AUTO_PERCENTILE, LINEAR_ONE_PIECE, setStretchMode(), and STRETCH_UNKNOWN.

 {
    if( mode == "linear_one_piece")
    {
       setStretchMode(LINEAR_ONE_PIECE, rebuildTable);
    }
    else if(mode == "linear_1std_from_mean")
    {
       setStretchMode(LINEAR_1STD_FROM_MEAN, rebuildTable);
    }
    else if(mode == "linear_2std_from_mean")
    {
       setStretchMode(LINEAR_2STD_FROM_MEAN, rebuildTable);
    }
    else if(mode == "linear_3std_from_mean")
    {
       setStretchMode(LINEAR_3STD_FROM_MEAN, rebuildTable);
    }
    else if(mode == "linear_auto_min_max")
    {
       setStretchMode(LINEAR_AUTO_MIN_MAX, rebuildTable);
    }
    else if(mode == "linear_auto_percentile")
    {
       setStretchMode(LINEAR_AUTO_PERCENTILE, rebuildTable);
    }
    else
    {
       setStretchMode(STRETCH_UNKNOWN, false);
    }   
 }

◆ setupTable()

void ossimHistogramRemapper::setupTable ( )

private

Initialized base class (ossimTableRemapper) values:

theTableBinCount
theTableBandCount
theTableType
theTable (resizes if not correct size.

Definition at line 1956 of file ossimHistogramRemapper.cpp.

Referenced by buildTable().

 {
    const ossim_uint32 BANDS = getNumberOfInputBands();
    
    
    ossim_uint32 values_per_band = 0;
    ossim_uint32 bytes_per_pixel = 0;
    
    switch (theOutputScalarType)
    {
       case OSSIM_UINT8:
          values_per_band = 256;  // 2 ^ 8
          bytes_per_pixel = 1;
          theTableType = ossimTableRemapper::NATIVE;
          break;
          
       case OSSIM_USHORT11:
          values_per_band = 2048; // 2 ^ 11
          bytes_per_pixel = 2;
          theTableType = ossimTableRemapper::NATIVE;
          break;
       case OSSIM_USHORT12:
           values_per_band = 4096; // 2 ^ 12
           bytes_per_pixel = 2;
           theTableType = ossimTableRemapper::NATIVE;
           break;
       case OSSIM_USHORT13:
           values_per_band = 8192; // 2 ^ 13
           bytes_per_pixel = 2;
           theTableType = ossimTableRemapper::NATIVE;
           break;
       case OSSIM_USHORT14:
           values_per_band = 16384; // 2 ^ 14
           bytes_per_pixel = 2;
           theTableType = ossimTableRemapper::NATIVE;
           break;
       case OSSIM_USHORT15:
           values_per_band = 32768; // 2 ^ 15
           bytes_per_pixel = 2;
           theTableType = ossimTableRemapper::NATIVE;
           break;
          
       case OSSIM_UINT16:
       case OSSIM_SINT16:
          values_per_band = 65536; // 2 ^ 16
          bytes_per_pixel = 2;
          theTableType = ossimTableRemapper::NATIVE;
          break;
          
       case OSSIM_UINT32:
       case OSSIM_SINT32:
          values_per_band = 65536; // 2 ^ 16
          bytes_per_pixel = 4;
          theTableType = ossimTableRemapper::MIN_MAX;
          break;
          
       case OSSIM_NORMALIZED_FLOAT:
       {
          bytes_per_pixel = 4;
          theTableType = ossimTableRemapper::NORMALIZED;
          break;
       }
       case OSSIM_FLOAT:
          bytes_per_pixel = 4;
          values_per_band = 65536; // 2 ^ 16
          theTableType = ossimTableRemapper::MIN_MAX;
          break;
          
       case OSSIM_NORMALIZED_DOUBLE:  
       {
          bytes_per_pixel = 8;
          values_per_band = 65536; // 2 ^ 16
          theTableType = ossimTableRemapper::NORMALIZED;
          break;         
       }       
       case OSSIM_DOUBLE:
          bytes_per_pixel = 8;
          values_per_band = 65536; // 2 ^ 16
          theTableType = ossimTableRemapper::MIN_MAX;
          break;
          
       default:
          break;
    }
 
    if (theNormalizedLowClipPoint.size() == 0)
    {
       initializeClips(BANDS);
    }
 
    if ( theOutputScalarType == OSSIM_FLOAT ||
         theOutputScalarType == OSSIM_DOUBLE ||
         theOutputScalarType == OSSIM_NORMALIZED_FLOAT ||
         theOutputScalarType == OSSIM_NORMALIZED_DOUBLE )
    {
       for (ossim_uint32 band = 0; band < BANDS; ++band)
       {
          ossimRefPtr<ossimHistogram> h  = getHistogram(band);
          
          if (h.valid())
          {
             if (h->GetRes() > static_cast<ossim_int32>(values_per_band))
             {
                values_per_band = h->GetRes();
             }
          }
       }
    }      
    
    theTableBinCount  = values_per_band;
    theTableBandCount = BANDS;
 
    ossim_uint32 size_in_bytes = values_per_band * BANDS * bytes_per_pixel;
    theTable.resize(size_in_bytes);
 
    ossimImageSource* input = dynamic_cast<ossimImageSource*>(getInput());
    double minPix = ossim::defaultMin(getOutputScalarType());
    double maxPix = ossim::defaultMax(getOutputScalarType());
    
    if(input)
    {
       //---
       // Last check for NaNs in key data members and set to some default if so.
       // This could occur if someone stripped a keyword list down to a minimal
       // set of keywords.
       //---
       for (ossim_uint32 band = 0; band < BANDS; ++band)
       {
          minPix = input->getMinPixelValue(band);
          maxPix = input->getMaxPixelValue(band);
          if ( ossim::isnan(theMinOutputValue[band]) )
          {
             theMinOutputValue[band] = minPix;
          }
          if ( ossim::isnan(theMaxOutputValue[band]) )
          {
             theMaxOutputValue[band] = maxPix;
          }
       }   
    }
    else
    {
       //---
       // Last check for NaNs in key data members and set to some default if so.
       // This could occur if someone stripped a keyword list down to a minimal
       // set of keywords.
       //---
       for (ossim_uint32 band = 0; band < BANDS; ++band)
       {
          if ( ossim::isnan(theMinOutputValue[band]) )
          {
             theMinOutputValue[band] = minPix;
          }
          if ( ossim::isnan(theMaxOutputValue[band]) )
          {
             theMaxOutputValue[band] = maxPix;
          }
       }   
    }
 }

◆ verifyEnabled()

void ossimHistogramRemapper::verifyEnabled ( )

private

This set theBypassFlag.

This is an internally used flag to signal that there is nothing to do in this filter; hence, bypass.

Definition at line 2117 of file ossimHistogramRemapper.cpp.

References setBypassFlag(), STRETCH_UNKNOWN, theHistogram, theStretchMode, and ossimRefPtr< T >::valid().

Referenced by makeClean(), reset(), and setStretchMode().

 {
    //---
    // Since this filter can be constructed with no input connection do not
    // output and error, simply return.
    //--- 
    setBypassFlag(true);
    //if (theInputConnection)
    {
 
 #if 1     
       // Start off bypassed.
 
       if (theStretchMode != STRETCH_UNKNOWN)
       {
          if(theHistogram.valid())
          {
             setBypassFlag(false);
          }
 /*         
          const ossim_uint32 BANDS =
             (ossim_uint32)theNormalizedLowClipPoint.size();
          for (ossim_uint32 band = 0; band < BANDS; ++band)
          {
             //const double MIN = ossimTableRemapper::getMinPixelValue(band);
             //const double MAX = ossimTableRemapper::getMaxPixelValue(band);
             if ( theNormalizedLowClipPoint[band]  != 0.0   ||
                  theNormalizedHighClipPoint[band] != 1.0 )
                 // theMinOutputValue[band] != MIN ||
                  //theMaxOutputValue[band] != MAX )
             {
                // Need to turn filter on.
                setBypassFlag(false);
                break;
             }
          }
          */
       }
 #endif
    }
    if (traceDebug())
    {
       ossimNotify(ossimNotifyLevel_DEBUG)
          << "ossimHistogramRemapper::verifyEnabled theBypassFlag: "
          << (theBypassFlag ? "true" : "false") << endl;
    }
 }

Member Data Documentation

◆ theBandList

vector<ossim_uint32> ossimHistogramRemapper::theBandList

private

Definition at line 577 of file ossimHistogramRemapper.h.

Referenced by print().

◆ theBypassFlag

bool ossimHistogramRemapper::theBypassFlag

private

Definition at line 580 of file ossimHistogramRemapper.h.

Referenced by getMaxPixelValue(), getMinPixelValue(), getTile(), print(), and setBypassFlag().

◆ theDirtyFlag

bool ossimHistogramRemapper::theDirtyFlag

private

Definition at line 568 of file ossimHistogramRemapper.h.

Referenced by buildLinearTable(), getTile(), makeClean(), print(), setBypassFlag(), setHighNormalizedClipPoint(), setHistogram(), setLowNormalizedClipPoint(), setMaxOutputValue(), setMidPoint(), setMinOutputValue(), and setStretchMode().

◆ theHistogram

ossimRefPtr<ossimMultiResLevelHistogram> ossimHistogramRemapper::theHistogram

mutableprivate

Definition at line 569 of file ossimHistogramRemapper.h.

Referenced by getHighClipPoint(), getHistogram(), getHistogramFile(), getLowClipPoint(), print(), saveState(), setHistogram(), setNullCount(), and verifyEnabled().

◆ theMaxOutputValue

vector<ossim_float64> ossimHistogramRemapper::theMaxOutputValue

private

Definition at line 574 of file ossimHistogramRemapper.h.

Referenced by getMaxOutputValue(), getMaxPixelValue(), initializeClips(), initializeMinMaxOutput(), print(), setMaxOutputValue(), setMinOutputValue(), and setupTable().

◆ theMidPoint

vector<ossim_float64> ossimHistogramRemapper::theMidPoint

private

Definition at line 572 of file ossimHistogramRemapper.h.

Referenced by getMidPoint(), initializeClips(), print(), and setMidPoint().

◆ theMinOutputValue

vector<ossim_float64> ossimHistogramRemapper::theMinOutputValue

private

Definition at line 573 of file ossimHistogramRemapper.h.

Referenced by getMinOutputValue(), getMinPixelValue(), initializeClips(), initializeMinMaxOutput(), print(), setMaxOutputValue(), setMinOutputValue(), and setupTable().

◆ theNormalizedHighClipPoint

vector<ossim_float64> ossimHistogramRemapper::theNormalizedHighClipPoint

private

Definition at line 571 of file ossimHistogramRemapper.h.

Referenced by getHighClipPoint(), getHighNormalizedClipPoint(), initializeClips(), print(), setHighNormalizedClipPoint(), and setLowNormalizedClipPoint().

◆ theNormalizedLowClipPoint

vector<ossim_float64> ossimHistogramRemapper::theNormalizedLowClipPoint

private

Definition at line 570 of file ossimHistogramRemapper.h.

Referenced by applyLinearStretch(), buildAutoLinearMinMaxTableTemplate(), buildAutoLinearPercentileTableTemplate(), buildLinearTable(), buildLinearTableStdFromMean(), getLowClipPoint(), getLowNormalizedClipPoint(), initializeClips(), print(), setHighNormalizedClipPoint(), setLowNormalizedClipPoint(), and setupTable().

◆ theResetBandIndicesFlag

bool ossimHistogramRemapper::theResetBandIndicesFlag

private

Definition at line 581 of file ossimHistogramRemapper.h.

Referenced by getHistogramBand().

◆ theStretchMode

StretchMode ossimHistogramRemapper::theStretchMode

private

Definition at line 567 of file ossimHistogramRemapper.h.

Referenced by buildTable(), getStretchMode(), setStretchMode(), and verifyEnabled().

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

Public Types

Public Member Functions

Protected Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ StretchMode

Constructor & Destructor Documentation

◆ ossimHistogramRemapper() [1/2]

◆ ~ossimHistogramRemapper()

◆ ossimHistogramRemapper() [2/2]

Member Function Documentation

◆ applyLinearStretch()

◆ buildAutoLinearMinMaxTable()

◆ buildAutoLinearMinMaxTableTemplate()

◆ buildAutoLinearPercentileTable()

◆ buildAutoLinearPercentileTableTemplate()

◆ buildLinearTable() [1/2]

◆ buildLinearTable() [2/2]

◆ buildLinearTableStdFromMean()

◆ buildTable()

◆ canConnectMyInputTo()

◆ computeHistogram()

◆ getHighClipPoint() [1/2]

◆ getHighClipPoint() [2/2]

◆ getHighNormalizedClipPoint() [1/2]

◆ getHighNormalizedClipPoint() [2/2]

◆ getHistogram() [1/3]

◆ getHistogram() [2/3]

◆ getHistogram() [3/3]

◆ getHistogramBand()

◆ getHistogramFile()

◆ getLongName()

◆ getLowClipPoint() [1/2]

◆ getLowClipPoint() [2/2]

◆ getLowNormalizedClipPoint() [1/2]

◆ getLowNormalizedClipPoint() [2/2]

◆ getMaxOutputValue() [1/2]

◆ getMaxOutputValue() [2/2]

◆ getMaxPixelValue()

◆ getMidPoint() [1/2]

◆ getMidPoint() [2/2]

◆ getMinOutputValue() [1/2]

◆ getMinOutputValue() [2/2]

◆ getMinPixelValue()

◆ getNumberOfStretchModes()

◆ getShortName()

◆ getStretchMode()

◆ getStretchModeString() [1/2]

◆ getStretchModeString() [2/2]

◆ getTile()

◆ initialize()

◆ initializeClips() [1/2]

◆ initializeClips() [2/2]

◆ initializeMinMaxOutput()

◆ loadState()

◆ makeClean()

◆ openHistogram()

◆ operator=()

◆ print()

◆ reset()

◆ saveState()

◆ setBypassFlag()

◆ setHighClipPoint() [1/2]

◆ setHighClipPoint() [2/2]

◆ setHighNormalizedClipPoint() [1/2]

◆ setHighNormalizedClipPoint() [2/2]

◆ setHistogram()

◆ setLowClipPoint() [1/2]

◆ setLowClipPoint() [2/2]

◆ setLowNormalizedClipPoint() [1/2]

◆ setLowNormalizedClipPoint() [2/2]

◆ setMaxOutputValue() [1/2]

◆ setMaxOutputValue() [2/2]

◆ setMidPoint() [1/2]

◆ setMidPoint() [2/2]

◆ setMinOutputValue() [1/2]

◆ setMinOutputValue() [2/2]