> 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/monthly-search-beta/monthly-monitor.md).

# Run and compare months

Run your Monthly Search (monitoring) detector on a chosen month, read the results on the map, compare two months, and download a month's detections.

{% hint style="warning" %}
Monthly Search is in beta.
{% endhint %}

The **Monthly Search** tab is where you run your detector on one month of imagery at a time and look at what it finds. You can then compare months and download detections.

## Before you start

* Your detector has left the **Test** step, by passing or skipping it. Until then the **Monthly Search** tab is not available. See [Build a detector](https://docs.earthindex.ai/monthly-search-beta/set-up-monthly-search.md).
* You can run any complete month from January 2024 to the latest month that has ended.
* Allow several minutes per month, depending on the size of your area.

## Steps

1. Click the **Monthly Search** tab. The panel is titled "Run your detector on different months".

   ![The Monthly Monitor chapter with the month run controls.](https://182773137-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIQB2eToY1Iv2IH6cERjn%2Fuploads%2Fgit-blob-5c0be84249c0b6bf2a23037e6c774eec6e1c168e%2Fmonthly-monitor.jpg?alt=media)
2. Under **Choose month to run**, open the month picker and select a month. Months are grouped by year. The legend shows **Not run yet**, **Has results** and **Running**. Months that have not ended are not available.

   ![The month picker listing the months that can be run.](https://182773137-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIQB2eToY1Iv2IH6cERjn%2Fuploads%2Fgit-blob-b8c1519562ae24a5b48163906c56159adfc062a6%2Fmonth-picker.jpg?alt=media)
3. Under **Set sensitivity**, choose **Broad** (70%), **Balanced** (85%) or **Precise** (95%), or **Custom** with a **Confidence threshold** from 1% to 99%.
4. Under **Seasonality adjustment**, keep **Label Transfer** or choose **Window Calibration**. Seasons shift detector scores from month to month, and this setting controls how the detector accounts for that. If unsure, keep the default.
5. Click **Run on Jan 2025**. The button shows your selected month. The map shows "Running detector", and the month appears beside the map with a spinner. Up to 3 months can be queued or running at once.
6. To stop a run, click the X beside the month (tooltip "Cancel month run"), then **Cancel run**. A month still waiting asks "Remove from queue?".
7. When the run finishes, the month is marked as processed on the timeline below the map. Click it to show its detections. Use the arrows at the timeline's ends to scroll through months.
8. The panel shows the month's **Detections**. Click **View full details** for the sections **Summary**, **Run**, **Inference**, **Imagery**, **Model**, **Downloads** and **Raw data**. **Summary** lists **Status**, **Detections**, **Sensitivity**, **Imagery window** and **Completed**, plus the change against the previous processed month, such as "Change vs December 2025". The back arrow returns to the summary.
9. To compare, process at least two months. Above the map, switch from **Single month** to **Compare mode**. **Earlier month** opens on the left and **Later month** on the right. Change either with the **Month to compare** menu.
10. Read each legend: **Detected in both**, "Detected only in older image", "Detected only in newer image" and "Total detections in image". A detection is the same in both months when it sits on the same map tile. The eye icon beside an entry shows or hides that group.
11. To download, open **Downloads** in the full view. **GeoJSON** is a standard map file for GIS software. The list can also include **Binary detections**, **PMTiles**, **Manifest**, **Training positives**, **Training negatives**, **Detections (run)** and **Model artifact**.
12. To re-run a month, select it. The panel says "This month already has results. Re-running replaces them." Click **Re-run on Jan 2025**, then **Delete and re-run**. Change the sensitivity first if you want new settings.
13. To delete a month, click **Delete month** in the full view, or the trash icon (tooltip "Delete processed month"), then confirm "Delete processed month?".

Re-running and deleting permanently remove the month's results. To run months automatically, see [Auto-runs and limits](https://docs.earthindex.ai/monthly-search-beta/notifications-and-limits.md).

## What to expect

* Each processed month shows its **Detections** count and the **Sensitivity** it ran with.
* In compare mode, two maps show matching legends and counts.
* If you leave the page mid-run, the month still appears with a spinner when you reopen the project. Queued months are remembered by your browser, so use the same browser.

## If something goes wrong

| Symptom                                  | Fix                                                                                                                                                                         |
| ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| The run button is disabled               | The month is already running, or the queue is full: "Processing queue is full. Wait for your other runs to finish before starting another."                                 |
| "Monthly run failed. You can try again." | The panel adds "This month run failed before it finished." Select the month and click the run button again.                                                                 |
| Nothing shows on the map                 | With no results, the map reads "Run latest month to begin". Otherwise select a processed month on the timeline. Months you have not run show the tooltip **Month Not Run**. |
| **Compare mode** is disabled             | You need two processed months. Run another month first.                                                                                                                     |
| Counts jump between months               | Season, cloud and haze change the imagery. Compare months from a similar time of year and check the imagery under the detections.                                           |

## Related

* [Build a detector](https://docs.earthindex.ai/monthly-search-beta/set-up-monthly-search.md)
* [Auto-runs and limits](https://docs.earthindex.ai/monthly-search-beta/notifications-and-limits.md)
* [Monthly Search overview](https://docs.earthindex.ai/monthly-search-beta/overview.md)
