Read reference drawing
read_referenceDrawings and point clouds uploaded to the room, shared by all its models. Without id: the list - id, name, format, status ready|waiting, stand, readable (false: viewer only); a sheet adds scale, PDF page, n_pages. With id: nodes per layer in drawing units (source file), frame {origin, x, y, z} in project m: point (a, b, c) = origin + ax + by + c*z, flat nodes at flat_z. A sheet: PDF nodes in pt, PNG or JPEG one image node {width, height} in px, no pixels; origin bottom left, y up; only its scale makes m (unit.factor_m; unit.scale rule named, or pairs | fit_model_extent: assumptions). A WGS84 GeoJSON reads in map m of the model CRS, never degrees (coordinates {kind map, crs_name}, source assumption with projection rule and delta_m), within and pages too; without a georeference REFERENCE_GEOREF_REQUIRED. A point cloud: a summary, never a point, its bounds_m to hold against the model; probe {box, yaw_deg} (project m): n_points, heights, planes with rms_m; compare {guids}: per element the distance of the points nearest it, which body took the rest, how much of its free faces they cover; get_guide point_cloud. trust holds: the frame is where it lies now; uncertain: the place is assumed (source names the rule) - only a place the person confirmed or placed by a georef stamped user holds, a measured scale (drawing_pair_scale) never; void: unit or placement missing, no frame, place_reference gives them. Check an uncertain frame against points you know before building on it. coverage: what the file held and was read (n_not_projected: nodes left out whole); a node over a page is summarized, never cut. layers, within, elements narrow the nodes; over 2000 without them: no nodes, an overview with extent per layer and a try. next carries stand and revision: a page after a placement or model change is refused. A line is no wall and a rectangle no opening: say what you read it as. get_selection names points picked on a reference (drawing.at), one selected whole, and objects picked in it (drawing_elements: their keys go to elements). Read-only.
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": "read_reference"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | A reference id from the list: its nodes and frame; without id the list | |
| limit | No | Nodes per answer, default 100; next names the rest | |
| probe | No | A point cloud only: n_points, heights, a plane over all its points in the box and the dominant plane with its inliers, never the points | |
| stand | No | The stand of the list or of next; a page after the placement changed is refused (place_moved) | |
| layers | No | Only nodes on these layers, names as the reference lists them | |
| offset | No | First node; default 0 | |
| within | No | Only nodes whose extent meets the box [x0, y0, x1, y1], in the units of the nodes (WGS84 GeoJSON: map m) | |
| compare | No | A point cloud only: how far its points lie from these elements, each point counted once for the body nearest it | |
| elements | No | Only the nodes of these objects, keys as get_selection drawing_elements names them; an unknown key is refused | |
| revision | No | The revision of next; a page after the model moved to another revision is refused (revision_moved) |