Class ConfidenceConnectedImageFilter

java.lang.Object
org.itk.simple.ProcessObject
org.itk.simple.ImageFilter
org.itk.simple.ConfidenceConnectedImageFilter

public class ConfidenceConnectedImageFilter extends ImageFilter
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
  • 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

      protected static long getCPtr(ConfidenceConnectedImageFilter obj)
    • swigRelease

      protected static long swigRelease(ConfidenceConnectedImageFilter obj)
    • finalize

      protected void finalize()
      Overrides:
      finalize in class ImageFilter
    • delete

      public void delete()
      virtual itk::simple::ConfidenceConnectedImageFilter::~ConfidenceConnectedImageFilter() Destructor
      Overrides:
      delete in class ImageFilter
    • setSeedList

      public void setSeedList(VectorUIntList SeedList)
      Self& itk::simple::ConfidenceConnectedImageFilter::SetSeedList(std::vector< std::vector< unsigned int > > SeedList) Set list of image indexes for seeds.
    • getSeedList

      public VectorUIntList getSeedList()
      std::vector< std::vector< unsigned int > > itk::simple::ConfidenceConnectedImageFilter::GetSeedList() const Get list of seeds.
    • addSeed

      public void addSeed(VectorUInt32 point)
      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

      public String getName()
      std::string itk::simple::ConfidenceConnectedImageFilter::GetName() const Name of this class
      Overrides:
      getName in class ProcessObject
    • toString

      public String toString()
      std::string itk::simple::ConfidenceConnectedImageFilter::ToString() const Print ourselves out
      Overrides:
      toString in class ProcessObject
    • execute

      public Image execute(Image image1)
      Image itk::simple::ConfidenceConnectedImageFilter::Execute(const Image &image1) Execute the filter on the input image