Place reference drawing
place_referencePlaces a reference drawing of the room (listed by read_reference): named by id and the stand you read, one change per call. DXF or a sheet (PDF, PNG, JPEG); a GeoJSON lies through the georeference of the model. A sheet takes no unit and no georef; align: pair 0-1 measures its scale (an assumption) unless a person named one; alignment.scale says which, check tests it; a drawing point off the sheet is refused. unit: the drawing unit, where the file names none or a wrong one (a new unit drops an alignment: aligned_dropped). elevation_m or storey: the height of the reference. height_mode flat: everything lies at that height; file: the own z of 3D content plus that height (terrain with absolute heights of 400 m beside a model at 0: file with elevation_m -400). file is refused where all content is flat, flat at a point cloud; unnamed, the content decides (mostly 3D: file). mode origin: drawing zero on the project origin; georef: drawing coordinates as map coordinates through the served model's georeference. align: two pairs {drawing, model} give a rigid move at the scale of the unit; check is a third pair the move does not use, far from the first: its residual shows a swapped pair or a pair on another reference. revert_last: the choice before the last one back, exactly; once, then nothing_to_undo. Writes only the placement of the reference, never a model and never a revision (undo and restore_revision leave it); it holds for every model of the room (applies_to). Report: before and after, each with its stand (the next call names after.stand), changed, and for align the alignment with rotation_deg, the length deviations and check {residual_m, tolerance_m, within}. check within false stands at the top of the report: the placement is written anyway, as in the viewer, and a swapped pair or the wrong reference reads like this. A call that succeeds is not a job that's done: double-check the frame of read_reference against points you know, and revert_last where it does not hold.
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": {
"id": "<id>",
"stand": "<stand>"
},
"name": "place_reference"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The reference, its id from read_reference | |
| mode | No | origin: drawing zero on the project origin; georef: drawing coordinates are map coordinates of the georeference | |
| unit | No | The drawing unit | |
| align | No | Rigid move from two pairs, checked at a third | |
| stand | Yes | The stand read_reference or the last place_reference report named for it; another one now is refused (place_moved) and nothing is written | |
| source | No | Where the change comes from: assumption (default, your own reading, stamped so in the reference; read_reference then reads the place uncertain) or user (only what the person named word for word) | |
| storey | No | GlobalId of an IfcBuildingStorey of the served model: its height, as elevation_m | |
| elevation_m | No | Height in project m, bound to no storey: flat content lies at it, in height_mode file the own z is added | |
| height_mode | No | flat: all content at the height; file: own z plus the height | |
| revert_last | No | The unit and placement before the last change back |