Update installation instructions authored by Tiago Peixoto's avatar Tiago Peixoto
......@@ -232,8 +232,40 @@ If you encounter an error installing graph-tool via Macports, please file a bug
### Windows
Fully native installation on windows is not supported, but two viable options are either to use [Docker](#installing-using-docker) (see [here](https://docs.docker.com/docker-for-windows/) for instructions), or the Ubuntu userspace for windows (more information [here](http://blog.dustinkirkland.com/2016/04/howto-ubuntu-on-windows.html) and [here](https://insights.ubuntu.com/2016/04/14/howto-ubuntu-on-windows-2/)), which allows the native Ubuntu packages to be installed as described [above](#debian-ubuntu).
To use ``graph-tool`` on windows, you need to first install Windows Subsystem for Linux (WSL) as described here: https://learn.microsoft.com/en-us/windows/wsl/install
Usually, this requires simply running the command below on the power shell:
```
wsl --install
```
and then rebooting. You will be asked to provide a username and password.
This will install an Ubuntu subsystem alongside your windows OS. You then can install ``graph-tool`` just like described in the [Debian/Ubuntu](#debian-ubuntu) section above, i.e. you should open the file
```
sudo nano /etc/apt/sources.list
```
and add the following line to the bottom:
```
deb https://downloads.skewed.de/apt jammy main
```
(``jammy`` is the current version of Ubuntu at the time of this writing, it should replaced with most current version).
You should then add the signing key,
```
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-key 612DEFB798507F25
```
and update the package list:
```
sudo apt-get update
```
To enable all functionalities, the following extra packages need to be installed
```
sudo apt-get install python3-cairo python3-gi-cairo python3-gi gnome pip
sudo pip install zstandard
```
Finally, the package itself can be installed via:
```
sudo apt-get install python3-graph-tool
```
---------------------------------------
## Manual compilation
......@@ -338,7 +370,7 @@ GCC finishes under 80 minutes, and uses at most slightly below 3 GB. On the othe
### Parallel algorithms
graph-tool can run several of its algorithms in [parallel](http://en.wikipedia.org/wiki/Parallel_programming). It makes use of [OpenMP](http://en.wikipedia.org/wiki/Openmp) to do this, which provides a straightforward way of converting serial code into parallel code. OpenMP is an extension to the Fortran, C and C++ languages, which uses compiler directives to achieve automated code parallelization. Since it uses [compiler directives](http://en.wikipedia.org/wiki/Compiler_directive) (`#pragma `in C/C++), it maintains backwards compatibility with compilers that do not support OpenMP, and the code is then compiled cleanly as regular serial code. Thus, support for parallel code in graph-tool is quite optional. It is enabled by default, but if you wish to disable it, just pass the option `--disable-openmp` to the configure script.
# Google's colaboratory
# Google Colab
Colaboratory (also known as Colab) is a free Jupyter notebook environment that runs in the cloud and stores its notebooks on Google Drive. Since it's based on an Ubuntu system, we can install graph-tool on it using the instructions above. Please see here for a working Colab installation of graph-tool: https://colab.research.google.com/github/count0/colab-gt/blob/master/colab-gt.ipynb
......
......