Data and code for "Slice Emittance Preservation and Focus Control in a Passive Plasma Lens"

This repository contains the source data, simulation codes, and plotting scripts for the Physical Review Research article "Slice Emittance Preservation and Focus Control in a Passive Plasma Lens" by this dataset's authors. How-to All data analysis and simulation results are already present in the dataset and can be plotted using the associated plotting scripts located in the plotting directory. Following plotting, figures should be exported to PDF using the built-in MATLAB functionality in the figure window. The structure of the experimental data follows the format outlined in Experimental data, analysis scripts and simulations for "Emittance preservation in a plasma-wakefield accelerator". To do the analysis from scratch, the experimental data analysis and beam reconstruction should be run first via the exp_analysis_main.m script, followed by the simulation setup, execution, and post-processing. The simulations (apart from those corresponding to Figure 1 in the above article, the 2D_scan set in the simulations catalog) use the reconstructed beams as input, and therefore need the two reconstructedBeamParams_2023_*.mat files that are the final output of the experimental analysis. The simulation analysis output files (simOutput_*.mat) should be placed in simulations/sim_input/data/*/ -> simulation/sim_output/ for the plotting scripts to find them. Before running the simulations corresponding to Figure 4 in the above article (the 2023_07 set in the catalog), a plasma density file must be generated (if not already present) with the generate_density_table_2023_07.ipynb notebook in the utilities folder. The src folder is the install directory for HiPACE++ and should contain a subfolder named hipace that in turn contains the simulation code installation. Some of the raw simulation data, corresponding to Figures 5 and 6 in the associated paper, has not been included in this repository in an effort to save space. This data is not used for any plots, but was necessary to sample the peak plasma densities, so figures should be reproduced correctly nonetheless. Software versions and related information The experimental data analysis was finalized with MATLAB R2025b on macOS Tahoe 26.4. Some effort was made to make the data analysis OS-agnostic, but there is no guarantee it will run flawlessly on your system; some tinkering may be required. The simulations were performed on a Linux-based HPC cluster (MAXWELL at DESY). The simulation setup and data processing were done with Python 3.14 (full mamba environment can be found inside the simulations folder), and HiPACE++ v24.08 (using CUDA v12.3.107) was used for the PIC simulations.