- Python 100%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
| code | ||
| data | ||
| initial_script | ||
| plot | ||
| .gitignore | ||
| DATA.md | ||
| INITIAL_SCRIPT.md | ||
| LEGACY.md | ||
| LICENSE | ||
| README.md | ||
| RELEASE_NOTES.md | ||
| requirements.txt | ||
| SCRIPTS.md | ||
M31 H I Superbubbles and Turbulence
Data and figure-generation code for the study of M31 H I superbubbles and turbulence.
The plotting catalogue and equations match the final paper: 118 bubbles, the final global-ring H I densities, native expansion velocities, and the adopted momentum, expansion-time and supernova-count calculations. See the catalogue definitions and figure index. Changes, including the source-data-consistent S4 histogram, are summarized in RELEASE_NOTES.md.
Quick start
Use Python 3.12 in an isolated environment:
git clone https://github.com/fanyimeng/BubbleTurbPub.git
cd BubbleTurbPub
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
python plot/p_per_sn_vs_nsn.py
This small-table demo requires no FITS download. It writes
output/p_per_sn_vs_nsn.pdf, using all 118 final catalogue entries. The expected
paper output is plot/p_per_sn_vs_nsn.pdf.
For the table-only supplementary figures together:
python plot/build_paper_figures.py S3 S4 S7
Generated figures, caches and intermediate tables go to ignored directories;
the reference PDFs in plot/ and released input tables are preserved.
Data
- Final 118-bubble catalogue, with column definitions and conventions.
- Source Data and Supplementary Data: unchanged copies of the final submitted workbooks.
- Final turbulence profiles, Brinks comparison data and the frozen FM/RL
diagnostic plotting tables are included under
data/.
The large image-data archive is available from Tsinghua Cloud. The archive was distributed as approximately 6 GB compressed and 18 GB restored. Use its restoration instructions to recover the original analysis grids; rotating an image for display does not preserve the pixel coordinates used here.
DATA.md lists the filenames and additional products required by each
figure. FITS data are not stored in this Git repository. Personal-computer
symlinks have been removed. Place the required files under data/ or use local
symlinks there; neither will be committed by default.
Reproduce figures
After preparing the required data:
python plot/build_paper_figures.py 1 2 3 4
python plot/build_paper_figures.py S5 S6 S8 S9 S10 S12 S13 S14
The PV examples additionally require the two validated subcubes; the ROHSA overview requires existing fit products and cone masks:
python plot/build_paper_figures.py S2 S11
python plot/build_paper_figures.py --all runs all 18 figure entry points.
Individual scripts can also be run directly, from any working directory.
See SCRIPTS.md for the exact mapping and outputs.
The ROHSA figure redraws existing decompositions; it does not refit the cube.
Environment and validation
The updated scripts were checked with Python 3.12 on macOS arm64 using NumPy 2.4.2,
pandas 3.0.1, Astropy 7.2.0, Matplotlib 3.10.8 and SciPy 1.17.1.
Seaborn is used for the axis-ratio histogram; pypdf composes vector PDF panels.
requirements.txt lists compatible version ranges for these scripts.
The small-table demo takes a few seconds after the initial font-cache build. FITS-dependent figures require more time and memory; the full cube/ROHSA path requires the external data. Allow at least 30 GB free disk space for the restored archive and outputs. No GPU is required for the plotting commands.
Historical code
initial_script/ contains the original catalogue/PV utilities. Earlier plot
variants are retained for provenance and listed in LEGACY.md.
They are not the final-paper reproduction entry points above.
Article access and rights
This repository distributes supporting code, numerical data and standalone outputs generated by the code. It does not distribute manuscript text, accepted manuscripts, proofs, the publisher's article PDF or the complete Supplementary Information document.
The software licence does not grant rights to redistribute the published article. Article sharing is governed by the applicable publication licence.