documentation/tutorial.md

@@ -44,6 +44,57 @@ The parameters are located in several subdirectories according to their purpose:
 - 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.
 - WEATHER_FILES/ : the simulation can run on data fetched from an online database or on data files located in this subdirectory.
 
+## AV central
+The parameters of the agrivoltaics central (or the photovoltaics installation).
+
+- NumberOfPanelsX: this defines the number of modules across a block of PV modules.
+- NumberOfPanelsY: this defines the number of modules along a block of PV modules. 
+- RepetitionDistanceOfPanelsX: point-to-point (or center-to-center) distance between two neighboring panels across the block.
+- RepetitionDistanceOfPanelsY: point-to-point (or center-to-center) distance between two neighboring panels along the block.
+
+Figure 1 below shows an example with the following parameter values : 
+- NumberOfPanelsX: 2
+- NumberOfPanelsY: 8
+- RepetitionDistanceOfPanelsX: 2.5 [m]
+- RepetitionDistanceOfPanelsY: 2.0 [m] (this distance is exaggerated for demonstration purposes)
+- NumberOfPVBlocksX: 2
+- NumberOfPVBlocksY: 1
+- RepetitionDistanceOfPVBlocksX: 10 [m]
+  
+(the solar modules are 2.384 * 1.303 m)
+![](../uploads/AV parameters diagram.png)
+Figure 1 - illustration of parameters RepetitionDistanceOfPanelsX, 
+RepetitionDistanceOfPanelsY and  RepetitionDistanceOfPVBlocksX for a small 
+central with NumberOfPanelsX: 2, NumberOfPanelsY: 8, NumberOfPVBlocksX: 2
+and NumberOfPVBlocksY: 1.
+
+The CentralAzimut parameter (angle in degrees [°]) indicates the direction in 
+which the PV blocks' Y axis points:
+- 0 °: points N
+- 90 °: points E
+- 180 °: points S
+- 270 °: points W
+
+If the modules have a positive tilt, it means that for the following CentralAzimut values, the central will "face": 
+- 0 °: faces E
+- 90 °: faces S
+- 180 °: faces W
+- 270 °: faces N
+
+(for negative tilt values, the central will face the opposite way).
+
+Figures 2 and 3 are two examples to illustrate the behavior of those inputs.
+
+![](../uploads/AV parameters diagram east facing.png)
+
+Figure 2 - CentralAzimut: 0. The main axis (red arrow) of the block points North and, 
+with positive tilt, the PV modules face East.
+
+![](../uploads/AV parameters diagram south facing.png)
+
+Figure 3 - CentralAzimut: 90. The main axis (red arrow) of the block points East and, 
+with positive tilt, the PV modules face South.
+
 ## Weather data
 
 To run simulations, PASE needs these four weather variables :