Edit terrain
edit_terrainChanges one terrain (guid) moddl derives from its ground: a pit (cut), a fill (embankment), surface heights (points) or entries taken out again (remove: their ids) - one of them per call. Every entry has an id, the same id replaces it in place; get_element include terrain lists them. The net is derived anew from the ground with every entry: heights in order, then the fills, then the pits; a point under a pit acts once the pit gets smaller (under_cut). fill: its slope runs down from the crown until it meets the ground; where the ground stands above top_z nothing is filled (crown_in_ground_m2). With layers or at a geomodel all fills form one fill layer of its own on top (layer_name; the top layer is never thickened). points: within 1 mm in plan of a point it sets that height, else it adds a point - a Delaunay terrain is triangulated again around it, given triangles are split; outside the rim only without layers. Raising thickens the top layer only; lowering cuts every layer boundary down to the new surface. A layered terrain is changed at its container, a single layer is refused. After a fresh upload or a change by another tool a known pit can only get deeper or wider. A vertical wall is insert_in_host. New revision, effect report. A call that succeeds is not a job that's done. The report's terrain_edit: the entries after the call, excavation_m3 measured at the net, source assumption where a pit, a height or the ground is not the user's; the volume per layer in layers[], changed layers in carried; a fill's volume, crown area and toe line in fill; pit: per floor edge the slope width, per corner the top of the ridge between two slopes, worth a look where the pit stands beside something.
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": {
"guid": "<guid>"
},
"name": "edit_terrain"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cut | No | A pit | |
| fill | No | A fill (embankment) | |
| guid | Yes | The terrain: IfcGeographicElement with a closed mesh body, the container of its layers, or an IfcGeomodel whose strata have thickness everywhere | |
| note | No | Your note, stored with the new revision | |
| points | No | Surface heights | |
| remove | No | Entry ids to take out | |
| source | No | Where the values you write come from: assumption (default, your own estimate, stamped in the file) or user (only what the person named word for word; it then reads as the file does) | |
| dry_run | No | Preview: the planned effect and its checks, nothing written | |
| request_id | No | Your id for this call: a repeat answers the first result and writes nothing |