render_event_map

Science

A map of one origin and, by ledger reference, numeric results already in this session: stations coloured by availability state, alternative solutions with horizontal uncertainty, jackknife trials, similar events and co-detections, past decisions, detection probabilities with unexplained silences ringed.

Layers are copies. A point on the map is not a confirmed epicentre. Cite the tool_call_id that produced the number. A cluster of similar events is not the same source; a blast colour is an operator label, not a measurement. A layers id that is not this session's successful call of the stated tool is E_UNKNOWN_REF.

extent is local (± 50 km), network (the configured region box), or auto (local when every referenced layer fits). The base map is a bundled Natural Earth clip; the tool does not fetch cartography at runtime. decisions is optional so a session that cannot call get_decision_history still gets a map.

References

• Natural Earth. 1:10m cultural and physical vectors. https://www.naturalearthdata.com/

Contract

Generated from the live registry (ToolSpec). Field names, types and defaults come from the input and payload models; they are not hand-typed.

Group	visual
Class	3
Tool version	1.0.0
Highest declared tier	D
Timeout	30 s
Budget key	render
readOnlyHint	true
idempotentHint	true

Input

Field	Type	Required	Notes
origin_ref	object (kind catalog | solution | value)	yes	discriminated on kind
extent	string ∈ {auto, network, local}	no	default "auto"
layers	object	no	Optional ledger tool_call_ids. Empty object still marks the call Tier D.
layers.station_status	string | null	no	default null
layers.solutions	array[string] | null	no	default null
layers.jackknife	string | null	no	default null
layers.similar	string | null	no	default null
layers.decisions	string | null	no	default null
layers.detectability	string | null	no	default null
width_px	integer ∈ {800, 1200, 1600} | null	no	default null

Payload

Field	Type	Required	Notes
figure	object	yes	payload.figure fragment every render tool returns (docs/12).
figure.width_px	integer	yes
figure.height_px	integer	yes
figure.digest	string	yes
figure.caption	string	yes
figure.series	array[string]	no
figure.url	string	yes
extent	object	yes
extent.min_lat_deg	number	yes
extent.max_lat_deg	number	yes
extent.min_lon_deg	number	yes
extent.max_lon_deg	number	yes
layers_drawn	array[string]	yes

Example request

{
  "origin_ref": {
    "kind": "catalog",
    "event_id": 1001
  },
  "extent": "auto",
  "layers": {
    "station_status": "tc-0007",
    "solutions": [
      "tc-0011"
    ],
    "similar": "tc-0009"
  },
  "width_px": 1200
}

Example payload

{
  "figure": {
    "width_px": 1200,
    "height_px": 800,
    "digest": "sha256:56789abcdef0123456789abcdef0123456789abcdef0123456789abcdef01234",
    "caption": "stations by state, one relocated solution, similar events",
    "series": [
      "tc-0007",
      "tc-0009",
      "tc-0011"
    ],
    "url": "/mcp/figures/tc-0022.png"
  },
  "extent": {
    "min_lat_deg": 46.7,
    "max_lat_deg": 47.6,
    "min_lon_deg": 24.0,
    "max_lon_deg": 25.0
  },
  "layers_drawn": [
    "station_status",
    "solutions",
    "similar"
  ]
}

What this tool does not tell you

What this tool does not tell you: that a point on the map is a confirmed epicentre. Layers are copies of earlier numeric results; cite those tool_call_ids for numbers. A cluster of similar events is not the same source, and a blast colour is an operator label, not a measurement.

Errors named for this tool

Code	When
E_UNKNOWN_REF	a layers id is not this session's successful call of the stated tool