Package org.itk.simple
Class ConfidenceConnectedImageFilter
java.lang.Object
org.itk.simple.ProcessObject
org.itk.simple.ImageFilter
org.itk.simple.ConfidenceConnectedImageFilter
Segment pixels with similar statistics using connectivity.
This filter extracts a connected set of pixels whose pixel intensities
are consistent with the pixel statistics of a seed point. The mean and
variance across a neighborhood (8-connected, 26-connected, etc.) are
calculated for a seed point. Then pixels connected to this seed point
whose values are within the confidence interval for the seed point are
grouped. The width of the confidence interval is controlled by the
"Multiplier" variable (the confidence interval is the mean plus or
minus the "Multiplier" times the standard deviation). If the
intensity variations across a segment were gaussian, a "Multiplier"
setting of 2.5 would define a confidence interval wide enough to
capture 99% of samples in the segment.
After this initial segmentation is calculated, the mean and variance
are re-calculated. All the pixels in the previous segmentation are
used to calculate the mean the standard deviation (as opposed to using
the pixels in the neighborhood of the seed point). The segmentation is
then recalculated using these refined estimates for the mean and
variance of the pixel values. This process is repeated for the
specified number of iterations. Setting the "NumberOfIterations" to
zero stops the algorithm after the initial segmentation from the seed
point.
NOTE: the lower and upper threshold are restricted to lie within the
valid numeric limits of the input data pixel type. Also, the limits
may be adjusted to contain the seed point's intensity.
See:
itk::simple::ConfidenceConnected for the procedural interface
itk::ConfidenceConnectedImageFilter for the Doxygen on the original ITK class.
C++ includes: sitkConfidenceConnectedImageFilter.h
-
Field Summary
Fields inherited from class org.itk.simple.ProcessObject
swigCMemOwn
-
Constructor Summary
ConstructorsModifierConstructorDescriptionitk::simple::ConfidenceConnectedImageFilter::ConfidenceConnectedImageFilter() Default Constructor that takes no arguments and initializes default parametersprotected
ConfidenceConnectedImageFilter
(long cPtr, boolean cMemoryOwn) -
Method Summary
Modifier and TypeMethodDescriptionvoid
addSeed
(VectorUInt32 point) Self& itk::simple::ConfidenceConnectedImageFilter::AddSeed(std::vector< unsigned int > point) Add SeedList point.void
Self& itk::simple::ConfidenceConnectedImageFilter::ClearSeeds() Remove all SeedList points.void
delete()
virtual itk::simple::ConfidenceConnectedImageFilter::~ConfidenceConnectedImageFilter() DestructorImage itk::simple::ConfidenceConnectedImageFilter::Execute(const Image &image1) Execute the filter on the input imageprotected void
finalize()
protected static long
long
unsigned int itk::simple::ConfidenceConnectedImageFilter::GetInitialNeighborhoodRadius() const Get/Set the radius of the neighborhood over which the statistics are evaluateddouble
getMean()
double itk::simple::ConfidenceConnectedImageFilter::GetMean() const Method to get access to the mean of the pixels accepted in the output region.double
double itk::simple::ConfidenceConnectedImageFilter::GetMultiplier() const Set/Get the multiplier to define the confidence interval.getName()
std::string itk::simple::ConfidenceConnectedImageFilter::GetName() const Name of this classlong
unsigned int itk::simple::ConfidenceConnectedImageFilter::GetNumberOfIterations() const Set/Get the number of iterationsshort
uint8_t itk::simple::ConfidenceConnectedImageFilter::GetReplaceValue() const Set/Get value to replace thresholded pixelsstd::vector< std::vector< unsigned int > > itk::simple::ConfidenceConnectedImageFilter::GetSeedList() const Get list of seeds.double
double itk::simple::ConfidenceConnectedImageFilter::GetVariance() const Method to get access to the variance of the pixels accepted in the output region.void
setInitialNeighborhoodRadius
(long InitialNeighborhoodRadius) Self& itk::simple::ConfidenceConnectedImageFilter::SetInitialNeighborhoodRadius(unsigned int InitialNeighborhoodRadius) Get/Set the radius of the neighborhood over which the statistics are evaluatedvoid
setMultiplier
(double Multiplier) Self& itk::simple::ConfidenceConnectedImageFilter::SetMultiplier(double Multiplier) Set/Get the multiplier to define the confidence interval.void
setNumberOfIterations
(long NumberOfIterations) Self& itk::simple::ConfidenceConnectedImageFilter::SetNumberOfIterations(unsigned int NumberOfIterations) Set/Get the number of iterationsvoid
setReplaceValue
(short ReplaceValue) Self& itk::simple::ConfidenceConnectedImageFilter::SetReplaceValue(uint8_t ReplaceValue) Set/Get value to replace thresholded pixelsvoid
setSeedList
(VectorUIntList SeedList) Self& itk::simple::ConfidenceConnectedImageFilter::SetSeedList(std::vector< std::vector< unsigned int > > SeedList) Set list of image indexes for seeds.protected static long
toString()
std::string itk::simple::ConfidenceConnectedImageFilter::ToString() const Print ourselves outMethods inherited from class org.itk.simple.ImageFilter
getCPtr, swigRelease
Methods inherited from class org.itk.simple.ProcessObject
abort, addCommand, debugOff, debugOn, getCPtr, getDebug, getGlobalDefaultCoordinateTolerance, getGlobalDefaultDebug, getGlobalDefaultDirectionTolerance, getGlobalDefaultNumberOfThreads, getGlobalDefaultThreader, getGlobalWarningDisplay, getNumberOfThreads, getNumberOfWorkUnits, getProgress, globalDefaultDebugOff, globalDefaultDebugOn, globalWarningDisplayOff, globalWarningDisplayOn, hasCommand, removeAllCommands, setDebug, setGlobalDefaultCoordinateTolerance, setGlobalDefaultDebug, setGlobalDefaultDirectionTolerance, setGlobalDefaultNumberOfThreads, setGlobalDefaultThreader, setGlobalWarningDisplay, setNumberOfThreads, setNumberOfWorkUnits, swigRelease
-
Constructor Details
-
ConfidenceConnectedImageFilter
protected ConfidenceConnectedImageFilter(long cPtr, boolean cMemoryOwn) -
ConfidenceConnectedImageFilter
public ConfidenceConnectedImageFilter()itk::simple::ConfidenceConnectedImageFilter::ConfidenceConnectedImageFilter() Default Constructor that takes no arguments and initializes default parameters
-
-
Method Details
-
getCPtr
-
swigRelease
-
finalize
protected void finalize()- Overrides:
finalize
in classImageFilter
-
delete
public void delete()virtual itk::simple::ConfidenceConnectedImageFilter::~ConfidenceConnectedImageFilter() Destructor- Overrides:
delete
in classImageFilter
-
setSeedList
Self& itk::simple::ConfidenceConnectedImageFilter::SetSeedList(std::vector< std::vector< unsigned int > > SeedList) Set list of image indexes for seeds. -
getSeedList
std::vector< std::vector< unsigned int > > itk::simple::ConfidenceConnectedImageFilter::GetSeedList() const Get list of seeds. -
addSeed
Self& itk::simple::ConfidenceConnectedImageFilter::AddSeed(std::vector< unsigned int > point) Add SeedList point. -
clearSeeds
public void clearSeeds()Self& itk::simple::ConfidenceConnectedImageFilter::ClearSeeds() Remove all SeedList points. -
setNumberOfIterations
public void setNumberOfIterations(long NumberOfIterations) Self& itk::simple::ConfidenceConnectedImageFilter::SetNumberOfIterations(unsigned int NumberOfIterations) Set/Get the number of iterations -
getNumberOfIterations
public long getNumberOfIterations()unsigned int itk::simple::ConfidenceConnectedImageFilter::GetNumberOfIterations() const Set/Get the number of iterations -
setMultiplier
public void setMultiplier(double Multiplier) Self& itk::simple::ConfidenceConnectedImageFilter::SetMultiplier(double Multiplier) Set/Get the multiplier to define the confidence interval. Multiplier can be anything greater than zero. A typical value is 2.5 -
getMultiplier
public double getMultiplier()double itk::simple::ConfidenceConnectedImageFilter::GetMultiplier() const Set/Get the multiplier to define the confidence interval. Multiplier can be anything greater than zero. A typical value is 2.5 -
setInitialNeighborhoodRadius
public void setInitialNeighborhoodRadius(long InitialNeighborhoodRadius) Self& itk::simple::ConfidenceConnectedImageFilter::SetInitialNeighborhoodRadius(unsigned int InitialNeighborhoodRadius) Get/Set the radius of the neighborhood over which the statistics are evaluated -
getInitialNeighborhoodRadius
public long getInitialNeighborhoodRadius()unsigned int itk::simple::ConfidenceConnectedImageFilter::GetInitialNeighborhoodRadius() const Get/Set the radius of the neighborhood over which the statistics are evaluated -
setReplaceValue
public void setReplaceValue(short ReplaceValue) Self& itk::simple::ConfidenceConnectedImageFilter::SetReplaceValue(uint8_t ReplaceValue) Set/Get value to replace thresholded pixels -
getReplaceValue
public short getReplaceValue()uint8_t itk::simple::ConfidenceConnectedImageFilter::GetReplaceValue() const Set/Get value to replace thresholded pixels -
getMean
public double getMean()double itk::simple::ConfidenceConnectedImageFilter::GetMean() const Method to get access to the mean of the pixels accepted in the output region. This method should only be invoked after the filter has been executed using the Update() method. This is a measurement. Its value is updated in the Execute methods, so the value will only be valid after an execution. -
getVariance
public double getVariance()double itk::simple::ConfidenceConnectedImageFilter::GetVariance() const Method to get access to the variance of the pixels accepted in the output region. This method should only be invoked after the filter has been executed using the Update() method. This is a measurement. Its value is updated in the Execute methods, so the value will only be valid after an execution. -
getName
std::string itk::simple::ConfidenceConnectedImageFilter::GetName() const Name of this class- Overrides:
getName
in classProcessObject
-
toString
std::string itk::simple::ConfidenceConnectedImageFilter::ToString() const Print ourselves out- Overrides:
toString
in classProcessObject
-
execute
Image itk::simple::ConfidenceConnectedImageFilter::Execute(const Image &image1) Execute the filter on the input image
-