Hands-On Lattice and Longitudinal Calculations - Python version

D. Gamba, A. Latina, T. Prebibaj, A. Poyet, G. Russo, G. Sterbini, V. Ziemann

During the CAS 2023 in Santa Susanna (Spain), we will be using Python as scripting languages for the Hands-On Lattice Calculation course.

This repository contains all material used during the the course. The repository is based on the material prepared and updated during previous courses by G. Sterbini, A. Latina, A. Poyet, CERN and V. Ziemann, Uppsala University.

• Setup_Instructions.md contains all information to get ready for the course. We kindly ask the student to read this document before coming to CAS to prepare yourself (and your laptop) for the course.
• CAS_Optics_Primer.pdf is the primer of the course. You are invited to consult it before, during, and after the course.
• The *.ipynb notebooks will be the "canvas" used during the course. They contain all exercise with "incomplete" parts that the student will have to fill in. Solutions to all the exercises are also provided in *-solution.ipynb. These notebooks are provided for the student convenience, but they are clearly not expected to be used before and/or during the course itself...
  • 01_Guided_Exercises Guided/already solved exercises to introduce the hands-on course.
  • 02_Single_Particle_Beamline Exercises to probe single particle dynamics.
  • 03_Multi_Particles_Beamline Exercises to probe multi-particle dynamics.
  • 04_Periodic_Systems Exercises to probe the concept of peridic systems.
  • 05_Advanced_Exercises Advanced exercises, including matching, non-linear dynamics, ...

NOTE: the material in this repository is expected to evolve over time thanks to the feedback received from you! Please don't hesitate to transmit us your comments, suggestions, and complains!

Known schools using this material

• CAS 2023 in Santa Susanna
• CAS 2022 in Kaunas
• CAS 2021 in Chavannes-des-Bogis

Notes for the maintainer and presenter

Edit the material

The material is hosted on github under the cerncas organisation and mirrored (for backup purposes) to the CERN GitLab CAS group. One is expected to edit the material:

1. from github directly using the github editor
2. from one's computer cloning the repository, editing/adding/deleting the desired content, finally pushing the content to github

(CERN) GitLab vs GitHub

See article KB0003132 to learn about CERN policy. To setup a "Pull mirroring" on the CERN GitLab to retrieve a copy of GitHub repository, see the official documentation.

Create a pdf of an .md file

The typically suggested way is to use pandoc package:

pandoc Setup_Instructions.md -o Setup_Instructions.pdf

unfortunately, this doesn't work when you have HTML inside your .md file, as we presently have... A solution could be to use the Print extension for VisualStudio...

During the course

The students are expected to download the whole repository on their computer, and open the various notebooks using Jupyter Lab. The presenter can also use Jupyter Lab and do the exercise with the students. To launch Jupyter Lab, move in a terminal to this folder and execute:

jupyter lab

One can also present 01_Guided_Exercises-solution.ipynb in presentation mode:

jupyter nbconvert 01_Guided_Exercises-solution.ipynb --to slides --post serve

Alternatively, one can:

• create a html of the slides:

  jupyter nbconvert 01_Guided_Exercises-solution.ipynb --to slides

• create a pdf of the slides:

  conda install pandoc
  jupyter nbconvert 01_Guided_Exercises-solution.ipynb --to pdf