2.1 Earthwork

Available with the Following Subscriptions: All Subscriptions
Available for the Following Roles: Project Editor, Project Admin

Earthwork in cmBuilder allows you to modify terrain using operations like cuts, fills, ramps, and trenches. It helps you simulate excavation stages across Milestones, visualize how the site evolves over time, and generate accurate volume takeoffs for planning and analysis.

In this article, we cover:


Earthwork Overview

Earthwork operations in cmBuilder allow you to modify terrain using five operation types: Cut, Fill, Trench, Positive Ramp, and Negative Ramp.

Cut, Fill, and Trench are sketch-based operations, while ramps are used to create graded access between elevations.

To launch Earthwork, select Terrain (1) from the left toolbar and open Earthwork (2). The Earthwork Side Sheet (3) opens on the right, where you can access and manage all earthwork operations.

Earthwork Tools

From the Earthwork Side Sheet, you can access the following:

  • Earthwork Timeline (4) — View and manage operations grouped by Milestones
  • Add Operations (5) — Create new operations such as Cut, Fill, Trench, and Ramp
  • Earthwork Takeoff (6) — View volume calculations and export data
  • Earthwork Settings (7) — Configure excavation settings such as boundaries, colors, and surfaces

Create a Cut or Fill

After launching Earthwork, you can create a Cut or Fill operation to modify the terrain. A Cut removes material from the terrain, while a Fill adds material to raise the surface. These are sketch-based operations, where you define the excavation boundaries directly in the workspace.

  • Under Add Operations, select Cut (1) or Fill (2).
  • Click in the scene (3) to start the operation. The elevation at this point defines the cut top and fill bottom.
  • Define the boundaries of the cut/fill using the sketch tools (4) (Line, Smart Arc, Circle etc.) 
  • The sketch should be a closed polygon, it may not be self intersecting.
  • Click Confirm (5) to finalize the operation.

Cut Settings

  1. Choose either Cut to Depth (6) or Cut to Surface (7).

    • Cut to Depth creates a cut with a flat bottom.
    • Cut to Surface creates a cut where the bottom surface is parallel to the original topography, but offset.
  2. The Sketch Elevation (8) defines the Cut top. This can be adjusted using the input field or the Select from 3D (crosshair) (9).

  3. Define the Cut Depth (10), or alternatively provide a Bottom Elevation (11). For Cut to Surface, provide an offset and choose the reference surface to use for the offset. You can select cmBuilder Default or a custom Terrain Reference Surface. To learn how to create a Terrain Reference Surface, see 2.9 Terrain Reference Surface. You can also use the Select elevation from 3D viewer (12) to pick values directly.

  4. From the Timeline section (13), set the Milestone when the operation will appear. Use the Step option (14) to control the order within the Milestone.


Fill Settings

  1. Choose either Fill to Height (15) or Fill to Terrain (16).

    • Fill to Height gives you a flat bottom top.
    • Fill to Terrain creates a fill where the top surface is parallel to the original topography, but offset.
  2. The Sketch Elevation (17) defines the bottom of the Fill. This can be adjusted using the input field or the Select from 3D (crosshair) (18).

  3. Define the Fill Height (19) or alternatively provide an Elevation (20). For Fill to Terrain, provide an offset and choose the reference surface to use for the offset. You can select cmBuilder Default or a custom Terrain Reference Surface. To learn how to create a Terrain Reference Surface, see 2.9 Terrain Reference Surface. You can also use the Select elevation from 3D viewer (21) to pick values directly.

  4. From the Timeline section (22), set the Milestone where the operation will appear. Use the Step option (23) to control the order within the Milestone.

Sloping Adjustments for Cut and Fill

  • Click Adjust (24) to set wall slopes for both Cuts and Fills. Select either No Slope (25), Slope In (26), or Slope Out (27). Adjusting the slope is not available for Cut/Fill to surface.

  • Choose whether to Apply to all (28) walls or define slope ratios for individual walls.

  • Set the Slope ratio (29) for all walls, or adjust values per wall if needed.

  • Use the Walls to slope section (30) to include or exclude specific walls. Uncheck any walls that should remain vertical — this can also be done using the bubbles in the 3D view (A, B, C, D) (31).


Create a Ramp

Ramps are meant to provide vehicle access to the bottom of a cut or top of a fill.

  • Under Add operations, select Positive Ramp (1) or Negative Ramp (2).
  • Position the Ramp against a wall of a Cut or Fill, click to place the Ramp.

đź’ˇ Note: Ramps are only available to create after first creating a Cut or Fill


Ramp Settings

  • From the Timeline section, select the Milestone (3) from which the ramp will be visible in your scenario. You can also adjust the operation’s order within the selected Milestone using the Step option (4).
  • Use the Color/Texture (5) settings to define the visual appearance of the ramp.
  • Include as earthwork volume (6): Turn ON to include Ramp volume in the Earthwork Takeoff.

  • To access further settings click Adjust (7). Adjustments include:
    • Define Width (8), Height (9), and Percent grade (slope) (10)
    • Define Stable soil angle (side-wall slope ratio) (11), Set X as 0 for a vertical side angle. 
 

Remove a Ramp 

Ramps may be removed by navigating to the Milestone where they should no longer be visible and using a cut or fill operation.

  • To remove a positive ramp, use a cut to "dig it out" - sometimes it is easier to duplicate the initial excavation and adjust the sequence so the duplicate appears in the milestone when the ramp should be removed.
  • To remove a negative ramp, user a fil to "fill it in" 

Create a Trench

A trench allows you to create linear excavations by defining a path and selecting a cross section profile. This is typically used for utilities or narrow excavation areas. but can also be used for pad footing in a linear array.

đź’ˇNote: Watch the video tutorial on creating a trench for a step-by-step walkthrough.

From the Add Operations Side Sheet, choose Trench (5)


 

💡 Note: Trench geometry is defined by a profile swept along a path. The profile and the path can be customized. 

Frame 247468.jpg

Trench Settings

To define the trench path, sketch a Polyline that is not self-intersecting; angled corners and Arcs are ok. If you are creating a new trench the sketch tool will automatically launch after adding the trench excavation operation. If you wish to edit an existing trench you will need to enter the sketch tool from the trench's settings panel using Edit Sketch (1) 

2026-02-11_15-48-05.jpg


Trench Profile

Select the Trench Profile - there are 2 types of trench profiles straight walls and sloped walls. To change profiles, click on the icon (2 above) displaying the current trench profile. From the profile picker, select your desired option. The 3D trench will update in real time, allowing you to see the changes instantly.

Straight trench: Straight trenches have only one setting: Trench Width Bottom. The trench will have a consistent width -the width at the bottom is the same as the width at the top.

2026-02-11_15-49-31.jpg
 

Sloped trench: Sloped trenches have two settings: Trench Width Bottom and Wall Slope Ratio. Use the Trench Width Bottom setting to define the width at the bottom of the trench. The Wall Slope Ratio, sets the rise/run of the walls with respect to the trench depth . e.g. 1:1 result in walls sloped at 45° (from vertical), while 2:1, results in walls sloped at 30° (from vertical). 1:1 ratio is less steep than 2:1 meaning 1:1 results in a trench that is wider at the top than 2:1.

2026-02-11_15-56-46.jpg


Sloped Trench Bottom

From the Sloped Bottom tab (1), you are able to slope the bottom of the trench along its length by changing the Grade setting (2). By default, the grade is flat (set to 0%), the more you increase the percentage, the steeper the slope.

2026-02-11_16-12-08.jpg


In the example below we use a grade of 5%. The depth of the trench will increase along its path (indicated by the arrow) at a 5% slope, beginning at the starting point of the trench path (as defined in the trench path sketch). 

2026-02-11_16-41-06.jpg


Earthwork Timeline

Open the Earthwork Timeline to view all Earthwork Operations grouped by Milestone. Each operation is displayed as a card. Click the 3-dot menu or double click on a card to manage the operation.

You can:

  • Show visuals at this step – Displays the operation in the scene for the selected step.
  • Rename – Edit the name of the operation.
  • Duplicate - Make a copy of the operation, typically to adjust and move to a later Milestone.
  • Create fill from cut - To use the shape of a cut to create a fill
  • Move to - To move to a different Milestone. 
  • Edit Details - Reopen the cut/fill/ramp/trench to edit the operation settings.
  • Delete from Site Plan  - Permanently remove the operation from the Scenario.
2026-02-11_16-58-28.jpg
 

Earthwork Sequencing (Boolean Logic)

The operations (cut, fill, ramp, trench) are applied in sequence to modify the shape of the original map terrain the same way material has to be moved on/off your construction site in reality. Because operations are applied in sequence, each operation is modifying the map terrain that results from the last operation -they build on each other. This means the order in which operations are arranged in the Earthwork Timeline determines the final shape.

  • Cut operations remove material from site.
  • Fill operations add material back to the site.
  • Ramp adds or removes material to access the bottom of the excavation. 
  • Trenches are narrow, linear cuts typically for utilities. 

Examples:

  • When Cut 01 is applied before Fill 01, the terrain is first excavated and then partially filled.

2026-02-12_10-29-13.jpg
  • When the order is reversed (Fill 01 before Cut 01), the final terrain shape and total excavated volume change significantly.
2026-02-12_16-36-43.jpg

This demonstrates that changing the sequence of operations impacts both the visual outcome and the calculated earthwork volumes.

đź’ˇ Note: Always review the operation order in the Earthwork Timeline to ensure the desired excavation result.


Earthwork Takeoff

  1. Click Earthwork Takeoff (1) from the Earthwork panel. 
  1. The Earthwork Takeoff panel opens with the Overview tab (2), where you can review summary data.
  2. Set a Swell Factor (3) – percentage adjustment representing the increase in volume/decrease in density. 
  3. Check Project Total Volume (4), including:
    • Compact Volume 
    • Loose Volume
  4. Scroll to Milestone Breakdown (5) to view volume data grouped by milestones. 
  5. Click Export (6) to download the breakdown as a .csv file. 
  6. Switch to the Detailed Breakdown tab (7) to view a tabular breakdown of each operation, including milestone and volume data. 
  7. Use Export again to download the detailed data as a .csv file.

Earthwork Settings

  1. Click on the Earthwork Settings (1)
  2. Here you can change the color of the boundary or earthwork operations
  • Default earthwork color/texture (2) – Set the default color or texture for excavation areas
  • Dirt shows projections (3) – Enable or disable projected surfaces (such as overlays) on the excavation

Earthwork Colors

Enhance your site plans with colored Earthwork Operations. You can independently customize colors for the top/ bottom, and sides during cut, fill, or ramp operations. This allows for greater appeal and clarity in your simulation. 

2026-02-13_11-49-01.jpg


How to Customize the Color of Earthwork Operations

  • Start by creating a new or editing an existing excavation operation. Here we are using a Cut operation as an example. The same process applies to Fill and Ramp operations.
  • In the Color section (1), you'll find two color blocks, initially set to the default excavation color
    • The first block controls the top/bottom color of the operation
    • The second block controls the sides.
  • Click the desired color block (2) to access the color picker and select your preferred color. 

  • Once you've selected your colors click the Done button. The selected colors will be applied to your excavation operation.

2026-02-13_11-49-51.jpg


Video Tutorials

Watch the following videos for step-by-step guidance on creating and managing earthwork operations.

Creating a Trench

Watch this video to learn how to create a Trench.

Creating a Backfill to the Original Map

Watch this video to learn how to create a backfill to the original map.


Tips & FAQ

Creating Excavation Lifts and Benching

Simulating excavation in lifts helps you visualize the construction process and manage material movement more effectively. This approach improves planning, sequencing, and communication across project stages.

Follow these steps to create excavation lifts:

  1. Create the initial Cut by sketching around the building perimeter or excavation footprint.
    đź’ˇ Tip: Use the Project from 3D tool within the sketch to quickly project elements like slab edges from your model.
2026-02-12_17-43-36.jpg
  1. Set the cut depth to match the desired lift height (e.g., 10 ft).
2026-02-12_17-41-30.jpg
  1. Duplicate the cut to reuse the same boundary.
2026-02-12_17-45-09.jpg
  1. Click and drag the duplicated cut into the subsequent milestone and edit the depth to 10ft.

    đź’ˇ Note: If you are creating many lifts, you may wish to apply a slight offset to the sketch to avoid co-planar faces and improve performance. See Optimizing your earthwork.

2026-02-12_17-45-42.jpg
2026-02-12_17-47-37.jpg
2026-02-12_17-48-34.jpg
  1. Repeat this process for other lifts.

    đź’ˇ Tip: You can also apply an offset to the sketch, as seen below, to easily incorporate benching.

2026-02-12_17-54-41.jpg

Best Practices

Apply the following best practices to optimize your earthwork:

  • Reduce the number of operations by combining cuts and fills where possible.
  • Use Projected Zones instead of Cut/Fill to Terrain when changing ground appearance.
  • Simplify earthwork boundaries and sketches by removing unnecessary points without significantly altering geometry.

Here is a video walking through the above steps to create a trench

Was this article helpful?
0 out of 1 found this helpful

Comments

0 comments

Please sign in to leave a comment.

Articles in this section