Experimental data, analysis scripts and simulations for "Emittance preservation in a plasma-wakefield accelerator"

This dataset presents the experimental data, the analysis scripts and the accompanying simulations for the article "Emittance preservation in a plasma-wakefield accelerator" by C. A. Lindstrøm et al. [Nat. Commun. 15, 6097 (2024)]. The data was collected at the FLASHForward facility at DESY (Hamburg, Germany). Simulations were performed using HiPACE++ v23.11. Folder structure: Folders containing experimental data: Folder 1A_DATA__OBJECT_PLANE_SCANS contains all data from object-plane scans (emittance measurements). Folder 1B_DATA__SPECTRUM_MEASUREMENT contains all data from energy-spectrum measurements. Folder 1C_DATA__TWO_BPM_TOMOGRAPHY contains all data from two-BPM tomography measurements. Folder 1D_DATA__BEAM_RECONSTRUCTION contains all data from beam-reconstruction measurements (including longitudinal-phase-space measurements). Folder 1E_DATA__PLASMA_DENSITY contains all data from plasma-density measurements (spectral-line broadening). Folder 2_ANALYSIS contains all the data-analysis scripts, required for plotting experimental figures. Folder 3_SIMULATION contains all simulation scripts, required for generating 6D beam phase spaces and plotting simulation figures. Folder 4_FIGURES contains all figure-plotting scripts (17 figures total). Dataset structure: Each dataset is identified by a 5-digit number (e.g., 14275) Metadata and beam-synchronous scalar values are contained in a .mat dataset file (e.g., 14275.mat). The dataset file has the following fields: .metadata containing all the generic metadata .state containing all the non-beam-synchronous data (once per dataset; magnet settings etc.) .scalars containing all the beam-synchronous scalar data (once per shot; BPM readings etc.) .vectors containing all the beam-synchronous vector data (once per shot; scope traces etc.) .images containing all the beam-synchronous image data, with relative URLs (once per shot; spectrometer images etc.) The corresponding images (linked from the .mat file) are contained in the images folder, sorted by scan step. Instructions for plotting all figures*: Change directory to 4_FIGURES/ In MATLAB, run plot_all_figures(); The 4 main figures and 13 supplementary figures will be plotted Instructions for generating the 6D phase space for simulations*: Change directory to 3_SIMULATION/input_beam_generation/ In MATLAB, run generate_beam_and_plasma(); The full analysis will up to several minutes (the files are stored in the _files folder) Instructions for performing HiPACE++ simulations*: Change directory to e.g. 3_SIMULATION/simulations/experimental_cell_50mm/ The HiPACE++ input file is called input_file This file refers to the plasma profile (plasma_short.csv) and beam files (beam.h5 and driver.h5) found in 3_SIMULATION/run_notebooks/inputs/ Instructions for re-performing all the analysis*: Change directory to 2_ANALYSIS/ In MATLAB, run run_all_analyses(); The full analysis will up to several hours (the files are stored in various _files folders) * The scripts use UNIX system calls and are only compatible with Linux and Mac, but not Windows.