Code Map

This page summarizes the code a collaborator is most likely to need when recreating the Fire VASE data lake, manuscript analyses, or figures.

Start Here

• Reproduce the full data lake: Reproduce the Data Lake
• Reproduce manuscript figures: Reproduce the Figures
• Read script-level summaries: scripts/README.md

Data Lake Scripts

• prepare_data_lake.py: inventories, checksums, hardlinks, or copies the full handoff package.
• check_reproducibility.py: checks data-lake hashes, derived statistics, and figure pixel identity.
• generate_hero_vase.py: regenerates the transparent VPD-colored homepage hero from the data lake.
• generate_ai_transparency_report.py: regenerates the expanded AI transparency report and usage charts from repository evidence.
• config/data_release.yml: declares what belongs in the public data-lake release.

Dataset Construction Scripts

• cache_gridmet_years.py: downloads or refreshes the gridMET cache used for climate attribution.
• fire_vase_lakehouse_pilot.py: builds the manuscript lakehouse tables from FIRED inputs.
• fire_vase_build_climate_tables.py: builds centroid climate attribution tables.
• fire_vase_build_perimeter_climate_tables.py: builds active-area and perimeter-zone climate attribution tables.
• fire_vase_developmental_morphology_analysis.py: builds developmental morphology and morphospace products.

Figure Scripts

The easiest entry points are the numbered wrappers in manuscript_figures. They all share _figure_runner.py, which resolves data-lake paths and handles cached validation tables.

The shared figure-building code lives in scripts/figures. Those modules contain the actual Matplotlib figure logic.

Manuscript Artifacts

• main-16.pdf: narrative manuscript, titled The Developmental Morphospace of Wildfire.
• supplementary-2.pdf: working supplementary draft; unresolved insertion markers are not validated results.
• manuscript_v2.md: corrected technical manuscript and numerical authority for the current v2 analysis.
• build_fire_vase_google_docs_docx.py: builds the Google Docs-ready manuscript file.
• manuscript_climate_revision_science_style.md: historical climate-revision text retained for traceability.