Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

PyZgoubi is an interface to the Zgoubi particle tracker written in python.

Project Description

This is an interface to zgoubi. And framework for accelerator design. It is tested with zgoubi 6.0.1 from as well as recent developement versions, on Linux, MacOS X and Windows.


  • Python 2.5 or newer (not ported to 3.x yet)(2.7 recommended)
  • Numpy 1.4 or newer


  • Scipy
  • Matplotlib

Some features may require the new versions

Zgoubi can require several GB of RAM. See the Memory Issues section in the documentation for hints for low RAM systems.

To install run:

./ install

or to in install to a specific place:

./ install --prefix=/home/sam/pyzgoubi

If you install pyzgoubi to a custom prefix you may need to adjust your $PATH and $PYTHONPATH variables, the install script will give you some hints about what to do.

Once pyzgoubi is install run:

pyzgoubi --version

to check that it runs correctly. You may need to do this from a new terminal in order be using an updated $PATH. Don’t run this from the inside the source directory.

To automatically install zgoubi run:

pyzgoubi --install-zgoubi

this installs zgoubi into ~/.pyzgoubi/bin you can adjust ~/.pyzgoubi/settings.ini to use this as the default zgoubi executable.

There are some tests distributed with the source code. To run tests run:


Note that there are some know failures, see CHANGES for more info.

Documentation is available at or in the doc/ directory. To build the documentation run (you will need sphinx installed):

./ build_sphinx

More information can be found at or

Release History

This version
History Node


History Node


History Node


History Node


History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(239.1 kB) Copy SHA256 Hash SHA256
Wheel py2 Nov 29, 2016
(266.9 kB) Copy SHA256 Hash SHA256
Source None Nov 29, 2016

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers DreamHost DreamHost Log Hosting