calculate_tin_earthwork_volumes
Compute 3D TIN earthwork volumes from CAD spot elevations or point clouds, including topsoil stripping, cut, fill, and net balance between existing terrain and design subgrade.
Instructions
[v0.5 Tool 16] Compute 3D Delaunay TIN surface earthwork volumes (topsoil stripping, cut, fill,
and net earth balance) between existing terrain and designed subgrade level directly from
CAD spot-elevation layers or 3D point clouds (without Civil 3D).
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": "calculate_tin_earthwork_volumes"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| design_points | No | List of designed surface or subgrade spot elevation points (X, Y, Z in meters). | |
| file_path_cad | No | Optional DXF/DWG path to extract spot elevation points and boundary polygons. | |
| boundary_layers | No | CAD layers defining the earthwork/grading boundary polygon. | |
| existing_points | No | List of existing ground spot elevation points (X, Y, Z in meters). | |
| unit_scale_to_meter | No | CAD drawing unit scale to meters (default 1.0). | |
| fill_compaction_factor | No | Compaction multiplier for required borrow fill (default 1.15). | |
| design_elevation_layers | No | CAD layers containing designed surface elevation POINT/INSERT/TEXT entities. | |
| existing_elevation_layers | No | CAD layers containing existing ground elevation POINT/INSERT/TEXT entities. | |
| topsoil_strip_thickness_m | No | Topsoil stripping thickness in meters (e.g., 0.10m or 0.20m). | |
| constant_design_elevation_m | No | Optional constant horizontal design elevation [mBf] if `design_points` is not provided. | |
| pavement_structure_thickness_m | No | Total pavement structure thickness (m) deducted from finished design surface to reach the subgrade mirror level (tükörszint). Pass 0.0 if design_points are already subgrade levels. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| warnings | No | ||
| cut_area_m2 | Yes | ||
| fill_area_m2 | Yes | ||
| avg_existing_z_m | Yes | ||
| avg_subgrade_z_m | Yes | ||
| max_existing_z_m | Yes | ||
| max_subgrade_z_m | Yes | ||
| min_existing_z_m | Yes | ||
| min_subgrade_z_m | Yes | ||
| compaction_factor | No | ||
| footprint_area_m2 | Yes | ||
| cut_volume_bank_m3 | Yes | Net excavation (bevágás) volume below stripped ground to subgrade level in m3. | |
| design_points_count | Yes | ||
| tin_triangles_count | Yes | ||
| net_earth_balance_m3 | Yes | fill_volume_required_bank_m3 - cut_volume_bank_m3 (negative = excess spoil to haul away; positive = borrow needed). | |
| existing_points_count | Yes | ||
| topsoil_strip_volume_m3 | Yes | ||
| fill_volume_compacted_m3 | Yes | Net embankment/fill (töltés) volume above stripped ground to subgrade level in m3. | |
| topsoil_strip_thickness_m | Yes | ||
| fill_volume_required_bank_m3 | Yes | Required borrow/bank fill volume including compaction factor (fill_compacted * compaction_factor). | |
| pavement_structure_deduction_m | Yes |