**Please read the whole section before starting the install procedure.**
[[_TOC_]]
The recommended installation procedure relies on creating a virtual environment to handle PASE dependencies.
The repository provides environment files for setting up a conda virtual environment with all necessary dependencies. There are two separate files:
- One for Windows users: `environment_windows.yml`
- One for Unix-based systems (macOS and GNU/Linux, such as Ubuntu, Debian, etc.): `environment_unix.yml`
# Conda Installation
If you haven’t installed Conda, we recommend following the [Conda installation guide](https://docs.conda.io/projects/conda/en/latest/user-guide/install/index.html). Here are some options to consider:
-**Good option:** Install **Anaconda** for a comprehensive installation.
-**Better option:** Install **Miniconda** for a lighter, customizable setup.
-**Best option:** Install **Miniforge** (optimized for Conda-forge) and consider using [Mamba](https://mamba.readthedocs.io/en/latest/installation/mamba-installation.html), which is faster and more efficient than Conda.
# Windows Installation
1. Create the `pase` virtual environment:
```bash
conda env create -f environment_windows.yml
```
2. Activate the environment:
```bash
conda activate pase
```
3. Install Embree-related dependencies with pip (while this is not standard practice in Conda, it should work without issues):
```bash
pip install pyembree embreex
```
4. The framework is now ready for use (for advanced crop modeling, see section [Installing JavaStics](#installing-javastics)).
# Unix-based Installation
1. Create the `pase` virtual environment:
```bash
conda env create -f environment_unix.yml
```
2. Activate the environment:
```bash
conda activate pase
```
3. The framework is now ready for use (for advanced crop modeling, see section [Installing JavaStics](#installing-javastics)).
# Installing JavaStics
Due to license incompatibilities, the JavaStics 1.5.1 executable is not included in the PASE repository.
If you want to use the crop model STICS, download JavaStics 1.5.1 : https://stics.inrae.fr/telechargement and place the executable "JavaSticsCmd.exe" under INPUTS/CROPS/STICS.
