Measurements#

While sometimes, the goal of an experiment is just to find objects or to classify images and/or objects, other times, we want to go deeper and learn more about the images and/or objects we care about. This is where Measurements come in.

Right now, Piximi supports two broad classes of measurements - intensity measurements, which work for images OR objects, and shape/geometry measurements, which work for objects alone. More categories of measurements will be rolling out in time - stay tuned!

Measurements are available from the Measurements icon in the top bar of Piximi.

Measurements are created in individual tables - each table is specific to one “kind” - either images or a type of segmented object (such as cells). You can create as many tables as you like. Each table has measurements broken down by Splits - essentially, what are the different conditions in this experiment (if any) and how should we parse them? Each table has its own set of splits, which you can adjust at any time.

Creating Measurements in Piximi#

  1. Click the Measurements icon in the top bar of Piximi.

  2. Click the + button next to the word Tables to create a new measurement table. You can make as many tables as you like, to express different images or objects, broken down by different subsets.

_images/measure-00-pre-measurement.png

Fig. 11 The + button at the top of the Tables menu allows you to add a new table#

  1. Select a kind you’d like to make measurements of. Reminder, kinds include the images, as well as any objects you created via segmentation or annotation.

_images/measure-01-create-table.png

Fig. 12 Select what kind of measurement table you’d like to make#

  1. Piximi will begin to calculate metrics in the background. Depending on the number of examples present in that kind, this may take a few minutes - an indicator will show you the progress made.

_images/measure-02-spin-while-creating-table.png

Fig. 13 The circular indicator next to Tables indicates how far through measurement generation Piximi is. Make sure to keep the Piximi window open (consider moving it into its own tab) to let calculations continue!#

  1. Once the initial pre-calculations are done, you can select which measurements you’d like to make, as well as how you’d like to subset “split” the data (currently by Category or by Partition; if you only have one category, tha’s fine, but you do have to click something here!). As before, this will take some time, so just leave the Piximi tab open and the circular indicator will let you know how long this is going to take.

_images/measure-03-select-splits-and-measurements.png

Fig. 14 Select the split or splits you want to measure for each table, as well as the measurements you want for that table. Just like during table creation, a circular indicator next to the word Measurements will tell you how far along Piximi is at generating your measurements.#

  1. Once your measurements have been generated, they will appear in the main area in a data grid! In the grid, you can see the measurement name, the subset (or Split) of the data represented, and the Mean, Median, and Standard deviation of the data for that feature in that subset.

_images/measure-04-data-grid.png

Fig. 15 The Piximi data grid#

  1. If you’d like to plot data in Piximi, simply navigate to the data grid containing the data you want to plot and hit the Plots tab at the top. You can make as many plots as you would like by hitting the + button on the plots tab. Plots can also be exported by saving to PNG. Piximi includes several plot types, including scatter plots, swarm plots, and histograms.

_images/measure-05-scatter.png

Fig. 16 Scatter plots generated in Piximi can have X, Y, and Size measurements selected; they can also show colors according to the selected splits (with many colormaps to choose from). Note the “Save to PNG” button in the bottom right!#

_images/measure-06a-swarm-no-category.png

Fig. 17 Swarm plots can be shown on their own…#

_images/measure-06b-swarm-with-category.png

Fig. 18 … or with a summary boxplot overlaid.#

_images/measure-07-histogram.png

Fig. 19 You can choose to represent your data as a histogram, with a custom number of bins.#

If you want to do further analyses of your data (and you should)!, you can export your data tables from the measurements menu - this will let you do whatever downstream analysis you like.

_images/measure-08-export-measurements.png

Fig. 20 Piximi lets you export your data to outside programs#