DWF for Sp(4) gauge theories and Nf = 2 fundamental fermions

This repository contains a collection of Python scripts and supporting files used to analyze lattice field theory data for DWFs + Sp(4) gauge theory with Nf = 2 fundamental fermions. The main focus is on performing Wilson Flow analyses, extracting masses and matrix elements from correlators, fitting spectral properties, and studying chiral dynamics.

---

Authors

Niccolò Forzano, Ed Bennett, Luigi Del Debbio, Ryan C. Hill, Deog Ki Hong, Jong-Wan Lee, C.-J. David Lin, Biagio Lucini, Maurizio Piai, Davide Vadacchino, Peter Boyle.

---

Cloning the code

• Clone the repo.

---

🔧 Set up environments

• Download this code

• From the [data release][datarelease]

  • Download WF_cfgs.zip/, and place it in WF_cfgs/
  • Then, download cfgs.zip/ and place it in cfgs/

• Create the environment

  conda env create -f my-new-env.yml
  

  If you are using an Apple silicon CPU, ensure that you are running Conda 24.3 or later, and use the command

  conda env create -p osx-64 -f my-new-env.yml
  

  You can activate the environment using

  conda activate my-new-env2
  

---

📁 Repository Structure

• WF_cfgs/ — Raw Wilson Flow configurations (from GRID)
• cfgs/ — Raw hadron correlator measurements
• CSVs/ — CSV results from data extraction and analysis
• plots/ — Output plots generated by the scripts

---

📜 Main Scripts

Script	Description
spectrum_and_decay.py	Fit correlators and extract mass spectrum and decay constants
WF_and_Q.py	Analyze Wilson Flow and compute topological charge
plot_WF_E.py	Plot energy density from Wilson Flow
plot_topcharge.py	Plot topological charge evolution
NLO_w0.py	Compute Wilson Flow reference scales w₀ at NLO for plotting
GMOR_and_mV_mPS_ratio.py	Test GMOR relation and compute vector/pseudoscalar mass ratio
pcac.py	Compute PCAC mass from correlators
perform_chiPT.py	Perform chiral perturbation theory fits
g5g5.py, pj5q.py	Specifics for correlators extraction and Ward identities
extract_hdf5_files.py	Convert raw HDF5 data into analysis-ready format

---

🎨 Style

• paperdraft.mplstyle — Custom matplotlib style for consistent plotting

---

📦 Compressed Files

• WF_cfgs.zip, cfgs.zip — Compressed versions of raw data directories for portability

---

License

[datarelease]: https://doi.org/##.####/zenodo.######## TODO GPL