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.

本数据集配套于C. A. 林斯特伦（C. A. Lindstrøm）等人发表于《自然·通讯》（Nat. Commun.）2024年第15卷第6097页的论文"Emittance preservation in a plasma-wakefield accelerator"，包含实验数据、分析脚本及配套模拟结果。

本数据集的实验数据采集于德国汉堡德意志电子同步加速器（DESY）的FLASHForward实验装置，模拟工作基于HiPACE++ v23.11版本完成。

文件夹结构：

含实验数据的子文件夹如下：

1A_DATA__OBJECT_PLANE_SCANS：收录所有物面扫描（发射度测量）相关数据。
1B_DATA__SPECTRUM_MEASUREMENT：收录所有能谱测量相关数据。
1C_DATA__TWO_BPM_TOMOGRAPHY：收录所有双束流位置监测器（Beam Position Monitor, BPM）层析成像测量相关数据。
1D_DATA__BEAM_RECONSTRUCTION：收录所有束流重建测量相关数据（含纵向相空间测量数据）。
1E_DATA__PLASMA_DENSITY：收录所有等离子体密度测量（谱线展宽）相关数据。

2_ANALYSIS：收录绘制实验图所需的全部数据分析脚本。
3_SIMULATION：收录生成6维束流相空间及绘制模拟图所需的全部模拟脚本。
4_FIGURES：收录所有绘图脚本（共计17幅图）。

数据集结构：

每个数据集以5位数字编号标识（例如14275）。
元数据与束流同步标量值存储于.mat格式数据集文件中（例如14275.mat），该文件包含以下字段：
.metadata：存储所有通用元数据；
.state：存储所有非束流同步数据（每个数据集仅一份，如磁体设置等）；
.scalars：存储所有束流同步标量数据（每次束团脉冲（shot）一份，如束流位置监测器读数等）；
.vectors：存储所有束流同步矢量数据（每次束团脉冲（shot）一份，如示波器波形等）；
.images：存储所有束流同步图像数据，附带相对URL（每次束团脉冲（shot）一份，如能谱仪图像等）。

.mat文件链接的对应图像存储于images文件夹中，按扫描步长排序。

全图绘制指南*：
1. 切换工作目录至4_FIGURES/；
2. 在MATLAB中运行plot_all_figures();
即可生成4幅主图与13幅补充图。

模拟6维相空间生成指南*：
1. 切换工作目录至3_SIMULATION/input_beam_generation/；
2. 在MATLAB中运行generate_beam_and_plasma();
完整分析过程耗时可达数分钟，生成的文件将存储于_files文件夹中。

HiPACE++模拟运行指南*：
1. 切换工作目录至例如3_SIMULATION/simulations/experimental_cell_50mm/；
HiPACE++的输入文件名为input_file，该文件引用了3_SIMULATION/run_notebooks/inputs/路径下的等离子体轮廓文件（plasma_short.csv）及束流文件（beam.h5与driver.h5）。

全分析复现指南*：
1. 切换工作目录至2_ANALYSIS/；
2. 在MATLAB中运行run_all_analyses();
完整分析过程耗时可达数小时，生成的文件将存储于各_files文件夹中。

* 本脚本使用UNIX系统调用，仅兼容Linux与Mac操作系统，不支持Windows系统。