@@ -42,7 +42,7 @@ The parameters are located in several subdirectories according to their purpose:
- CROPS/ : parameter files for the crop models (SIMPLE, STICS, Gras-Sim)
- HARDWARE/ : Configure key properties of a PV panel for simulation, including its dimensions, peak power output, and whether it is bifacial. It also specifies if the panel has thickness and includes a 3D model file. These settings define the panel’s physical and operational characteristics in the simulation environment.
- SCENARIOS/ : define the parameters of the simulation scenario, such as location, latitude and longitude, altitude, simulation options, start and end year of the simulation, etc.
- STRUCTURE/ : define the parameters of the mounting structure, such as the height of the panels, their tilt, etc.
- STRUCTURES/ : define the parameters of the mounting structure, such as the height of the panels, their tilt, etc.
- WEATHER_FILES/ : the simulation can run on data fetched from an online database or on data files located in this subdirectory.
## AV central
...
...
@@ -99,25 +99,60 @@ with positive tilt, the PV modules face South.
### Structure
The parameters of the structure supporting the PV modules.
- StructureType: which type of structure for the PV modules
- Material: used to apply texture to the structure (e.g. Wood, Metal)
- PanelsPerGroup: Number of panels per pole in the structure
- PoleShape: shape of the pole profile (Square, Rectangle, Cylinder)
- PoleWidth: Pole size along x (used in case of square or rectangular pole)
- PoleHeight: Pole size along y (used in case of square or rectangular pole)
- PoleSide: Pole side length (used in case of square pole)
- PoleRadius: Pole radius (used in case of cylindrical pole)
- PoleLength: Pole size along z
- PoleGroundPositioning: vertical positioning of the pole relative to the ground (0 is flush with the ground, negative values mean the pole base is below ground level)
- PurlinShape: shape of the purlin profile (Square, Rectangle, Cylinder)
- PurlinWidth: purlin size along x (used in case of square or rectangular purlin)
- PurlinHeight: purlin size along y (used in case of square or rectangular purlin)
- PurlinSide: Purlin side length (used in case of square purlin)
- PurlinRadius: Purlin radius (used in case of cylindrical purlin)
- StructureSpacingY: Spacing along Y (interpreted by spacing_mode)
- StructureHeight: Structure height
The structure configuration defines the physical mounting system for the PV modules.
This is controlled by parameters in the `INPUTS/HARDWARE/STRUCTURES/` YAML files.
#### Structure Types
The `StructureType` parameter determines the overall logic and available components:
-**Agrivoltaic Fence**: Vertical posts (poles) with horizontal bars.
-**PV Table**: Fixed tilted tables with poles, rafters, diagonals, and purlins.
-**HSATS** (Horizontal Single Axis Tracker): Tracking systems with rotating rafters.
#### Structure Components
A structure is built from several elementary objects. You can customize the dimensions and shape of each:
1.**Pole**: Vertical support posts.
2.**Rafter**: Beams oriented along the X-axis (often tilted).
3.**Purlin**: Horizontal bars oriented along the Y-axis (supporting the panels).
4.**Diagonal**: Bracing struts (specific to PV Table).
#### Customizing Geometry
For each component (Pole, Purlin, Rafter, Diagonal), you can define its shape and size using these parameters:
-**Shape**: Defined by `*Shape` (e.g., `PoleShape`). Choices are `Square`, `Rectangle`, or `Cylinder`.
-**Dimensions**:
- For **Square/Rectangle**: Use `*Width` (X-dimension), `*Height` (Y-dimension), or `*Side` (for Square).
- For **Cylinder**: Use `*Radius`.
-**Length**: Defined by `*Length` (e.g., `PoleLength`).
```markdown
> **Note**: The `*Side` parameter is used if the base is `Square`, while `*Radius` is used if the base is `Cylinder`.
**Example YAML configuration for a square wooden pole:**
```yaml
PoleShape:
Value: Square
PoleSide:
Value: 0.15
PoleLength:
Value: 3.5
Material:
Value: Wood
```
```
#### Positioning and Spacing
Key parameters control how the structure is placed:
-**StructureHeight**: Elevation of the structure base from the ground.
-**PoleSpacingX**: Distance between two poles along the row (X-axis).
-**StructureSpacingY**: Distance between parallel rows of structures (Y-axis).
-**PoleGroundPositioning**: Vertical offset for the poles foundation (0 is flush with ground, negative values bury the pole).
-**TiltY**: Tilt angle of the PV modules (and rafters/purlins depending on the type).
-**PanelOffset**: Distance between the structure's mounting point and the panel center (useful to model mounting clamps or gaps).
