LightWin 0.12.1

Automatically compensate cavity failures in linacs

LightWin

LightWin is a tool to automatically find compensation settings for cavity failures in linacs.

Installation

The full installation instructions are detailed here.

The steps are straightforward and can be summarized as follows:

1. Create a dedicated Python environment.
2. Run pip install lightwin

If you want to edit the source code:

1. Clone the repository: git clone [e-mail]:AdrienPlacais/LightWin.git

   [!WARNING] If you Download ZIP this repository (which can happen if you don't have access to git), installation will fail at step #3. A workaround is proposed in the documentation.

2. Create a dedicated Python environment.
3. From LightWin folder: pip install -e .[test]
4. Test that everything is working with pytest -m "not tracewin and not implementation".

[!NOTE] If you are completely new to Python and these instructions are unclear, check this tutorial. In particular, you will want to:

1. Install Python 3.12 or higher.
2. Learn to use Python environments, pipenv or virtualenv.
3. Install a Python IDE such as Spyder or VSCode.

[!NOTE] Note that the TraceWin module will not work out of the box. You will need to tell LightWin were to find your TraceWin executables. See dedicated instructions.

Documentation

Documentation is now automatically built and hosted on Read the docs.

How to run

See here.

Example

See the data/example folder.