> For the complete documentation index, see [llms.txt](https://docs.biodock.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.biodock.ai/analysis-and-results/editing-objects-qc.md).

# Editing objects (QC)

*What you'll get: how to fix wrong, missing or merged objects in a result with the object editor, and how to apply your edits so the dashboard and exports use them.*

Open the result and click the **Edit objects** tab. The editor needs a desktop or laptop screen. Not every result has this tab: AI-assisted analyses and results that open the classic dashboard don't.

Edits change **this result only**. To teach the model not to make the same mistake again, see [Correcting results to improve your model](https://docs.biodock.ai/analysis-and-results/correcting-results-to-improve-your-model.md).

## The editor

<figure><img src="https://3806122466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fk3DfNQKoMy1JXdaDLvpG%2Fuploads%2Fgit-blob-7c8091cf0704697e80480f656e07e2647b3ab37d%2Fdocs-results-edit-objects-overview.png?alt=media" alt="The object editor: the image fills the screen, the tool rail at the top left, the top bar with the image stepper and Apply edits, and the inspector on the right with classes, Channels and Edits on this image"><figcaption><p>The tool rail on the left, the top bar above, and the inspector on the right.</p></figcaption></figure>

* **Top bar**: the back arrow, the image stepper (**‹ 2 / 3 ›**) and image list, undo and redo, the keyboard shortcuts (**?**), the tour, where applying stands, and the **Apply** button.
* **Tool rail** at the top left of the image: **Select**, **Box select**, **New object**, **AI select**, **Edit area**, **Split**, and **Pick** (only when the result has more than one class). **Pick** limits your clicks and boxes to one class, so you can select objects of that class where classes overlap.
* **Selection bar** at the bottom of the image while objects are selected.
* **Inspector** on the right: each class with its count in this image and an eye to show or hide it, the **Channels** settings for brightness and contrast, and **Edits on this image**.

The first time you open the editor, a few short slides explain it. The tour button in the top bar walks you through it again.

## Delete a wrong object

<figure><img src="https://3806122466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fk3DfNQKoMy1JXdaDLvpG%2Fuploads%2Fgit-blob-7cd8972aa30f6e01e9493e1e4d16e7b8b6297eb7%2Fdocs-results-edit-delete-apply.gif?alt=media" alt="Click a wrong outline, click Delete in the selection bar, click Apply 1 edit in the top bar, click Apply 1 edit in the popover, the top bar shows Applying edits"><figcaption><p>Click the object → <strong>Delete</strong> → <strong>Apply 1 edit</strong>.</p></figcaption></figure>

1. Click the object. Cmd/Ctrl + click adds more objects to the selection, and **Box select** (**B**) selects every object in a box you drag.
2. In the selection bar, click **Delete**, or press Delete or Backspace.
3. When you are done editing, apply your edits (see [Apply your edits](#apply-your-edits)).

The selection bar also has the object's class (click it to change the class), **Edit area**, **Merge** (with two or more objects selected) and **Hide**.

## Add a missed object

* **Trace it:** click **New object** (or press **N**). With several classes, it asks which class; **1**–**9** draws an object of that class. Trace the outline on the image, then press **Enter** or click **Done** to save it and start the next one. **Cancel** stops.
* **Let the AI draw it:** click **AI select** (or press **S**), then click the object. Click outside the outline to grow it, or inside to trim it, then press **Enter** or click **Done**. The drawing bar switches between **AI click** and **Trace**.

## Fix an outline

<figure><img src="https://3806122466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fk3DfNQKoMy1JXdaDLvpG%2Fuploads%2Fgit-blob-ccc5a3daf8e4239d97402fab5f995d411b880926%2Fdocs-results-edit-area.gif?alt=media" alt="Click an object, click Edit area, paint with Add over a missed edge, switch to Erase and paint over a part that spills out, click Save area"><figcaption><p><strong>Edit area</strong> → paint with <strong>Add</strong> or <strong>Erase</strong> → <strong>Save area</strong>.</p></figcaption></figure>

1. Click the object to select it.
2. Click **Edit area** (or press **E**).
3. Paint on the image with **Add** to add to the object, or **Erase** to cut from it. **A** and **M** switch between them. Hold **Space** to pan.
4. Click **Save area**, or **Discard** to throw the change away.

Two more tools fix common mistakes:

* **Split** (**X**) cuts one selected object in two: drag a line across it, edge to edge, then click **Split**.
* **Merge** (**G**) joins two or more selected objects of the same class into one.

Undo (Cmd/Ctrl + **Z**) takes back the most recent edit on the image you are on, and redo brings it back.

## Apply your edits

Your edits are saved as you make them, so you can stop and come back later. Until you apply them, they are **pending**: the dashboard, exports and the API still show the old objects. The top bar shows how many edits are not applied.

1. Click **Apply N edits** in the top bar.
2. If there are edits on this image and on others, choose **All images with edits** or **This image only**.
3. Click **Apply N edits** in the popover.

Biodock recalculates the measurements of the edited images in the background. The editor stays open, and the top bar shows **Applying edits · N%**. When it finishes, you'll see **Edits applied. The dashboard is up to date.**, and the top bar shows **Last applied …**. If applying fails, the top bar shows **Applying failed**, your edits stay pending, and the button becomes **Retry apply**.

On the **Dashboard** tab, the image viewer shows **Recalculating objects…** with a percentage while this runs, then **Applied edits successfully** (or **Applying edits failed**).

If you leave the editor with pending edits, you can choose **Keep editing**, **Leave for later** (the edits stay pending) or **Apply**.

{% hint style="warning" %}
Applying edits rewrites the results: object counts and measurements change, and result columns can appear or disappear. An export made before the edits no longer matches. There is no undo after edits are applied; to revert, edit the objects back and apply again.
{% endhint %}

{% hint style="info" %}
On images with more than 250,000 objects, editing may be limited to a few classes. The editor tells you which classes to pick.
{% endhint %}

## Keyboard shortcuts

Press **?** in the editor to see them all. They don't fire while you are typing in a field or while a dialog is open.

**Select**

* **V**: select tool (click an object, drag to pan)
* **B**: box select (drag over an area)
* **Cmd** (Mac) / **Ctrl** (Windows) + click: add or remove one object
* **Cmd** / **Ctrl** + drag: box select with any tool
* **Esc**: clear the selection, or stop drawing

**Edit**

* **N**: draw a new object
* **S**: AI select (click a missed object to outline it)
* **1**–**9**: draw a new object of that class
* **E**: edit the area of the selected object
* **A** / **M**: add to or cut from the area
* **Enter**: save the outline or area
* **X**: split the selected object along a line
* **G**: merge the selected objects into one
* **H**: hide the selection while you work
* **Backspace** / **Delete**: delete the selection
* **Cmd** / **Ctrl** + **Z**: undo the last edit on this image
* **Shift** + **Cmd** / **Ctrl** + **Z**, or **Cmd** / **Ctrl** + **Y**: redo

**View**

* **Space** (hold): pan while drawing
* **Shift** (hold): hide the outlines
* **O**: show or hide all objects
* **\[** / **]**: previous or next image


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.biodock.ai/analysis-and-results/editing-objects-qc.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
