Collapse
The Collapse module is a morphological module that can be used to analyze an object's shape. The module
will collapse a binary image by shifting the nonblack pixels to the side of the image specified
in the user interface. The resulting image is appears like a histogram but instead of representing the
number of colors within an image (a histogram) it relates to how many nonblack pixels are in
each vertical or horizontal scan line (when in Binary mode). Basically each scan line (either horizontal or vertical)
is scanned for nonblack pixels. If one if found the resulting height if incremented by 1. This
continues for all scan lines.
Note that left & right and top & bottom are symmetrical
views of the same information.
This module is useful in shape analysis where decomposing the shape of an image reduces the shape detection
problem to a 1 dimensional problem rather than a 2 dimensional problem. While the reduction in dimension
does come at a shape uniqueness price it can be a sufficient model in many cases.
This module is often combined with the peak detection module to determine if a shape is present.
Interface
Instructions
1. Direction  Specify which direction you want the current pixels to collapse/shift towards
2. Method  If you have black and white pixels you can use Binary mode to create the histogram. If instead
you have grayscale or colored pixels that represent the intensity value of the pixel then selecting analog mode will
sum up all those pixels and create a white pixel to represent values greater than 255.
3. Display  Chose how you'd like to display the results. Area Chart will display a solid chart
in the appropriate direction. Line Chart is similar to an Area Chart but only includes the chart
border. Surface will display the accumulated values as a pixel intensity line that fills
the entire image. This can be thought of as looking at the results from above versus
from the side like the Area and Line Charts do.
Example
Source  Left Collapsed 
 
Bottom Collapsed  Right Collapsed 
 
Source  Bottom Analog Collapsed 
 
Variables
COLLAPSE_MAX  maximum collapsed value in binary mode
COLLAPSE_MAX_POSITION  position (X or Y) of maximum value in binary mode
COLLAPSE_MIN  minimum collapsed value in binary mode
COLLAPSE_MIN_POSITION  position (X or Y) of minimum value in binary mode
COLLAPSE_AVERAGE  average collpased value in binary mode
COLLAPSE_VALUES  count values for each row/column
COLLAPSE_MAX_RED  maximum collapsed red value in color mode
COLLAPSE_MAX_POSITION_RED  position (X or Y) of maximum red value in color mode
COLLAPSE_MIN_RED  minimum collapsed red value in color mode
COLLAPSE_MIN_POSITION_RED  position (X or Y) of minimum red value in color mode
COLLAPSE_AVERAGE_RED  average collpased red value in color mode
COLLAPSE_VALUE  count values for each row/column
COLLAPSE_RED_VALUES  count values for each red row/column
COLLAPSE_MAX_GREEN  maximum collapsed green value in color mode
COLLAPSE_MAX_POSITION_GREEN  position (X or Y) of maximum green value in color mode
COLLAPSE_MIN_GREEN  minimum collapsed green value in color mode
COLLAPSE_MIN_POSITION_GREEN  position (X or Y) of minimum green value in color mode
COLLAPSE_AVERAGE_GREEN  average collpased green value in color mode
COLLAPSE_GREEN_VALUES  count values for each green row/column
COLLAPSE_MAX_BLUE  maximum collapsed blue value in color mode
COLLAPSE_MAX_POSITION_BLUE  position (X or Y) of maximum blue value in color mode
COLLAPSE_MIN_BLUE  minimum collapsed blue value in color mode
COLLAPSE_MIN_POSITION_BLUE  position (X or Y) of minimum blue value in color mode
COLLAPSE_AVERAGE_BLUE  average collpased blue value in color mode
COLLAPSE_BLUE_VALUES  count values for each blue row/column
See Also
Line Alignment
Threshold
