Overview
A terrain-following frame can only bend as far as its joints allow. PVX.AI checks every frame against the limits in its spec twice: before placement, with a simulation in Tracker Settings, and after placement, when each frame has settled on the real terrain. Frames that cannot meet their limits are still placed, but flagged indicative so you can decide what to do with them.
Prerequisites
A terrain-following tracker spec (see Setting Up Terrain-Following Trackers) and terrain loaded in the drawing.
Step-by-Step Guide
1. Set the validation bands
In Tracker Settings > Mechanical Constraints, turn on the bands you need:
- Min Ground Clearance and Max Ground Clearance: the gap between the panel edge at full tilt and the ground. It is sampled along the tube between piles, so a hump or ditch in the middle of a segment is caught, not only the ground at the piles. Sampling uses a fixed step, so a very narrow crest can be under-measured.
- Min Pile Reveal and Max Pile Reveal: how far each pile stands above the ground. This is what decides which pile lengths you order.
With 2 piles per segment, every pile shares the segment’s straight line, so the reveal band is checked once against the reveal that Reference Height implies. If that reveal is already outside the band, the form warns you before you save. Per-pile reveals that follow the terrain need 3 or more piles per segment.
2. Run the sample terrain simulation
In the preview, open Sample terrain simulation and slide a synthetic terrain under the tracker. It reports live whether the frame stays within constraints or lists the violations, so you can tune joints, break angle and piles before placing anything.
3. Place the trackers
Place with Build Layout as usual. Each frame settles on the terrain while respecting the break angle, slopes, clearance and reveal limits together.
4. Read the deviation summary
When frames exceed a limit, the Terrain-following deviations dialog lists how many frames break each constraint (segment break angle, motor hinge angle, wing or segment slope, clearance, reveal, terrain coverage gaps) and how many multi-row groups placed fewer tables than requested. A frame that breaks several limits is counted in each row. In the drawing, the torque tube of an indicative frame is drawn red instead of purple.
5. Check the site with Collision Analysis
Run Collision Analysis on the PV area. Terrain-following frames are judged against the bands in their own spec, not against the panel’s limits, and appear with the family Terrain-following. Fix what you can with grading or Adapt Terrain to Pile, then run the analysis again.
Tips & Recommendations
- Use the summary to choose between three options: grade the ground, loosen the spec within what the vendor allows, or accept the flagged frames.
- If you ticked Don’t show this again, turn the dialog back on with Show terrain-following deviation summary after placement in Configurations > Settings.
- Sections, shadows, BoQ pile lengths, the pile export and the PVsyst export all use each frame’s settled, bent geometry.
