Skip to content
David Bruhwiler edited this page Jul 26, 2016 · 2 revisions

What is rssynergia?

Utilities for working with the Synergia framework, maintained by Fermilab

Running Synergia Notebooks on RadiaSoft's Jupyter server

To get started you will need to log into jupyter.radiasoft.org using a GitHub account. Once you've logged in and started the server you can hit the 'new' button on the right hand side and select 'Terminal' to open a Linux command line environment.

You can then add several of our repos to get started using Synergia in a notebook. You'll want to do:

> mkdir my_directory_name
> cd my_directory_name
> git clone https://github.com/radiasoft/rssynergia
> git clone https://github.com/radiasoft/ioptics

The 'rssynergia' repo contains an 'examples' folder with several notebooks showing the running of Synergia and subsequent data analysis. The best places to start are probably either the 'drift_expansion' or 'iota_examples' folders.

'drift_expansion' has a notebook which examines the expansion of a coasting beam in a drift and compares the simulated result to theoretical calculation. If you want to see the running of an IOTA simulation in Synergia we have two notebooks in 'iota_examples' that run through the setup of the lattice and bunch and go through some simple analysis, one with a zero-current bunch and the other with space charge included.

If you haven't used an IPython notebook it is basically an interactive Python environment. The notebook is made up of cells that you can write Python code into. A cell can be executed using 'shift + enter'. The serial version of Synergia can be run directly within the notebook and then the same notebook can be used for post-processing and analysis of the data. Plots and graphics, such as from matplotlib can also be displayed directly within the notebook.

Clone this wiki locally