MeasureShape#
Measure the form of each detected colony.
Parameters and usage: MeasureShape.
One row per: detected colony
Written to:
deliverables/measurements.csv(every operation, with your metadata joined) anddeliverables/measurements_by_feature/MeasureShape.csv, each with a.parquetbeside itColumns: 8
SHAPE#
Changed in version 0.20.0: Colony size magnitudes moved from SHAPE to
SIZE: MeasureSize
is now their only source, and MeasureShape
emits form descriptors only. The radius columns were rebuilt so each name
matches its value. Retired columns are not aliased, and stores written by
earlier versions keep their old column names. A run started before 0.20.0
must be re-run with --overwrite, not resumed. Resuming reuses the
images it already finished, with their old column names.
Retired column |
Successor |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
New columns: Size_MedianRadius, Size_MeanRadius,
Size_RobustMeanRadius and Size_MaxRadius, all measured from one
center, the centroid of the distance-transform peak.
Same name, different value: Size_MedianRadius, Size_MeanRadius
and Size_MaxRadius are not the retired Shape_MedianRadius,
Shape_MeanRadius and Shape_MaxRadius. Compare old data against the
successor in the table above (identical except for colonies touching
another colony or the image border, which now measure to that edge),
never against the same-named Size_ column.
Model outputs are named by the stripped label, so <Model>_MaxRadius_*,
<Model>_MeanRadius_* and <Model>_MedianRadius_* fitted before and
after 0.20.0 share a name but not a meaning.
Column |
Description |
Type |
|---|---|---|
|
Calculated as \(\frac{4\pi*\text{Area}}{\text{Perimeter}^2}\). Measures how closely a colony approximates a perfect circle (value = 1). Values < 1 indicate irregular colony morphology, which may result from genetic mutations, environmental stress, or mixed microbial populations on agar plates. |
|
|
Measure of colony elongation, ranging from 0 (perfect circle) to 1 (highly elongated). Values near 0 indicate compact, radially symmetric growth typical of healthy bacterial colonies, while higher values may suggest directional growth, motility, or environmental gradients on the agar surface. |
|
|
Ratio of actual colony area to its convex hull area (Area/ConvexArea). Values near 1 indicate compact, solid colonies with minimal indentations. Lower values (< 0.9) may indicate invasive growth, colony spreading, or the presence of clearing zones around colonies. Can slightly exceed 1, because the hull passes through pixel centers. |
|
|
Ratio of colony area to its bounding box area (ObjectArea/BboxArea). Measures how efficiently the colony fills its allocated space. Compact colonies have higher extent values, while spread-out or irregular colonies have lower values. |
|
|
Calculated as \(\frac{\text{Perimeter}^2}{4\pi*\text{Area}}\). Inverse of circularity (ranges from 1 for perfect circles to higher values for irregular shapes). Measures colony shape complexity - compact, circular colonies have values near 1, while irregular or filamentous colonies have much higher values. |
|
|
Angle (in radians) between the colony’s major axis and the horizontal axis. Measures colony alignment and growth directionality. Random orientations are typical for most bacterial colonies, while consistent orientations may indicate environmental gradients or mechanical stresses during plating. |
|
|
Mean Euclidean distance from each colony pixel to the nearest background pixel, computed on the object in isolation. This is a measure of interior thickness, not a radius: for an ideal disk of radius R it equals \(R/3\), one third of Size_InscribedRadius. Thin appendages on a compact body (runners, a hyphal fringe) pull that ratio below 1/3; a uniformly thin, elongated colony raises it toward 1/2. The image border counts as an edge. |
|
|
Median Euclidean distance from each colony pixel to the nearest background pixel, computed on the object in isolation. This is a measure of interior thickness, not a radius: for an ideal disk of radius R it equals \(R(1 - 1/\sqrt{2}) \approx 0.293R\). More robust to boundary raggedness than MeanBoundaryDist. See Size_RobustMeanRadius and Size_MaxRadius for the colony’s radial extent. The image border counts as an edge. |