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.

 


Setup

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.

Polygons

  • 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


Advanced

Constraints

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

 


Conditions 

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


Visualisation

Blob

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

Error

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

Hole

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

ROI

Region Of Interest for the measurement


Results

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)

Command

Parameters

Return values

Comments

Set Object=ROI;Value=<polygon> ok,None Sets the first ROI polygon. See Copy/paste ROIs for details.
Set Object=ROI;Number=<number>;
Value=<polygon>
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

Shortcut

Command

Comments

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.