find_repeat_sites
Rank sites imaged more than once, before a change tool is pointed at one.
Use this when the site is not already known. Each site's ``hrefs`` are that
site's STAC URLs, oldest first, ready for ``pick_change_interval``,
``change_composite``, or ``stack_stats``. Prefer this, or
``search_catalog(area=..., fuzzy=True)``, over ``semantic=True`` when the
name shares words with a task. No model is called.
Argument reference (ranking, recency, cadence, baseline, return fields):
https://umbra-py.space/find-repeat-sites/
Filters bound which acquisitions are ranked. ``bbox`` is WGS84
``[min_lon, min_lat, max_lon, max_lat]``. ``intersects`` is one GeoJSON
Point, or a Polygon or MultiPolygon (or a Feature, FeatureCollection, or
GeometryCollection wrapping those). A point matches footprints that
contain it. It cannot be combined with ``bbox`` or ``place``. ``place`` is geocoded
only when ``bbox`` is omitted. ``area`` is a task-name substring;
``fuzzy=True`` is a deterministic loose match. When ``area`` matches no
task and ``bbox``, ``intersects``, and ``place`` are omitted, it is
geocoded. The result then adds ``matched_by`` (``geocode``) plus the
resolved place and bbox. A name Nominatim does not know, and a geocoder
that is busy or unreachable, set ``hint`` and return no sites
(``resolved_area`` is the ``area`` that was tried). A task-name hit adds
nothing. ``start`` / ``end`` bound
which passes enter the pool (ISO date, bare year or month, or a relative
expression). ``products`` is any of GEC, CSI, SIDD, SICD, CPHD.
``polarizations``, ``min_incidence``, ``max_incidence``, and
``max_resolution`` (metres) drop passes missing that field.
``top`` (default 20) is how many sites to return. ``min_passes`` (default
2) is the minimum depth: comparable passes when ``rank_by`` is
``comparable``, otherwise raw dated passes. ``rank_by`` is ``passes``
(default), ``comparable`` (largest same-polarization subset), ``recency``
(newest pass), ``span`` (first to last), or ``cadence`` (tightest median
gap). For the three temporal orders, ``min_passes`` still counts raw
passes.
``active_since`` / ``active_before`` select sites by newest pass;
``first_since`` / ``first_before`` select by earliest pass. Those keep
each survivor's full history, unlike ``start`` / ``end``, which truncate
the pool. ``max_revisit_days`` caps the worst gap and
``median_revisit_days`` caps the median gap. ``min_span_days`` /
``max_span_days`` bound the first-to-last span. A non-positive cadence or
span raises ``ValueError``. With ``rank_by="comparable"`` the cadence and
span filters use that subset. A bare year or month on a ``*_before``
bound includes the whole period.
``limit`` (default 500) sizes only a live or Canopy pool. A local index
ranks each task over the whole index and ignores ``limit``. ``local``
matches ``search_catalog``: unset uses the index when present. A Canopy
token (``$UMBRA_CANOPY_TOKEN``) draws the pool from the commercial
archive, and ``local=True`` cannot be combined with it.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "find_repeat_sites"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Pool filter: inclusive upper bound on which passes are counted. Same grammar as start. | |
| top | No | Maximum sites to return, best first. Default 20. | |
| area | No | Pool filter: task-name substring. With fuzzy, a loose token match. If it matches no task and bbox, intersects, and place are omitted, it is geocoded. | |
| bbox | No | Pool filter: WGS84 [min_lon, min_lat, max_lon, max_lat]. When set, place is not geocoded. | |
| fuzzy | No | Loose task-name match for area. No model call. | |
| limit | No | How many acquisitions to pull for a live or Canopy ranking. Default 500. Ignored on a local index, which groups the whole index. | |
| local | No | True uses only the local index; False forces a live walk. Omit to use the index when present. True cannot be combined with a Canopy token. | |
| place | No | Pool filter: free-text place. Geocoded to a bbox only when bbox is omitted. | |
| start | No | Pool filter: inclusive lower bound on which passes are counted. ISO date, bare year or month, or a relative expression. | |
| rank_by | No | passes (default), comparable, recency, span, or cadence. Unknown values raise ValueError. | passes |
| products | No | Pool filter: keep passes that expose one of these types (GEC, CSI, SIDD, SICD, CPHD). Case-insensitive. | |
| intersects | No | Pool filter: one GeoJSON Point, or a Polygon or MultiPolygon, optionally wrapped in a Feature, FeatureCollection, or GeometryCollection. A point matches footprints that contain it. Cannot be combined with bbox or place. | |
| min_passes | No | Minimum series depth. Default 2. Counts comparable passes when rank_by is comparable, otherwise raw dated passes. | |
| first_since | No | Keep sites whose earliest pass is on or after this date. Same grammar as start. | |
| active_since | No | Keep sites whose newest pass is on or after this date. Same grammar as start. | |
| first_before | No | Keep sites whose earliest pass is on or before this date. A bare year or month includes that whole period. | |
| active_before | No | Keep sites whose newest pass is on or before this date. A bare year or month includes that whole period. | |
| max_incidence | No | Pool filter: maximum incidence angle in degrees. Passes missing it are dropped. | |
| max_span_days | No | Drop sites whose first-to-last span is longer than this many days. Non-positive raises. Uses the comparable series when rank_by is comparable. | |
| min_incidence | No | Pool filter: minimum incidence angle in degrees. Passes missing it are dropped. | |
| min_span_days | No | Drop sites whose first-to-last span is shorter than this many days. Non-positive raises. Uses the comparable series when rank_by is comparable. | |
| polarizations | No | Pool filter: keep passes exposing any listed polarization. Missing values are dropped. | |
| max_resolution | No | Pool filter: keep passes this fine or finer, in metres. Missing resolution is dropped. | |
| max_revisit_days | No | Drop sites whose worst revisit gap exceeds this many days. Non-positive raises. Uses the comparable series when rank_by is comparable. | |
| median_revisit_days | No | Drop sites whose median revisit gap exceeds this many days. Non-positive raises. Uses the comparable series when rank_by is comparable. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||