documentation/tutorial.md

@@ -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