Adapting Terrain to Piles

Overview

Adapt Terrain to Pile reshapes the ground of a PV area whose racks are already placed, so that every pile length or rack height ends up inside the limits you give. Instead of grading the whole site to a slope target, it starts from the pile limits: the affected rows are regraded as one continuous, buildable surface with the least cut and fill that clears every rack, and the rest of the site is held still. Use it after Collision Analysis shows racks whose piles are too long or too short and a vertical shift is not enough.


Prerequisites

Racks placed on terrain inside a PV area, with the pile depth set in the rack spec.

Step-by-Step Guide

1. Open the tool

On the Layout panel, click the arrow under Collision Analysis and choose Adapt Terrain to Pile. You can also select racks in the Collision Analysis grid and click Adapt terrain to piles; then only those racks are adapted and the rest of the area is held as it is. The window has two tabs: Adapt To Pile and Grading.

2. Select the area and decide on grading

Next to Area, pick the PV area. Then choose:

  • Grade the terrain first on: the settings on the Grading tab run first, and their N-S and E-W slope limits also limit the ground between rows. Use this on rough ground.
  • Grade the terrain first off: no grading pass. Max corridor slope sets the steepest ground allowed between two rows; leave it empty for the built-in 15 %.

3. Choose what to hold

  • Rack Height: keep the structure at a set height above the ground. Fixed racks take Bottom and Top; trackers take one Height.
  • Pile Length: keep the piles at a set length above ground. Fixed racks take Front and Back; trackers take one Length.

For fixed racks, Pile length limits lets you give a min and max for the front and back piles. Left empty, the front pile is held exactly at its target and the back pile is free within the buildable range. Enter the same number twice to pin a pile to one length. The info line shows the underground depth from the spec and the mode in use.

4. Fixed tables: slope limits, Suggest Back and Grade + Adapt together

On a fixed-rack drawing the Front and Back rows are a pile reveal range per pile row: every pile ends inside its row’s range, and a row left empty is held exactly at its target. The slope limit is entered as two numbers: Max slope N-S: (between the rows; leave it empty for the built-in 15 %) and Max slope E-W: (along the rows; leave it empty to use the N-S value). A site specification such as “N-S 25 %, E-W 18 %” goes straight into these two boxes.

The two reveal rows decide the N-S slope a table can stand on. Click Suggest Back under the Back row to size the back range from the natural ground: PVX.AI measures the N-S slope under every table (locally, nothing in the drawing changes), fills the Back row, and tells you what share of the tables could not follow the ground with your previous rows and with the suggestion. Click it again after you change the front row, the rack type or the option below.

Tick Grade + Adapt together to grade the ground and seat every table in one solve. Each table gets its height and its roll along the row together with the ground, inside the reveal ranges and the slope limits; the roll is limited by the E-W slope limit. Because the run does its own grading, you do not need a separate Grading run first, and on steep ground it usually moves much less earth than grading and adapting one after the other. Then set:

  • Fill weight: how much a cubic metre of fill costs compared with a cubic metre of cut. 1 treats them equally; a higher value makes the solve prefer cut.
  • Corridors: Limit everywhere holds the N-S and E-W limits on all ground in the area, the corridors between rows included. Corridor limit (N-S) keeps the limits under the tables but lets the ground between two rows be as steep as Max corridor slope N-S:. Left empty, that box means the N-S limit, which is the same as Limit everywhere. On steep sites a corridor limit above the table limit can cut the earthwork by more than half; check that it suits your access and drainage needs.

On steep ground Grade + Adapt together can move tables up or down by metres; the command line reminds you of this when the run starts. The run is two undo steps: press Ctrl+Z twice to restore both the terrain and the tables.

5. Build

Click Build. The calculation runs in the PVX.AI cloud. For fixed racks, each table gets a level seat within one continuous graded surface, and racks are shifted where that saves earthwork. For trackers, PVX.AI solves the ground and the table seats together: each table is raised, lowered and re-tilted along its axis in place, so the ends of neighbouring tables meet and every pile stays inside the band. Tables that cannot move this way are held as they are: terrain-following frames, multi-row group members, racks on locked layers and racks with fewer than two piles.

6. Review the result

The terrain is updated with the graded zones, and pile length labels are refreshed. Regenerate contours with Civil sub-tab > Terrain > Contours & Spot Elevations, then run Collision Analysis again to confirm every rack is inside its limits.


Tips & Recommendations

  • Try the cheaper fixes first: Apply selected shifts and Fix collisions in Collision Analysis move less ground.
  • Fixed table tilt angles are never changed; only the ground and the rack height move. With Grade + Adapt together a table can also roll along its row, within the E-W slope limit.
  • Use the cut and fill from this run in your earthworks quantities, and compare against the original surface with the cut/fill tools.
  • If the result is not what you want, reset the terrain and run it again with different limits.

Related