western-us-biomass

Code analyzing changes in live aboveground forest biomass across the Western United States

Usage

This repository consists of code that reproduce the figures and numbers in our analysis of trends in live aboveground biomass in forests across the Western United States. First, you'll want to download a copy of the supporting data from Zenodo. Second, you'll want to update references in src/western_us_biomass/dir_info.py to refer to the location where you save the data files. From there, you're set to explore the analysis on your own.

Instructions

Set up the environment

# Clone the repository
git clone https://github.com/carbonplan/western-us-biomass.git
cd western-us-biomass

# Install dependencies with pixi
pixi install

# Activate the environment
pixi shell

Train model components

To train a single ensemble member:

sbatch src/western_us_biomass/train_models/submit_training_jobs_one_run.sh

To train multiple ensemble members:

sbatch src/western_us_biomass/train_models/submit_training_jobs_ensemble.sh

Run the model

To run multiple ensemble members:

sbatch src/western_us_biomass/run_model/submit_all_tiles_ensemble.sh

To run a single ensemble member:

sbatch src/western_us_biomass/run_model/submit_all_tiles_single_run.sh

Postprocess the model output

cd src/western_us_biomass/process_outputs
sbatch postprocess_output.sh

Make figures

Navigate to nbs/4_make_figures/ and run notebooks corresponding to each figure. Each figure is split into two notebooks: one notebook that processes all data for the figure into smaller intemediate data files, and another notebook that generates the figure from that data.

License

All the code in this repository is MIT-licensed, but we request that you please provide attribution if reusing any of our digital content (graphics, logo, articles, etc.).

About us

CarbonPlan is a nonprofit organization that uses data and science for climate action. We aim to improve the transparency and scientific integrity of climate solutions with open data and tools. Find out more at carbonplan.org or get in touch by opening an issue or sending us an email.