The pygrace project is a set of tools designed to act as an interface between the Python programming language and the Grace plotting tool, allowing users to create complex Grace files from within Python.

It is intended to:

  • Assist in the automated creation of many figures for use in large-scale, exploratory data analysis.
  • Encourage code reuse, by offering an object-oriented structure.
  • Reduce the time required to create figures for scientific journal articles.

Click here to access the project on github.


To clone the pygrace repository, change to a directory where you want to save the code and type:

git clone https://github.com/pygrace/pygrace.git

To install pygrace, all you need to do is enter into the pygrace directory you just created and run setup.py:

cd pygrace
python setup.py install

By default, Python will attempt to install pygrace in the global Python site-packages directory. If you don't have permissions to do this (or prefer not to install pygrace globally), you can install it locally by adding the --user option:

python setup.py install --user

You can test that python can find the pygrace package by opening an interactive python prompt and typing:

import PyGrace

If no error is raised, then installation was succesful!

Getting started

pygrace was designed so that, “anything you can do in Grace, you can do in pygrace.” The best way to get started is to go through the examples in the Examples directory. Each example is fully commented.