[feature] New module sky_model with Reinhart sky discretization scheme, water balance correction in GrasSim

Closes #87 and #116

See merge request !32

Merge branch '116-feature-add-tregenza-sky-discretization-scheme-and-optionnal-bre-cie' into 'develop'

Resolve "[feature] Add Tregenza/Reinhart sky discretization scheme"

See merge request !23

* Reinhart sky discretization scheme is in a new module sky_model in a new class ReinhartSky. 
Its only input is multiplying factor MF, that is used to multiply the 145 patches from the "original" Tregenza sky subdivision scheme into as many patches (e.g. MF = 4 subdivides each of the patches of the Tregenza scheme in 4). 
Only the top patch is not subdivided like the others, but its size decreases as MF increases.

* Conversion function from spherical to cartesian coordinates is in new file conversion_functions.py.
Inputs are documented in the function docstring.
Conversion functions should be stored there and reused as much as possible to reduce risks of errors.


Closes #116

Resolve "[feature] APV central visualization early in the main script", closes #87

See merge request !31

[feature] Temporary - crop yield map display in a conditional and automate crop yield display as last simulation year

The input of the function used to display results in the main and example scripts is not called identically for the different crop models, so I put a conditional to avoid having to manually adapt the scripts every time we switch crop models.

Also automatically select the last simulation year to display the crop yield, based on the parameters dictionary. Until now, it was hard coded. It made it so the user could run into an error when the hard-coded year did not match the time range of the simulation. Advanced users can still edit the date of the yield map display as needed.

* Display the APV central before the light computations
* set ground opacity to 0.5 to make it easier to inspect the 3D scene
* add X (East), Y (North) and Z (Zenith) axes on the PyVista render

Resolve "[feature] Save time series of mean variables in a csv file"

See merge request !29

Save mean soil/crop data from a nyears_data dictionnary

The start_year and end_year are related to an Agri4cast csv file and refactoring the whole thing is necessary (just changing the start_year and end_year is not enough). I will create a new issue to better describe the topic.

Merge branch '92-feature-set-start-and-end-year-as-input-parameters-in-get_n_years_daily_wd' into 'develop'

Resolve "[feature] set start and end year as input parameters in get_n_years_daily_WD"

See merge request !27

Merge branch '103-feature-grassim-add-cumulated-sum-of-exported-biomass-to-management-attibutes' into 'develop'

Resolve "[feature] GrasSim: Add cumulated sum of exported biomass to management attibutes"

See merge request !28

Before, the method was working with the hard-coded 2005-2015 year range, which is not at all flexible

Cumulated biomass can now be saved in nyears_data

Resolve "[fix] GrasSim: clip soil water content min value to zero"

See merge request !26

Was clipped to wilting point, which underestimates drought

[fix] days_since_rotation is updated if day is outside of a rotation period.

See merge request !15

v1.1.0 - cosine correction and grassim refactoring

See merge request !21

Resolve "[feature] Chose crop model in the config file instead of main script"

See merge request !20

Crop config files were passed outside the YAML_inputs_provider and handled differently than other parameter files. This is now fixed.

Field names in the yaml files were also homogenized.

A Definition field was duplicated

[docs] Add partial docstring to MODULES.PHOTOVOLTAICS.production.PV_Production.compute_global_tilted_irradiance

Add partial docstring to MODULES.PHOTOVOLTAICS.production.PV_Production.compute_global_tilted_irradiance to document the inputs (variables and units). Some are still missing and tagged with TODO.

Resolve "[fix] Diffuse irradiance is not fully anisotropic"

See merge request !19

Contributions to the diffuse map are now proportional to the cosine of the zenith angle of light coming from the "n small suns".
The computation is vectorized and should not be a performance decrease relative to the previous implementation, while  significantly increasing accuracy.

For now it contains conversion from cartesian to spherical coordinates. Takes numpy arrays as input, of dimensions (3,) or (N, 3) and automatically adapts.

[feature] Crop model config file

See merge request !14

* Place return False after the for loop.
* Add self.days_since_rotation += 1 before return False

* Place return False after the for loop.
* Add self.days_since_rotation += 1 before return False

Add a "config" parameter to run_crop_simu(), a dictionary containing model name and names of all needed parameter files.

[refactor] Gras-Sim model rework

See merge request !12

* Separate soil, crop and management-related code in 3 different classes
* Use a "variables_to_save.yaml" file to control model output (nyears_data content)
* Add soil volume reduction caused by coarse fragment
* Minor style changes

[feature] generic time series plot

See merge request !13

Example and quick plot of variables from nyears_data dictionnaries

[feature] Example script and input files

See merge request !11

Create example.py (inspired from main.py) and clean the script to make it easier to read and understand for new users.

Upload 2 templates :
- feature request
- bugfix request

Those templates are used when creating an issue. Predefined sections make it easier to describe an issue (summary, current behavior, desired behavior, related things, sources, etc.)

Merging of the new Grassim features

See merge request lucisun/collaborations/deal-framework-agrivoltaics-pase!10