gleam

R package implementing the FAO GLEAM model to simulate livestock systems and estimate emissions based on herd, feed, and energy flows.
https://github.com/un-fao/gleam

Category: Consumption
Sub Category: Agriculture and Nutrition

Keywords

dpg-candidate

Last synced: about 6 hours ago
JSON representation

Repository metadata

R package implementing the FAO GLEAM model to simulate livestock systems and estimate emissions based on herd, feed, and energy flows.

README.md

gleam: The GLEAM R Package

The official R package of the FAO's Global Livestock Environmental Assessment Model (GLEAM).

This package provides a modular implementation of GLEAM to quantify environmental impacts from livestock agrifood systems.
The model simulates herd dynamics and quantifies key metrics, including animal-sourced food production, energy requirements and
feed intake, nitrogen balance, and greenhouse gas emissions from enteric fermentation, manure management, and upstream feed production.
The package also allocates estimated emissions to major animal products and services.

Purpose

This package supports the sustainable transformation of livestock systems by enabling evidence-based decision-making through
a transparent and reproducible modeling framework.

The official GLEAM workflow allows users to:

  • Simulate steady-state herd dynamics to disaggregate animal herds into age and sex-specific cohorts
  • Compute annual production of animal products and herd growth rate
  • Estimate animal energy requirements for maintenance, activity, growth, lactation, pregnancy, work, eggs, and fiber production
  • Compute nutritional contributions of user-defined feed rations per cohort
  • Estimate dry matter intake and nitrogen balance
  • Estimate methane (CH4) emissions from enteric fermentation
  • Estimate CH4 and nitrous oxide (N2O) emissions from manure management
  • Estimate carbon dioxide (CO2), CH4, and N2O emission related to the production, processing and transport of feed
  • Allocate estimated emissions to major animal products and services

Model Coverage

The model currently considers cattle, buffalo, camels, goats, pigs, and sheep.

Installation

To install the development version of the package:

# If devtools is not installed
install.packages("devtools")

# Install from GitHub
devtools::install_git("https://github.com/un-fao/GLEAM.git")

Help & Contact

We kindly ask users to inform us of your usage, as this helps us track the tool’s impact and guide future improvements. Please also get in touch with the GLEAM development team for documentation, internal guidance, or technical questions.

License

This package is licensed under the AGPL-3 license which permits free use, modification, and sharing of the software. Under AGPL-3.0, any modifications to the code must be made publicly available by creating a new branch on GitHub. The software cannot be relicensed under more restrictive terms without adhering to the AGPL-3.0 guidelines. Developers may anonymize or remove any sensitive or identifiable data (customizations) before resubmitting code.

Acknowledgement

The development of the GLEAM ecosystem was supported by the German Federal Ministry of
Food, Agriculture, and Regional Identity BMELH.



Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: about 6 hours ago

Total Commits: 810
Total Committers: 13
Avg Commits per committer: 62.308
Development Distribution Score (DDS): 0.681

Commits in past year: 579
Committers in past year: 13
Avg Commits per committer in past year: 44.538
Development Distribution Score (DDS) in past year: 0.656

Name Email Commits
ahmedjoubest a****t@g****m 258
lydialanzoni “****i@f****” 218
elaouniyassine e****0@g****m 201
Tempio g****o@f****g 36
ahmedjoubest a****d@a****r 30
Dominik Wisser d****r@g****m 23
lydialanzoni l****i@f****m 22
lydialanzoni l****i@f****g 6
ManlingXu o****g@g****m 5
David OBrien d****f@g****m 5
Rakotovao n****o@f****g 3
Wang w****2@g****m 2
chikomolas c****t@g****m 1

Committer domains:


Issue and Pull Request metadata

Last synced: 1 day ago

Total issues: 0
Total pull requests: 10
Average time to close issues: N/A
Average time to close pull requests: 23 days
Total issue authors: 0
Total pull request authors: 2
Average comments per issue: 0
Average comments per pull request: 3.8
Merged pull request: 2
Bot issues: 0
Bot pull requests: 0

Past year issues: 0
Past year pull requests: 10
Past year average time to close issues: N/A
Past year average time to close pull requests: 23 days
Past year issue authors: 0
Past year pull request authors: 2
Past year average comments per issue: 0
Past year average comments per pull request: 3.8
Past year merged pull request: 2
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/un-fao/gleam

Top Issue Authors

Top Pull Request Authors

  • lydialanzoni (6)
  • ahmedjoubest (4)

Top Issue Labels

Top Pull Request Labels

  • Feature (4)

Package metadata

cran.r-project.org: gleam

Global Livestock Environmental Assessment Model (GLEAM-X)

  • Homepage: https://github.com/un-fao/GLEAM/
  • Documentation: http://cran.r-project.org/web/packages/gleam/gleam.pdf
  • Licenses: AGPL-3
  • Latest release: 0.8.0 (published 5 months ago)
  • Last Synced: 2026-09-23T01:05:17.190Z (1 day ago)
  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 319 Last month
  • Rankings:
    • Dependent packages count: 24.036%
    • Dependent repos count: 29.642%
    • Average: 46.477%
    • Downloads: 85.752%
  • Maintainers (1)

Dependencies

DESCRIPTION cran
  • R >= 4.4.0 depends
  • cli >= 3.0.0 imports
  • data.table >= 1.16.0 imports
  • knitr * suggests
  • rmarkdown * suggests
  • testthat >= 3.2.0 suggests
.github/workflows/R-CMD-check.yaml actions
  • actions/checkout v4 composite
  • r-lib/actions/check-r-package v2 composite
  • r-lib/actions/setup-pandoc v2 composite
  • r-lib/actions/setup-r v2 composite
  • r-lib/actions/setup-r-dependencies v2 composite
gleam/DESCRIPTION cran
  • R >= 4.4.0 depends
  • cli >= 3.0.0 imports
  • data.table >= 1.16.0 imports
  • knitr * suggests
  • rmarkdown * suggests
  • testthat >= 3.2.0 suggests

Score: 11.591366891276792