> For the complete documentation index, see [llms.txt](https://docs.earthindex.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.earthindex.ai/search/deep-search.md).

# Deep Search

Run a Deep Search on your labelled area, set its minimum confidence, and review the detections it returns.

Deep Search learns from your labels, then scores every tile in your area of interest. A detection is a 320 m tile that scores above the minimum confidence you set.

## Before you start

* You have Full Access. With Open access the **Deep Search** tab is greyed out. To request Full Access, see [Create an account](https://docs.earthindex.ai/get-started/account.md).
* You have searches left this month. Full Access includes 30 per month. A search counts when you start it, even if you cancel it or it fails.
* The layer you are viewing has at least 10 positive and at least 1 negative [label](https://docs.earthindex.ai/search/label-tiles.md). Predictions do not count.

## Steps

1. Open your project and the layer you want to search.
2. In the Predictions panel, click the **Deep Search** tab.
3. If the panel shows a warning, add the labels it asks for.
4. Set **Minimum Confidence** with the slider. It runs from 1% to 99% and starts at 85%. The search returns only tiles that score above this value.

   ![The Deep Search tab with the minimum confidence slider and the Run button.](https://182773137-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIQB2eToY1Iv2IH6cERjn%2Fuploads%2Fgit-blob-6f721137652c5a62bbd6c241c07b47adc11069b5%2Fdeep-search-tab.jpg?alt=media)

   ![The minimum confidence slider moved to a lower value.](https://182773137-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIQB2eToY1Iv2IH6cERjn%2Fuploads%2Fgit-blob-69c67a8c27e9da776b82f08b24cbe3fce2bbaaba%2Fminimum-confidence.jpg?alt=media)
5. Optional: tick **Skip Random Negatives**. By default the search adds extra negative examples that it picks at random from your area, on top of your own negative labels. If you tick the box, it learns from your negative labels only. See [Why negatives matter](https://docs.earthindex.ai/improve-your-results/why-negatives-matter.md).
6. Click **Run Predictions**.
7. Wait for the search to finish. You can leave and come back.
8. To cancel a running search, click the X at the right end of the **Running Deep Search...** bar. This removes the search from the project.

## Read the results

While the search runs, the panel shows the time elapsed and its stage: Starting, Training, Evaluating, then Finalizing. It takes several minutes. Then **Results** appears and the detections show on the map. A project keeps one Deep Search result at a time.

* **Filter by Confidence:** drag the ends of the range slider, which is drawn over a histogram with **Low** and **High** at its ends. The map, the list and the count update when you stop dragging. Your range is saved with the project.
* **Count:** the figure at the bottom, such as `1,234 Predictions`, is the number of detections in your range. The slider starts at your **Minimum Confidence**, because the search kept nothing below it.
* **Detections tab:** it shows unlabelled tiles in your range. Click a tile to move the map to it. Click its positive or negative button to label it, and it leaves the list. The sort control switches between **High to Low** and **Low to High**.
* **Summary tab:** it shows **Completed**, **Runtime**, **Detections** (the number the search returned) and **Min Confidence**.
* **Map:** hover over an outlined detection to see its confidence and its MGRS tile, a square of about 100 km on a side (see the [Glossary](https://docs.earthindex.ai/reference/glossary.md)). The **Deep Search Predictions** switch in **Map Layers** shows or hides detections.

![The Summary tab with the details of the Deep Search run.](https://182773137-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIQB2eToY1Iv2IH6cERjn%2Fuploads%2Fgit-blob-6ae935470dfd955e1c7caa9458171a16ef0de861%2Fsummary.jpg?alt=media)

![Deep Search results: confidence range slider with histogram, detections tab and tile list.](https://182773137-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIQB2eToY1Iv2IH6cERjn%2Fuploads%2Fgit-blob-b4687dd433df6df4a21554674e9839fe278776ba%2Fdetections.jpg?alt=media)

To use the results outside Earth Index, open **Download project** in the top bar and tick **Deep Search results**. To remove the results and run a new search, click the X next to **Results**, then click **Clear Results**.

A search returns up to 100,000 detections and keeps the most confident ones. No single MGRS tile contributes more than 20,000. See [Limits and quotas](https://docs.earthindex.ai/reference/limits-and-quotas.md).

## If something goes wrong

| Symptom                                                                                                                            | Fix                                                                                                                                                     |
| ---------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| The **Deep Search** tab is greyed out.                                                                                             | Open access does not include Deep Search. Request Full Access (see [Create an account](https://docs.earthindex.ai/get-started/account.md)).             |
| **Run Predictions** is disabled, with a warning such as "Add at least 10 positive labels and 1 negative label to run deep search." | The layer needs at least 10 positive and 1 negative label. Add the labels the warning names to that layer.                                              |
| A yellow message says "quota exceeded: maximum deep searches per month limit reached (30)".                                        | You used all 30 searches this month. See [Limits and quotas](https://docs.earthindex.ai/reference/limits-and-quotas.md).                                |
| A message says "Deep search error", and the panel returns to the setup form.                                                       | Run the search again. If it keeps failing, report it (see [Create an account](https://docs.earthindex.ai/get-started/account.md)).                      |
| The panel adds "Looks like we're currently experiencing higher than usual demand."                                                 | Training took more than 30 seconds. The search continues. Wait for it.                                                                                  |
| The slider and tabs have not appeared.                                                                                             | The results are still downloading ("Loading detections..."). If you see "Failed to load deep search detections. Please try again.", reload the project. |
| The results are gone.                                                                                                              | **Clear Results** removes them. Run a new Deep Search.                                                                                                  |
| The slider will not go lower.                                                                                                      | Clear the results and run a new search with a lower **Minimum Confidence**. It counts toward your 30 per month.                                         |
| The list has fewer detections than the **Summary** tab.                                                                            | The list hides tiles outside your range and tiles you already labelled. Widen the range.                                                                |

## Related

* [Quick Search or Deep Search](https://docs.earthindex.ai/improve-your-results/quick-vs-deep-search.md)
* [Why negatives matter](https://docs.earthindex.ai/improve-your-results/why-negatives-matter.md)
* [Limits and quotas](https://docs.earthindex.ai/reference/limits-and-quotas.md)
