Measurements Viewer#
The Measurements Viewer lets you measure the images and objects in your project, summarize the results in tables, and visualize them in plots. It operates on every image/object of the chosen Kind, so no selection is needed in the Project Viewer: click Measure at the top of the Project Viewer to open it.
Table Creation and Measurement Selection#
1. Create Table
Click Add Table, then choose one of the project’s Kinds. Each table measures all of the items belonging to that Kind (the Image kind measures whole images). Tables appear as tabs along the top of the viewer, and can be renamed or deleted from their tab.
2. Object Measurements
Geometry measurements performed on the object masks. They are not available for the Image Kind.
Area: The area of the annotation mask.
Bounding-Box Area: The area of the annotation’s bounding box.
Perimeter: The perimeter of the annotation mask.
Extent: The ratio of mask area to bounding-box area.
Equivalent Diameter: The diameter of a circle whose area is equal to the area of the annotation.
Diameter of Equal Perimeter (PED): The diameter of a circle whose perimeter is equal to that of the annotation.
Radius: The radius of the annotation.
Sphericity: How close the annotation is to a perfect circle. Ranges from 0 (irregular) to 1 (circular).
Compactness: How compact the object is. A circle is the most compact, with a value of 1; the value increases as the shape becomes more irregular.
Center of Mass (X, Y): The coordinates of the object’s center of mass.
3. Intensity Measurements
Performed on whole images, as well as on the image crops of annotated objects:
Total: The cumulative sum of the pixel intensities.
Mean and Median: The mean and median pixel intensity.
Std: The standard deviation of the pixel intensities.
MAD: The median absolute deviation of the pixel intensities.
Min Value and Max Value: The lowest and highest pixel intensity.
Lower Quartile and Upper Quartile: The intensities below which 25% and 75% of the pixels fall.
Tick a group to select all of its measurements, or expand it to pick individual ones.
Table View#
Table Tabs: Switch between the measurement tables you have created.
Table | Plot View: Switch between the data grid and the measurement plots.
Export: Download the table as a
.csvfile (or, in the plot view, save the plot as a.png).Split Options: Choose how the measurements are grouped (see below).
Data Grid: One row per measurement, with:
Count: The number of items measured.
Mean, Median and Std Dev: Statistics over those items.
Split Options#
By default the statistics are computed over every item in the Kind. Use the Split Options to break them down by one or more dimensions:
Category: The category of each item.
Partition: The training partition of each item (training, validation, or unassigned).
Image: The image an object belongs to (for object Kinds).
Drag a dimension from Available Dimensions into Column Grouping to create a pivot table with one set of columns per value. The order of the dimensions matters: the first dimension is the outermost grouping. Drag a dimension back to remove it.
Plot View#
1. Plot Controls
Plot: The type of plot: Histogram, Scatter, or Beeswarm.
Color Theme: The color scheme of the plot.
X-axis / Y-axis: The measurements used for each axis.
Size: The measurement used for the size of the marks.
Color: The split (category or partition) used to color the marks.
Number of Bins and Show Bin Label: Histogram options.
Swarm Group: The split (category or partition) used to group a beeswarm plot.
Plot Name |
Color Theme |
x-Axis |
y-Axis |
Size |
Color |
Num. Bins |
Swarm Group |
|---|---|---|---|---|---|---|---|
Histogram |
Configurable |
Configurable |
N/A |
N/A |
N/A |
Configurable |
N/A |
Scatter |
Configurable |
Configurable |
Configurable |
Configurable |
Configurable |
N/A |
N/A |
Beeswarm |
Configurable |
N/A |
Configurable |
Configurable |
N/A |
N/A |
Configurable |
2. Plot
Displays the current plot.
3. Plot Tabs
Switch between multiple plots. Click the + at the end of the tab bar to create a new plot, click a tab’s title to rename it, and use the x to remove it.
4. Save Plot
Save the current plot as a .png file.