Gcamdata: An R package for preparation, synthesis, and tracking of input data for the GCAM integrated human-earth systems model

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

doi:10.5334/jors.232

Gcamdata: An R package for preparation, synthesis, and tracking of input data for the GCAM integrated human-earth systems model

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

Research output: Contribution to journal › Article › peer-review

18 Scopus citations

Abstract

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.

Original language	English
Article number	6
Journal	Journal of Open Research Software
Volume	7
Issue number	1
DOIs	https://doi.org/10.5334/jors.232
State	Published - 2019
Externally published	Yes

Funding

The management and financial expertise of Ibimina Nweke and Kali Wood provided crucial support during gcamdata development. The package makes crucial use of land-use and land cover change data developed by Alan Di Vittorio of Lawrence Berkeley National Laboratory. Primary support for this work was provided by the U.S. Department of Energy, Office of Science, as part of research in Multi-Sector Dynamics, Earth and Environmental System Modeling Program. Additional support was provided by the U.S. Department of Energy Offices of Fossil Energy, Nuclear Energy, and Energy Efficiency and Renewable Energy and the U.S. Environmental Protection Agency.

Keywords

Data provenance
Earth modeling
Human-earth system modeling
Reproducibility
Unit testing

Access to Document

10.5334/jors.232

Cite this

Bond-Lamberty, B., Dorheim, K., Cui, R., Horowitz, R., Snyder, A., Calvin, K., Feng, L., Hoesly, R., Horing, J., Kyle, G. P., Link, R., Patel, P., Roney, C., Staniszewski, A., Turner, S., Chen, M., Feijoo, F., Hartin, C., Hejazi, M., ... Clarke, L. (2019). Gcamdata: An R package for preparation, synthesis, and tracking of input data for the GCAM integrated human-earth systems model. Journal of Open Research Software, 7(1), Article 6. https://doi.org/10.5334/jors.232

@article{fc484eff78674a758f77844c37e8c3d2,

title = "Gcamdata: An R package for preparation, synthesis, and tracking of input data for the GCAM integrated human-earth systems model",

abstract = "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.",

keywords = "Data provenance, Earth modeling, Human-earth system modeling, Reproducibility, Unit testing",

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

note = "Publisher Copyright: {\textcopyright} 2019 The Author(s).",

year = "2019",

doi = "10.5334/jors.232",

language = "English",

volume = "7",

journal = "Journal of Open Research Software",

issn = "2049-9647",

publisher = "Ubiquity Press",

number = "1",

}

Bond-Lamberty, B, Dorheim, K, Cui, R, Horowitz, R, Snyder, A, Calvin, K, Feng, L, Hoesly, R, Horing, J, Kyle, GP, Link, R, Patel, P, Roney, C, Staniszewski, A, Turner, S, Chen, M, Feijoo, F, Hartin, C, Hejazi, M, Iyer, G, Kim, S, Liu, Y, Lynch, C, McJeon, H, Smith, S, Waldhoff, S, Wise, M & Clarke, L 2019, 'Gcamdata: An R package for preparation, synthesis, and tracking of input data for the GCAM integrated human-earth systems model', Journal of Open Research Software, vol. 7, no. 1, 6. https://doi.org/10.5334/jors.232

TY - JOUR

T1 - Gcamdata

T2 - An R package for preparation, synthesis, and tracking of input data for the GCAM integrated human-earth systems model

AU - Bond-Lamberty, Ben

AU - Dorheim, Kalyn

AU - Cui, Ryna

AU - Horowitz, Russell

AU - Snyder, Abigail

AU - Calvin, Katherine

AU - Feng, Leyang

AU - Hoesly, Rachel

AU - Horing, Jill

AU - Kyle, G. Page

AU - Link, Robert

AU - Patel, Pralit

AU - Roney, Christopher

AU - Staniszewski, Aaron

AU - Turner, Sean

AU - Chen, Min

AU - Feijoo, Felipe

AU - Hartin, Corinne

AU - Hejazi, Mohamad

AU - Iyer, Gokul

AU - Kim, Sonny

AU - Liu, Yaling

AU - Lynch, Cary

AU - McJeon, Haewon

AU - Smith, Steven

AU - Waldhoff, Stephanie

AU - Wise, Marshall

AU - Clarke, Leon

PY - 2019

Y1 - 2019

N2 - 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.

AB - 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.

KW - Data provenance

KW - Earth modeling

KW - Human-earth system modeling

KW - Reproducibility

KW - Unit testing

UR - https://www.scopus.com/pages/publications/85064087588

U2 - 10.5334/jors.232

DO - 10.5334/jors.232

M3 - Article

AN - SCOPUS:85064087588

SN - 2049-9647

VL - 7

JO - Journal of Open Research Software

JF - Journal of Open Research Software

IS - 1

M1 - 6

ER -

Gcamdata: An R package for preparation, synthesis, and tracking of input data for the GCAM integrated human-earth systems model

Abstract

Funding

Keywords

Access to Document

Other files and links

Fingerprint

Cite this