describe_scene
Return a SAR-literate reading of the scene at url.
The picture and the metadata card are produced deterministically; a model
only interprets them. How that model is reached depends on whether this
process holds a vision key:
- **No key** (the public community host): this tool does **not** call a
vision model. It returns the PNG plus a reading kit (SAR rules, the
metadata card, the JSON schema). Produce the JSON, then call
:func:`stamp_description` — that is the validation boundary
(provenance-stamped ``{summary, observed_features, confidence,
caveats}``). Until you stamp it, your prose is not pipeline output.
A baked preview is typically 512 px; the kit names the size and
that a local server can stream a higher-resolution GeoTIFF.
- **Key configured** (local stdio): sends the picture to that vision
model, validates through ``parse_description``, and returns the
stamped object directly.
The packaged SAR rules are the value over just looking at ``quicklook``:
brightness is backscatter not sunlight, speckle is not structure, a dark
patch may be radar shadow not water, one frame is not change.
``preview`` defaults to ``"auto"``: a baked catalog preview if this server
has one, else a fresh render. ``"render"`` is refused on the public host.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"url": "<url>"
},
"name": "describe_scene"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| db | No | Decibel stretch for a fresh render. Default true. A baked preview is always decibel. | |
| url | Yes | STAC JSON URL or index item id. The public host also accepts a product filename or acquisition stem that is in the index. | |
| asset | No | Product to picture. Default GEC. | GEC |
| model | No | Vision model id when this server holds an API key. Omit for the default. Unused on the no-key kit path. | |
| preview | No | auto (default) uses a baked preview when present, else renders. baked refuses if none. render always streams a COG and is refused on the public host. | auto |
| max_size | No | Longest side in pixels for a fresh render. Default 1024. A baked preview may be smaller; the kit says when this was ignored. |