Wiki » History » Version 22
Rogers, Chris, 16 April 2013 13:20
| 1 | 1 | Rogers, Chris | h1. XBOA |
|---|---|---|---|
| 2 | |||
| 3 | 12 | Rogers, Chris | A multiparticle tracking postprocessor library for accelerator physicsists. You've got your favourite tracking code running, 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! |
| 4 | 1 | Rogers, Chris | |
| 5 | h2. Download and Installation |
||
| 6 | |||
| 7 | 22 | Rogers, Chris | "*Downloads*":http://micewww.pp.rl.ac.uk/maus/xboa/ * |
| 8 | 19 | Rogers, Chris | |
| 9 | 20 | Rogers, Chris | Also try "sourceforge":http://sourceforge.net/projects/xboa/ and "launchpad":http://launchpad.net/xboa mirrors. |
| 10 | 1 | Rogers, Chris | |
| 11 | Installation instructions are in the README file, but you probably have to do something like: |
||
| 12 | |||
| 13 | <pre> |
||
| 14 | tar -xzf xboa-<version>.tar.gz |
||
| 15 | 4 | Rogers, Chris | cd xboa-<version> |
| 16 | 1 | Rogers, Chris | python setup.py build |
| 17 | sudo python setup.py install |
||
| 18 | </pre> |
||
| 19 | |||
| 20 | 11 | Rogers, Chris | At the moment only Linux is supported, but windows support would be pretty easy to implement if there was demand. |
| 21 | |||
| 22 | 1 | Rogers, Chris | h2. Running |
| 23 | |||
| 24 | 9 | Rogers, Chris | When doing any physics analysis beyond the most basic, one really wants to be able to manipulate the analysis in various ways. For any detailed analysis, physicists will want to make cuts and calculate different variables in different ways. For this reason x-boa really provides just a library of physics analysis functions. Examples of how to use it are provided, but once physicists get going they can really push the analysis however they like. |
| 25 | |||
| 26 | 6 | Rogers, Chris | 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: |
| 27 | |||
| 28 | "Example 1":http://micewww.pp.rl.ac.uk/projects/x-boa/repository/entry/xboa/examples/Example_1.py |
||
| 29 | 7 | Rogers, Chris | "Example 2":http://micewww.pp.rl.ac.uk/projects/x-boa/repository/entry/xboa/examples/Example_2.py |
| 30 | "Example 3":http://micewww.pp.rl.ac.uk/projects/x-boa/repository/entry/xboa/examples/Example_3.py |
||
| 31 | "Example 4":http://micewww.pp.rl.ac.uk/projects/x-boa/repository/entry/xboa/examples/Example_4.py |
||
| 32 | 9 | Rogers, Chris | |
| 33 | There is also a script that _almost_ clones the functionality of the ecalc9f code developed by Greg Penn and Rick Fernow: |
||
| 34 | |||
| 35 | 10 | Rogers, Chris | "XBOA9f":http://micewww.pp.rl.ac.uk/projects/x-boa/repository/entry/xboa/examples/XBOA9f |
| 36 | 8 | Rogers, Chris | |
| 37 | h2. Documentation |
||
| 38 | |||
| 39 | 18 | Rogers, Chris | Please see the "full documentation":http://micewww.pp.rl.ac.uk/maus/xboa/xboa-latest-version/doc/ |