Python Package gr¶
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:
apt install libxt6 libxrender1 libxext6 libgl1-mesa-glx libqt5widgets5
- CentOS 7:
yum install libXt libXrender libXext mesa-libGL qt5-qtbase-gui
- Fedora 28:
dnf install libXt libXrender libXext mesa-libGL qt5-qtbase-gui
- openSUSE 42.3 / 15:
zypper install libXt6 libXrender1 libXext6 Mesa-libGL1 libQt5Widgets5
- Arch Linux:
pacman -S mesa qt5-base
- CentOS 6 / Other Linux distributions
yum install libXt libXrender libXext Mesa-libGL qt-x11
Note: The CentOS 6 build is used for other Linux distributions and relies on Qt 4 for the
gksqtapplication, so you may need to install X11, OpenGL and Qt 4 packages specific to your system.
- On FreeBSD make sure to install the these packages:
pkg install libXt libXrender libXext mesa-libs qt5
For information on building the GR runtime yourself, see Building the GR Runtime.
Docker and other headless Linux systems¶
GR does not rely on X11 for its non-interactive output formats, so you will not need the dependencies listed above on a headless system.
GR3 uses GLX for OpenGL context creation, which requires a connection to an X server. If you are using a headless sytem, e.g. a Docker container, you can use Xvfb or similar tools to start an X server that can be used by GR3, although it may only provide software rendering.
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)
You can find several tutorials on using GR in the Tutorials section.
You can find a collection of Python scripts using GR in the Examples section.
The Python API for GR consists of:
- gr Reference
- gr.pygr Reference
- gr.pygr.mlab Reference
- gr3 Reference
- grm Reference