Skip to main content

Breathing Earth System Simulator (BESS) Model Python Implementation

CI

This software package is a Python implementation of the Breathing Earth System Simulator (BESS) model. It was re-implemented in Python by Gregory Halverson at Jet Propulsion Laboratory based on MATLAB code produced by Youngryel Ryu at Seoul University. The BESS model was designed to quantify global gross primary productivity (GPP) and evapotranspiration (ET) using MODIS with a spatial resolution of 1–5 km and a temporal resolution of 8 days. It couples atmospheric and canopy radiative transfer processes with photosynthesis, stomatal conductance, and transpiration models on sunlit and shaded portions of vegetation and soil. An artificial neural network emulator of Hideki Kobayashi's Forest Light Environmental Simulator (FLiES) radiative transfer model is used to estimate incoming solar radiation. This implementation of BESS was designed to process GPP at fine spatial resolution using surface temperature from the ECOsystem Spaceborne Thermal Radiometer Experiment on Space Station (ECOSTRESS) mission and normalized difference vegetation index (NDVI) and albedo from the Spatial Timeseries for Automated high-Resolution multi-Sensor (STARS) data fusion system. The software was developed as part of a research grant by the NASA Research Opportunities in Space and Earth Sciences (ROSES) program. It was designed for use by the ECOSTRESS mission as a precursor for the Surface Biology and Geology (SBG) mission. However, it may also be useful for general remote sensing and GIS projects in Python. This package can be utilized for remote sensing research in Jupyter notebooks and deployed for operations in data processing pipelines. This software is being released according to the SPD-41 open-science requirements of NASA-funded ROSES projects.

Gregory H. Halverson (they/them)
gregory.h.halverson@jpl.nasa.gov
Lead developer
NASA Jet Propulsion Laboratory 329G

Youngryel Ryu (he/him)
yryu@snu.ac.kr
BESS algorithm inventor
Seoul National University

Hideki Kobayashi (he/him)
hkoba@jamstec.go.jp
FLiES algorithm inventor
Japan Agency for Marine-Earth Science and Technology

Robert Freepartner (he/him)
robert.freepartner@jpl.nasa.gov
MATLAB to python translation
Raytheon

Joshua Fisher (he/him)
jbfisher@chapman.edu
Concept development and project management
Chapman University

Kerry Cawse-Nicholson (she/her)
kerry-anne.cawse-nicholson@jpl.nasa.gov
Project management
NASA Jet Propulsion Laboratory 329G

Zoe Pierrat (she/her)
zoe.a.pierrat@jpl.nasa.gov
Algorithm maintenance
NASA Jet Propulsion Laboratory 329G

Claire Villanueva-Weeks (she/her)
claire.s.villanueva-weeks@jpl.nasa.gov
Code maintenance
NASA Jet Propulsion Laboratory 329G

Installation

Use the pip package manager to install this package

pip install breathing-earth-system-simulator

References

The following scientific references provide detailed information about the BESS model and its underlying algorithms:

  1. Ryu, Y., Baldocchi, D. D., Kobayashi, H., van Ingen, C., Li, J., Black, T. A., ... & Ueyama, M. (2011). Integration of MODIS land and atmosphere products with a coupled-process model to estimate gross primary productivity and evapotranspiration from 1 km to global scales. Remote Sensing of Environment, 115(8), 1865-1874. https://doi.org/10.1016/j.rse.2011.03.009

  2. Kobayashi, H., Ryu, Y., Baldocchi, D. D., Welles, J. M., & Norman, J. M. (2012). On the correct estimation of gap fraction: How to remove scattered radiation in gap fraction measurements? Agricultural and Forest Meteorology, 160, 14-25. https://doi.org/10.1016/j.agrformet.2012.03.001

  3. Fisher, J. B., Lee, B., Purdy, A. J., Halverson, G. H., Dohlen, M. B., & Tu, K. P. (2020). ECOSTRESS: NASA's next generation mission to measure evapotranspiration from the International Space Station. Water Resources Research, 56(4), e2019WR026058. https://doi.org/10.1029/2019WR026058

  4. Ryu, Y., Jiang, C., Kobayashi, H., & Detto, M. (2018). Modis-derived global land products of shortwave radiation and diffuse and total photosynthetically active radiation at 5 km resolution from 2000. Remote Sensing of Environment, 204, 812-825. https://doi.org/10.1016/j.rse.2017.09.021

  5. Kobayashi, H., & Iwabuchi, H. (2008). A coupled 1-D atmosphere and canopy radiative transfer model for an atmosphere with a nonlambertian surface. Journal of Quantitative Spectroscopy and Radiative Transfer, 109(17-18), 2955-2970. https://doi.org/10.1016/j.jqsrt.2008.07.008

Metadata

Release files for BESS-JPL 1.28.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for BESS-JPL 1.28.0
File Size Uploaded
bess_jpl-1.28.0.tar.gz 52.2 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for BESS-JPL 1.28.0
File Interpreter ABI Platform
bess_jpl-1.28.0-py3-none-any.whl Python 3 none any Details

Total release size: 104.0 MB

Release files / bess_jpl-1.28.0.tar.gz

Download URL bess_jpl-1.28.0.tar.gz
Size 52.2 MB
Tags Source
SHA-256 checksum
How to use checksums
04d4cdab9f3b612616705db42c226023b9b62cfb32f860aa6a30d7397f645f37
BLAKE2b-256 checksum
How to use checksums
5869ab12b2396c71525fc212f9bc2422b744ba11fd128379a7b54c2755a693e8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.9.25

Release files / bess_jpl-1.28.0-py3-none-any.whl

Download URL bess_jpl-1.28.0-py3-none-any.whl
Size 51.8 MB
Tags Python 3
SHA-256 checksum
How to use checksums
dcc3379d57c5986708e5b735a6bddde98703e25d1474e3d6d3fa91387ccf7989
BLAKE2b-256 checksum
How to use checksums
38e7cc9b80751e028e391631c6e1f73d2eae8d4e07aecd5e349e3318fcc443d7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.9.25

Release history Release notifications | RSS feed

This release

1.28.0 This release

2 release files

1.27.0

2 release files

1.26.1

2 release files

1.26.0

2 release files

1.25.0

2 release files

1.24.0

2 release files

1.23.0

2 release files

1.22.0

2 release files

1.21.0

2 release files

1.20.1

2 release files

1.20.0

2 release files

1.19.1

2 release files

1.19.0

1 release file

1.18.0

1 release file

1.17.0

2 release files

1.16.0

2 release files

1.15.1

2 release files

1.11.0

2 release files

1.9.2

2 release files

1.9.1

2 release files

1.9.0

2 release files

1.8.0

2 release files

1.7.0

2 release files

1.6.1

2 release files

1.6.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page