Sovereign 8s.is mirror of standardgalactic/BubbleTurbPub
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-09-10 17:19:30 +08:00
code Simplify public documentation and limit catalogue release 2026-09-10 17:19:30 +08:00
data Align public data and figure reproduction with final Nature Astronomy results 2026-09-10 17:08:25 +08:00
initial_script Align public data and figure reproduction with final Nature Astronomy results 2026-09-10 17:08:25 +08:00
plot Align public data and figure reproduction with final Nature Astronomy results 2026-09-10 17:08:25 +08:00
.gitignore Simplify public documentation and limit catalogue release 2026-09-10 17:19:30 +08:00
DATA.md Align public data and figure reproduction with final Nature Astronomy results 2026-09-10 17:08:25 +08:00
INITIAL_SCRIPT.md Align public data and figure reproduction with final Nature Astronomy results 2026-09-10 17:08:25 +08:00
LEGACY.md Simplify public documentation and limit catalogue release 2026-09-10 17:19:30 +08:00
LICENSE ok 2026-04-02 00:38:32 +08:00
README.md Simplify public documentation and limit catalogue release 2026-09-10 17:19:30 +08:00
RELEASE_NOTES.md Simplify public documentation and limit catalogue release 2026-09-10 17:19:30 +08:00
requirements.txt Align public data and figure reproduction with final Nature Astronomy results 2026-09-10 17:08:25 +08:00
SCRIPTS.md Simplify public documentation and limit catalogue release 2026-09-10 17:19:30 +08:00

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

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.