DOI: 10.5281/zenodo.11967838
title: Experimental data, analysis scripts and simulations for "Emittance preservation in a plasma-wakefield accelerator"

description: 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.