Find the most-extreme element by geometry
find_extremeFind the largest, smallest, or northmost/southmost/eastmost/westmost elements by category or level, then use returned external IDs to highlight or zoom to them.
Instructions
Find the most-extreme element(s) by position or size.
Use this to answer superlative questions (e.g. "the largest piece of equipment", "the northmost air handler", "the smallest transformer"), then pass the returned external_ids to highlight_elements or zoom_to. This tool does NOT change the view by itself.
For largest/smallest, each element carries its volume_cuft. For compass directions the answer is simply which element is most extreme.
Examples: - Largest equipment: op='largest' - Northmost air handler: op='northmost', category='air_handlers' - Three smallest fans: op='smallest', category='fans', limit=3
Returns: {"op": str, "count": int, "elements": [{external_id, asset_type, description, level_name, volume_cuft?}]} ranked most-extreme first.
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": {
"op": "<op>"
},
"name": "find_extreme"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| op | Yes | Which extreme: a compass direction (northmost/southmost/eastmost/westmost) ranks by position; largest/smallest ranks by 3D bounding-box volume. | |
| level | No | Optional building level to restrict to. Omit for all levels. | |
| limit | No | How many ranked elements to return (1-50). Use 1 for the single most-extreme element. | |
| category | No | Optional category to restrict to (e.g. the largest air handler). Omit to rank across all tracked equipment. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||