update tutorial.md - formatting (hlines) authored by Bouvry Arnaud's avatar Bouvry Arnaud
......@@ -14,7 +14,7 @@ The engine running the computations is made of modules, located in the pase/ dir
Those modules are imported at the start of the simulation script.
The `example.py` script is the preferred example for newcomers.
---
# Inputs
## Parameter files
......@@ -48,7 +48,7 @@ The parameters are located in several subdirectories according to their purpose:
- STRUCTURES/ : define the parameters of the mounting structure, such as the type of structure, the shape of the profiles used in the structure, etc.
- CROPS/ : parameter files for the crop models (SIMPLE, STICS, GrasSim)
- WEATHER_FILES/ : the simulation can run on data fetched from an online database or on data files located in this subdirectory.
---
## AV central
This section details parameters of the photovoltaics component of the agrivoltaics central, i.e. the PV modules and structures.
......@@ -61,6 +61,7 @@ Figure 1 - Illustration of blocks of PV modules. A block is highlighted by the d
In this example, each block counts 4 PV modules and there are respectively 3 block repetitions in the X axis and 2 block repetitions in the Y axis for a total of 6 blocks.
</div>
---
### PV modules
The PV modules are layed out in blocks. The user must start by defining the properties of the PV modules in a parameter file under `INPUTS/HARDWARE/PV_MODULES/`, e.g. `INPUTS/HARDWARE/PV_MODULES/Example1_PV_Module.yaml`.
......@@ -139,7 +140,8 @@ Figure 4 - CentralAzimut: 90. The main axis (red arrow) of the block points East
with positive tilt, the PV modules face South.
</div>
### Structure
---
### Structures
The structure configuration defines the physical mounting system for the PV modules.
Figure 5 illustrates the currently supported structure types.
......@@ -286,7 +288,7 @@ Table 7 - Parametrization of diagonals.
| `DiagonalEpsilon` | — | Small numerical offset to avoid degenerate geometry |
| `DiagonalGroundGuard` | meters | Minimum height above ground of the diagonal lower endpoint (0 = ground level) |
---
#### Positioning and Spacing
......@@ -305,7 +307,7 @@ indicates in which file each parameter can be found.
| STRUCTURE | `RepetitionDistanceGroupYMode` | — | `auto`: group spacing is derived from the panel layout; `manual`: uses `RepetitionDistanceGroupY` |
| STRUCTURE | `RepetitionDistanceGroupY` | meters | Explicit spacing between structure groups along Y (only used when mode is `manual`) |
---
#### Parameter validation per structure type
......@@ -362,7 +364,7 @@ Note: `PoleSide`, `PoleWidth`, `PoleHeight`, `PurlinSide`, etc. are optional in
the relevant dimension parameter must be non-zero when its shape type is selected
(see Table 3 for shape-to-parameter associations).
---
#### Structure types
......@@ -371,9 +373,6 @@ The active type is set with parameter `StructureType`.
The following subsections detail how each structure type can be parametrized.
---
##### PV Table
A fixed, tilted table structure.
......@@ -415,8 +414,6 @@ The length and angle of the diagonals are calculated automatically.
Figure 12 - TiltY parameter : the tilt angle of the PV modules (and rafters/purlins depending on the type).
</div>
---
##### HSATS
Horizontal Single-Axis Tracking Structure.
......@@ -445,8 +442,6 @@ Figure 13 - HSATS structure with highlighted objects representing the different
This object represents one group; groups are repeated along the Y axis to form a full AV system.
</div>
---
##### Agrivoltaic Fence
A fence-like structure where panels are mounted vertically between posts.
......@@ -477,14 +472,13 @@ Figure 14 - Agrivoltaic Fence Structure : the poles remain vertical and tilt is
applied to the PV modules to simulate the effect of wind.
</div>
---
#### Structure material
Currently, the Material property is used to apply a color to the structures. Use :
- "Metal" for grey structures
- "Wood" for brown structures
---
## Weather data
......
......