| ... | ... | @@ -2,6 +2,14 @@ |
|
|
|
|
|
|
|
Disclaimer : this procedure is suggested but not mandatory. Power users should install the dependencies of PASE in the way that suits them most. This procedure is the only one tested by the development team of PASE.
|
|
|
|
|
|
|
|
# Downloading PASE
|
|
|
|
|
|
|
|
To start, download PASE :
|
|
|
|
- if you are familiar with git or wish to contribute to the project, [clone the repository](https://docs.gitlab.com/ee/topics/git/clone.html)
|
|
|
|
- if you only want to try the software, go to the project's main page, click on the blue "Code" drop-down button in the top right corner, and click "Download source code" > zip
|
|
|
|
|
|
|
|
# Dependencies
|
|
|
|
|
|
|
|
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:
|
| ... | ... | @@ -9,7 +17,7 @@ The repository provides environment files for setting up a conda virtual environ |
|
|
|
- One for Windows users: `environment_windows.yml`
|
|
|
|
- One for Unix-based systems (macOS and GNU/Linux, such as Ubuntu, Debian, etc.): `environment_unix.yml`
|
|
|
|
|
|
|
|
# Installing Conda
|
|
|
|
## Installing Conda
|
|
|
|
|
|
|
|
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:
|
|
|
|
|
| ... | ... | @@ -17,7 +25,7 @@ If you haven’t installed Conda, we recommend following the [Conda 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.
|
|
|
|
|
|
|
|
# Installing Python modules on Windows
|
|
|
|
## Installing Python modules on Windows
|
|
|
|
|
|
|
|
1. Create the `pase` virtual environment:
|
|
|
|
|
| ... | ... | @@ -39,11 +47,11 @@ If you haven’t installed Conda, we recommend following the [Conda installation |
|
|
|
|
|
|
|
4. The framework is now ready for use (for advanced crop modeling, see section [Installing JavaStics](#installing-javastics)).
|
|
|
|
|
|
|
|
# Installing Python modules on Unix-based systems
|
|
|
|
## Installing Python modules on Unix-based systems
|
|
|
|
|
|
|
|
**Important notice : for systems running on an arm CPU, the installation procedure is different !**
|
|
|
|
|
|
|
|
## arm CPU systems
|
|
|
|
### arm CPU systems
|
|
|
|
Creating the virtual environment from the environment file did not work during testing. The work-around consists in manually installing the required packages and activating a specific configuration option for the **pyembree** install.
|
|
|
|
|
|
|
|
The commands to run in the terminal are listed below (if you did not install mamba, simply replace "mamba" with "conda" in lines 3 and 5 - untested):
|
| ... | ... | @@ -55,7 +63,7 @@ conda config --env --set subdir osx-64 |
|
|
|
mamba install pyembree
|
|
|
|
```
|
|
|
|
|
|
|
|
## All other systems
|
|
|
|
### All other systems
|
|
|
|
1. Create the `pase` virtual environment:
|
|
|
|
|
|
|
|
```bash
|
| ... | ... | @@ -70,7 +78,7 @@ mamba install pyembree |
|
|
|
|
|
|
|
3. The framework is now ready for use (for advanced crop modeling, see section [Installing JavaStics](#installing-javastics)).
|
|
|
|
|
|
|
|
# Installing JavaStics
|
|
|
|
## Installing JavaStics
|
|
|
|
|
|
|
|
Due to license incompatibilities, the JavaStics 1.5.1 executable is not included in the PASE repository.
|
|
|
|
|
| ... | ... | |
| ... | ... | |
