Flatfielding Paper Files

This repository contains the scripts, figure files, and reduced data products used for the beam-flatfielding paper.

Layout

• Section2_Beamforming/: beamforming theory and array-gain scripts.
• Section4_Optimization/: flatfielding verification on raw-voltage-derived data.
• Section5_Simulations/: simulated tied-array beam diagnostics.
• Section6_RealData/: real-data figure scripts and flatfielding utilities.
• common/: shared helper modules.
• Figures/: frozen figure files included by the manuscript.
• data/: local reduced inputs for Section 2 and Section 4.
• plots_output/: cached reduced real-data products used by fast plotting scripts.
• latex/: manuscript source.
• zenodo/: notes on the Zenodo upload contents.
• tools/build_zenodo_release.py: collects a Zenodo upload directory from the repository and the local reduced data products.

Dependencies

Install the Python requirements with:

python -m pip install -r requirements.txt

The main dependencies are numpy, matplotlib, scipy, h5py, astropy, lofarantpos, and PyYAML.

Data Paths

The repository uses two data mechanisms:

• Section 2 / Section 4 scripts load reduced .npy products via PAPER_PLOTS_DATA_DIR, defaulting to data/.
• Section 6 scripts load reduced FITS and PRESTO outputs via PAPER_PLOTS_REAL_DATA_DIR, defaulting to data/real_data/ and falling back to the local /project/euflash/Data/flatfielding tree if the packaged data are not present.

Optional overrides:

export PAPER_PLOTS_DATA_DIR=/path/to/data
export PAPER_PLOTS_REAL_DATA_DIR=/path/to/real_data
export PAPER_PLOTS_FF_FITS_DIR=/path/to/ff_fits
export PAPER_PLOTS_OG_FITS_DIR=/path/to/og_fits
export PAPER_PLOTS_SPS_FF_DIR=/path/to/sps/ff
export PAPER_PLOTS_SPS_OG_DIR=/path/to/sps/og

Paper Figures

The manuscript includes these frozen figure files:

Figures/beamforming/coh_to_incoh.png
Figures/verification/flatfield_null_response.png
Figures/verification/flatfield_dynamic_panels.png
Figures/verification/statistics_histogram.png
Figures/verification/flatfield_regime_map.png
Figures/simulations/coh_maps.png
Figures/simulations/beam_scatter.png
Figures/simulations/phase_concentration_offsets.png
Figures/real_data/beam_power_j0250.png
Figures/real_data/overview.png
Figures/real_data/rednoise_comparison.png
Figures/real_data/folded_ff.png
Figures/real_data/folded_og.png
Figures/real_data/folded_profile_comparison.png

Zenodo Upload

To collect the Zenodo upload directory, run:

python tools/build_zenodo_release.py

This writes, by default:

dist/flatfielding-paper-zenodo/

The output directory contains:

• source scripts needed for the paper
• frozen manuscript figures
• reduced .npy, .npz, FITS, and .singlepulse inputs needed to rerun the published figures
• short notes on the uploaded contents