Class 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
    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      static TransientAreasSegmentationModule __fromPtr__​(long addr)  
      void clearAllBuffers()
      cleans all the buffers of the instance
      static TransientAreasSegmentationModule create​(Size inputSize)
      allocator
      protected void finalize()  
      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
      Size getSize()
      return the sze of the manage input and output images
      String printSetup()
      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 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
      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​(String fs)
      write xml/yml formated parameters information
    • Constructor Detail

      • TransientAreasSegmentationModule

        protected TransientAreasSegmentationModule​(long addr)
    • Method Detail

      • 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