Latest version of BO tutorial

Author: ansantam

.gitignore

@@ -0,0 +1,141 @@
+# Flug archives
+*.tar.zst
+*.json
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# virtual environment
+*_env/
+*-train-data/
+# model
+wandb/
+models/
+# slurm_log/

README.md

@@ -0,0 +1,52 @@
+# Numerical Methods of Accelerator Physics
+
+MSc lecture at TU Darmstadt, etit, TEMF by Adrian Oeftiger in 2022/23.
+
+Fourteenth part of a jupyter notebook lecture series, guest lecture held by Dr. Andrea Santamaria Garcia on 10.02.2023.
+
+Find the rendered HTML slides [here](https://aoeftiger.github.io/TUDa-NMAP-14/).
+
+---
+
+## Run online
+
+Run this notebook talk online, interactively on mybinder.org:
+
+[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/aoeftiger/TUDa-NMAP-14/v1.0)
+
+The `lecture.ipynb` notebook will work out-of-the-box.
+
+---
+
+## Run on TU Darmstadt jupyterhub
+
+If you have a TU ID, access the [local TU Darmstadt jupyterhub](https://tu-jupyter-i.ca.hrz.tu-darmstadt.de/) using your TU ID.
+
+A possible way to upload and run this lecture repository is the following:
+
+1. Open a terminal by clicking on the top right "New" -> "Terminal".
+
+2. A new tab opens with a terminal, click into the black area and enter (copy&pasting):
+
+``` bash
+wget https://github.com/aoeftiger/TUDa-NMAP-14/archive/refs/heads/main.zip
+unzip main.zip
+cd TUDa-NMAP-14-main
+```
+
+3. You have downloaded, unzipped and entered the lecture repository. As a last step, install the dependencies:
+
+``` bash
+export TMPDIR="`pwd`"
+pip install -r requirements_noversions.txt --prefix="`pwd`"/requirements
+``` 
+
+Close the terminal tab and open the `lecture.ipynb` notebook inside the repository directory on the jupyterhub main page.
+
+---
+
+## Run locally
+
+The notebook can of course also be run on your local computer using your own jupyter notebook server. Install such an environment e.g. via the extensive [Anaconda distribution](https://www.anaconda.com/products/distribution), the minimalistic [Miniconda distribution](https://docs.conda.io/en/main/miniconda.html) or the extremely fast [Mamba package manager](https://mamba.readthedocs.io/en/latest/). (The order indicates preference by simplicity in installation and usage.)
+
+You may find all required packages in the `requirements.txt` file.