Road Corridor
Sweeps a road cross-section template along a 3D centreline (e.g. from Auto-Grade Road), daylights cut and fill slopes to the terrain, and reports earthworks to subgrade, pavement quantities and a mass haul.
Overview
Sweeps a road cross-section template along a 3D centreline (e.g. from Auto-Grade Road), daylights cut and fill slopes to the terrain, and reports earthworks to subgrade, pavement quantities and a mass haul.
Inputs (10)
- Centreline (Curve): 3D road centreline. Its Z is the finished road level on the axis (use Auto-Grade Road for a draped, slope-limited profile).
- Terrain (Mesh): Existing ground mesh.
- Template (Text): Preset name (residential street, urban street, rural road, cycle path, access track), a JSON template, or Road Network's Corridor Templates (one per Corridor Edge) so the 3D matches the 2D plan.
- Interval (Number): Distance between cross sections (m).
- Design Speed (Number): Design speed (km/h), used for superelevation on curves.
- Max Superelevation (Number): Maximum superelevation (%). 0 = keep the normal crown (typical for urban streets).
- Runoff Length (Number): Length (m) over which superelevation is introduced.
- Cut Reuse Factor (Number): Share of bank cut that can be reused as compacted fill (0 to 1).
- Free Haul (Number): Free-haul distance (m) for the overhaul figure.
- Run (Boolean): False = keep showing the last results (cached).
Outputs (14)
- Design Surface (Mesh): Finished road surface with daylight slopes, coloured by part.
- Subgrade (Mesh): Underside of the pavement build-up (formation level for earthworks).
- Feature Lines (Curve): 3D lines along every part edge.
- Daylight Lines (Curve): Where the cut / fill slopes meet the ground, left and right.
- Sections (Curve): Design cross section at each station (3D).
- Ground Sections (Curve): Existing ground along each cross section (3D).
- Stations (Number): Chainage of each cross section (m).
- Cut Areas (Number): Cut area to subgrade per section (m²).
- Fill Areas (Number): Fill area to subgrade per section (m²).
- Mass Haul (Curve): Mass haul diagram drawn below the corridor: mass line and balance (zero) line. X = chainage, Y = scaled volume.
- Quantities (Text): JSON: earthworks, mass haul, pavement layer volumes, surface areas, kerb length.
- Template (Text): The template used, as editable JSON.
- Info (Text): Method, assumptions, simplifications and references.
- Dashboard Data (Text): JSON legend and metrics (for Analysis Dashboard and Report Metrics).
Method, assumptions and simplifications
The same notes appear in the component's Info output.
Method
- Cross sections every Interval along the centreline (and at its end), square to its plan direction.
- Each side of the template is built outward from the axis: an optional rise (kerb upstand), then the part width at its cross slope (negative % falls away from the axis).
- Superelevation on curves: e = min(eMax, V² / 127 R) %, applied to lane parts (outside lane up to +e, inside to -max(crown, e)), smoothed with a moving average over the Runoff Length.
- Daylight: from the outer edge a cut slope rises (or a fill slope falls) at 1 : H until it meets the terrain, found by 0.25 m steps then bisection, up to the template's maximum daylight width.
- Earthwork line: the subgrade (surface minus the pavement layer depth) under paved parts, the finished surface elsewhere. Cut and fill areas integrate the gap to the existing ground every 0.1 m across the section.
- Volumes by average end area between sections; pavement layer volumes and surface areas the same way.
- Mass haul: cumulative (cut × Cut Reuse Factor - fill) along the road; balance points where it crosses zero; haul = area between the mass line and zero (m³ × m); average haul = haul / volume moved; volume beyond free haul = loop height above the level where the loop is Free Haul wide.
Assumptions
- The centreline Z is the finished road level on the axis (use Auto-Grade Road for a draped, slope-limited profile).
- Daylight slopes are given as H:V (2 = 1 vertical in 2 horizontal).
- Cut Reuse Factor turns bank cut into usable compacted fill (losses and shrinkage together).
- Preset templates use typical dimensions for early design, not a specific standard: check them against the local street design guide.
- Ground is read by vertical rays onto the terrain mesh; sections off the terrain or beyond the maximum daylight are flagged (partial volumes).
Simplifications and limits
- Superelevation ignores side friction (e = V² / 127 R, capped at eMax), which overstates it on gentle curves.
- No prismoidal or curvature correction to average end area; on tight curves the inner sides of sections can overlap and volumes are overstated.
- Topsoil strip and bulking are not separated; earthwork under kerbs uses the kerb bed depth.
- Conditional parts (ditches only in cut) are tested at the part's start.
- Junctions are not handled here: feed Road Network's Corridor Edges so corridors stop at the junction mouths.
Workflow
- Road Network -> Corridor Edges -> Auto-Grade Road -> Centreline; Corridor Templates -> Template; terrain -> Terrain.
- Quantities and Dashboard Data -> Report Metrics; Mass Haul curves are drawn below the corridor.
References
- AASHTO, A Policy on Geometric Design of Highways and Streets (Green Book): e + f = V² / 127 R.
- Average end area method and mass haul (Brückner) diagram: standard earthworks practice.