Update installation instructions authored by Tiago Peixoto's avatar Tiago Peixoto
......@@ -141,13 +141,43 @@ If you encounter an error installing graph-tool via Macports, please file a bug
### Anaconda
It's possible to install graph-tool using [Anaconda](https://anaconda.org) for both GNU/Linux and MacOS, via [conda-forge](https://anaconda.org/conda-forge/graph-tool). The packages are binary, so no compilation is necessary. Just type:
It's possible to install graph-tool using [Anaconda](https://anaconda.org) for both GNU/Linux and MacOS, via [conda-forge](https://anaconda.org/conda-forge/graph-tool). The packages are binary, so no compilation is necessary. This mode of installation is particularly useful when a system-wide installation is not possible due to lack of permissions, e.g. in HPC environments, since anaconda allows for unprivileged installations in a home directory.
The easiest way to install `graph-tool` is to create a new environment and install it there:
```
conda create --name gt -c conda-forge graph-tool
conda activate gt
```
After that, install additional packages to the environment as needed:
```
conda install -n gt -c conda-forge ipython jupyter
```
You can also install `graph-tool` to a pre-existing environment with the following command,
but the solver is likely to fail (or hang) if your environment already contains many
packages already, whose dependencies may conflict with the `graph-tool` dependencies.
This is particularly likely if your environment contains packages from the official
`Anaconda` distribution, rather than the `conda-forge` distribution.
```
conda install -c conda-forge graph-tool
```
This mode of installation is particularly useful when a system-wide installation is not possible due to lack of permissions, e.g. in HPC environments.
Note: Rather than specifying `-c conda-forge` on every command, you can add `conda-forge` to your channels with:
```
conda config --add channels conda-forge
```
It is possible to list all of the versions of `graph-tool` available for your platform with:
```
conda search graph-tool --channel conda-forge
```
### Windows
......
......