Up | ImageResampler - 70 | Blob4 - 87 | TemplateFinder3 - 63 | Blob3 - 60 | MultiBlob - 47 | TemplateFinder2 - 44 | TextureMatcher - 53 | PolyLineGapFinder - 49 | ColorSegmentor - 57 | PolygonMatch - 62 | ColorAnalyzer - 80 | PolyLineEdgeFaults2 - 85 | PolarUnwrap - 113 | SurfaceAnalyzer - 91 | ImageMixer - 147 | AreaFilter - 158



MultiBlob - 47

The MultiBlob inherits its main properties from the Blob2 tool. In addition it has a Condition feature that allows the user to classify the state of each polygon as true or false. This is very useful if you need to check the presence of N equal objects in an image. See image below where the separation between two lines is checked with one MultiBlob with two polygons.



Reference - Reference system selection

Search Area - the tool's region of interest

Polygon definition file - The areas to be searched are initially read from a text file (see the StrVec format). The name of that file is also stored, for possible future reload. The path information, however, is stored directly in the system, without need for the external file. You can browse for or manually edit the filename

  • Load - load areas search from file

  • Save - save area search to file

  • Always read file at startup (overwrite SPB) - With this selection, the file is always loaded at startup.


  • Vector - list of numbered polygons
  • Content - the points of the selected polygon
  • New - add polygon
  • Delete - remove selected polygon
  • Paste new - creates a new polygon, pastes the polygon from the clipboard and presses apply  - this is the quickes way to create many polygons
  • Highlight selection - highlights the selected polygon in the image
  • Copy - copies the selected polygon to the clipboard
  • Paste - pastes the clipboard to the selected polygon - will overwrite an existing polygon

Emphasizing gradients - Activate Sobel-filter to work on a differentiated image

Morphology - Erode (remove) or dilate (add) the found blob area

  • Example : e2d2 - erodes two pixel before dilating 2 pixels

Area Search

  • Minimum threshold - minimum accepted intensity value
  • Maximum threshold - maximum accepted intensity value

- will activate a tool parameter browser.

Note : Minimum and maximum threshold can be linked to a result in another tool - Very often a percentile value from the Intensity Tool

  • Threshold as percentiles - minimum and maximum threshold are intensity percentiles from 0 to 100%
  • Search outside threshold values - Search outside the intensity limits, not between  
  • Smooth factor - smoothes the contour - used to correct the result contour length



A set of constraints can be specified, limiting the blobs that are found by the tool (result validation). The constraints apply to each blob, and all must be satisfied for a blob to be considered qualified.

  • Contour area - Area including any holes
  • Blob area - Area excluding any holes
  • Holes - Separate holes within a blob. A minimum hole area implies that the blob must have a hole; a maximum area does not.  
  • Circularity - Min and max circularity (Contour length / Contour area)  
  • Intensity Min and max intensity



The conditions are used to classify each polygon into PASS - FAIL. This is reflected in the OK Index.

  • Blob count - Blob count per polygon. Min/Max number of blobs in polygon.
  • Holes Hole count per blob. Min/Max number of holes per blob.
  • Ignored holes Ignored hole count per blob. Min/Max ignored holes per blob.
  • Contrast The min or max polygon contrast. Contrast measured between percentiles.
  • Area - The min and max blob area in polygon
  • Coverage (%) - The min and max blob coverage in polygon



A line following the contour of the blob

BlobOnError Visualize the blob when the polygon fail. 

Center of gravity

A point defining the blob’s center of gravity


A cross is shown in the ROI center if no blobs are found


A line following the contour of the hole

IgnoredHole A line following an ignored hole
OK To indicate pass polygons
PathNumber The polygon number is drawn in the image 
PathNumberOnError The polygon number is drawn in the image when a polygon fail - this is very useful when having many polygons to maintain


Region Of Interest for the measurement


OK count

  Number of polygons classified to pass the conditions

Error count

  Number  of polygons classified to fail

Total count

  Total number of polygons

All OK

  True = 1 if all polygons pass

All Error

  True = 1 if all polygons fail

OK Index

  Return the state of each polygon - (1,0,1,0,)

The remaining results give the minimum and maximum values for the results used in constraints and conditions. They are provided for process insight when configuring the tool. 

Low min percentile value

High min percentile value


Low max percentile value


High max percentile value


Min contour area


Max contour area


Min area


Max area


Min hole count


Max hole count


Min ignored hole count  
Max ignored hole count  

Min hole area


Max hole area


Min circularity


Max circularity


Min intensity


Max intensity    
Min contrast  

Max contrast


Min coverage
Max coverage

ExecuteCmd support
(see also executeCmd)



Return values


Set Object=ROI;Value=<polygon> ok,None Sets the first ROI polygon. See Copy/paste ROIs for details.
Set Object=ROI;Number=<number>;
ok,None Sets the numbered ROI polygon. See Copy/paste ROIs for details.
Add Object=ROI;Value=<polygon> ok,None Adds ROI polygon to the end of the list. See Copy/paste ROIs for details.
Get Object=ROI;Number=<number> ok,<polygon> Gets numbered polygon, as Scorpion polygon (StrArr format).
Get Object=Tuple;Number=<number> ok,<tuple> Gets numbered polygon, as Python tuple
Clear Object=ROI;Number=<number> ok,None Clears numbered polygon (makes empty)
DeleteAll - ok,None Deletes all polygons

Keyboard shortcuts
- More information




Ctrl-Z Set ROI Sets the selected polygon to points marked in the image. If only a single point is marked, the polygon is moved, centered around the point.
If the tool dialog is not open, the first polygon is set.
Ctrl-1 - Ctrl-0 Set polygon 0-10 Sets the numbered polygon to points marked in the image. If only a single point is marked, the polygon is moved, centered around the point. If a new polygon is defined this way, any missing polygons in between are set as empty.
Ctrl-Shift-1 - Ctrl-Shift-0 Clear polygon 0-10 Clears the numbered polygon (sets empty).
Ctrl-Shift-A Add polygon This is a shortcut to the 'Add polygon' button on the "Setup/Add polygon" page, and is only effective when that page is visible.



Scorpion Vision Version XII : Build 646 - Date: 20170225
Scorpion Vision Software® is a registered trademark of Tordivel AS.
Copyright © 2000 - 2017 Tordivel AS.