Class TransientAreasSegmentationModule

java.lang.Object
org.opencv.core.Algorithm
org.opencv.bioinspired.TransientAreasSegmentationModule

public class TransientAreasSegmentationModule extends Algorithm
class which provides a transient/moving areas segmentation module perform a locally adapted segmentation by using the retina magno input data Based on Alexandre BENOIT thesis: "Le système visuel humain au secours de la vision par ordinateur" 3 spatio temporal filters are used:
  • a first one which filters the noise and local variations of the input motion energy
  • a second (more powerfull low pass spatial filter) which gives the neighborhood motion energy the segmentation consists in the comparison of these both outputs, if the local motion energy is higher to the neighborhood otion energy, then the area is considered as moving and is segmented
  • a stronger third low pass filter helps decision by providing a smooth information about the "motion context" in a wider area
  • Field Summary

    Fields inherited from class org.opencv.core.Algorithm

    nativeObj
  • Constructor Summary

    Constructors
    Modifier
    Constructor
    Description
    protected
     
  • Method Summary

    Modifier and Type
    Method
    Description
    __fromPtr__(long addr)
     
    void
    cleans all the buffers of the instance
    create(Size inputSize)
    allocator
    protected void
     
    void
    getSegmentationPicture(Mat transientAreas)
    access function return the last segmentation result: a boolean picture which is resampled between 0 and 255 for a display purpose
    return the sze of the manage input and output images
    parameters setup display method
    void
    run(Mat inputToSegment)
    main processing method, get result using methods getSegmentationPicture()
    void
    run(Mat inputToSegment, int channelIndex)
    main processing method, get result using methods getSegmentationPicture()
    void
    try to open an XML segmentation parameters file to adjust current segmentation instance setup if the xml file does not exist, then default setup is applied warning, Exceptions are thrown if read XML file is not valid
    void
    setup(String segmentationParameterFile)
    try to open an XML segmentation parameters file to adjust current segmentation instance setup if the xml file does not exist, then default setup is applied warning, Exceptions are thrown if read XML file is not valid
    void
    setup(String segmentationParameterFile, boolean applyDefaultSetupOnFailure)
    try to open an XML segmentation parameters file to adjust current segmentation instance setup if the xml file does not exist, then default setup is applied warning, Exceptions are thrown if read XML file is not valid
    void
    write xml/yml formated parameters information

    Methods inherited from class org.opencv.core.Algorithm

    clear, empty, getDefaultName, getNativeObjAddr, save

    Methods inherited from class java.lang.Object

    clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
  • Constructor Details

    • TransientAreasSegmentationModule

      protected TransientAreasSegmentationModule(long addr)
  • Method Details

    • __fromPtr__

      public static TransientAreasSegmentationModule __fromPtr__(long addr)
    • getSize

      public Size getSize()
      return the sze of the manage input and output images
      Returns:
      automatically generated
    • setup

      public void setup(String segmentationParameterFile, boolean applyDefaultSetupOnFailure)
      try to open an XML segmentation parameters file to adjust current segmentation instance setup
      • if the xml file does not exist, then default setup is applied
      • warning, Exceptions are thrown if read XML file is not valid
      Parameters:
      segmentationParameterFile - : the parameters filename
      applyDefaultSetupOnFailure - : set to true if an error must be thrown on error
    • setup

      public void setup(String segmentationParameterFile)
      try to open an XML segmentation parameters file to adjust current segmentation instance setup
      • if the xml file does not exist, then default setup is applied
      • warning, Exceptions are thrown if read XML file is not valid
      Parameters:
      segmentationParameterFile - : the parameters filename
    • setup

      public void setup()
      try to open an XML segmentation parameters file to adjust current segmentation instance setup
      • if the xml file does not exist, then default setup is applied
      • warning, Exceptions are thrown if read XML file is not valid
    • printSetup

      public String printSetup()
      parameters setup display method
      Returns:
      a string which contains formatted parameters information
    • write

      public void write(String fs)
      write xml/yml formated parameters information
      Parameters:
      fs - : the filename of the xml file that will be open and writen with formatted parameters information
    • run

      public void run(Mat inputToSegment, int channelIndex)
      main processing method, get result using methods getSegmentationPicture()
      Parameters:
      inputToSegment - : the image to process, it must match the instance buffer size !
      channelIndex - : the channel to process in case of multichannel images
    • run

      public void run(Mat inputToSegment)
      main processing method, get result using methods getSegmentationPicture()
      Parameters:
      inputToSegment - : the image to process, it must match the instance buffer size !
    • getSegmentationPicture

      public void getSegmentationPicture(Mat transientAreas)
      access function return the last segmentation result: a boolean picture which is resampled between 0 and 255 for a display purpose
      Parameters:
      transientAreas - automatically generated
    • clearAllBuffers

      public void clearAllBuffers()
      cleans all the buffers of the instance
    • create

      public static TransientAreasSegmentationModule create(Size inputSize)
      allocator
      Parameters:
      inputSize - : size of the images input to segment (output will be the same size)
      Returns:
      automatically generated
    • finalize

      protected void finalize() throws Throwable
      Overrides:
      finalize in class Algorithm
      Throws:
      Throwable