Using sensor models to perform correlation along epipolars. More...

#include <otbStereoSensorModelToElevationMapFilter.h>

Inheritance diagram for otb::StereoSensorModelToElevationFilter< TInputImage, TOutputHeight >:

Collaboration diagram for otb::StereoSensorModelToElevationFilter< TInputImage, TOutputHeight >:

Public Types
typedef StereoSensorModelToElevationFilter	Self
	Standard class typedefs.
typedef itk::ImageToImageFilter < TInputImage, TOutputHeight >	Superclass
typedef itk::SmartPointer< Self >	Pointer
typedef itk::SmartPointer < const Self >	ConstPointer
typedef TInputImage	InputImageType
	Convenient typedefs.
typedef InputImageType::PixelType	InputPixelType
typedef TOutputHeight	OutputImageType
	Some convenient typedefs.
typedef OutputImageType::RegionType	OutputRegionType
typedef OutputImageType::PixelType	HeightType
typedef OutputImageType::PointType	OutputPointType
typedef itk::InterpolateImageFunction < TInputImage, double >	InterpolatorType
typedef InterpolatorType::Pointer	InterpolatorPointerType
typedef GenericRSTransform	GenericRSTransformType
typedef GenericRSTransform < double, 3, 3 >	GenericRSTransform3DType
typedef itk::NormalizedCorrelationImageToImageMetric < TInputImage, TInputImage >	CorrelationMetricType
typedef InputImageType::SizeType	RadiusType
typedef Superclass::OutputImageRegionType	OutputImageRegionType
	Superclass typedefs.
typedef Superclass::OutputImagePixelType	OutputImagePixelType
typedef InputImageType::Pointer	InputImagePointer
typedef InputImageType::ConstPointer	InputImageConstPointer
typedef InputImageType::RegionType	InputImageRegionType
typedef InputImageType::PixelType	InputImagePixelType
typedef DataObject::Pointer	DataObjectPointer
	Smart Pointer type to a DataObject.
typedef OutputImageType::Pointer	OutputImagePointer
typedef std::vector < DataObjectPointer >	DataObjectPointerArray
	STL Array of SmartPointers to DataObjects.
typedef DataObjectPointerArray::size_type	DataObjectPointerArraySizeType
	Size type of an std::vector.
Public Member Functions
virtual const char *	GetNameOfClass () const
	Run-time type information (and related methods).
void	SetMasterInput (const TInputImage *image)
	Set the master input image.
void	SetSlaveInput (const TInputImage *image)
	Set the slave input iamge.
const TInputImage *	GetMasterInput () const
	Get the master input image.
const TInputImage *	GetSlaveInput () const
	Get the slave input image.
TOutputHeight *	GetCorrelationOutput ()
	Get the output correlation map.
virtual void	SetDEMDirectory (const char *_arg)
	Set the directory containing the DEM tiles.
virtual const char *	GetDEMDirectory () const
	Get the directory containing the DEM tiles.
virtual void	SetGeoidFile (const char *_arg)
	Set the path to the geoid file.
virtual const char *	GetGeoidFile () const
	Get the path to tyhe geoid file.
virtual void	SetUseDEM (bool _arg)
	Set the use DEM flag.
virtual bool	GetUseDEM ()
	Get the use DEM flag.
virtual void	UseDEMOn ()
	Toggle the use DEM flag.
virtual void	UseDEMOff ()
virtual void	SetAverageElevation (double _arg)
	Set the average elevation to consider if no DEM is used.
virtual double	GetAverageElevation ()
	Get the average elevation to consider if no DEM is used.
virtual void	SetLowerElevation (double _arg)
	Set the lower offset for the local elevation exploration.
virtual void	SetHigherElevation (double _arg)
	Set the lower offset for the local elevation exploration.
virtual void	SetElevationStep (double _arg)
	Set the step of the elevation exploration.
virtual void	SetCorrelationThreshold (double _arg)
	Set the threshold of the correlation to keep estimated height.
virtual double	GetCorrelationThreshold ()
	Get the threshold of the correlation to keep estimated height.
virtual void	SetVarianceThreshold (double _arg)
	Set the threshold on the variance of the master patch to start elevation estimation.
virtual double	GetVarianceThreshold ()
	Set the threshold on the variance of the master patch to start elevation estimation.
virtual void	SetSubtractInitialElevation (bool _arg)
	Set the SubtractInitialElevation flag.
virtual bool	GetSubtractInitialElevation ()
	Get the SubtractInitialElevation flag.
virtual void	SubtractInitialElevationOn ()
	Toggle the SubtractInitialElevation flag.
virtual void	SubtractInitialElevationOff ()
void	SetRadius (unsigned int radius)
	Set the radius of the patches.
virtual void	SetInput (const InputImageType *image)
	Set/Get the image input of this process object.
virtual void	SetInput (unsigned int, const TInputImage *image)
const InputImageType *	GetInput (void)
const InputImageType *	GetInput (unsigned int idx)
	Method used internally for getting an input.
virtual void	PushBackInput (const InputImageType *image)
	Push/Pop the input of this process object.
virtual void	PopBackInput ()
	Model a stack on the input list by providing a pop back.
virtual void	PushFrontInput (const InputImageType *image)
virtual void	PopFrontInput ()
OutputImageType *	GetOutput (void)
	Get the output data of this process object.
OutputImageType *	GetOutput (unsigned int idx)
	Method used internally for getting an output.
virtual void	GraftOutput (DataObject *output)
	Graft the specified DataObject onto this ProcessObject's output.
virtual void	GraftNthOutput (unsigned int idx, DataObject *output)
	Graft the specified data object onto this ProcessObject's idx'th output.
virtual DataObjectPointer	MakeOutput (unsigned int idx)
	Make a DataObject of the correct type to used as the specified output.
DataObjectPointerArray &	GetInputs ()
	Return an array with all the inputs of this process object.
DataObjectPointerArraySizeType	GetNumberOfInputs () const
	Get the size of the input vector.
virtual DataObjectPointerArraySizeType	GetNumberOfValidRequiredInputs () const
	Get the number of valid inputs.
DataObjectPointerArray &	GetOutputs ()
	Return an array with all the outputs of this process object.
DataObjectPointerArraySizeType	GetNumberOfOutputs () const
virtual void	SetAbortGenerateData (bool _arg)
	Set the AbortGenerateData flag for the process object.
virtual const bool &	GetAbortGenerateData ()
	Get the AbortGenerateData flag for the process object.
virtual void	AbortGenerateDataOn ()
	Turn on and off the AbortGenerateData flag.
virtual void	AbortGenerateDataOff ()
virtual void	SetProgress (float _arg)
	Set the execution progress of a process object.
virtual const float &	GetProgress ()
	Get the execution progress of a process object.
void	UpdateProgress (float amount)
	Update the progress of the process object.
virtual void	Update ()
	Bring this filter up-to-date.
virtual void	UpdateLargestPossibleRegion ()
	Like Update(), but sets the output requested region to the largest possible region for the output.
virtual void	UpdateOutputInformation ()
	Update the information decribing the output data.
virtual void	PropagateRequestedRegion (DataObject *output)
	Send the requested region information back up the pipeline (to the filters that preceed this one).
virtual void	UpdateOutputData (DataObject *output)
	Actually generate new output.
virtual void	EnlargeOutputRequestedRegion (DataObject *)
	Give the process object a chance to indictate that it will produce more output than it was requested to produce.
virtual void	ResetPipeline ()
	Reset the pipeline.
virtual void	SetReleaseDataFlag (bool flag)
	Turn on/off the flags to control whether the bulk data belonging to the outputs of this ProcessObject are released after being used by a downstream ProcessObject.
virtual bool	GetReleaseDataFlag () const
void	ReleaseDataFlagOn ()
void	ReleaseDataFlagOff ()
virtual void	SetReleaseDataBeforeUpdateFlag (bool _arg)
	Turn on/off the flags to control whether the bulk data belonging to the outputs of this ProcessObject are released/reallocated during an Update().
virtual const bool &	GetReleaseDataBeforeUpdateFlag ()
virtual void	ReleaseDataBeforeUpdateFlagOn ()
virtual void	ReleaseDataBeforeUpdateFlagOff ()
virtual void	SetNumberOfThreads (int _arg)
	Get/Set the number of threads to create when executing.
virtual const int &	GetNumberOfThreads ()
MultiThreader *	GetMultiThreader ()
	Return the multithreader used by this class.
virtual void	PrepareOutputs ()
	An opportunity to deallocate a ProcessObject's bulk data storage.
virtual LightObject::Pointer	CreateAnother () const
	Create an object from an instance, potentially deferring to a factory.
virtual void	DebugOn () const
	Turn debugging output on.
virtual void	DebugOff () const
	Turn debugging output off.
bool	GetDebug () const
	Get the value of the debug flag.
void	SetDebug (bool debugFlag) const
	Set the value of the debug flag.
virtual unsigned long	GetMTime () const
	Return this objects modified time.
virtual void	Modified () const
	Update the modification time for this object.
virtual void	Register () const
	Increase the reference count (mark as used by another object).
virtual void	UnRegister () const
	Decrease the reference count (release by another object).
virtual void	SetReferenceCount (int)
	Sets the reference count (use with care).
unsigned long	AddObserver (const EventObject &event, Command *)
	Allow people to add/remove/invoke observers (callbacks) to any ITK object.
unsigned long	AddObserver (const EventObject &event, Command *) const
Command *	GetCommand (unsigned long tag)
	Get the command associated with the given tag.
void	InvokeEvent (const EventObject &)
	Call Execute on all the Commands observing this event id.
void	InvokeEvent (const EventObject &) const
	Call Execute on all the Commands observing this event id.
void	RemoveObserver (unsigned long tag)
	Remove the observer with this tag value.
void	RemoveAllObservers ()
	Remove all observers .
bool	HasObserver (const EventObject &event) const
	Return true if an observer is registered for this event.
MetaDataDictionary &	GetMetaDataDictionary (void)
const MetaDataDictionary &	GetMetaDataDictionary (void) const
void	SetMetaDataDictionary (const MetaDataDictionary &rhs)
virtual void	Delete ()
	Delete an itk object.
void	Print (std::ostream &os, Indent indent=0) const
	Cause the object to print itself out.
virtual int	GetReferenceCount () const
	Gets the reference count on this object.
Static Public Member Functions
static Pointer	New ()
	Method for creation through the object factory.
static void	SetGlobalWarningDisplay (bool flag)
	This is a global flag that controls whether any debug, warning or error messages are displayed.
static bool	GetGlobalWarningDisplay ()
	Get the value of the global debug output control flag.
static void	GlobalWarningDisplayOn ()
static void	GlobalWarningDisplayOff ()
static void	BreakOnError ()
	This method is called when itkExceptionMacro executes.
Static Public Attributes
static const unsigned int	InputImageDimension
	ImageDimension constants.
static const unsigned int	OutputImageDimension
	ImageDimension constant.
Protected Types
typedef ImageToImageFilterDetail::ImageRegionCopier < itkGetStaticConstMacro(OutputImageDimension), itkGetStaticConstMacro(InputImageDimension)>	InputToOutputRegionCopierType
	Typedef for the region copier function object that converts an input region to an output region.
typedef ImageToImageFilterDetail::ImageRegionCopier < itkGetStaticConstMacro(InputImageDimension), itkGetStaticConstMacro(OutputImageDimension)>	OutputToInputRegionCopierType
	Typedef for the region copier function object that converts an output region to an input region.
typedef int	InternalReferenceCountType
	Define the type of the reference count according to the target.
Protected Member Functions
	StereoSensorModelToElevationFilter ()
	Constructor.
virtual	~StereoSensorModelToElevationFilter ()
	Destructor.
virtual void	ThreadedGenerateData (const OutputRegionType &outputRegionForThread, int threadId)
	Threaded generate data.
virtual void	GenerateInputRequestedRegion (void)
	Generate the input requested regions.
virtual void	BeforeThreadedGenerateData ()
	Things to do before the threaded generate-data.
const DataObject *	GetInput (unsigned int idx) const
void	PushBackInput (const DataObject *input)
	PushBackInput(), PushFronInput() in the public section force the input to be the type expected by an ImageToImageFilter.
void	PushFrontInput (const DataObject *input)
virtual void	PrintSelf (std::ostream &os, Indent indent) const
	Methods invoked by Print() to print information about the object including superclasses.
virtual void	CallCopyOutputRegionToInputRegion (InputImageRegionType &destRegion, const OutputImageRegionType &srcRegion)
	This function calls the actual region copier to do the mapping from output image space to input image space.
virtual void	CallCopyInputRegionToOutputRegion (OutputImageRegionType &destRegion, const InputImageRegionType &srcRegion)
	This function calls the actual region copier to do the mapping from input image space to output image space.
const DataObject *	GetOutput (unsigned int idx) const
virtual void	GenerateData ()
	A version of GenerateData() specific for image processing filters.
virtual void	ThreadedGenerateData (const OutputImageRegionType &outputRegionForThread, int threadId)
	If an imaging filter can be implemented as a multithreaded algorithm, the filter will provide an implementation of ThreadedGenerateData().
virtual void	AllocateOutputs ()
	The GenerateData method normally allocates the buffers for all of the outputs of a filter.
virtual void	AfterThreadedGenerateData ()
	If an imaging filter needs to perform processing after all processing threads have completed, the filter can can provide an implementation for AfterThreadedGenerateData().
virtual int	SplitRequestedRegion (int i, int num, OutputImageRegionType &splitRegion)
	Split the output's RequestedRegion into "num" pieces, returning region "i" as "splitRegion".
virtual void	SetNthInput (unsigned int num, DataObject *input)
	Protected methods for setting inputs.
virtual void	AddInput (DataObject *input)
	Adds an input to the first null position in the input list.
virtual void	RemoveInput (DataObject *input)
	Remove an input.
virtual void	SetNumberOfRequiredInputs (unsigned int _arg)
virtual const unsigned int &	GetNumberOfRequiredInputs ()
void	SetNumberOfInputs (unsigned int num)
	Called to allocate the input array.
virtual void	SetNthOutput (unsigned int num, DataObject *output)
	Protected methods for setting outputs.
virtual void	AddOutput (DataObject *output)
	Adds an output to the first null position in the output list.
virtual void	RemoveOutput (DataObject *output)
virtual void	SetNumberOfRequiredOutputs (unsigned int _arg)
virtual const unsigned int &	GetNumberOfRequiredOutputs ()
void	SetNumberOfOutputs (unsigned int num)
	Called to allocate the output array.
virtual void	GenerateOutputRequestedRegion (DataObject *output)
	Given one output whose requested region has been set, how should the requested regions for the remaining outputs of the process object be set? By default, all the outputs are set to the same requested region.
virtual void	GenerateOutputInformation ()
	Generate the information decribing the output data.
virtual void	PropagateResetPipeline ()
	Called to allocate the input array.
virtual void	ReleaseInputs ()
	A filter may need to release its input's bulk data after it has finished calculating a new output.
virtual void	CacheInputReleaseDataFlags ()
	Cache the state of any ReleaseDataFlag's on the inputs.
virtual void	RestoreInputReleaseDataFlags ()
	Restore the cached input ReleaseDataFlags.
bool	PrintObservers (std::ostream &os, Indent indent) const
virtual void	PrintHeader (std::ostream &os, Indent indent) const
	Define a default print header for all objects.
virtual void	PrintTrailer (std::ostream &os, Indent indent) const
	Define a default print trailer for all objects.
Static Protected Member Functions
static ITK_THREAD_RETURN_TYPE	ThreaderCallback (void *arg)
	Static function used as a "callback" by the MultiThreader.
Protected Attributes
bool	m_Updating
	These ivars are made protected so filters like itkStreamingImageFilter can access them directly.
TimeStamp	m_OutputInformationMTime
	Time when GenerateOutputInformation was last called.
InternalReferenceCountType	m_ReferenceCount
	Number of uses of this object by other objects.
SimpleFastMutexLock	m_ReferenceCountLock
	Mutex lock to protect modification to the reference count.
Private Member Functions
	StereoSensorModelToElevationFilter (const Self &)
void	operator= (const Self &)
double	Correlation (const std::vector< double > &master, const std::vector< double > &slave) const
Private Attributes
InterpolatorPointerType	m_Interpolator
	Interpolator for slave image.
RadiusType	m_Radius
	Radius of the patches.
double	m_LowerElevation
	Lower offset for the local elevation exploration.
double	m_HigherElevation
	Higher offset for the local elevation exploration.
double	m_ElevationStep
	Step of the elevation exploration.
bool	m_UseDEM
	If set to true, the local elevation is extracted from a DEM + geoid.
std::string	m_DEMDirectory
	Directory containing the DEM tiles.
std::string	m_GeoidFile
	Path to the geoid file.
double	m_AverageElevation
	Average elevation to consider if no DEM is used.
double	m_CorrelationThreshold
	Threshold of the correlation to keep estimated height.
double	m_VarianceThreshold
	Threshold on the variance of the master patch to start elevation estimation.
bool	m_SubtractInitialElevation
	If set to true, the elevation map will only contains the difference between the estimated elevation and the initial one.

Detailed Description

template<class TInputImage, class TOutputHeight>
class otb::StereoSensorModelToElevationFilter< TInputImage, TOutputHeight >

Using sensor models to perform correlation along epipolars.

This filter uses a pair of stereo images along-track to build an elevation map.

Images are not resampled to epipolar geometry. Instead, for each patch of the master image, corresponding patches are interpolated in the slave image according to a range of candidate elevations. Colocalisation is achieved through the GenericRSTransform for each pixel of the patch, which means the interpolated path follows the warping between the two images (it is not necesseraly aligned with slave image boundary). The elevation achieving the higher correlation is kept in the final elevation map.

Setting-up the elevation exploration range is simple : the LowerElevation and HigherElevation parameters allows to set the exploration range offsets with respect to the local elevation, and the ElevationStep parameter allows to set the step between candidate elevation. The local elevation can either be constant over the whole scene, or interpolated in a Digital Elevation Model. The latter allows to account for highly varying elevation in large scene, and allows to reduce the elevation exploration range. Please note that one can also use a geoid file along with the DEM.

Correlation parameters are as follows :

The radius allows to to tune patches size (default is 3),
The CorrelationThreshold allows to set a threshold bellow which correlation is considered to fail. If the correlation maxima is bellow this threshold, the estimated elevation is discarded (default is 0.7).
The VarianceThreshold allows to discard master patches for which variance is too small to yeld reliable correlation. If the variance of the current master patch lies bellow this threshold, no elevation exploration is performed at this location (default is 4).

This filter supports multi-threading and streaming. It can process images of any size and does not requires input images size to match. If images extents do not match, elevation will only be estimated over their overlapping extent. The elevation map is produced in the geometry and grid of the master input image.

Definition at line 78 of file otbStereoSensorModelToElevationMapFilter.h.

Member Typedef Documentation

typedef DataObject::Pointer itk::ImageSource< TOutputHeight >::DataObjectPointer [inherited]

Smart Pointer type to a DataObject.

Reimplemented from itk::ProcessObject.

Definition at line 62 of file itkImageSource.h.

typedef ImageToImageFilterDetail::ImageRegionCopier<itkGetStaticConstMacro(OutputImageDimension), itkGetStaticConstMacro(InputImageDimension)> itk::ImageToImageFilter< TInputImage, TOutputHeight >::InputToOutputRegionCopierType [protected, inherited]

Typedef for the region copier function object that converts an input region to an output region.

Definition at line 161 of file itkImageToImageFilter.h.

typedef int itk::LightObject::InternalReferenceCountType [protected, inherited]

Define the type of the reference count according to the target.

This allows the use of atomic operations

Definition at line 137 of file itkLightObject.h.

typedef Superclass::OutputImageRegionType itk::ImageToImageFilter< TInputImage, TOutputHeight >::OutputImageRegionType [inherited]

Superclass typedefs.

Reimplemented from itk::ImageSource< TOutputHeight >.

Definition at line 75 of file itkImageToImageFilter.h.

template<class TInputImage , class TOutputHeight >

typedef TOutputHeight otb::StereoSensorModelToElevationFilter< TInputImage, TOutputHeight >::OutputImageType

Some convenient typedefs.

Reimplemented from itk::ImageSource< TOutputHeight >.

Definition at line 97 of file otbStereoSensorModelToElevationMapFilter.h.

typedef ImageToImageFilterDetail::ImageRegionCopier<itkGetStaticConstMacro(InputImageDimension), itkGetStaticConstMacro(OutputImageDimension)> itk::ImageToImageFilter< TInputImage, TOutputHeight >::OutputToInputRegionCopierType [protected, inherited]

Typedef for the region copier function object that converts an output region to an input region.

Definition at line 166 of file itkImageToImageFilter.h.

Member Function Documentation

virtual void itk::ProcessObject::AbortGenerateDataOn ( ) [virtual, inherited]

Turn on and off the AbortGenerateData flag.

void itk::ProcessObject::AddInput ( DataObject * input ) [protected, virtual, inherited]

Adds an input to the first null position in the input list.

Expands the list memory if necessary

Reimplemented in otb::PersistentDescriptorsListSampleGenerator< TInputImage, TVectorData, TFunctionType, TListSample, TLabelListSample >, otb::DescriptorsListSampleGenerator< TInputImage, TVectorData, TListSample, TLabelListSample, TOutputPrecision, TCoordRep >, otb::PersistentObjectDetectionClassifier< TInputImage, TOutputVectorData, TLabel, TFunctionType >, and otb::ObjectDetectionClassifier< TInputImage, TOutputVectorData, TLabel, TFunctionPrecision, TCoordRep >.

Definition at line 144 of file itkProcessObject.cxx.

{
  DataObjectPointerArraySizeType idx;
  
  this->Modified();
  
  for (idx = 0; idx < m_Inputs.size(); ++idx)
    {
    if (!m_Inputs[idx])
      {
      m_Inputs[idx] = input;
      return;
      }
    }
  
  this->SetNumberOfInputs( static_cast<int>( m_Inputs.size() + 1 ) );
  m_Inputs[ static_cast<int>( m_Inputs.size() ) - 1] = input;
}

unsigned long itk::Object::AddObserver	(	const EventObject &	event,
		Command *	cmd
	)			`[inherited]`

Allow people to add/remove/invoke observers (callbacks) to any ITK object.

This is an implementation of the subject/observer design pattern. An observer is added by specifying an event to respond to and an itk::Command to execute. It returns an unsigned long tag which can be used later to remove the event or retrieve the command. The memory for the Command becomes the responsibility of this object, so don't pass the same instance of a command to two different objects

Definition at line 389 of file itkObject.cxx.

Referenced by otb::StreamingImageVirtualWriter< TInputImage >::GenerateData(), itk::ProgressAccumulator::RegisterInternalFilter(), otb::StreamingImageFileWriter< TInputImage >::UpdateOutputData(), and otb::WriterWatcherBase::WriterWatcherBase().

{
  if (!this->m_SubjectImplementation)
    {
    this->m_SubjectImplementation = new SubjectImplementation;
    }
  return this->m_SubjectImplementation->AddObserver(event,cmd);
}

void itk::ProcessObject::AddOutput ( DataObject * output ) [protected, virtual, inherited]

Adds an output to the first null position in the output list.

Expands the list memory if necessary

Definition at line 390 of file itkProcessObject.cxx.

References itk::DataObject::ConnectSource().

{
  unsigned int idx;
  
  for (idx = 0; idx < m_Outputs.size(); ++idx)
    {
    if ( m_Outputs[idx].IsNull() )
      {
      m_Outputs[idx] = output;

      if (output)
        {
        output->ConnectSource(this, idx);
        }
      this->Modified();
  
      return;
      }
    }
  
  this->SetNumberOfOutputs( static_cast<int>( m_Outputs.size() ) + 1);
  m_Outputs[ static_cast<int>( m_Outputs.size() ) - 1] = output;
  if (output)
    {
    output->ConnectSource(this, static_cast<int>( m_Outputs.size() ) - 1 );
    }
  this->Modified();
}

virtual void itk::ImageSource< TOutputHeight >::AfterThreadedGenerateData ( void ) [inline, protected, virtual, inherited]

If an imaging filter needs to perform processing after all processing threads have completed, the filter can can provide an implementation for AfterThreadedGenerateData().

The execution flow in the default GenerateData() method will be: 1) Allocate the output buffer 2) Call BeforeThreadedGenerateData() 3) Spawn threads, calling ThreadedGenerateData() in each thread. 4) Call AfterThreadedGenerateData() Note that this flow of control is only available if a filter provides a ThreadedGenerateData() method and NOT a GenerateData() method.

Definition at line 264 of file itkImageSource.h.

{};

virtual void itk::ImageSource< TOutputHeight >::AllocateOutputs ( ) [protected, virtual, inherited]

The GenerateData method normally allocates the buffers for all of the outputs of a filter.

Some filters may want to override this default behavior. For example, a filter may have multiple outputs with varying resolution. Or a filter may want to process data in place by grafting its input to its output.

void itk::LightObject::BreakOnError ( ) [static, inherited]

This method is called when itkExceptionMacro executes.

It allows the debugger to break on error.

Definition at line 149 of file itkLightObject.cxx.

{
  ;  
}

void itk::ProcessObject::CacheInputReleaseDataFlags ( ) [protected, virtual, inherited]

Cache the state of any ReleaseDataFlag's on the inputs.

While the filter is executing, we need to set the ReleaseDataFlag's on the inputs to false in case the current filter is implemented using a mini-pipeline (which will try to release the inputs). After the filter finishes, we restore the state of the ReleaseDataFlag's before the call to ReleaseInputs().

Definition at line 1050 of file itkProcessObject.cxx.

{
  unsigned int idx;
  
  m_CachedInputReleaseDataFlags.resize( m_Inputs.size() );
  for (idx = 0; idx < m_Inputs.size(); ++idx)
    {
    if (m_Inputs[idx])
      {
      m_CachedInputReleaseDataFlags[idx]=m_Inputs[idx]->GetReleaseDataFlag();
      m_Inputs[idx]->ReleaseDataFlagOff();
      }
    else
      {
      m_CachedInputReleaseDataFlags[idx] = false;
      }
    }
}

virtual void itk::ImageToImageFilter< TInputImage, TOutputHeight >::CallCopyInputRegionToOutputRegion	(	OutputImageRegionType &	destRegion,
		const InputImageRegionType &	srcRegion
	)			`[protected, virtual, inherited]`

This function calls the actual region copier to do the mapping from input image space to output image space.

It uses a Function object used for dispatching to various routines to copy an input region (start index and size) to an output region. For most filters, this is a trivial copy because most filters require the input dimension to match the output dimension. However, some filters like itk::UnaryFunctorImageFilter can support output images of a higher dimension that the input.

This function object is used by the default implementation of GenerateOutputInformation(). It can also be used in routines like ThreadedGenerateData() where a filter may need to map an input region to an output region.

The default copier uses a "dispatch pattern" to call one of three overloaded functions depending on whether the input and output images are the same dimension, the input is a higher dimension that the output, or the input is of a lower dimension than the output. The use of an overloaded function is required for proper compilation of the various cases.

For the latter two cases, trivial implementations are used. If the input image is a higher dimension than the output, the first portion of the input region is copied to the output region. If the input region is a lower dimension than the output, the input region information is copied into the first portion of the output region and the rest of the output region is set to zero.

If a filter needs a different default behavior, it can override this method.

virtual void itk::ImageToImageFilter< TInputImage, TOutputHeight >::CallCopyOutputRegionToInputRegion	(	InputImageRegionType &	destRegion,
		const OutputImageRegionType &	srcRegion
	)			`[protected, virtual, inherited]`

This function calls the actual region copier to do the mapping from output image space to input image space.

It uses a Function object used for dispatching to various routines to copy an output region (start index and size) to an input region. For most filters, this is a trivial copy because most filters require the input dimension to match the output dimension. However, some filters like itk::ExtractImageFilter can support output images of a lower dimension that the input.

This function object can be used by GenerateOutputInformation() to copy the input LargestPossibleRegion to the output LargestPossibleRegion and can also be used in GenerateData or ThreadedGenerateData() where a filter may need to map an output region to an input region.

The default copier uses a "dispatch pattern" to call one of three overloaded functions depending on whether the input and output images are the same dimension, the input is a higher dimension that the output, or the input is of a lower dimension than the output. The use of an overloaded function is required for proper compilation of the various cases.

For the latter two cases, trivial implementations are used. If the input image is a higher dimension than the output, the output region information is copied into the first portion of the input region and the rest of the input region is set to zero. If the input region is a lower dimension than the output, the first portion of the output region is copied to the input region.

If a filter needs a different default behavior, it can override this method. The ExtractImageFilter overrides this function object so that if the input image is a higher dimension than the output image, the filter can control "where" in the input image the output subimage is extracted (as opposed to mapping to first few dimensions of the input).

LightObject::Pointer itk::Object::CreateAnother ( void ) const [virtual, inherited]

Create an object from an instance, potentially deferring to a factory.

This method allows you to create an instance of an object that is exactly the same type as the referring object. This is useful in cases where an object has been cast back to a base class.

Reimplemented from itk::LightObject.

Definition at line 231 of file itkObject.cxx.

References itk::SmartPointer< TObjectType >::GetPointer(), and itk::Object::New().

Referenced by itk::StreamingImageIOBase::GetActualNumberOfSplitsForWriting().

{
  return Object::New().GetPointer();
}

void itk::Object::DebugOff ( ) const [virtual, inherited]

Turn debugging output off.

Definition at line 253 of file itkObject.cxx.

{
  m_Debug = false;
}

void itk::Object::DebugOn ( ) const [virtual, inherited]

Turn debugging output on.

Definition at line 242 of file itkObject.cxx.

{
  m_Debug = true;
}

void itk::LightObject::Delete ( ) [virtual, inherited]

Delete an itk object.

Delete a itk object.

This method should always be used to delete an object when the new operator was used to create it. Using the C delete method will not work with reference counting.

This method should always be used to delete an object when the new operator was used to create it. Using the C++ delete method will not work with reference counting.

Definition at line 88 of file itkLightObject.cxx.

{
  this->UnRegister();
}

virtual void itk::ProcessObject::EnlargeOutputRequestedRegion ( DataObject * ) [inline, virtual, inherited]

Give the process object a chance to indictate that it will produce more output than it was requested to produce.

For example, many imaging filters must compute the entire output at once or can only produce output in complete slices. Such filters cannot handle smaller requested regions. These filters must provide an implementation of this method, setting the output requested region to the size they will produce. By default, a process object does not modify the size of the output requested region.

Definition at line 224 of file itkProcessObject.h.

{};

virtual void itk::ImageSource< TOutputHeight >::GenerateData ( void ) [protected, virtual, inherited]

A version of GenerateData() specific for image processing filters.

This implementation will split the processing across multiple threads. The buffer is allocated by this method. Then the BeforeThreadedGenerateData() method is called (if provided). Then, a series of threads are spawned each calling ThreadedGenerateData(). After all the threads have completed processing, the AfterThreadedGenerateData() method is called (if provided). If an image processing filter cannot be threaded, the filter should provide an implementation of GenerateData(). That implementation is responsible for allocating the output buffer. If a filter an be threaded, it should NOT provide a GenerateData() method but should provide a ThreadedGenerateData() instead.

See also:: ThreadedGenerateData()

Reimplemented from itk::ProcessObject.

void itk::ProcessObject::GenerateOutputInformation ( void ) [protected, virtual, inherited]

Generate the information decribing the output data.

Default implementation - copy information from first input to all outputs.

The default implementation of this method will copy information from the input to the output. A filter may override this method if its output will have different information than its input. For instance, a filter that shrinks an image will need to provide an implementation for this method that changes the spacing of the pixels. Such filters should call their superclass' implementation of this method prior to changing the information values they need (i.e. GenerateOutputInformation() should call Superclass::GenerateOutputInformation() prior to changing the information.

Definition at line 1095 of file itkProcessObject.cxx.

Referenced by otb::WaveletFilterBank< TInputImage, TOutputImage, TWaveletOperator, Wavelet::INVERSE >::GenerateOutputInformation(), otb::WaveletFilterBank< TInputImage, TOutputImage, TWaveletOperator, Wavelet::FORWARD >::GenerateOutputInformation(), otb::VCAImageFilter< TVectorImage >::GenerateOutputInformation(), otb::MatrixImageFilter< TInputImage, TOutputImage, TMatrix >::GenerateOutputInformation(), itk::FFTComplexToComplexImageFilter< TPixel, NDimension >::GenerateOutputInformation(), itk::DirectFourierReconstructionImageToImageFilter< TInputPixelType, TOutputPixelType >::GenerateOutputInformation(), and itk::FFTComplexConjugateToRealImageFilter< TPixel, VDimension >::GenerateOutputInformation().

{
  DataObjectPointer input, output;

  if (m_Inputs.size() && m_Inputs[0])
    {
    input = m_Inputs[0];

    for (unsigned int idx = 0; idx < m_Outputs.size(); ++idx)
      {
      output = this->GetOutput(idx);
      if (output)
        {
        output->CopyInformation(input);
        }  
      }
    }
}

void itk::ProcessObject::GenerateOutputRequestedRegion ( DataObject * output ) [protected, virtual, inherited]

Given one output whose requested region has been set, how should the requested regions for the remaining outputs of the process object be set? By default, all the outputs are set to the same requested region.

By default we set all the output requested regions to be the same.

If a filter needs to produce different requested regions for each output, for instance an image processing filter producing several outputs at different resolutions, then that filter may override this method and set the requested regions appropriatedly.

Note that a filter producing multiple outputs of different types is required to override this method. The default implementation can only correctly handle multiple outputs of the same type.

Reimplemented in itk::MultiResolutionPyramidImageFilter< TInputImage, TOutputImage >, itk::RecursiveMultiResolutionPyramidImageFilter< TInputImage, TOutputImage >, itk::watershed::BoundaryResolver< TPixelType, TDimension >, itk::watershed::EquivalenceRelabeler< TScalarType, TImageDimension >, itk::watershed::Relabeler< TScalarType, TImageDimension >, itk::watershed::Segmenter< TInputImage >, itk::watershed::SegmentTreeGenerator< TScalarType >, itk::watershed::Relabeler< ScalarType, itkGetStaticConstMacro(ImageDimension)>, itk::watershed::Segmenter< InputImageType >, and itk::watershed::SegmentTreeGenerator< ScalarType >.

Definition at line 846 of file itkProcessObject.cxx.

{
  DataObjectPointerArraySizeType idx;
  for (idx = 0; idx < m_Outputs.size(); ++idx)
    {
    if (m_Outputs[idx] && m_Outputs[idx] != output)
      {
      m_Outputs[idx]->SetRequestedRegion(output);
      }
    }  
}

virtual const bool& itk::ProcessObject::GetAbortGenerateData ( ) [virtual, inherited]

Get the AbortGenerateData flag for the process object.

Process objects may handle premature termination of execution in different ways.

template<class TInputImage , class TOutputHeight >

virtual double otb::StereoSensorModelToElevationFilter< TInputImage, TOutputHeight >::GetAverageElevation ( ) [virtual]

Get the average elevation to consider if no DEM is used.

Default is 0.

Command * itk::Object::GetCommand ( unsigned long tag ) [inherited]

Get the command associated with the given tag.

NOTE: This returns a pointer to a Command, but it is safe to asign this to a Command::Pointer. Since Command inherits from LightObject, at this point in the code, only a pointer or a reference to the Command can be used.

Definition at line 414 of file itkObject.cxx.

References itk::Object::GetCommand().

Referenced by itk::Object::GetCommand().

{
  if (this->m_SubjectImplementation)
    {
    return this->m_SubjectImplementation->GetCommand(tag);
    }
  return NULL;
}

template<class TInputImage , class TOutputHeight >

virtual double otb::StereoSensorModelToElevationFilter< TInputImage, TOutputHeight >::GetCorrelationThreshold ( ) [virtual]

Get the threshold of the correlation to keep estimated height.

Default is 0.7.

bool itk::Object::GetDebug ( ) const [inherited]

Get the value of the debug flag.

Definition at line 264 of file itkObject.cxx.

{
  return m_Debug;
}

const InputImageType* itk::ImageToImageFilter< TInputImage, TOutputHeight >::GetInput ( unsigned int idx ) [inherited]

Method used internally for getting an input.

Reimplemented from itk::ProcessObject.

DataObjectPointerArray& itk::ProcessObject::GetInputs ( ) [inline, inherited]

Return an array with all the inputs of this process object.

This is useful for tracing back in the pipeline to construct graphs etc.

Definition at line 108 of file itkProcessObject.h.

Referenced by otb::PipelineMemoryPrintCalculator::EvaluateProcessObjectPrintRecursive().

    {return m_Inputs;}

MetaDataDictionary & itk::Object::GetMetaDataDictionary ( void ) [inherited]

Returns:: A reference to this objects MetaDataDictionary.

Warning:: This reference may be changed.

Reimplemented in otb::ImageMetadataInterfaceBase.

Definition at line 532 of file itkObject.cxx.

Referenced by otb::RenderingImageFilter< TInputImage, TOutputImage >::BeforeThreadedGenerateData(), itk::Brains2MaskImageIO::CanReadFile(), otb::DataNode< TPrecision, VDimension, TValuePrecision >::CopyFieldList(), otb::VectorImage< TPixel, VImageDimension >::CopyInformation(), otb::Image< TPixel, VImageDimension >::CopyInformation(), otb::VectorImage< TPixel, VImageDimension >::GetImageKeywordlist(), otb::Image< TPixel, VImageDimension >::GetImageKeywordlist(), itk::GDCMImageIO::GetPatientName(), itk::GDCMImageIO::GetValueFromTag(), otb::RAMDrivenAdaptativeStreamingManager< TImage >::PrepareStreaming(), otb::VectorImage< TPixel, VImageDimension >::PrintSelf(), otb::Image< TPixel, VImageDimension >::PrintSelf(), otb::JPEG2000ImageIO::ReadImageInformation(), itk::IPLCommonImageIO::ReadImageInformation(), otb::ImageMetadataInterfaceBase::SetImage(), itk::GDCMImageIO::Write(), and itk::PolygonGroupSpatialObjectXMLFileWriter::WriteFile().

{
  if(m_MetaDataDictionary==NULL)
    {
    m_MetaDataDictionary=new MetaDataDictionary;
    }
  return *m_MetaDataDictionary;
}

const MetaDataDictionary & itk::Object::GetMetaDataDictionary ( void ) const [inherited]

Returns:: A constant reference to this objects MetaDataDictionary.

Reimplemented in otb::ImageMetadataInterfaceBase.

Definition at line 543 of file itkObject.cxx.

{
  if(m_MetaDataDictionary==NULL)
    {
    m_MetaDataDictionary=new MetaDataDictionary;
    }
  return *m_MetaDataDictionary;
}

unsigned long itk::Object::GetMTime ( void ) const [virtual, inherited]

Return this objects modified time.

Return the modification for this object.

Definition at line 286 of file itkObject.cxx.

Referenced by itk::BoundingBox< TPointIdentifier, VPointDimension, TCoordRep, TPointsContainer >::GetMTime(), itk::ResampleImageFilter< TInputImage, TOutputImage, TInterpolatorPrecisionType >::GetMTime(), itk::DeformationFieldSource< TOutputImage >::GetMTime(), itk::SpatialObject< TDimension >::GetMTime(), itk::TransformToDeformationFieldSource< TOutputImage, TTransformPrecisionType >::GetMTime(), itk::InverseDeformationFieldImageFilter< TInputImage, TOutputImage >::GetMTime(), itk::VectorResampleImageFilter< TInputImage, TOutputImage, TInterpolatorPrecisionType >::GetMTime(), itk::SpatialObject< ::itk::GetMeshDimension< TMesh >::PointDimension >::GetObjectMTime(), otb::Function::StandardRenderingFunction< TPixel, TRGBPixel, TPixelRepresentationFunction, TTransferFunction >::Initialize(), itk::VTKImageExportBase::PipelineModifiedCallback(), and itk::ProcessObject::UpdateOutputInformation().

{
  return m_MTime.GetMTime();
}

MultiThreader* itk::ProcessObject::GetMultiThreader ( ) [inline, inherited]

Return the multithreader used by this class.

Definition at line 280 of file itkProcessObject.h.

    {return m_Threader;}

template<class TInputImage , class TOutputHeight >

virtual const char* otb::StereoSensorModelToElevationFilter< TInputImage, TOutputHeight >::GetNameOfClass ( ) const [virtual]

Run-time type information (and related methods).

Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputHeight >.

DataObjectPointerArraySizeType itk::ProcessObject::GetNumberOfInputs ( ) const [inline, inherited]

Get the size of the input vector.

This is merely the size of the input vector, not the number of inputs that have valid DataObject's assigned. Use GetNumberOfValidRequiredInputs() to determine how many inputs are non-null.

Definition at line 118 of file itkProcessObject.h.

Referenced by otb::PipelineMemoryPrintCalculator::EvaluateProcessObjectPrintRecursive(), otb::WaveletFilterBank< TInputImage, TOutputImage, TWaveletOperator, Wavelet::INVERSE >::GenerateInputRequestedRegion(), otb::WaveletFilterBank< TInputImage, TOutputImage, TWaveletOperator, Wavelet::INVERSE >::GenerateOutputInformation(), otb::ModulusAndDirectionImageToImageFilter< TInputImage, TInputImageDirection, TOutputImage >::GetInput(), and otb::ModulusAndDirectionImageToImageFilter< TInputImage, TInputImageDirection, TOutputImage >::GetInputDirection().

    {return m_Inputs.size();}

ProcessObject::DataObjectPointerArraySizeType itk::ProcessObject::GetNumberOfValidRequiredInputs ( ) const [virtual, inherited]

Get the number of valid inputs.

Get the number of specified inputs.

This is the number of non-null entries in the input vector in the first NumberOfRequiredInputs slots. This method is used to determine whether the necessary required inputs have been set. Subclasses of ProcessObject may override this implementation if the required inputs are not the first slots in input vector.

Reimplemented in itk::MultiResolutionPDEDeformableRegistration< TFixedImage, TMovingImage, TDeformationField, TRealType >, and itk::PDEDeformableRegistrationFilter< TFixedImage, TMovingImage, TDeformationField >.

Definition at line 112 of file itkProcessObject.cxx.

{
  DataObjectPointerArraySizeType num;
  if (m_NumberOfRequiredInputs < m_Inputs.size())
    {
    num = m_NumberOfRequiredInputs;
    }
  else
    {
    num = m_Inputs.size();
    }
  // count the number of non-null inputs
  // this used to use std::count_if, but that function object
  // did not work correctly with SunPro CC 5.6.
  int count = 0;
  for(std::vector<DataObjectPointer>::const_iterator i = m_Inputs.begin();
      i < (m_Inputs.begin() + num); ++i)
    {
    if((*i).IsNotNull())
      {
      count++;
      }
    }
  return count;
}

OutputImageType* itk::ImageSource< TOutputHeight >::GetOutput ( void ) [inherited]

Get the output data of this process object.

The output of this function is not valid until an appropriate Update() method has been called, either explicitly or implicitly. Both the filter itself and the data object have Update() methods, and both methods update the data. Here are three ways to use GetOutput() and make sure the data is valid. In these examples, image is a pointer to some Image object, and the particular ProcessObjects involved are filters. The same examples apply to non-image (e.g. Mesh) data as well.

   anotherFilter->SetInput( someFilter->GetOutput() );
   anotherFilter->Update();

In this situation, someFilter and anotherFilter are said to constitute a pipeline.

   image = someFilter->GetOutput();
   image->Update();

   someFilter->Update();
   image = someFilter->GetOutput();

(In the above example, the two lines of code can be in either order.)

Note that Update() is not called automatically except within a pipeline as in the first example. When streaming (using a StreamingImageFilter) is activated, it may be more efficient to use a pipeline than to call Update() once for each filter in turn.

For an image, the data generated is for the requested Region, which can be set using ImageBase::SetRequestedRegion(). By default, the largest possible region is requested.

For Filters which have multiple outputs of different types, the GetOutput() method assumes the output is of OutputImageType. For the GetOutput(unsigned int) method, a dynamic_cast is performed incase the filter has outputs of different types or image types. Derived classes should have names get methods for these outputs.

OutputImageType* itk::ImageSource< TOutputHeight >::GetOutput ( unsigned int idx ) [inherited]

Method used internally for getting an output.

Reimplemented from itk::ProcessObject.

DataObjectPointerArray& itk::ProcessObject::GetOutputs ( ) [inline, inherited]

Return an array with all the outputs of this process object.

This is useful for tracing forward in the pipeline to contruct graphs etc.

Definition at line 133 of file itkProcessObject.h.

Referenced by otb::PipelineMemoryPrintCalculator::EvaluateProcessObjectPrintRecursive().

    { return m_Outputs; }

virtual const float& itk::ProcessObject::GetProgress ( ) [virtual, inherited]

Get the execution progress of a process object.

The progress is a floating number in [0,1] with 0 meaning no progress and 1 meaning the filter has completed execution.

Referenced by itk::WatershedMiniPipelineProgressCommand::Execute(), itk::LaplacianRecursiveGaussianImageFilter< TInputImage, TOutputImage >::ReportProgress(), and itk::XMLFilterWatcher::ShowProgress().

virtual int itk::LightObject::GetReferenceCount ( ) const [inline, virtual, inherited]

Gets the reference count on this object.

Definition at line 105 of file itkLightObject.h.

    {return static_cast<int>(m_ReferenceCount);}

template<class TInputImage , class TOutputHeight >

virtual bool otb::StereoSensorModelToElevationFilter< TInputImage, TOutputHeight >::GetSubtractInitialElevation ( ) [virtual]

Get the SubtractInitialElevation flag.

If set to true, the elevation map will only contains the difference between the estimated elevation and the initial one. If set to false, elevation is absolute. Default is false.

template<class TInputImage , class TOutputHeight >

virtual bool otb::StereoSensorModelToElevationFilter< TInputImage, TOutputHeight >::GetUseDEM ( ) [virtual]

Get the use DEM flag.

If set to true, the local elevation is extracted from a DEM + geoid. If set to false, average elevation is used. Default is false.

template<class TInputImage , class TOutputHeight >

virtual double otb::StereoSensorModelToElevationFilter< TInputImage, TOutputHeight >::GetVarianceThreshold ( ) [virtual]

Set the threshold on the variance of the master patch to start elevation estimation.

Default is 4.

virtual void itk::ImageSource< TOutputHeight >::GraftNthOutput	(	unsigned int	idx,
		DataObject *	output
	)			`[virtual, inherited]`

Graft the specified data object onto this ProcessObject's idx'th output.

This is similar to the GraftOutput method except it allows you to specify which output is affected. The specified index must be a valid output number (less than ProcessObject::GetNumberOfOutputs()). See the GraftOutput for general usage information.

virtual void itk::ImageSource< TOutputHeight >::GraftOutput ( DataObject * output ) [virtual, inherited]

Graft the specified DataObject onto this ProcessObject's output.

This method grabs a handle to the specified DataObject's bulk data to used as its output's own bulk data. It also copies the region ivars (RequestedRegion, BufferedRegion, LargestPossibleRegion) and meta-data (Spacing, Origin) from the specified data object into this filter's output data object. Most importantly, however, it leaves the Source ivar untouched so the original pipeline routing is intact. This method is used when a process object is implemented using a mini-pipeline which is defined in its GenerateData() method. The usage is:

    // setup the mini-pipeline to process the input to this filter
    firstFilterInMiniPipeline->SetInput( this->GetInput() );
   
    // setup the mini-pipeline to calculate the correct regions
    // and write to the appropriate bulk data block
    lastFilterInMiniPipeline->GraftOutput( this->GetOutput() );

    // execute the mini-pipeline
    lastFilterInMiniPipeline->Update();

    // graft the mini-pipeline output back onto this filter's output.
    // this is needed to get the appropriate regions passed back.
    this->GraftOutput( lastFilterInMiniPipeline->GetOutput() );

For proper pipeline execution, a filter using a mini-pipeline must implement the GenerateInputRequestedRegion(), GenerateOutputRequestedRegion(), GenerateOutputInformation() and EnlargeOutputRequestedRegion() methods as necessary to reflect how the mini-pipeline will execute (in other words, the outer filter's pipeline mechanism must be consistent with what the mini-pipeline will do).

bool itk::Object::HasObserver ( const EventObject & event ) const [inherited]

Return true if an observer is registered for this event.

Definition at line 467 of file itkObject.cxx.

{
  if (this->m_SubjectImplementation)
    {
    return this->m_SubjectImplementation->HasObserver(event);
    }
  return false;
}

void itk::Object::InvokeEvent ( const EventObject & event ) const [inherited]

Call Execute on all the Commands observing this event id.

The actions triggered by this call doesn't modify this object.

Definition at line 457 of file itkObject.cxx.

{
  if (this->m_SubjectImplementation)
    {
    this->m_SubjectImplementation->InvokeEvent(event,this);
    }
}

void itk::Object::InvokeEvent ( const EventObject & event ) [inherited]

Call Execute on all the Commands observing this event id.

Definition at line 446 of file itkObject.cxx.

Referenced by itk::VTKImageExportBase::UpdateDataCallback().

{
  if (this->m_SubjectImplementation)
    {
    this->m_SubjectImplementation->InvokeEvent(event,this);
    }
}

virtual DataObjectPointer itk::ImageSource< TOutputHeight >::MakeOutput ( unsigned int idx ) [virtual, inherited]

Make a DataObject of the correct type to used as the specified output.

Every ProcessObject subclass must be able to create a DataObject that can be used as a specified output. This method is automatically called when DataObject::DisconnectPipeline() is called. DataObject::DisconnectPipeline, disconnects a data object from being an output of its current source. When the data object is disconnected, the ProcessObject needs to construct a replacement output data object so that the ProcessObject is in a valid state. So DataObject::DisconnectPipeline eventually calls ProcessObject::MakeOutput. Note that MakeOutput always returns a SmartPointer to a DataObject. If a subclass of ImageSource has multiple outputs of different types, then that class must provide an implementation of MakeOutput().

Reimplemented from itk::ProcessObject.

void itk::Object::Modified ( void ) const [virtual, inherited]

Update the modification time for this object.

Make sure this object's modified time is greater than all others.

Many filters rely on the modification time to determine if they need to recompute their data.

Definition at line 297 of file itkObject.cxx.

{
  m_MTime.Modified();
  InvokeEvent( ModifiedEvent() );
}

template<class TInputImage , class TOutputHeight >

static Pointer otb::StereoSensorModelToElevationFilter< TInputImage, TOutputHeight >::New ( ) [static]

Method for creation through the object factory.

Reimplemented from itk::Object.

void itk::ProcessObject::PrepareOutputs ( ) [virtual, inherited]

An opportunity to deallocate a ProcessObject's bulk data storage.

Some filters may wish to reuse existing bulk data storage to avoid unnecessary deallocation/allocation sequences. The default implementation calls Initialize() on each output. DataObject::Initialize() frees its bulk data by default.

Reimplemented in itk::WatershedImageFilter< TInputImage >.

Definition at line 864 of file itkProcessObject.cxx.

{  
  unsigned int idx;
  
  if (this->GetReleaseDataBeforeUpdateFlag())
    {
    for (idx = 0; idx < m_Outputs.size(); idx++)
      {
      if (m_Outputs[idx])
        {
        m_Outputs[idx]->PrepareForNewData(); 
        }
      }
    }
}

void itk::LightObject::Print	(	std::ostream &	os,
		Indent	indent = `0`
	)			const `[inherited]`

Cause the object to print itself out.

Avoid DLL boundary problems.

This function will be common to all itk objects. It just calls the header/self/trailer virtual print methods, which can be overriden by subclasses (any itk object).

Definition at line 135 of file itkLightObject.cxx.

References itk::Indent::GetNextIndent().

Referenced by itk::operator<<(), and itk::WeakPointer< ProcessObject >::Print().

{
  this->PrintHeader(os, indent); 
  this->PrintSelf(os, indent.GetNextIndent());
  this->PrintTrailer(os, indent);
}

virtual void itk::ImageToImageFilter< TInputImage, TOutputHeight >::PrintSelf	(	std::ostream &	os,
		Indent	indent
	)			const `[protected, virtual, inherited]`

Methods invoked by Print() to print information about the object including superclasses.

Chaining method to print an object's instance variables, as well as its superclasses.

Typically not called by the user (use Print() instead) but used in the hierarchical print process to combine the output of several classes.

Reimplemented from itk::ProcessObject.

void itk::ProcessObject::PropagateRequestedRegion ( DataObject * output ) [virtual, inherited]

Send the requested region information back up the pipeline (to the filters that preceed this one).

check flag to avoid executing forever if there is a loop

Give the subclass a chance to indicate that it will provide more data then required for the output. This can happen, for example, when a source can only produce the whole output. Although this is being called for a specific output, the source may need to enlarge all outputs.

Give the subclass a chance to define how to set the requested regions for each of its outputs, given this output's requested region. The default implementation is to make all the output requested regions the same. A subclass may need to override this method if each output is a different resolution.

Give the subclass a chance to request a larger requested region on the inputs. This is necessary when, for example, a filter requires more data at the "internal" boundaries to produce the boundary values - such as an image filter that derives a new pixel value by applying some operation to a neighborhood of surrounding original values.

Now that we know the input requested region, propagate this through all the inputs.

Reimplemented in itk::StreamingImageFilter< TInputImage, TOutputImage >, and itk::VTKImageImport< TOutputImage >.

Definition at line 766 of file itkProcessObject.cxx.

{
  if (m_Updating)
    {
    return;
    }

  this->EnlargeOutputRequestedRegion( output );

  this->GenerateOutputRequestedRegion( output );
  
  this->GenerateInputRequestedRegion();

  m_Updating = true;
  DataObjectPointerArraySizeType idx;
  for (idx = 0; idx < m_Inputs.size(); ++idx)
    {
    if (m_Inputs[idx])
      {
      m_Inputs[idx]->PropagateRequestedRegion();
      }
    }
  m_Updating = false;
}

void itk::ProcessObject::PropagateResetPipeline ( ) [protected, virtual, inherited]

Called to allocate the input array.

Copies old inputs. Propagate a call to ResetPipeline() up the pipeline. Called only from DataObject.

Propagate the ResetPipeline call

Definition at line 631 of file itkProcessObject.cxx.

{
  // 
  // Reset this object.
  //
  // Clear the updating flag.
  m_Updating = 0;

  //
  // Loop through the inputs
  //
  unsigned int idx;
  DataObject::Pointer input;
  for (idx = 0; idx < m_Inputs.size(); ++idx)
    {
    if (m_Inputs[idx])
      {
      input = m_Inputs[idx];

      input->PropagateResetPipeline();
      }
    }
}

void itk::ImageToImageFilter< TInputImage, TOutputHeight >::PushBackInput ( const DataObject * input ) [inline, protected, virtual, inherited]

PushBackInput(), PushFronInput() in the public section force the input to be the type expected by an ImageToImageFilter.

However, these methods end of "hiding" the versions from the superclass (ProcessObject) whose arguments are DataObjects. Here, we re-expose the versions from ProcessObject to avoid warnings about hiding methods from the superclass.

Reimplemented from itk::ProcessObject.

Definition at line 248 of file itkImageToImageFilter.h.

    { Superclass::PushBackInput(input); }

virtual void itk::ImageToImageFilter< TInputImage, TOutputHeight >::PushBackInput ( const InputImageType * image ) [virtual, inherited]

Push/Pop the input of this process object.

These methods allow a filter to model its input vector as a queue or stack. These routines may not be appropriate for all filters, especially filters with different types of inputs. These routines follow the semantics of STL.

The routines are useful for applications that need to process "rolling" sets of images. For instance, if an application has 10 images and they need to run a filter on images 1, 2, 3, 4, then run the filter on images 2, 3, 4, 5, then run the filter on images 3, 4, 5, 6, the application can accomplish this by popping an input off the front of the input list and push a new image onto the back of input list. Again, this only makes sense for filters that single type of input.

Other uses are also possible. For a single input filter, pushing and popping inputs allow the application to temporarily replace an input to a filter.

void itk::Object::Register ( ) const [virtual, inherited]

Increase the reference count (mark as used by another object).

Reimplemented from itk::LightObject.

Definition at line 309 of file itkObject.cxx.

Referenced by itk::ObjectFactoryBase::RegisterFactory().

{
  itkDebugMacro(<< "Registered, "
                << "ReferenceCount = " << (m_ReferenceCount+1));

  // call the parent
  Superclass::Register();
}

void itk::ProcessObject::ReleaseInputs ( ) [protected, virtual, inherited]

A filter may need to release its input's bulk data after it has finished calculating a new output.

The filter may need to release the inputs because the user has turned on the ReleaseDataFlag or it may need to release the inputs because the filter is an "in place" filter and it has overwritten its input with its output data. The implementation here simply checks the ReleaseDataFlag of the inputs. InPlaceImageFilter overrides this method so release the input it has overwritten.

See also:: InPlaceImageFilter::ReleaseInputs()

Definition at line 886 of file itkProcessObject.cxx.

Referenced by itk::watershed::Segmenter< TInputImage >::GenerateData(), itk::InPlaceLabelMapFilter< TInputImage >::ReleaseInputs(), and itk::InPlaceImageFilter< TInputImage, TOutputImage >::ReleaseInputs().

{  
  unsigned int idx;

  for (idx = 0; idx < m_Inputs.size(); ++idx)
    {
    if (m_Inputs[idx])
      {
      if ( m_Inputs[idx]->ShouldIReleaseData() )
        {
        m_Inputs[idx]->ReleaseData();
        }
      }  
    }
}

void itk::Object::RemoveAllObservers ( ) [inherited]

Remove all observers .

Definition at line 435 of file itkObject.cxx.

{
  if (this->m_SubjectImplementation)
    {
    this->m_SubjectImplementation->RemoveAllObservers();
    }
}

void itk::ProcessObject::RemoveInput ( DataObject * input ) [protected, virtual, inherited]

Remove an input.

Removes the first occurence of the given OutputObject from the inputs to this ProcessObject. If it's the last object on the list, shortens the list.

Definition at line 173 of file itkProcessObject.cxx.

{
  if (!input)
    {
    return;
    }
  
  // find the input in the list of inputs
  DataObjectPointerArray::iterator pos = 
    std::find(m_Inputs.begin(), m_Inputs.end(), input);

  if(pos == m_Inputs.end())
    {
    itkDebugMacro("tried to remove an input that was not in the list");
    return;
    }

  // Set the position in the m_Inputs containing input to 0
  *pos = 0;

  // if that was the last input, then shrink the list
  if (pos == m_Inputs.end() - 1 )
    {
    this->SetNumberOfInputs( static_cast<int>( m_Inputs.size() ) - 1);
    }

  this->Modified();
}

void itk::Object::RemoveObserver ( unsigned long tag ) [inherited]

Remove the observer with this tag value.

Definition at line 425 of file itkObject.cxx.

Referenced by otb::StreamingImageVirtualWriter< TInputImage >::GenerateData(), and otb::StreamingImageFileWriter< TInputImage >::UpdateOutputData().

{
  if (this->m_SubjectImplementation)
    {
    this->m_SubjectImplementation->RemoveObserver(tag);
    }
}

void itk::ProcessObject::ResetPipeline ( ) [virtual, inherited]

Reset the pipeline.

If an exception is thrown during an Update(), the pipeline may be in an inconsistent state. This method clears the internal state of the pipeline so Update() can be called.

Definition at line 621 of file itkProcessObject.cxx.

{
  if (this->GetOutput(0))
    {
    this->GetOutput(0)->ResetPipeline();
    }
}

virtual void itk::ProcessObject::SetAbortGenerateData ( bool _arg ) [virtual, inherited]

Set the AbortGenerateData flag for the process object.

Process objects may handle premature termination of execution in different ways.

template<class TInputImage , class TOutputHeight >

virtual void otb::StereoSensorModelToElevationFilter< TInputImage, TOutputHeight >::SetAverageElevation ( double _arg ) [virtual]

Set the average elevation to consider if no DEM is used.

Default is 0.

template<class TInputImage , class TOutputHeight >

virtual void otb::StereoSensorModelToElevationFilter< TInputImage, TOutputHeight >::SetCorrelationThreshold ( double _arg ) [virtual]

Set the threshold of the correlation to keep estimated height.

Default is 0.7.

void itk::Object::SetDebug ( bool debugFlag ) const [inherited]

Set the value of the debug flag.

A non-zero value turns debugging on.

Definition at line 275 of file itkObject.cxx.

{
  m_Debug = debugFlag;
}

template<class TInputImage , class TOutputHeight >

virtual void otb::StereoSensorModelToElevationFilter< TInputImage, TOutputHeight >::SetElevationStep ( double _arg ) [virtual]

Set the step of the elevation exploration.

Default is 1 meters.

void itk::Object::SetGlobalWarningDisplay ( bool flag ) [static, inherited]

This is a global flag that controls whether any debug, warning or error messages are displayed.

Set the value of the global debug output control flag.

Definition at line 370 of file itkObject.cxx.

{
  m_GlobalWarningDisplay = val;
}

template<class TInputImage , class TOutputHeight >

virtual void otb::StereoSensorModelToElevationFilter< TInputImage, TOutputHeight >::SetHigherElevation ( double _arg ) [virtual]

Set the lower offset for the local elevation exploration.

Default is 20 meters.

virtual void itk::ImageToImageFilter< TInputImage, TOutputHeight >::SetInput ( const InputImageType * image ) [virtual, inherited]

Set/Get the image input of this process object.

template<class TInputImage , class TOutputHeight >

virtual void otb::StereoSensorModelToElevationFilter< TInputImage, TOutputHeight >::SetLowerElevation ( double _arg ) [virtual]

Set the lower offset for the local elevation exploration.

Default is -20 meters.

void itk::Object::SetMetaDataDictionary ( const MetaDataDictionary & rhs ) [inherited]

Returns:: Set the MetaDataDictionary

Reimplemented in otb::ImageMetadataInterfaceBase.

Definition at line 554 of file itkObject.cxx.

Referenced by otb::Image< TPixel, VImageDimension >::CopyInformation(), and otb::VectorImage< TPixel, VImageDimension >::CopyInformation().

{
  if(m_MetaDataDictionary==NULL)
    {
    m_MetaDataDictionary=new MetaDataDictionary;
    }
  *m_MetaDataDictionary=rhs;
}

void itk::ProcessObject::SetNthInput	(	unsigned int	idx,
		DataObject *	input
	)			`[protected, virtual, inherited]`

Protected methods for setting inputs.

Set an Input of this filter.

Subclasses make use of them for setting input.

This method does Register()/UnRegister() manually to deal with the fact that smart pointers aren't around to do the reference counting.

Reimplemented in itk::ImageToVectorImageFilter< TInputImage >.

Definition at line 210 of file itkProcessObject.cxx.

{
  // does this change anything?
  if ( idx < m_Inputs.size() && m_Inputs[idx] == input )
    {
    return;
    }
  
  // Expand array if necessary.
  if (idx >= m_Inputs.size())
    {
    this->SetNumberOfInputs(idx + 1);
    }
  
  m_Inputs[idx] = input;

  this->Modified();
}

void itk::ProcessObject::SetNthOutput	(	unsigned int	idx,
		DataObject *	output
	)			`[protected, virtual, inherited]`

Protected methods for setting outputs.

Set an output of this filter.

Subclasses make use of them for getting output.

This method specifically does not do a Register()/UnRegister() because of the desire to break the reference counting loop.

Definition at line 333 of file itkProcessObject.cxx.

References itk::DataObject::ConnectSource().

Referenced by itk::CoreAtomImageToDistanceMatrixProcess< TSourceImage >::CoreAtomImageToDistanceMatrixProcess(), itk::CoreAtomImageToUnaryCorrespondenceMatrixProcess< TSourceImage >::CoreAtomImageToUnaryCorrespondenceMatrixProcess(), itk::SimplexMeshToTriangleMeshFilter< TInputMesh, TOutputMesh >::CreateTriangles(), otb::FillGapsFilter::FillGapsFilter(), itk::ImageRegistrationMethod< TFixedImage, TMovingImage >::ImageRegistrationMethod(), itk::ImageToSpatialObjectRegistrationMethod< TFixedImage, TMovingSpatialObject >::ImageToSpatialObjectRegistrationMethod(), itk::SimplexMeshAdaptTopologyFilter< TInputMesh, TOutputMesh >::InsertNewCells(), itk::MedialNodePairCorrespondenceProcess< TSourceImage >::MedialNodePairCorrespondenceProcess(), itk::MedialNodeTripletCorrespondenceProcess< TSourceImage >::MedialNodeTripletCorrespondenceProcess(), itk::MultiResolutionImageRegistrationMethod< TFixedImage, TMovingImage >::MultiResolutionImageRegistrationMethod(), itk::MultiScaleHessianBasedMeasureImageFilter< TInputImage, THessianImage, TOutputImage >::MultiScaleHessianBasedMeasureImageFilter(), itk::PointSetToImageRegistrationMethod< TFixedPointSet, TMovingImage >::PointSetToImageRegistrationMethod(), itk::PointSetToPointSetRegistrationMethod< TFixedPointSet, TMovingPointSet >::PointSetToPointSetRegistrationMethod(), otb::ProspectModel::ProspectModel(), itk::RegularSphereMeshSource< TOutputMesh >::RegularSphereMeshSource(), otb::SailModel::SailModel(), itk::watershed::BoundaryResolver< TPixelType, TDimension >::SetEquivalencyTable(), itk::watershed::Relabeler< ScalarType, itkGetStaticConstMacro(ImageDimension)>::SetOutputImage(), itk::watershed::EquivalenceRelabeler< TScalarType, TImageDimension >::SetOutputImage(), itk::SphereMeshSource< TOutputMesh >::SphereMeshSource(), otb::WaveletFilterBank< TInputImage, TOutputImage, TWaveletOperator, Wavelet::FORWARD >::WaveletFilterBank(), otb::WaveletPacketTransform< TInputImage, TOutputImage, TFilter, Wavelet::FORWARD, TCost >::WaveletPacketTransform(), otb::WaveletTransform< TInputImage, TOutputImage, TFilter, Wavelet::INVERSE >::WaveletTransform(), and otb::WaveletTransform< TInputImage, TOutputImage, TFilter, Wavelet::FORWARD >::WaveletTransform().

{
  // does this change anything?
  if ( idx < m_Outputs.size() && output == m_Outputs[idx])
    {
    return;
    }

  // Expand array if necessary.
  if (idx >= m_Outputs.size())
    {
    this->SetNumberOfOutputs(idx + 1);
    }

  // Keep a handle to the original output and disconnect the old output from
  // the pipeline
  DataObjectPointer oldOutput;
  if ( m_Outputs[idx] )
    {
    oldOutput = m_Outputs[idx];
    m_Outputs[idx]->DisconnectSource(this, idx);
    }

  if (output)
    {
    output->ConnectSource(this, idx);
    }
  // save the current reference (which releases the previous reference)
  m_Outputs[idx] = output;

  // if we are clearing an output, we need to create a new blank output
  // so we are prepared for the next Update(). this copies the requested
  // region ivar
  if (!m_Outputs[idx])
    {
    itkDebugMacro( " creating new output object." );
    DataObjectPointer newOutput = this->MakeOutput(idx);
    this->SetNthOutput(idx, newOutput);

    // If we had an output object before, copy the requested region
    // ivars and release data flag to the the new output
    if (oldOutput)
      {
      newOutput->SetRequestedRegion( oldOutput );
      newOutput->SetReleaseDataFlag( oldOutput->GetReleaseDataFlag() );
      }
    }

  this->Modified();
}

void itk::ProcessObject::SetNumberOfInputs ( unsigned int num ) [protected, inherited]

Called to allocate the input array.

Called by constructor to set up input array.

Copies old inputs.

Definition at line 96 of file itkProcessObject.cxx.

Referenced by otb::WaveletFilterBank< TInputImage, TOutputImage, TWaveletOperator, Wavelet::FORWARD >::WaveletFilterBank(), otb::WaveletFilterBank< TInputImage, TOutputImage, TWaveletOperator, Wavelet::INVERSE >::WaveletFilterBank(), otb::WaveletPacketTransform< TInputImage, TOutputImage, TFilter, Wavelet::FORWARD, TCost >::WaveletPacketTransform(), otb::WaveletTransform< TInputImage, TOutputImage, TFilter, Wavelet::INVERSE >::WaveletTransform(), and otb::WaveletTransform< TInputImage, TOutputImage, TFilter, Wavelet::FORWARD >::WaveletTransform().

{
  // in case nothing has changed.
  if (num == m_Inputs.size())
    {
    return;
    }
  m_Inputs.resize(num);
  this->Modified();
}

void itk::ProcessObject::SetNumberOfOutputs ( unsigned int num ) [protected, inherited]

Called to allocate the output array.

Called by constructor to set up output array.

Copies old outputs.

Definition at line 424 of file itkProcessObject.cxx.

Referenced by otb::WaveletFilterBank< TInputImage, TOutputImage, TWaveletOperator, Wavelet::FORWARD >::WaveletFilterBank(), otb::WaveletFilterBank< TInputImage, TOutputImage, TWaveletOperator, Wavelet::INVERSE >::WaveletFilterBank(), otb::WaveletPacketTransform< TInputImage, TOutputImage, TFilter, Wavelet::FORWARD, TCost >::WaveletPacketTransform(), otb::WaveletTransform< TInputImage, TOutputImage, TFilter, Wavelet::INVERSE >::WaveletTransform(), and otb::WaveletTransform< TInputImage, TOutputImage, TFilter, Wavelet::FORWARD >::WaveletTransform().

{

  // in case nothing has changed.
  if (num == m_Outputs.size())
    {
    return;
    }
  m_Outputs.resize(num);
  this->Modified();
}

virtual void itk::ProcessObject::SetNumberOfThreads ( int _arg ) [virtual, inherited]

Get/Set the number of threads to create when executing.

Referenced by itk::CannyEdgeDetectionImageFilter< TInputImage, TOutputImage >::Compute2ndDerivative(), itk::CannyEdgeDetectionImageFilter< TInputImage, TOutputImage >::Compute2ndDerivativePos(), itk::FiniteDifferenceSparseImageFilter< TInputImageType, TSparseOutputImageType >::PrecalculateChange(), and otb::WaveletFilterBank< TInputImage, TOutputImage, TWaveletOperator, Wavelet::INVERSE >::WaveletFilterBank().

virtual void itk::ProcessObject::SetProgress ( float _arg ) [virtual, inherited]

Set the execution progress of a process object.

The progress is a floating number in [0,1] with 0 meaning no progress and 1 meaning the filter has completed execution. The ProgressEvent is NOT invoked.

template<class TInputImage , class TOutputHeight >

void otb::StereoSensorModelToElevationFilter< TInputImage, TOutputHeight >::SetRadius ( unsigned int radius ) [inline]

Set the radius of the patches.

Default is 3.

Definition at line 214 of file otbStereoSensorModelToElevationMapFilter.h.

  {
    m_Radius.Fill(radius);
    this->Modified();
  }

void itk::Object::SetReferenceCount ( int ref ) [virtual, inherited]

Sets the reference count (use with care).

If there is a delete method, invoke it.

Reimplemented from itk::LightObject.

Definition at line 347 of file itkObject.cxx.

{
  itkDebugMacro(<< "Reference Count set to " << ref);

  // ReferenceCount in now unlocked.  We may have a race condition to
  // to delete the object.
  if( ref <= 0 )
    {
    this->InvokeEvent(DeleteEvent());
    }

  Superclass::SetReferenceCount(ref);
}

virtual void itk::ProcessObject::SetReleaseDataBeforeUpdateFlag ( bool _arg ) [virtual, inherited]

Turn on/off the flags to control whether the bulk data belonging to the outputs of this ProcessObject are released/reallocated during an Update().

In limited memory scenarios, a user may want to force the elements of a pipeline to release any bulk data that is going to be regenerated anyway during an Update() in order to control peak memory allocation. Note that this flag is different from the ReleaseDataFlag. ReleaseDataFlag manages the deallocation of a ProcessObject's bulk output data once that data has been consumed by a downstream ProcessObject. The ReleaseDataBeforeUpdateFlag manages the deallocation/reallocation of bulk data during a pipeline update to control peak memory utilization. Default value is on.

void itk::ProcessObject::SetReleaseDataFlag ( bool flag ) [virtual, inherited]

Turn on/off the flags to control whether the bulk data belonging to the outputs of this ProcessObject are released after being used by a downstream ProcessObject.

Default value is off. Another options for controlling memory utilization is the ReleaseDataBeforeUpdateFlag.

Definition at line 528 of file itkProcessObject.cxx.

{
  unsigned int idx;
  
  for (idx = 0; idx < m_Outputs.size(); idx++)
    {
    if (m_Outputs[idx])
      {
      m_Outputs[idx]->SetReleaseDataFlag(val);
      }
    }
}

template<class TInputImage , class TOutputHeight >

virtual void otb::StereoSensorModelToElevationFilter< TInputImage, TOutputHeight >::SetSubtractInitialElevation ( bool _arg ) [virtual]

Set the SubtractInitialElevation flag.

If set to true, the elevation map will only contains the difference between the estimated elevation and the initial one. If set to false, elevation is absolute. Default is false.

template<class TInputImage , class TOutputHeight >

virtual void otb::StereoSensorModelToElevationFilter< TInputImage, TOutputHeight >::SetUseDEM ( bool _arg ) [virtual]

Set the use DEM flag.

If set to true, the local elevation is extracted from a DEM + geoid. If set to false, average elevation is used. Default is false.

template<class TInputImage , class TOutputHeight >

virtual void otb::StereoSensorModelToElevationFilter< TInputImage, TOutputHeight >::SetVarianceThreshold ( double _arg ) [virtual]

Set the threshold on the variance of the master patch to start elevation estimation.

Default is 4.

virtual int itk::ImageSource< TOutputHeight >::SplitRequestedRegion	(	int	i,
		int	num,
		OutputImageRegionType &	splitRegion
	)			`[protected, virtual, inherited]`

Split the output's RequestedRegion into "num" pieces, returning region "i" as "splitRegion".

This method is called "num" times. The regions must not overlap. The method returns the number of pieces that the routine is capable of splitting the output RequestedRegion, i.e. return value is less than or equal to "num".

template<class TInputImage , class TOutputHeight >

virtual void otb::StereoSensorModelToElevationFilter< TInputImage, TOutputHeight >::SubtractInitialElevationOn ( ) [virtual]

Toggle the SubtractInitialElevation flag.

If set to true, the elevation map will only contains the difference between the estimated elevation and the initial one. If set to false, elevation is absolute. Default is false.

virtual void itk::ImageSource< TOutputHeight >::ThreadedGenerateData	(	const OutputImageRegionType &	outputRegionForThread,
		int	threadId
	)			`[protected, virtual, inherited]`

If an imaging filter can be implemented as a multithreaded algorithm, the filter will provide an implementation of ThreadedGenerateData().

This superclass will automatically split the output image into a number of pieces, spawn multiple threads, and call ThreadedGenerateData() in each thread. Prior to spawning threads, the BeforeThreadedGenerateData() method is called. After all the threads have completed, the AfterThreadedGenerateData() method is called. If an image processing filter cannot support threading, that filter should provide an implementation of the GenerateData() method instead of providing an implementation of ThreadedGenerateData(). If a filter provides a GenerateData() method as its implementation, then the filter is responsible for allocating the output data. If a filter provides a ThreadedGenerateData() method as its implementation, then the output memory will allocated automatically by this superclass. The ThreadedGenerateData() method should only produce the output specified by "outputThreadRegion" parameter. ThreadedGenerateData() cannot write to any other portion of the output image (as this is responsibility of a different thread).

See also:: GenerateData(), SplitRequestedRegion()

static ITK_THREAD_RETURN_TYPE itk::ImageSource< TOutputHeight >::ThreaderCallback ( void * arg ) [static, protected, inherited]

Static function used as a "callback" by the MultiThreader.

The threading library will call this routine for each thread, which will delegate the control to ThreadedGenerateData().

void itk::Object::UnRegister ( ) const [virtual, inherited]

Decrease the reference count (release by another object).

If there is a delete method, invoke it.

Reimplemented from itk::LightObject.

Definition at line 324 of file itkObject.cxx.

Referenced by itk::Object::New(), and itk::ObjectFactoryBase::UnRegisterFactory().

{
  // call the parent
  itkDebugMacro(<< "UnRegistered, "
                << "ReferenceCount = " << (m_ReferenceCount-1));

  if ( (m_ReferenceCount-1) <= 0)
    {
    this->InvokeEvent(DeleteEvent());
    }

  Superclass::UnRegister();
}

void itk::ProcessObject::Update ( void ) [virtual, inherited]

Bring this filter up-to-date.

The following methods are used to coordinate the execution of the data processing pipeline.

Update() checks modified times against last execution times, and re-executes objects if necessary. A side effect of this method is that the whole pipeline may execute in order to bring this filter up-to-date. This method updates the currently prescribed requested region. If no requested region has been set on the output, then the requested region will be set to the largest possible region. Once the requested region is set, Update() will make sure the specified requested region is up-to-date. This is a confusing side effect to users who are just calling Update() on a filter. A first call to Update() will cause the largest possible region to be updated. A second call to Update() will update that same region. If a modification to the upstream pipeline cause a filter to have a different largest possible region, this second call to Update() will not cause the output requested region to be reset to the new largest possible region. Instead, the output requested region will be the same as the last time Update() was called. To have a filter always to produce its largest possible region, users should call UpdateLargestPossibleRegion() instead.

Definition at line 611 of file itkProcessObject.cxx.

Referenced by otb::ImageSeriesFileReader< Image< TPixel, 2 >, Image< TInternalPixel, 2 > >::GenerateData(), otb::ImageSeriesFileReader< Image< TPixel, 2 >, VectorImage< TInternalPixel, 2 > >::GenerateData(), itk::DerivativeImageFilter< TInputImage, TOutputImage >::GenerateData(), otb::ImageSeriesFileReader< VectorImage< TPixel, 2 >, VectorImage< TInternalPixel, 2 > >::GenerateData(), itk::AutoCropLabelMapFilter< TInputImage >::GenerateOutputInformation(), and itk::LabelMapMaskImageFilter< TInputImage, TOutputImage >::GenerateOutputInformation().

{
  if (this->GetOutput(0))
    {
    this->GetOutput(0)->Update();
    }
}

void itk::ProcessObject::UpdateLargestPossibleRegion ( ) [virtual, inherited]

Like Update(), but sets the output requested region to the largest possible region for the output.

This is the method users should call if they want the entire dataset to be processed. If a user wants to update the same output region as a previous call to Update() or a previous call to UpdateLargestPossibleRegion(), then they should call the method Update().

Definition at line 1120 of file itkProcessObject.cxx.

{
  this->UpdateOutputInformation();

  if (this->GetOutput(0))
    {
    this->GetOutput(0)->SetRequestedRegionToLargestPossibleRegion();
    this->GetOutput(0)->Update();
    }
}

void itk::ProcessObject::UpdateOutputData ( DataObject * output ) [virtual, inherited]

Actually generate new output.

prevent chasing our tail

Prepare all the outputs. This may deallocate previous bulk data.

Propagate the update call - make sure everything we might rely on is up-to-date Must call PropagateRequestedRegion before UpdateOutputData if multiple inputs since they may lead back to the same data object.

Cache the state of any ReleaseDataFlag's on the inputs. While the filter is executing, we need to set the ReleaseDataFlag's on the inputs to false in case the current filter is implemented using a mini-pipeline (which will try to release the inputs). After the filter finishes, we restore the state of the ReleaseDataFlag's before the call to ReleaseInputs().

Tell all Observers that the filter is starting

GenerateData this object - we have not aborted yet, and our progress before we start to execute is 0.0.

Count the number of required inputs which have been assigned

If we ended due to aborting, push the progress up to 1.0 (since it probably didn't end there)

Notify end event observers

Now we have to mark the data as up to date.

Restore the state of any input ReleaseDataFlags

Release any inputs if marked for release

Reimplemented in otb::StreamingImageFileWriter< TInputImage >, and itk::StreamingImageFilter< TInputImage, TOutputImage >.

Definition at line 908 of file itkProcessObject.cxx.

{
  DataObjectPointerArraySizeType idx;

  if (m_Updating)
    {
    return;
    }

  this->PrepareOutputs();

  m_Updating = true;
  if ( m_Inputs.size() == 1 )
    {
    if (m_Inputs[0])
      {
      m_Inputs[0]->UpdateOutputData();
      }
    }
  else
    {
    for (idx = 0; idx < m_Inputs.size(); ++idx)
      {
      if (m_Inputs[idx])
        {
        m_Inputs[idx]->PropagateRequestedRegion();
        m_Inputs[idx]->UpdateOutputData();
        }
      }
    }

  this->CacheInputReleaseDataFlags();
  
  this->InvokeEvent( StartEvent() );

  m_AbortGenerateData = false;
  m_Progress = 0.0f;

  DataObjectPointerArraySizeType ninputs = this->GetNumberOfValidRequiredInputs();
  if (ninputs < m_NumberOfRequiredInputs)
    {
    itkExceptionMacro(<< "At least " << m_NumberOfRequiredInputs 
                      << " inputs are required but only " << ninputs 
                      << " are specified.");
    }
  else
    {
    try
      {
      this->GenerateData();
      }
    catch( ProcessAborted & excp )
      {
      this->InvokeEvent( AbortEvent() );
      this->ResetPipeline();
      this->RestoreInputReleaseDataFlags();
      throw excp;
      }
    catch( ExceptionObject& excp )
      {
      this->ResetPipeline();
      this->RestoreInputReleaseDataFlags();
      throw excp;
      }
    }

  if ( m_AbortGenerateData )
    {
    this->UpdateProgress(1.0f);
    }

  this->InvokeEvent( EndEvent() );

  for (idx = 0; idx < m_Outputs.size(); ++idx)
    {
    if (m_Outputs[idx])
      {
      m_Outputs[idx]->DataHasBeenGenerated();
      }
    }
  
  this->RestoreInputReleaseDataFlags();
  
  this->ReleaseInputs();
  
  // Mark that we are no longer updating the data in this filter
  m_Updating = false;
}

void itk::ProcessObject::UpdateOutputInformation ( void ) [virtual, inherited]

Update the information decribing the output data.

This method transverses up the pipeline gathering modified time information. On the way back down the pipeline, this method calls GenerateOutputInformation() to set any necessary information about the output data objects. For instance, a filter that shrinks an image will need to provide an implementation for GenerateOutputInformation() that changes the spacing of the pixels. Such filters should call their superclass' implementation of GenerateOutputInformation prior to changing the information values they need (i.e. GenerateOutputInformation() should call Superclass::GenerateOutputInformation() prior to changing the information.

Watch out for loops in the pipeline

Since we are in a loop, we will want to update. But if we don't modify this filter, then we will not execute because our OutputInformationMTime will be more recent than the MTime of our output.

We now wish to set the PipelineMTime of each output DataObject to the largest of this ProcessObject's MTime, all input DataObject's PipelineMTime, and all input's MTime. We begin with the MTime of this ProcessObject.

Loop through the inputs

Propagate the UpdateOutputInformation call

What is the PipelineMTime of this input? Compare this against our current computation to find the largest one.

Pipeline MTime of the input does not include the MTime of the data object itself. Factor these mtimes into the next PipelineMTime

Call GenerateOutputInformation for subclass specific information. Since UpdateOutputInformation propagates all the way up the pipeline, we need to be careful here to call GenerateOutputInformation only if necessary. Otherwise, we may cause this source to be modified which will cause it to execute again on the next update.

Keep track of the last time GenerateOutputInformation() was called

Reimplemented in itk::watershed::Segmenter< TInputImage >, itk::VTKImageImport< TOutputImage >, and itk::watershed::Segmenter< InputImageType >.

Definition at line 664 of file itkProcessObject.cxx.

References itk::Object::GetMTime(), itk::DataObject::SetPipelineMTime(), and itk::DataObject::UpdateOutputInformation().

Referenced by itk::VTKImageExportBase::UpdateInformationCallback(), and itk::watershed::Segmenter< TInputImage >::UpdateOutputInformation().

{
  unsigned long t1, t2;
  DataObjectPointerArraySizeType idx;
  DataObject *input;
  DataObject *output;

  if ( m_Updating )
    {
    this->Modified();
    return;
    }

  t1 = this->GetMTime();

  for (idx = 0; idx < m_Inputs.size(); ++idx)
    {
    if (m_Inputs[idx])
      {
      input = m_Inputs[idx];

      m_Updating = true;
      input->UpdateOutputInformation();
      m_Updating = false;
      
      t2 = input->GetPipelineMTime();

      if (t2 > t1)
        {
        t1 = t2;
        }

      t2 = input->GetMTime();
      if (t2 > t1)
        {
        t1 = t2;
        }
      }
    }

  if (t1 > m_OutputInformationMTime.GetMTime())
    {
    for (idx = 0; idx < m_Outputs.size(); ++idx)
      {
      output = this->GetOutput( static_cast<int>( idx ) );
      if (output)
        {
        output->SetPipelineMTime(t1);
        }  
      }
    
    this->GenerateOutputInformation();

    m_OutputInformationMTime.Modified();
    }
}

void itk::ProcessObject::UpdateProgress ( float amount ) [inherited]

Update the progress of the process object.

Sets the Progress ivar to amount and invokes any observers for the ProgressEvent. The parameter amount should be in [0,1] and is the cumulative (not incremental) progress.

If a ProgressMethod exists, execute it. Then set the Progress ivar to amount. The parameter amount should range between (0,1).

Definition at line 500 of file itkProcessObject.cxx.

Referenced by itk::watershed::Segmenter< TInputImage >::GenerateData(), itk::ProgressReporter::ProgressReporter(), and itk::ProgressReporter::~ProgressReporter().

{
  m_Progress = amount;
  this->InvokeEvent( ProgressEvent() );
}

template<class TInputImage , class TOutputHeight >

virtual void otb::StereoSensorModelToElevationFilter< TInputImage, TOutputHeight >::UseDEMOn ( ) [virtual]

Toggle the use DEM flag.

If set to true, the local elevation is extracted from a DEM + geoid. If set to false, average elevation is used. Default is false.

Member Data Documentation

template<class TInputImage , class TOutputHeight >

double otb::StereoSensorModelToElevationFilter< TInputImage, TOutputHeight >::m_AverageElevation [private]

Average elevation to consider if no DEM is used.

Definition at line 270 of file otbStereoSensorModelToElevationMapFilter.h.

template<class TInputImage , class TOutputHeight >

double otb::StereoSensorModelToElevationFilter< TInputImage, TOutputHeight >::m_CorrelationThreshold [private]

Threshold of the correlation to keep estimated height.

Definition at line 273 of file otbStereoSensorModelToElevationMapFilter.h.

template<class TInputImage , class TOutputHeight >

std::string otb::StereoSensorModelToElevationFilter< TInputImage, TOutputHeight >::m_DEMDirectory [private]

Directory containing the DEM tiles.

Definition at line 264 of file otbStereoSensorModelToElevationMapFilter.h.

template<class TInputImage , class TOutputHeight >

double otb::StereoSensorModelToElevationFilter< TInputImage, TOutputHeight >::m_ElevationStep [private]

Step of the elevation exploration.

Definition at line 257 of file otbStereoSensorModelToElevationMapFilter.h.

template<class TInputImage , class TOutputHeight >

double otb::StereoSensorModelToElevationFilter< TInputImage, TOutputHeight >::m_HigherElevation [private]

Higher offset for the local elevation exploration.

Definition at line 254 of file otbStereoSensorModelToElevationMapFilter.h.

template<class TInputImage , class TOutputHeight >

double otb::StereoSensorModelToElevationFilter< TInputImage, TOutputHeight >::m_LowerElevation [private]

Lower offset for the local elevation exploration.

Definition at line 251 of file otbStereoSensorModelToElevationMapFilter.h.

TimeStamp itk::ProcessObject::m_OutputInformationMTime [protected, inherited]

Time when GenerateOutputInformation was last called.

Definition at line 421 of file itkProcessObject.h.

InternalReferenceCountType itk::LightObject::m_ReferenceCount [mutable, protected, inherited]

Number of uses of this object by other objects.

Definition at line 141 of file itkLightObject.h.

template<class TInputImage , class TOutputHeight >

bool otb::StereoSensorModelToElevationFilter< TInputImage, TOutputHeight >::m_SubtractInitialElevation [private]

If set to true, the elevation map will only contains the difference between the estimated elevation and the initial one.

If set to false, elevation is absolute. Default is false.

Definition at line 282 of file otbStereoSensorModelToElevationMapFilter.h.

bool itk::ProcessObject::m_Updating [protected, inherited]

These ivars are made protected so filters like itkStreamingImageFilter can access them directly.

This flag indicates when the pipeline is executing. It prevents infinite recursion when pipelines have loops.

Reimplemented in otb::HistogramAndTransferFunctionWidget< THistogram, TPixel >, and otb::ImageViewerBase< TPixel, TLabel >.

Definition at line 418 of file itkProcessObject.h.

template<class TInputImage , class TOutputHeight >

bool otb::StereoSensorModelToElevationFilter< TInputImage, TOutputHeight >::m_UseDEM [private]

If set to true, the local elevation is extracted from a DEM + geoid.

If set to false, average elevation is used. Default is false.

Definition at line 261 of file otbStereoSensorModelToElevationMapFilter.h.

template<class TInputImage , class TOutputHeight >

double otb::StereoSensorModelToElevationFilter< TInputImage, TOutputHeight >::m_VarianceThreshold [private]

Threshold on the variance of the master patch to start elevation estimation.

Definition at line 277 of file otbStereoSensorModelToElevationMapFilter.h.

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

otb::StereoSensorModelToElevationFilter< TInputImage, TOutputHeight > Class Template Reference [Filters supporting Streaming]

Public Types

Public Member Functions

Static Public Member Functions

Static Public Attributes

Protected Types

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Detailed Description

template<class TInputImage, class TOutputHeight> class otb::StereoSensorModelToElevationFilter< TInputImage, TOutputHeight >

Member Typedef Documentation

Member Function Documentation

Member Data Documentation

otb::StereoSensorModelToElevationFilter< TInputImage, TOutputHeight > Class Template Reference
[Filters supporting Streaming]

template<class TInputImage, class TOutputHeight>
class otb::StereoSensorModelToElevationFilter< TInputImage, TOutputHeight >