Overview
Two outputs, for two different jobs:
- Earthworks (CSV) hands the grading result to a civil engineer or contractor: the original level, the finished level and the difference at every terrain point.
- PVXAI_CLEANCOPY rescues a drawing that has become slow or bloated. It writes a new DWG with the PVX.AI project (terrain, PV Areas, exclusions, roads, BESS areas and project settings) and leaves everything else behind.
Prerequisites
For the CSV, a drawing where grading or another earthworks operation has run. Without one there are no paired points to export. For the clean copy, a drawing with PVX.AI terrain or areas.
Step-by-Step Guide
1. Export the earthworks CSV
On the PVX.AI ribbon, open the Export dropdown on the Export panel and choose Earthworks (CSV). If the drawing has a rack pad surface from Adapt Terrain to Pile, you are asked which surface to read:
- TIN: the rack pad surface. It covers only the PV Areas where Adapt Terrain to Pile ran, and includes the pad corners.
- Grid: the terrain grid over the whole site.
Choose the save location.
2. Read the columns
The file has five columns, each labelled with its unit: Easting, Northing, NGL (natural ground level, from the original surface), FGL (finished ground level, from the current surface) and Difference (FGL minus NGL). A positive difference is fill, a negative one is cut.
3. Write a clean copy
Type PVXAI_CLEANCOPY on the AutoCAD command line and answer the prompts:
- Crop terrain to PV Areas and BESS areas? Yes (default) keeps only the terrain around the site. If Yes, enter a crop buffer distance in drawing units, or press Enter for none.
- Terrain resample factor: 1 keeps the current resolution; 2 to 16 make the grid coarser and the file lighter.
- Choose a file name for the new DWG. It must not be the drawing you are in.
4. Open the copy and regenerate
The new drawing holds the terrain (current and original), PV Area, KML, exclusion, BESS and road boundaries, and the project data such as rack and inverter specifications. Racks, piles, strings, electrical design, contours and cut/fill drawings are not copied, because PVX.AI can rebuild them from those inputs. Open the copy and run Build Layout and the electrical steps again. The source drawing is never changed.
Tips & Recommendations
- Use the clean copy when a client drawing carries embedded imagery, proxy objects or third-party data that slows AutoCAD down.
- Keep the resample factor at 1 if you will grade again or export earthworks from the copy: a coarser grid changes the volumes.
- The other exports on the same dropdown include Terrain (CSV), BoQ (XLS) and Piles (XLS).
