Prepare your Python environment¶
You will need a Python environment to run Clinica. We advise you to use Miniconda. Miniconda allows you to install, run, and update Python packages and their dependencies. It can also create environments to isolate your libraries. To install Miniconda, open a new terminal and type the following commands:
- If you are on Linux:
curl https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh -o /tmp/miniconda-installer.sh bash /tmp/miniconda-installer.sh
- If you are on Mac:
curl https://repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-x86_64.sh -o /tmp/miniconda-installer.sh bash /tmp/miniconda-installer.sh
Miniconda will ask you where to install it.
Do not forget to copy the
export PATH given at the end of the installation.
If everything went fine, open a new terminal and type
conda info, it will verify if
Conda is installed, check the version and show your Miniconda path.
The latest release of Clinica can be installed by using the conventional PyPI package manager as follows:
conda create --name clinicaEnv python=3.7 conda activate clinicaEnv pip install clinica
v0.3.5, Conda installation is not proposed anymore (i.e.
conda create --name clinicaEnv python=3.6 clinica -c Aramislab -c conda-forge
will only install Clinica
Pip is now the only way to install latest versions of Clinica.
Developer installation (Advanced)
If you plan to contribute to Clinica or if you want to have the current development version, you can either:
- Download the tarball for a specific version from our repository. Then decompress it.
- Clone Clinica's repository from GitHub:
git clone https://github.com/aramis-lab/clinica.git
We suggest creating a custom Conda environment and installing Clinica inside it:
cd clinica conda create --name clinicaEnv python=3.7 conda activate clinicaEnv pip install -r requirements-dev.txt pip install -e .
Installation of the third-party software packages¶
Depending on the pipeline that you want to use, you need to install pipeline-specific interfaces. Not all the dependencies are necessary to run Clinica. Please refer to this section to determine which third-party libraries you need to install.
Run the Clinica environment¶
Activation of the Clinica environment¶
Now that you have created the Clinica environment, you can activate it:
conda activate clinicaEnv activate-global-python-argcomplete --user # Only the first time you activate the environment eval "$(register-python-argcomplete clinica)"
Congratulations, you have installed Clinica! At this point, you can try the
clinica command and get the help screen:
(clinicaEnv)$ clinica usage: clinica [-v] [-l file.log] ... clinica expects one of the following keywords: run To run pipelines on BIDS/CAPS datasets. convert To convert unorganized datasets into a BIDS hierarchy. iotools Tools to handle BIDS/CAPS datasets. visualize To visualize outputs of Clinica pipelines. generate To generate pre-filled files when creating new pipelines (for developers). Optional arguments: -v, --verbose Verbose: print all messages to the console -l file.log, --logname file.log Define the log file name (default: clinica.log)
If you have successfully installed the third-party software packages, you are ready to run any of the pipelines proposed by Clinica.
You can now learn how to interact with Clinica.
Deactivation of the Clinica environment¶
At the end of your session, remember to deactivate your Conda environment: