Path 1: AI-assisted analysis

Want to fully automate your analysis to batch run on many images? Follow that tutorial here instead. This tutorial involves some amount of manual work to get to your results.


AI-assisted analysis is the fastest way to get to quantitative results for small image sets. However, as there is still a manual-edited portion, it may not be suitable for analyses that have too many objects, such as:

  • Large batches of images with many objects per image

  • Segmenting out small objects like cells on whole-slide images


1. Upload images

If you already have uploaded files, you can skip this step.

Navigate to Files from the left sidebar, and press Upload. You'll be able to upload from your computer, or import from a third party (even S3). This will take a second to upload and process into files.

2. Start the analysis

Once your files are uploaded, go to AI Analysis on the left sidebar, and click Start a new analysis run. Then choose AI-assisted, and choose the files that you uploaded. Then press Start. This should open you into an AI-assisted analysis window.

3. Label

Your labeling tools and how to use them

Select your first class on the left toolbar. Once you click, you will have three different tools you can toggle between by clicking them: AI Detect, AI Select, and Pen. You'll also now be in drawing mode, so you will now need to hold Space to be able to pan across your image.

AI Detect is the fastest, and you should use it unless it isn't working well for you, filling in the gaps with AI Select. The Pen is the slowest, and should be used if AI Select is not working for you. AI Detect is only applicable to object classes.

AI Detect might not work well for harder images - in these cases, you may need to use AI Select heavily. We'll be improving AI Detect over time.

To use AI Detect on a tile, drag a tight box around one example of your object, using the crosshairs to help you. AI will locate the position of similar-looking objects, and also segment them.

Using the filters

After you use AI detect, you'll need to filter the results, using the sliders. The confidence score slider controls the model score threshold at which objects are filtered out. Drag higher to get fewer labels, and lower to get more labels.

The size range slider has a minimum and maximum upper bound. You can filter out or include larger or smaller objects using these ranges.

Other settings you might use for labeling

You might need to switch images, add images, configure classes, or adjust your brightness/contrast settings. Find the instructions for those below.

Changing class color

You can also choose from different colors to represent the class. Simply click the colored circle to open up a color picker.

Changing the name or deleting a class

Hover over the class to reveal the 3 dots button, which you can click. From there, use the dropdown to rename or delete a class. If you delete a class, every object created for that class will be deleted as well.

Add a new class

Click the + button next to your size group on the left sidebar to add a new class. You might need to add a new size group if your new class represents an object that is of significantly different size or a different segmentation type.

4. Quantify your labeled objects

Submit for analysis

Once you've labeled all of your objects of interest, you can quantify them. Don't worry, you'll be able to add more objects later and re-quantify.

Click the Quantify objects button, to open up your configuration window.

<Image of choose metrics + hierarchies>

On this window, you can choose the metrics you'd like to quantify, including channel intensities and morphological characteristics. Choosing more metrics can lead to slower processing. Then, press submit.

Interpreting your results

You're done and ready to look at your results! View the Results dashboard overview to understand this page.

Last updated