Terrain Grading

Overview

Grading reshapes the ground inside a PV area so no slope exceeds the targets you set, as one continuous buildable surface. It is one of four ways PVX.AI moves earth. Pick the one that matches the problem:

  • Area grading (this article): use it before the layout when large parts of the site are steeper than your racks allow, or when long tracker rows need an even surface. It moves the most earth and gives the smoothest result.
  • Smoothing: the same Grading dialog with the cut/fill slider centred, so cut equals fill and no soil is imported or hauled away. It is the default choice for area grading. See Terrain Smoothing.
  • Adapt Terrain to Pile: use it after racks are placed, when most of the site is fine and only some racks have piles that are too long or too short. It regrades only the rows that need it, as one continuous buildable surface with the least cut and fill that clears every rack, and holds the rest of the site as it is, so it moves far less earth. See Adapting Terrain to Piles.
  • Pad grading: level pads for BESS containers and stations, from the Grading step of the BESS Designer. See Grading BESS Pads.

A common sequence: import terrain, check the slope maps, grade only if the slopes demand it, place racks, run Collision Analysis, and fix the remaining racks with Fix collisions or Adapt Terrain to Pile.


Prerequisites

Terrain in the drawing and a PV Area to grade.

Step-by-Step Guide

1. Open the Grading dialog

Click Civil Analysis on the PVX.AI ribbon to open the Civil sub-tab, then go to Civil sub-tab > Earthworks > Grading. Opening the Earthworks panel also makes the terrain layers visible.

2. Select the area

Click Select Area and pick the PV Area boundary.

3. Set the slope targets

Enter NS Threshold Slope (%) and EW Threshold Slope (%). The dialog shows the matching angle in degrees. Take these from the rack datasheet: the north-south limit is what the structure tolerates along its tilt direction, the east-west limit what it tolerates along the row.

If your rack accepts more slope facing south than facing north, tick Separate North / South limits and enter a North-facing limit (%) and a South-facing limit (%). They replace the NS value. A limit under 1 % cannot fully converge and may leave the surface partly graded.

4. Choose the slope transition

Under Slope Transition Mode, choose:

  • Soft Slope Transition: blends the graded ground into the surrounding terrain over a transition zone outside the boundary. Use it in most cases: the edge is buildable and drains naturally.
  • Hard Slope Transition: graded ground inside, original ground outside, with a sharp edge at the boundary. Use it when you may not touch ground outside the PV area, for example at a property line.

5. Set the cut/fill balance

Expand Cut/Fill Balance and pick a Method:

  • Cut/Fill Ratio: a slider from -1 to +1 with a live diagram. Centred, cut and fill balance. Drag toward ← more fill when excavation is the expensive side (shallow rock), or toward more cut → when imported fill is expensive or hard to compact.
  • Max fill height: caps the deepest fill. PVX.AI sets the grade line so the lowest ground fills to exactly this depth, which gives a cut-heavy result. Use it when the specification limits fill depth, for example 1 m of compacted fill under piles.

6. Add roads (optional)

Tick Generate roads (uses this grading’s targets) to route site roads on the graded surface in the same run. See Generating Roads During Grading.

7. Run

Click OK. When the run finishes, PVX.AI:

  • replaces the working terrain (PVXAI_Terrain_Current) with the graded surface, changing only the ground it moved, and keeps the original surface on PVXAI_Terrain_Initial;
  • draws a before/after table with cut and fill volumes on PVXAI_Terrain_Legend_CutFill;
  • draws the cut/fill map on PVXAI_CutFill (turned off at the end of the run; turn it on to inspect);
  • redraws the slope legend and directional slope maps for the graded surface, and refreshes any contours and spot elevations already in the drawing.

Tips & Recommendations

  • Start with targets slightly above what you need, read the volumes, then tighten. Every percentage point of slope you remove costs earthwork.
  • Racks already placed are not moved by grading. Run Adapt Objects afterwards so they sit on the new ground. See Adapting Objects to Terrain.
  • Graded seams with the surrounding terrain are watertight: no terrain point keeps two elevations.
  • To start again from the original ground, use Resetting the Terrain.
  • If the volumes look too high, see Why are my cut/fill volumes high?

Related