SoLocalMaximaQuantification engine More...
#include <ImageViz/Engines/ImageAnalysis/Statistics/SoLocalMaximaQuantification.h>
Classes | |
class | SbLocalMaximaDetail |
Results details of SoLocalMaximaQuantification. More... | |
Public Types | |
enum | PrecisionMode { PIXEL = 0 , SUB_PIXEL = 1 } |
Public Types inherited from SoImageVizEngine | |
enum | ComputeMode { MODE_2D = 0 , MODE_3D = 1 , MODE_AUTO = 2 } |
Compute Mode This enum specifies whether the main input will be interpreted as a 3D volume or a stack of 2D images for processing. More... | |
enum | Neighborhood3d { CONNECTIVITY_6 = 0 , CONNECTIVITY_18 = 1 , CONNECTIVITY_26 = 2 } |
Neighborhood Connectivity 3D. More... | |
Public Member Functions | |
SoLocalMaximaQuantification () | |
Constructor. | |
Public Member Functions inherited from SoImageVizEngine | |
virtual SoType | getTypeId () const |
Returns the type identifier for this specific instance. | |
virtual void | startEvaluate () |
Evaluate engine and dependencies in another thread without blocking the current one. | |
virtual void | waitEvaluate () |
Wait for the end of engine evaluation. | |
virtual void | abortEvaluate () |
Abort current processing as soon as possible. | |
virtual bool | isEvaluating () |
Returns true if the engine evaluation is in progress. | |
Public Member Functions inherited from SoEngine | |
virtual int | getOutputs (SoEngineOutputList &list) const |
Returns a list of outputs in this engine. | |
SoEngineOutput * | getOutput (const SbName &outputName) const |
Returns a reference to the engine output with the given name. | |
SbBool | getOutputName (const SoEngineOutput *output, SbName &outputName) const |
Returns (in outputName) the name of the engine output (output). | |
SoEngine * | copy () const |
Creates and returns an exact copy of the engine. | |
Public Member Functions inherited from SoFieldContainer | |
void | setToDefaults () |
Sets all fields in this object to their default values. | |
SbBool | hasDefaultValues () const |
Returns TRUE if all of the object's fields have their default values. | |
SbBool | fieldsAreEqual (const SoFieldContainer *fc) const |
Returns TRUE if this object's fields are exactly equal to fc's fields. | |
void | copyFieldValues (const SoFieldContainer *fc, SbBool copyConnections=FALSE) |
Copies the contents of fc's fields into this object's fields. | |
SoNONUNICODE SbBool | set (const char *fieldDataString) |
Sets one or more fields in this object to the values specified in the given string, which should be a string in the Open Inventor file format. | |
SbBool | set (const SbString &fieldDataString) |
Sets one or more fields in this object to the values specified in the given string, which should be a string in the Open Inventor file format. | |
void | get (SbString &fieldDataString) |
Returns the values of the fields of this object in the Open Inventor ASCII file format in the given string. | |
virtual int | getFields (SoFieldList &list) const |
Appends references to all of this object's fields to resultList, and returns the number of fields appended. | |
virtual int | getAllFields (SoFieldList &list) const |
Returns a list of fields, including the eventIn's and eventOut's. | |
virtual SoField * | getField (const SbName &fieldName) const |
Returns a the field of this object whose name is fieldName. | |
virtual SoField * | getEventIn (const SbName &fieldName) const |
Returns a the eventIn with the given name. | |
virtual SoField * | getEventOut (const SbName &fieldName) const |
Returns the eventOut with the given name. | |
SbBool | getFieldName (const SoField *field, SbName &fieldName) const |
Returns the name of the given field in the fieldName argument. | |
SbBool | enableNotify (SbBool flag) |
Notification at this Field Container is enabled (if flag == TRUE) or disabled (if flag == FALSE). | |
SbBool | isNotifyEnabled () const |
Notification is the process of telling interested objects that this object has changed. | |
virtual void | setUserData (void *data) |
Sets application data. | |
void * | getUserData (void) const |
Gets user application data. | |
Public Member Functions inherited from SoBase | |
virtual void | touch () |
Marks an instance as modified, simulating a change to it. | |
virtual SbName | getName () const |
Returns the name of an instance. | |
virtual void | setName (const SbName &name) |
Sets the name of an instance. | |
void | setSynchronizable (const bool b) |
Sets this to be a ScaleViz synchronizable object. | |
bool | isSynchronizable () const |
Gets the ScaleViz synchronizable state of this object. | |
Public Member Functions inherited from SoRefCounter | |
void | ref () const |
Adds a reference to an instance. | |
void | unref () const |
Removes a reference from an instance. | |
void | unrefNoDelete () const |
unrefNoDelete() should be called when it is desired to decrement the reference count, but not delete the instance if this brings the reference count to zero. | |
int | getRefCount () const |
Returns current reference count. | |
void | lock () const |
lock this instance. | |
void | unlock () const |
unlock this instance. | |
Public Member Functions inherited from SoTypedObject | |
SbBool | isOfType (const SoType &type) const |
Returns TRUE if this object is of the type specified in type or is derived from that type. | |
template<typename TypedObjectClass > | |
SbBool | isOfType () const |
Returns TRUE if this object is of the type of class TypedObjectClass or is derived from that class. | |
Public Attributes | |
SoSFEnum | computeMode |
Select the compute Mode (2D or 3D or AUTO) Use enum ComputeMode. | |
SoSFImageDataAdapter | inGrayImage |
Enter input grey level image Default value is NULL. | |
SoSFVec3i32 | localWindow |
The neighborhood size in X, Y and Z. | |
SoSFFloat | thresholdLevel |
Threshold. | |
SoSFEnum | precisionMode |
Select the precision mode of position. | |
SoSFInt32 | numberOfPatterns |
The number of patterns to be detected. | |
SoImageVizEngineAnalysisOutput< SbLocalMaximaDetail > | outResult |
The matching results. | |
Public Attributes inherited from SoImageVizEngine | |
SbEventHandler< EventArg & > | onBegin |
Event raised when the processing begins. | |
SbEventHandler< EventArg & > | onEnd |
Event raised when processing ends and the result is available. | |
SbEventHandler< EventArg & > | onProgress |
Event raised while processing is running. | |
Additional Inherited Members | |
Static Public Member Functions inherited from SoImageVizEngine | |
static SoType | getClassTypeId () |
Returns the type identifier for this class. | |
Static Public Member Functions inherited from SoEngine | |
static SoType | getClassTypeId () |
Returns the type identifier for the SoEngine class. | |
static SoEngine * | getByName (const SbName &name) |
Looks up engine(s) by name. | |
static int | getByName (const SbName &name, SoEngineList &list) |
Looks up engine(s) by name. | |
Static Public Member Functions inherited from SoFieldContainer | |
static SoType | getClassTypeId () |
Returns the type of this class. | |
Static Public Member Functions inherited from SoBase | |
static SoType | getClassTypeId () |
Returns type identifier for this class. | |
Static Public Member Functions inherited from SoTypedObject | |
static SoType | getClassTypeId () |
Returns the type identifier for this class. | |
SoLocalMaximaQuantification engine
The SoLocalMaximaQuantification engine extracts the local maxima of an image using a neighborhood analysis.
Input_Image[i,j] is a local maximum if the 2 conditions below apply:
Examples:
Example 1:
Input parameters: p=0, q=0, threshold=4, number=50.
The local maxima will be the points higher or equal to 4.
Number of local maxima detected: 7
Positions of the local maxima:
(7,3) (6,5) (5,7) (6,7) (6,8) (2,9) (6,9)
This corresponds to a threshold.
Example 2: Input parameters:p=1, q=1, threshold=3, number=50.
Number of local maxima detected: 4
Positions of the local maxima: (7,3) (6,5) (5,7) (2,9)
Remark: If there is an area in the image at constant level, the engine returns the upper left corner of this area. The other points of the area are not considered as �local maxima�.
Example 3: Input parameters: p=2, q=2, threshold=3, number=50.
Number of local maxima detected: 2
Positions of the local maxima: (7,3) (5,7)
Remark: The algorithm is not performed on the image border depending on n and m values. That is the reason why the point (2,9) is not considered as a local maximum.
Local Maximum Sub-Pixel Position Determination:
On example 3, the algorithm detects 2 local maxima. The positions are converted to sub-pixel positions:
X Sub-pixel Position Determined by Parabola Approximation
Y Sub-pixel Position Determined by Parabola Approximation
computeMode | MODE_AUTO |
inGrayImage | NULL |
localWindow | 3 3 3 |
thresholdLevel | 0.0f |
precisionMode | PIXEL |
numberOfPatterns | 1 |
Definition at line 124 of file SoLocalMaximaQuantification.h.
Enumerator | |
---|---|
PIXEL | |
SUB_PIXEL |
Definition at line 185 of file SoLocalMaximaQuantification.h.
SoLocalMaximaQuantification::SoLocalMaximaQuantification | ( | ) |
Constructor.
SoSFEnum SoLocalMaximaQuantification::computeMode |
Select the compute Mode (2D or 3D or AUTO) Use enum ComputeMode.
Default is MODE_AUTO
Definition at line 136 of file SoLocalMaximaQuantification.h.
SoSFImageDataAdapter SoLocalMaximaQuantification::inGrayImage |
Enter input grey level image Default value is NULL.
Supported types include: grayscale binary label image.
Definition at line 174 of file SoLocalMaximaQuantification.h.
SoSFVec3i32 SoLocalMaximaQuantification::localWindow |
The neighborhood size in X, Y and Z.
Default value is SbVec3i32(3,3,3).
Definition at line 177 of file SoLocalMaximaQuantification.h.
SoSFInt32 SoLocalMaximaQuantification::numberOfPatterns |
The number of patterns to be detected.
Default value is 1.
Definition at line 202 of file SoLocalMaximaQuantification.h.
SoImageVizEngineAnalysisOutput<SbLocalMaximaDetail> SoLocalMaximaQuantification::outResult |
The matching results.
Default value is NULL.
Definition at line 205 of file SoLocalMaximaQuantification.h.
SoSFEnum SoLocalMaximaQuantification::precisionMode |
Select the precision mode of position.
Use enum PrecisionMode. Default is PIXEL
Definition at line 199 of file SoLocalMaximaQuantification.h.
SoSFFloat SoLocalMaximaQuantification::thresholdLevel |