h1. XBOA

A multiparticle tracking postprocessor library for accelerator physicsists. You've got GPT running, or your favourite tracking code, what now? This package is a post-processor for taking beam data to calculate beam emittance, Twiss functions, etc. Also includes bindings to plotting packages ROOT and matplotlib, and a whole lot more!

h2. Download and Installation

You can download the latest version from the code repository hosted on "sourceforge":http://sourceforge.net/projects/xboa/. 

Installation instructions are in the README file, but you probably have to do something like:

<pre>

tar -xzf xboa-<version>.tar.gz

cd xboa-<version>

python setup.py build

sudo python setup.py install

</pre>

h2. Running

There are several example scripts in the directory xboa-<version>/xboa/examples that are good to start with. They take you through the steps required to load particle tracking data, access it, make plots and manipulate it in various ways. Reference documentation is in the directory xboa-<version>/doc. Browse the example script code at:

"Example 1":http://micewww.pp.rl.ac.uk/projects/x-boa/repository/entry/xboa/examples/Example_1.py

"Example 2":http://micewww.pp.rl.ac.uk/projects/x-boa/repository/entry/xboa/examples/Example_1.py

"Example 3":http://micewww.pp.rl.ac.uk/projects/x-boa/repository/entry/xboa/examples/Example_1.py

"Example 4":http://micewww.pp.rl.ac.uk/projects/x-boa/repository/entry/xboa/examples/Example_1.py