Installation¶

GR is available on PyPI and we recommend installing it with pip:

pip install gr

This will automatically install both the GR runtime and the Python wrapper. You may need to install some additional dependencies on Linux:

• Debian:

  apt install libxt6 libxrender1 libxext6 libgl1-mesa-glx libqt6widgets6

• Ubuntu:

  apt install libxt6 libxrender1 libxext6 libglx-mesa0 libqt6widgets6

• CentOS / Fedora / Rocky Linux:

  yum install libXt libXrender libXext mesa-libGL qt6-qtbase-gui

• openSUSE:

  zypper install libXt6 libXrender1 libXext6 Mesa-libGL1 libQt6Widgets6

• Arch Linux:

  pacman -S mesa qt6-base

Note: Depending on the Linux flavor you are using, the package names may differ from the ones mentioned here. This particularly applies to the Qt versions used.

On FreeBSD make sure to install the these packages:

pkg install libXt libXrender libXext mesa-libs qt6

For information on building the GR runtime yourself, see Building the GR Runtime.

Getting Started¶

After installing GR, you can try it out by creating a simple plot:

from gr.pygr import mlab
mlab.plot(range(100), lambda x: x**2)

Tutorials¶

You can find several tutorials on using GR in the Tutorials section.

Examples¶

You can find a collection of Python scripts using GR in the Examples section.

API Reference¶

The Python API for GR consists of: