gcamdata: An R Package for Preparation, Synthesis, and Tracking of Input Data for the GCAM Integrated Human-Earth Systems Model

Bond-Lamberty, Ben; Dorheim, Kalyn; Cui, Ryna; Horowitz, Russell; Snyder, Abigail; Calvin, Katherine; Feng, Leyang; Hoesly, Rachel; Horing, Jill; Kyle, G. Page; Link, Robert; Patel, Pralit; Roney, Christopher; Staniszewski, Aaron; Turner, Sean; Chen, Min; Feijoo, Felipe; Hartin, Corinne; Hejazi, Mohamad; Iyer, Gokul; Kim, Sonny; Liu, Yaling; Lynch, Cary; McJeon, Haewon; Smith, Steven; Waldhoff, Stephanie; Wise, Marshall; Clarke, Leon

doi:10.5334/jors.232

Title: gcamdata: An R Package for Preparation, Synthesis, and Tracking of Input Data for the GCAM Integrated Human-Earth Systems Model

Journal Article · 14 March 2019 · Journal of Open Research Software

DOI: https://doi.org/10.5334/jors.232 · OSTI ID:1503168

^[1];

^[1]; Horowitz, Russell ^[2];

^[1];

^[1]; Feng, Leyang ^[3]; Hoesly, Rachel ^[1];

^[4];

^[1]; Link, Robert ^[1];

^[1];

^[1]; Staniszewski, Aaron ^[1];

^[1]; Chen, Min ^[1]; Feijoo, Felipe ^[5];

^[1]; Hejazi, Mohamad ^[1]; Iyer, Gokul ^[1] more »

Pacific Northwest National Lab. (PNNL), Richland, WA (United States). Joint Global Change Research Inst.
Univ. of California, Los Angeles, CA (United States)
Pacific Northwest National Lab. (PNNL), Richland, WA (United States). Joint Global Change Research Inst.; American Univ., Washington, DC (United States)
Stanford Univ., CA (United States)
Pacific Northwest National Lab. (PNNL), Richland, WA (United States). Joint Global Change Research Inst.; Pontifical Catholic Univ. of Valparaiso (Chile)
Columbia Univ., New York, NY (United States)

The increasing data requirements of complex models demand robust, reproducible, and transparent systems to track and prepare models’ inputs. Here we describe version 1.0 of the gcamdata R package that processes raw inputs to produce the hundreds of XML files needed by the GCAM integrated human-earth systems model. It features extensive functional and unit testing, data tracing and visualization, and enforces metadata, documentation, and flexibility in its component data-processing subunits. Although this package is specific to GCAM, many of its structural pieces and approaches should be broadly applicable to, and reusable by, other complex model/data systems aiming to improve transparency, reproducibility, and flexibility.

View Accepted Manuscript (DOE)

Cite

Export

Save

Research Organization:: Pacific Northwest National Laboratory (PNNL), Richland, WA (United States)

Sponsoring Organization:: USDOE Office of Science (SC), Biological and Environmental Research (BER); USDOE Office of Fossil Energy (FE); USDOE Office of Nuclear Energy (NE); USDOE Office of Energy Efficiency and Renewable Energy (EERE); USEPA

Grant/Contract Number:: AC05-76RL01830

OSTI ID:: 1503168

Report Number(s):: PNNL-SA-135553

Journal Information:: Journal of Open Research Software, Vol. 7, Issue 1; ISSN 2049-9647

Publisher:: Software Sustainability InstituteCopyright Statement

Country of Publication:: United States

Language:: English

References (15)

The case for open computer programs Ince, Darrel C.; Hatton, Leslie; Graham-Cumming, John Nature, Vol. 482, Issue 7386 https://doi.org/10.1038/nature10836	journal	February 2012
Archiving numerical models of biogeochemical dynamics Thornton, Peter E.; Cook, Robert B.; Braswell, Bobby H. Eos, Transactions American Geophysical Union, Vol. 86, Issue 44 https://doi.org/10.1029/2005EO440003	journal	January 2005
The representative concentration pathways: an overview van Vuuren, Detlef P.; Edmonds, Jae; Kainuma, Mikiko Climatic Change, Vol. 109, Issue 1-2 https://doi.org/10.1007/s10584-011-0148-z	journal	August 2011
Global energy-climate scenarios and models: a review: Global energy-climate scenarios and models Krey, Volker Wiley Interdisciplinary Reviews: Energy and Environment, Vol. 3, Issue 4 https://doi.org/10.1002/wene.98	journal	February 2014
The SSP4: A world of deepening inequality Calvin, Katherine; Bond-Lamberty, Ben; Clarke, Leon Global Environmental Change, Vol. 42 https://doi.org/10.1016/j.gloenvcha.2016.06.010	journal	January 2017
Programming tools: Adventures with R Tippmann, Sylvia Nature, Vol. 517, Issue 7532 https://doi.org/10.1038/517109a	journal	December 2014
Historical (1750–2014) anthropogenic emissions of reactive gases and aerosols from the Community Emissions Data System (CEDS) Hoesly, Rachel M.; Smith, Steven J.; Feng, Leyang Geoscientific Model Development, Vol. 11, Issue 1 https://doi.org/10.5194/gmd-11-369-2018	journal	January 2018
Reproducible Research in Computational Science Peng, R. D. Science, Vol. 334, Issue 6060 https://doi.org/10.1126/science.1213847	journal	December 2011
Shedding Light on the Dark Data in the Long Tail of Science Library Trends, Vol. 57, Issue 2 https://doi.org/10.1353/lib.0.0036	journal	January 2008
How well do integrated assessment models simulate climate change? van Vuuren, Detlef P.; Lowe, Jason; Stehfest, Elke Climatic Change, Vol. 104, Issue 2 https://doi.org/10.1007/s10584-009-9764-2	journal	December 2009
The Global Land Data Assimilation System Rodell, M.; Houser, P. R.; Jambor, U. Bulletin of the American Meteorological Society, Vol. 85, Issue 3 https://doi.org/10.1175/BAMS-85-3-381	journal	March 2004
A functional test platform for the Community Land Model Wang, Dali; Xu, Yang; Thornton, Peter Environmental Modelling & Software, Vol. 55 https://doi.org/10.1016/j.envsoft.2014.01.015	journal	May 2014
The rise of research networks Adams, Jonathan Nature, Vol. 490, Issue 7420 https://doi.org/10.1038/490335a	journal	October 2012
Accelerated dryland expansion regulates future variability in dryland gross primary production Yao, Jingyu; Liu, Heping; Huang, Jianping Nature Communications, Vol. 11, Issue 1 https://doi.org/10.1038/s41467-020-15515-2	journal	April 2020
Historical (1750 - 2014) anthropogenic emissions of reactive gases and aerosols from the Community Emission Data System (CEDS) Hoesly, Rachel M.; Smith, Steven J.; Feng, Leyang EGU https://doi.org/10.5194/gmd-2017-43	preprint	March 2017

Cited By (1)

GCAM v5.1: representing the linkages between energy, water, land, climate, and economic systems Calvin, Katherine; Patel, Pralit; Clarke, Leon Geoscientific Model Development, Vol. 12, Issue 2 https://doi.org/10.5194/gmd-12-677-2019	journal	January 2019