Blob (IJBlob 1.4.7 API)

java.lang.Object
- ij.blob.Blob

```
public class Blob
extends Object
```
Represents a connected component - a so called "blob".

Author:

Thorsten Wagner

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`DRAW_CONVEX_HULL`
`static int`	`DRAW_HOLES`
`static int`	`DRAW_LABEL`
`static String`	`GETAREACONVEXHULL` Method name of getAreaConvexHull (for filtering).
`static String`	`GETAREATOPERIMETERRATIO` Method name of getAreaToPerimeterRatio (for filtering).
`static String`	`GETASPECTRATIO` Method name of getLongSideMBR (for filtering).
`static String`	`GETCIRCULARITY` Method name of getCircularity (for filtering).
`static String`	`GETCONTOURTEMPERATURE` Method name of getContourTemperature (for filtering).
`static String`	`GETCONVEXITY` Method name of getConvexity (for filtering).
`static String`	`GETDIAMETERMAXIMUMINSCRIBEDCIRCLE` Method name of getMaximumInscribedCircle (for filtering).
`static String`	`GETELONGATION` Method name of getElongation (for filtering).
`static String`	`GETENCLOSEDAREA` Method name of getEnclosedArea (for filtering).
`static String`	`GETFERETDIAMETER` Method name of getFeretDiameter (for filtering).
`static String`	`GETFRACTALBOXDIMENSION` Method name of getContourTemperature (for filtering).
`static String`	`GETLONGSIDEMBR` Method name of getLongSideMBR (for filtering).
`static String`	`GETMINFERETDIAMETER` Method name of getMinFeretDiameter (for filtering).
`static String`	`GETNUMBEROFHOLES` Method name of getNumberofHoles (for filtering).
`static String`	`GETORIENTATIONMAJORAXIS`
`static String`	`GETORIENTATIONMINORAXIS`
`static String`	`GETPERIMETER` Method name of getPerimeter (for filtering).
`static String`	`GETPERIMETERCONVEXHULL` Method name of getPerimeterConvexHull (for filtering).
`static String`	`GETSHORTSIDEMBR` Method name of getLongSideMBR (for filtering).
`static String`	`GETSOLIDITY` Method name of getSolidity (for filtering).
`static String`	`GETTHINNESRATIO` Method name of getThinnesRatio (for filtering).

Constructor Summary

Constructors
Constructor and Description

Blob(Polygon outerContour, int label)

Blob(Polygon outerContour, int label, ij.measure.Calibration cal)

Constructors
Constructor and Description
`Blob(Polygon outerContour, int label)`
`Blob(Polygon outerContour, int label, ij.measure.Calibration cal)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static void`	`addCustomFeature(CustomBlobFeature feature)`
`void`	`draw(ij.process.ImageProcessor ip)` Draws the Blob with its holes.
`void`	`draw(ij.process.ImageProcessor ip, int options)` Draws the Blob with or without its holes.
`Object`	`evaluateCustomFeature(String methodName, Object... params)` Evaluates the Custom Feature and return its value
`static ij.ImagePlus`	`generateBlobImage(Blob b)`
`double`	`getAreaConvexHull()`
`double`	`getAreaToPerimeterRatio()` Area/Perimeter
`double`	`getAspectRatio()`
`Point2D`	`getCenterOfGravity()` Return the geometric center of gravity of the blob.
`double`	`getCentralMoments(int p, int q)` Central Moments Definition of "Gorman et. al.
`double`	`getCircularity()` Calculates the circularity of the outer contour: (perimeter*perimeter) / (enclosed area).
`double`	`getContourTemperature()` Calculates the Contour Temperatur.
`Polygon`	`getConvexHull()` Returns the convex hull of the blob.
`double`	`getConvexity()`
`double`	`getDiamaterMaximumInscribedCircle()`
`double`	`getEigenvalueMajorAxis()` Calculates Eigenvalue from the major axis using the moments of the boundary
`double`	`getEigenvalueMinorAxis()` Calculates Eigenvalue from the minor axis using the moments of the boundary
`double`	`getElongation()` The Elongation of the Blob based on a fitted ellipse (1 - minor axis / major axis)
`double`	`getEnclosedArea()` Calculates the enclosed are of the outer contour without subsctracting possible holes.
`double`	`getFeretDiameter()` Calculates the feret diameter of the outer contour
`double`	`getFractalBoxDimension()`
`double`	`getFractalBoxDimension(int[] boxSizes)` Box Dimension of the blob boundary.
`double`	`getFractalDimensionGoodness()` The goodness of the "best fit" line of the fractal box dimension estimation.
`ArrayList<Polygon>`	`getInnerContours()` Return all inner contours (holes) of the blob.
`int`	`getLabel()` Return the label of the blob in the labeled image
`double`	`getLongSideMBR()`
`double`	`getMinFeretDiameter()` Calculates the min feret diameter of the outer contour
`Point[]`	`getMinimumBoundingRectangle()`
`double`	`getMoment(int p, int q)` Region-Based Moments Definition of "Gorman et. al.
`int`	`getNumberofHoles()` The number of inner contours (Holes) of a blob.
`double`	`getOrientationMajorAxis()`
`double`	`getOrientationMinorAxis()`
`Polygon`	`getOuterContour()` The outer contour of an object (polygon points are pixel indicies)
`int[]`	`getOuterContourAsChainCode()` Calculates the freeman chain code the outer contour
`ij.gui.Roi`	`getOuterContourAsROI()`
`double`	`getPerimeter()` Calculates the perimeter of the outer contour using its chain code
`double`	`getPerimeterConvexHull()` Calculates the perimeter of the convex hull
`double`	`getShortSideMBR()`
`double`	`getSolidity()`
`double`	`getThinnesRatio()` The Thinnes Ratio of the blob (normed).
`boolean`	`isOnEdge(ij.process.ImageProcessor ip)` Checks if the blob is on the edge of the image.
`void`	`setCalibration(ij.measure.Calibration cal)`
`static void`	`setDefaultColor(Color defaultColor)` Changes the default blob color.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - DRAW_HOLES
```
public static final int DRAW_HOLES
```
    See Also:
    
    Constant Field Values
  - DRAW_CONVEX_HULL
```
public static final int DRAW_CONVEX_HULL
```
    See Also:
    
    Constant Field Values
  - DRAW_LABEL
```
public static final int DRAW_LABEL
```
    See Also:
    
    Constant Field Values
  - GETFERETDIAMETER
```
public static final String GETFERETDIAMETER
```
    Method name of getFeretDiameter (for filtering).
    
    See Also:
    
    Constant Field Values
  - GETMINFERETDIAMETER
```
public static final String GETMINFERETDIAMETER
```
    Method name of getMinFeretDiameter (for filtering).
    
    See Also:
    
    Constant Field Values
  - GETORIENTATIONMAJORAXIS
```
public static final String GETORIENTATIONMAJORAXIS
```
    See Also:
    
    Constant Field Values
  - GETORIENTATIONMINORAXIS
```
public static final String GETORIENTATIONMINORAXIS
```
    See Also:
    
    Constant Field Values
  - GETELONGATION
```
public static final String GETELONGATION
```
    Method name of getElongation (for filtering).
    
    See Also:
    
    Constant Field Values
  - GETLONGSIDEMBR
```
public static final String GETLONGSIDEMBR
```
    Method name of getLongSideMBR (for filtering).
    
    See Also:
    
    Constant Field Values
  - GETSHORTSIDEMBR
```
public static final String GETSHORTSIDEMBR
```
    Method name of getLongSideMBR (for filtering).
    
    See Also:
    
    Constant Field Values
  - GETASPECTRATIO
```
public static final String GETASPECTRATIO
```
    Method name of getLongSideMBR (for filtering).
    
    See Also:
    
    Constant Field Values
  - GETPERIMETER
```
public static final String GETPERIMETER
```
    Method name of getPerimeter (for filtering).
    
    See Also:
    
    Constant Field Values
  - GETPERIMETERCONVEXHULL
```
public static final String GETPERIMETERCONVEXHULL
```
    Method name of getPerimeterConvexHull (for filtering).
    
    See Also:
    
    Constant Field Values
  - GETCONVEXITY
```
public static final String GETCONVEXITY
```
    Method name of getConvexity (for filtering).
    
    See Also:
    
    Constant Field Values
  - GETSOLIDITY
```
public static final String GETSOLIDITY
```
    Method name of getSolidity (for filtering).
    
    See Also:
    
    Constant Field Values
  - GETENCLOSEDAREA
```
public static final String GETENCLOSEDAREA
```
    Method name of getEnclosedArea (for filtering).
    
    See Also:
    
    Constant Field Values
  - GETAREACONVEXHULL
```
public static final String GETAREACONVEXHULL
```
    Method name of getAreaConvexHull (for filtering).
    
    See Also:
    
    Constant Field Values
  - GETCIRCULARITY
```
public static final String GETCIRCULARITY
```
    Method name of getCircularity (for filtering).
    
    See Also:
    
    Constant Field Values
  - GETTHINNESRATIO
```
public static final String GETTHINNESRATIO
```
    Method name of getThinnesRatio (for filtering).
    
    See Also:
    
    Constant Field Values
  - GETAREATOPERIMETERRATIO
```
public static final String GETAREATOPERIMETERRATIO
```
    Method name of getAreaToPerimeterRatio (for filtering).
    
    See Also:
    
    Constant Field Values
  - GETCONTOURTEMPERATURE
```
public static final String GETCONTOURTEMPERATURE
```
    Method name of getContourTemperature (for filtering).
    
    See Also:
    
    Constant Field Values
  - GETDIAMETERMAXIMUMINSCRIBEDCIRCLE
```
public static final String GETDIAMETERMAXIMUMINSCRIBEDCIRCLE
```
    Method name of getMaximumInscribedCircle (for filtering).
    
    See Also:
    
    Constant Field Values
  - GETFRACTALBOXDIMENSION
```
public static final String GETFRACTALBOXDIMENSION
```
    Method name of getContourTemperature (for filtering).
    
    See Also:
    
    Constant Field Values
  - GETNUMBEROFHOLES
```
public static final String GETNUMBEROFHOLES
```
    Method name of getNumberofHoles (for filtering).
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - Blob
```
public Blob(Polygon outerContour,
            int label)
```
  - Blob
```
public Blob(Polygon outerContour,
            int label,
            ij.measure.Calibration cal)
```
    Parameters:
    
    outerContour - Contur of the blob
    
    label - Its unique label
    
    cal - The blob will use the image calibration
- Method Detail
  - setCalibration
```
public void setCalibration(ij.measure.Calibration cal)
```
  - addCustomFeature
```
public static void addCustomFeature(CustomBlobFeature feature)
```
  - setDefaultColor
```
public static void setDefaultColor(Color defaultColor)
```
    Changes the default blob color.
    
    Parameters:
    
    defaultColor - The default color.
  - evaluateCustomFeature
```
public Object evaluateCustomFeature(String methodName,
                                    Object... params)
                             throws NoSuchMethodException
```
    Evaluates the Custom Feature and return its value
    
    Parameters:
    
    Method - name The method name of the method in the feature class
    
    params - the parameters of the method specified by the method name
    
    Throws:
    
    NoSuchMethodException
  - getOuterContourAsROI
```
public ij.gui.Roi getOuterContourAsROI()
```
    Returns:
    
    Outer contour as traced roi
  - draw
```
public void draw(ij.process.ImageProcessor ip,
                 int options)
```
    Draws the Blob with or without its holes.
    
    Parameters:
    
    ip - The ImageProcesser in which the blob has to be drawn.
    
    options - Drawing Options are DRAW_HOLES, DRAW_CONVEX_HULL, DRAW_LABEL. Combinations with | are possible.
  - draw
```
public void draw(ij.process.ImageProcessor ip)
```
    Draws the Blob with its holes.
    
    Parameters:
    
    ip - The ImageProcesser in which the blob has to be drawn.
  - getCenterOfGravity
```
public Point2D getCenterOfGravity()
```
    Return the geometric center of gravity of the blob. It is calculated by the outer contour without consider possible holes.
    
    Returns:
    
    Geometric center of gravity of the blob
  - getFeretDiameter
```
public double getFeretDiameter()
```
    Calculates the feret diameter of the outer contour
    
    Returns:
    
    The feret diameter of the outer contour.
  - getMinFeretDiameter
```
public double getMinFeretDiameter()
```
    Calculates the min feret diameter of the outer contour
    
    Returns:
    
    The feret diameter of the outer contour.
  - getMoment
```
public double getMoment(int p,
                        int q)
```
    Region-Based Moments Definition of "Gorman et. al. Practical Algorithms for Image Analysis" (p. 157). (computational expensive!)
    
    Parameters:
    
    q - (order = (p + q))
    
    p - (order = (p + q))
    
    Returns:
    
    Region-Based Moments of order (p + q)
  - getCentralMoments
```
public double getCentralMoments(int p,
                                int q)
```
    Central Moments Definition of "Gorman et. al. Practical Algorithms for Image Analysis" (p. 158). (computational expensive!)
    
    Parameters:
    
    q - (order = (p + q))
    
    p - (order = (p + q))
    
    Returns:
    
    Central Moment of Order (p + q)
  - getOrientationMajorAxis
```
public double getOrientationMajorAxis()
```
    Returns:
    
    The Orientation of the Major Axis from the Blob in grad (measured counter clockwise from the positive x axis).
  - getOrientationMinorAxis
```
public double getOrientationMinorAxis()
```
    Returns:
    
    The Orientation of the Major Axis from the Blob in grad (measured counter clockwise from the positive x axis).
  - getEigenvalueMajorAxis
```
public double getEigenvalueMajorAxis()
```
    Calculates Eigenvalue from the major axis using the moments of the boundary
    
    Returns:
    
    Return the Eigenvalue from the major axis (computational expensive!)
  - getEigenvalueMinorAxis
```
public double getEigenvalueMinorAxis()
```
    Calculates Eigenvalue from the minor axis using the moments of the boundary
    
    Returns:
    
    Return the Eigenvalue from the minor axis (computational expensive!)
  - getElongation
```
public double getElongation()
```
    The Elongation of the Blob based on a fitted ellipse (1 - minor axis / major axis)
    
    Returns:
    
    The Elongation (normed between 0 and 1)
  - getMinimumBoundingRectangle
```
public Point[] getMinimumBoundingRectangle()
```
  - getLongSideMBR
```
public double getLongSideMBR()
```
    Returns:
    
    The long side length of the minimum enclosing rectangle
  - getShortSideMBR
```
public double getShortSideMBR()
```
    Returns:
    
    The short side length of the minimum enclosing rectangle
  - getAspectRatio
```
public double getAspectRatio()
```
    Returns:
    
    The aspect ratio of the minimum enclosing rectangle
  - getOuterContour
```
public Polygon getOuterContour()
```
    The outer contour of an object (polygon points are pixel indicies)
    
    Returns:
    
    The outer contour of an object (polygon points are pixel indicies)
  - getOuterContourAsChainCode
```
public int[] getOuterContourAsChainCode()
```
    Calculates the freeman chain code the outer contour
    
    Returns:
    
    The outer contour as freeman chain code
  - getInnerContours
```
public ArrayList<Polygon> getInnerContours()
```
    Return all inner contours (holes) of the blob.
    
    Returns:
    
    Arraylist of the inner contours.
  - getLabel
```
public int getLabel()
```
    Return the label of the blob in the labeled image
    
    Returns:
    
    Return blob's label in the labeled image
  - getPerimeter
```
public double getPerimeter()
```
    Calculates the perimeter of the outer contour using its chain code
    
    Returns:
    
    The perimeter of the outer contour.
  - getPerimeterConvexHull
```
public double getPerimeterConvexHull()
```
    Calculates the perimeter of the convex hull
    
    Returns:
    
    The perimeter of the convex hull
  - getConvexity
```
public double getConvexity()
```
    Returns:
    
    convex hull perimeter/actual perimeter
  - isOnEdge
```
public boolean isOnEdge(ij.process.ImageProcessor ip)
```
    Checks if the blob is on the edge of the image.
    
    Parameters:
    
    ip - The imageprocesser which contains the blob
    
    Returns:
    
    true if the blob is on a edge.
  - getSolidity
```
public double getSolidity()
```
    Returns:
    
    enclosed area / enclosed of the convex hull
  - getConvexHull
```
public Polygon getConvexHull()
```
    Returns the convex hull of the blob.
    
    Returns:
    
    The convex hull as polygon
  - getEnclosedArea
```
public double getEnclosedArea()
```
    Calculates the enclosed are of the outer contour without subsctracting possible holes.
    
    Returns:
    
    The enclosed area of the outer contour (without substracting the holes).
  - getAreaConvexHull
```
public double getAreaConvexHull()
```
    Returns:
    
    Area of the convex hull
  - getCircularity
```
public double getCircularity()
```
    Calculates the circularity of the outer contour: (perimeter*perimeter) / (enclosed area). If the value approaches 0.0, it indicates that the polygon is increasingly elongated.
    
    Returns:
    
    Circularity (perimeter*perimeter) / (enclosed area)
  - getThinnesRatio
```
public double getThinnesRatio()
```
    The Thinnes Ratio of the blob (normed). A circle has a thinnes ratio of 1.
    
    Returns:
    
    Thinnes Ratio defined as: (4*PI)/Circularity
  - getAreaToPerimeterRatio
```
public double getAreaToPerimeterRatio()
```
    Area/Perimeter
    
    Returns:
    
    Area to perimeter ratio
  - getContourTemperature
```
public double getContourTemperature()
```
    Calculates the Contour Temperatur. It has a strong relationship to the fractal dimension.
    
    Returns:
    
    Contour Temperatur
    
    See Also:
    
    in Luciano da Fontoura Costa, Roberto Marcondes Cesar, Jr.Shape Classification and Analysis: Theory and Practice, Second Edition, 2009, CRC Press
  - getFractalBoxDimension
```
public double getFractalBoxDimension(int[] boxSizes)
```
    Box Dimension of the blob boundary.
    
    Parameters:
    
    boxSizes - ordered array of Box-Sizes
    
    Returns:
    
    Calculates the fractal box dimension of the blob.
  - getDiamaterMaximumInscribedCircle
```
public double getDiamaterMaximumInscribedCircle()
```
  - generateBlobImage
```
public static ij.ImagePlus generateBlobImage(Blob b)
```
  - getFractalBoxDimension
```
public double getFractalBoxDimension()
```
    Returns:
    
    The fractal box dimension of the blob.
  - getFractalDimensionGoodness
```
public double getFractalDimensionGoodness()
```
    The goodness of the "best fit" line of the fractal box dimension estimation.
    
    Returns:
    
    The goodness of the "best fit" line of the fractal box dimension estimation.
  - getNumberofHoles
```
public int getNumberofHoles()
```
    The number of inner contours (Holes) of a blob.
    
    Returns:
    
    The number of inner contours (Holes) of a blob.

Class Blob

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

DRAW_HOLES

DRAW_CONVEX_HULL

DRAW_LABEL

GETFERETDIAMETER

GETMINFERETDIAMETER

GETORIENTATIONMAJORAXIS

GETORIENTATIONMINORAXIS

GETELONGATION

GETLONGSIDEMBR

GETSHORTSIDEMBR

GETASPECTRATIO

GETPERIMETER

GETPERIMETERCONVEXHULL

GETCONVEXITY

GETSOLIDITY

GETENCLOSEDAREA

GETAREACONVEXHULL

GETCIRCULARITY

GETTHINNESRATIO

GETAREATOPERIMETERRATIO

GETCONTOURTEMPERATURE

GETDIAMETERMAXIMUMINSCRIBEDCIRCLE

GETFRACTALBOXDIMENSION

GETNUMBEROFHOLES

Constructor Detail

Blob

Blob

Method Detail

setCalibration

addCustomFeature

setDefaultColor

evaluateCustomFeature

getOuterContourAsROI

draw

draw

getCenterOfGravity

getFeretDiameter

getMinFeretDiameter

getMoment

getCentralMoments

getOrientationMajorAxis

getOrientationMinorAxis

getEigenvalueMajorAxis

getEigenvalueMinorAxis

getElongation

getMinimumBoundingRectangle

getLongSideMBR

getShortSideMBR

getAspectRatio

getOuterContour

getOuterContourAsChainCode

getInnerContours

getLabel

getPerimeter

getPerimeterConvexHull

getConvexity

isOnEdge

getSolidity

getConvexHull

getEnclosedArea

getAreaConvexHull

getCircularity

getThinnesRatio

getAreaToPerimeterRatio

getContourTemperature

getFractalBoxDimension

getDiamaterMaximumInscribedCircle

generateBlobImage

getFractalBoxDimension

getFractalDimensionGoodness

getNumberofHoles