> For the complete documentation index, see [llms.txt](https://docs.nimbusimage.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nimbusimage.com/documentation/analyzing-image-data-with-objects-connections-and-properties/interacting-with-objects.md). # Interacting with objects One of the main advantages of working in NimbusImage is the ability to directly interact with your objects. This interactive approach allows you to quickly refine your analysis by removing incorrect objects, adding missing ones, and organizing them with tags—all within the same interface. ## Selecting and manipulating objects

To interact with objects in your dataset: * **Shift-drag** across objects to select multiple objects at once * Once selected, a popup menu appears with several options: * **Delete selected** - Remove the selected objects * **Delete unselected** - Keep only the selected objects and remove all others * **Tag selected** - Add or change tags for the selected objects * **Color selected** - Apply custom colors to the selected objects * **Copy selected IDs** - Copy the object IDs to clipboard for reference

{% hint style="info" %} The selection tool is particularly useful for cleaning up results from automated segmentation. You can quickly remove falsely identified objects or select groups of objects to apply a consistent tag. {% endhint %} ## Object browser and filtering The Object Browser provides powerful tools for managing which objects are visible in your view:

The Filters panel shows options for showing and hiding particular tags, plus property-value and advanced filters

Key features include: * **Tag filtering** - Filter objects by their tags (e.g., "nucleus" or "Brightfield blob") * **Tag match options** - Choose if objects should match "Any" or "All" of the selected tags * **Current frame only** - When enabled, shows only objects in the currently displayed time frame in the object list (helpful for time-lapse data) * **Show annotations from hidden layers** - By default, annotations remain visible even when their corresponding layer is hidden; toggle this off to hide annotations when their layer is hidden ### Advanced filtering options The Object Browser offers three powerful filtering mechanisms: 1. **Property value filter** - Filter objects based on measurements like area, intensity, or other computed properties 2. **Annotation ID filter** - Find specific objects by their unique IDs 3. **Region filter** - Draw a region of interest and show only objects within that area These filters can be combined to precisely target objects meeting multiple criteria. ### Filtering by text-valued properties Some properties hold text rather than numbers — for example, a gene name or genotype assigned to each cell. When you add a property filter for one of these, the filter automatically switches from a numeric range to a **value picker**: * **Search box** — type to narrow the list of values; press Enter to add the exact (or top) match. * **Value list** — every distinct value with the number of objects that have it, most common first. Click values to select them, or use **Select N shown** to add everything that matches your search. * **Chips** — selected values appear as removable chips; **Clear** removes them all. An object passes the filter if its value matches **any** of the selected values. A new text filter starts with nothing selected, which lets every object through. Properties with very many distinct values (more than 20,000) are searched on the server instead of locally. ## Annotation list The Annotation List provides a detailed tabular view of all objects in your dataset:

The annotation list shows all your objects

The list offers several useful features: * **Customizable columns** - Show or hide information like Annotation ID, Index, Shape, Tags, XY coordinates, Z position, and Time * **Sorting** - Click any column header to sort by that property * **Navigation** - Click on any row to navigate directly to that object in the image viewer * **Bulk actions** - Select multiple objects using the checkboxes and perform actions like deletion or tagging * **Pagination** - For datasets with many objects, navigate through pages with the pagination controls (10, 50, 100, or 200 objects per page) {% hint style="info" %} For very large datasets (hundreds of thousands of objects or more), NimbusImage loads annotations lazily and handles the list on the server so everything stays responsive. See [Working with large annotation datasets](/documentation/analyzing-image-data-with-objects-connections-and-properties/large-annotation-datasets.md). {% endhint %} ### Montage view The montage view shows the objects on the Object Browser's current page as a grid of image crops, one panel per object — a quick way to eyeball every cell that passed a filter, or every object at the top of a sorted column. Open it with the grid button next to the 3D toggle, or with "Open montage view" in the [command palette](/documentation/viewing-your-data.md#command-palette). It appears over the image viewer, and the other panels stay usable beside it. The montage follows the Object Browser exactly: the same filters, sort order, and page. To see more objects at once, raise the page size (up to 200) or step through pages. * **Crops** — each panel shows the object's bounding box plus adjustable padding, at the object's own XY position, Z slice, and time point, using your current layers and contrast settings. Point objects are shown using the padding alone. * **Scale** — **Same scale** (default) shows every object at one magnification so sizes are comparable; **Fit each** zooms each panel to fill its frame. * **Labels** — each panel shows the object's number (its Index in the list), plus any property values you choose to display. * **Interaction** — click a panel to toggle that object's selection; use the panel's "go to" button to navigate to the object in the viewer (which closes the montage). Hovering a panel highlights the object in the list and the image. * **Export PNG** — save the whole montage, labels included, as a single image. The montage closes when you switch datasets or enter 3D view. ## Finding and showing measurements The Object Browser has three tabs — **Objects**, **Measurements**, and **Connections** — and the first two both give you access to your computed properties without opening a separate dialog. ### The measurements chip strip Above the object list on the Objects tab, a strip of chips shows one chip per computed property, each with an eye icon and a `shown / total` count. Click a single-value property's chip to toggle its column in the list; click a multi-value property's chip to open a compact checklist of its individual values, with Show all and Hide all. A filter box in the strip matches both property **and** value names, so typing a gene name or a metric name surfaces it directly and narrows the chips' checklists to the match. A pinned **"+ New measurement…"** chip creates a property without leaving the panel. The strip is capped at about three rows and scrolls beyond that, so a dataset with many properties can't take over the panel. ### The Measurements tab The Measurements tab lists every property — including ones you haven't computed yet — with value counts, "N shown" badges, per-value show/hide checkboxes, and a **Run** button per property so you can compute one without going through the Measure dialog. Compute errors and warnings appear here as alerts. ## Coloring objects by a property value Beyond showing measurements as numbers, you can color your objects by them. Use the **Color objects by property** button in the app bar, or the annotation list's **More Actions → Color by Property…**, and pick a computed property — including a nested path such as a per-channel mean. Every object in the dataset then takes its color from its value, and a legend appears in the viewer explaining the mapping. You can color either way: * **Continuous** — values map onto a colormap ramp * **Categorical** — each distinct value gets its own color from a palette {% hint style="info" %} Continuous ramps span the 1st–99th percentile of your values by default rather than the full minimum-to-maximum extent. Real measurements often have a few extreme outliers, and stretching the ramp across them collapses everything else into one indistinguishable color. The legend still reports the true extent and marks the clipped ends with `≤` and `≥`. {% endhint %} Two things worth knowing: * Objects created after you apply a coloring, and property values you recompute afterwards, don't re-color automatically. Re-apply the coloring to refresh it. * Applying any other coloring — for example, coloring a selection by hand — retires the legend, since it no longer describes what you're looking at. ## Working with properties Properties allow you to measure features of your objects. These measurements can be displayed alongside your objects and used for filtering:

The Measure objects panel: create new properties on the left, and manage the properties already computed for your objects on the right

From the Properties panel, you can: * **View available properties** - See what measurements are available for each object type * **Show in list** - Select which properties should appear in the Annotation List * **Use as filter** - Enable properties to be used for filtering in the Object Browser * **Measure objects** - Create new properties by applying different measurement algorithms to your objects {% hint style="info" %} Press "t" while viewing your image to show property values directly on the objects themselves, making it easy to visualize measurements in context. {% endhint %}