update authored by Grote Selim's avatar Grote Selim
......@@ -110,7 +110,7 @@ The `StructureType` parameter determines the overall logic and available compone
![Structure types](uploads/structure/three_struc_example.png)
Figure 4 - Structure types. HSATS is a tracking system, PV Table and Agrivoltaic Fence are fixed systems.
Figure 4 - Three examples of structures: HSATS, PV Table and Agrivoltaic Fence.
#### Structure Components
A structure is built from several elementary objects. You can customize the dimensions and shape of each:
......@@ -120,14 +120,18 @@ A structure is built from several elementary objects. You can customize the dime
3. **Purlin**: Horizontal bars oriented along the Y-axis (supporting the panels).
4. **Diagonal**: Bracing struts (specific to PV Table).
![HSATS](uploads/structure/HSATS.png)
Figure 5 - HSATS structure with highlighting objects representing the different components. This object represent a group you can duplicate along the X axis and Y axis to form a full AV system.
#### 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`.
- **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`).
- 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`).
#### Positioning and Spacing
Key parameters control how the structure is placed:
......@@ -141,24 +145,21 @@ Key parameters control how the structure is placed:
#### example
![HSATS](uploads/structure/HSATS.png)
Figure 4 - HSATS structure with highlighting objects representing the different components. This object represent a group you can duplicate along the X axis and Y axis to form a full AV system.
![PV Table](uploads/structure/PVTable.png)
Figure 5 - PV Table structure groups. PV tables have diagonals that start from the smallest pole of the group and end at the largest pole of the group. The length and angle of the diagonals are calculated automatically.
Figure 6 - PV Table structure groups. PV tables have diagonals that start from the smallest pole of the group and end at the largest pole of the group. The length and angle of the diagonals are calculated automatically.
You can set the `PanelOffset`, this is the distance between the structure's group and the panel center, this parameter is always calculated along the normal of the panel.
You can set the `PanelOffset`, this is the distance between the structure's group and the panel center, this parameter is always applied along the normal of the panel.
**Warning**: If the tilt angle is too high for the given base height, the structure may extend below ground level. Ensure that `Height` or `PoleSpacingX` is increased, or `TiltY` is decreased, to avoid a `ValueError`: "Invalid PVTable configuration: The tilt angle is too high for the given base height. This results in the structure extending below ground level. Please increase 'Height' or 'PoleSpacingX' or decrease 'TiltY'."
![Agrivoltaic Fence](uploads/structure/AgriFence.png)
Figure 6 - Agrivoltaic Fence structure hasn't affected by the tilt angle.
Figure 7 - Agrivoltaic Fence structure hasn't affected by the tilt angle.
......
......