Simulations: Rotating Sensing Using Tractor Atom Interferometry

Prerequisites

Julia 1.8.5 (install with juliaup)
IJulia installed into the main Julia 1.8.5 environment. Make sure the kernel is properly installed by running using IJulia; installkernel("Julia", "--project=@.") in the Julia REPL.

Jupyter Lab with jupytext extension. Recommended to install via miniforge:

conda install jupyterlab notebook jupyterlab_execute_time nbdime jupytext ipywidgets ipyparallel python-localvenv-kernel markdown-kernel

Environment instantiation

Run julia --project=. in a checkout of this project and then ] instantiate in the resulting REPL.
Consider running make -j4 ipynb (where 4 is the number of available cores) to create missing .ipynb files from the available .jl notebook files. Or make <name of notebook.ipynb> to create a particular notebook. Generating all notebooks may take several hours, so this is best run overnight.

Notebooks

In a terminal, from a checkout of this project, run JULIA_NUM_THREADS=auto jupyter lab
The jupytext extension ensures that the .jl files in the root folder can be opened as notebooks. Saving a notebook will automatically create a corresponding .ipynb file. In principle, the .jl and .ipynb files can be used interchangeable, although some features of Jupyter work better when opening the .ipynb files.

See #INDEX.md for an overview of the notebooks. Assuming make ipynb has been run, the links in that file can be used to open any of the notebooks.