Knowledge Graph for End-to-End Traceability of an Integrated Human-Earth System Model
Prieto, Isaias, Niazi, Hassan · 2026
Read Knowledge Graph for End-to-End Traceability of an Integrated Human-Earth System Model by Prieto, Isaias, Niazi, Hassan (2026) in the Tower of Babel, a free online library of public-domain works preserved in clean, searchable text. No sign-up. The full text is served as a plain-text file at a predictable URL, where text is present: https://antarctic-labs.com/tower-of-babel/doe-osti-3484978-knowledge-graph-for-end-to-end-traceabil.txt.
Introduction
Pacific Northwest SULI report PNNL-39717, dated August 2026, builds a knowledge graph for tracing an integrated human-Earth system model end to end. Isaias Prieto and Hassan Niazi wrote the report at the Joint Global Change Research Institute. Note the cover prints the first author's name as Preito.
The graph holds edge, fact, and provenance tables, 56 tables in all. Stage tests check row counts table by table. Benchmarks demand exact read-only matches, with changes re-locked and justified. Tests cover input-to-output tracing and one-query assembly. Modelers can prove where every number in a big climate-economy model came from.
Catalog record
| CREATOR | Prieto, Isaias, Niazi, Hassan |
|---|---|
| YEAR | 2026 |
| COLLECTION | PAPERS |
| FORMAT | TXT |
| FILE SIZE | 42 KB |
| LICENSE | Public Domain |
| RIGHTS | PUBLIC DOMAIN |
| SOURCE | DOE OSTI |
Browse the full library · About the Tower of Babel
Full text
The opening of the work, from the library's hosted text:
PNNL-39717 Knowledge Graph for End-to-End Traceability of an Integrated Human- Earth System Model August 2026 Isaias Preito Hassan Niazi Science Undergraduate Laboratory Internship (SULI) Pacific Northwest National Laboratory (PNNL), Joint Global Change Research Institute (JGCRI) Prepared for the U.S. Department of Energy under Contract DE-AC05-76RL01830 Choose an item. This report was prepared as an account of work sponsored by an agency of the United States Government. Neither the United States Government nor any agency thereof, nor Battelle Memorial Institute, nor any of their employees, makes any warranty, express or implied, or assumes any legal liability or responsibility for the accuracy, completeness, or usefulness of any information, apparatus, product, or process disclosed, or represents that its use would not infringe privately owned rights. Reference herein to any specific commercial product, process, or service by trade name, trademark, manufacturer, or otherwise does not necessarily constitute or imply its endorsement, recommendation, or favoring by the United States Government or any agency thereof, or Battelle Memorial Institute. The views and opinions of authors expressed herein do not necessarily state or reflect those of the United States Government or any agency thereof. PACIFIC NORTHWEST NATIONAL LABORATORY operated by BATTELLE for the UNITED STATES DEPARTMENT OF ENERGY under Contract DE-AC05-76RL01830 Printed in the United States of America Available to DOE and DOE contractors from the Office of Scientific and Technical Information, P.O. Box 62, Oak Ridge, TN 37831-0062 www.osti.gov ph: (865) 576-8401 fox: (865) 576-5728 email: [email protected] Available to the public from the National Technical Information Service 5301 Shawnee Rd., Alexandria, VA 22312 ph: (800) 553-NTIS (6847) or (703) 605-6000 email: [email protected] Online ordering: http://www.ntis.gov Choose an item. PNNL-39717 Knowledge Graph for End-to-End Traceability of an Integrated Human-Earth System Model August 2026 Isaias Preito Hassan Niazi Science Undergraduate Laboratory Internship (SULI) Pacific Northwest National Laboratory (PNNL), Joint Global Change Research Institute (JGCRI) Prepared for the U.S. Department of Energy under Contract DE-AC05-76RL01830 Pacific Northwest National Laboratory SULI Research Report 1 Technical Abstract Integrated human-Earth system models inform energy-water-land system dynamics and policies, yet their results are difficult to trace through input-data, model structure, scenario configurations, and solved outputs. Because this information is siloed across disconnected artifacts, process-based IAMs have historically lacked a unified, queryable representation. Such lack of traceability prevents researchers from systematically isolating the multi-sector drivers of complex outcomes (such as tracing water-scarcity results back to distant energy- system dynamics) or conducting holistic uncertainty attribution across hundreds of interacting parameters. To address this concern, our work documents the software engineering process of a knowledge graph that unifies these four layers for the Global Change Analysis Model (GCAM-USA_Reference scenario, GCAM v9.1). The graph was built as a relational property graph in DuckDB from the run’s own artifacts: the input-preparation dependency map (gcamdata chunk map), the model’s XML input files, the run configuration, and the results database (BaseX), successfully mapping the model’s declared structure. The resulting graph comprises 204,321 nodes and 1,687,814 edges across 16 node types and 15 edge types, with approximately 16.3 million time-series values stored separately to maintain structural efficiency. To ensure representation fidelity, every edge carries an epistemic-status annotation recording the warrant for the relationship (structural, provenance, dependency, or model-derived), and a machine-readable provenance ledger classifying the origin of every schema element. Evaluation against a fixed five-benchmark suite with locked baselines reports zero structural orphans, zero dangling edge endpoints, and 100% of output-producing technologies traceable to raw input files. Two interactive interfaces present the graph, including a serverless browser application built on DuckDB-Wasm. By establishing the first end-to-end provenance framework for an IAM, this work enables researchers and scientists to systematically audit complex policy scenarios, debug model structures, and trace policy-relevant outputs to their data origins in real time. General Audience Abstract Governments and researchers rely on complex computer models to explore how energy systems, agriculture, and the economy might evolve under different natural conditions and policies. The Global Change Analysis Model (GCAM) is one of the most widely used of these tools. However, models of this scale are difficult for information traceability. Because raw data, model structures, run configurations, and final results are scattered across multiple files and formats, tracing how a specific input affects an output becomes challenging. Scientists call this problem epistemic opacity, which is the reality that humans can’t track the millions of steps a model takes to reach its conclusions. To address this limitation, we developed a knowledge graph that connects all four of these hidden layers into a single, searchable digital network. Comprising approximately 204,000 entities (such as regions, sectors, technologies, and data files) and 1.7 million relationships, this graph turns a fragmented codebase into a cohesive map. With this tool, questions that previously required timely digging through separate databases can now be answered with a single, nearly instant query. To ensure absolute accuracy, every relationship in the graph is labeled with its origin, backed by a rigorous set of benchmark tests to ensure no data is lost or untraceable. Finally, an interactive browser-based view allows users to explore this network. By making massive simulation models traceable from end-to-end, this work takes a vital step toward making the science behind global change science more transparent and accessible. 1. Introduction 1.3 Purpose and Research questions 2 1.1 Context The purpose of this project was to design and implement a software product that bridges the The Global Change Analysis Model (GCAM) is an architectural gap of lack of systematic traceability of open-source, global, market-equilibrium integrated all influencing factors and parameterizations leading human-Earth systems model that represents the linked to an outcome of interest for a single model run. The behavior of energy, water, land, biogeochemcical, and resulting system is a knowledge graph that unifies the economic systems (Calvin et al., 2019; Niazi et al., run’s data provenance, declared model structure, 2024; Kyle et al., 2023), with GCAM-USA extending scenario configuration, and solved outputs within a the model with state-level details for the United States single connected, queryable store, accompanied by (Binsted et al., 2022; Zhao et al., 2026; Bracken et al., interactive web interfaces for client-side exploration. 2026). This project leverages a single solved run, the This framing adopts Pfenninger’s (2024) thesis that GCAM-USA_Reference scenario of GCAM (Bond- releasing open code and data is insufficient on its Lamberty et al., 2026; Zhao et al., 2026). A run rests own, meaning that cognitive understandability must on the gcamdata R package that prepares hundreds of be operationalized as an explicit design goal. Within raw input datasets into the XML files the model the vocabulary of model interpretability, the graph consumes (Bond-Lamberty et al., 2019; Niazi et al., operates as a structural transparency instrument by 2025a; Niazi et al., 2025b), and packages such as making the model’s constituent components, rgcam extract solved results from the run’s BaseX parameter lineages, logical dependencies, and output database (Link & Patel, 2026). declared relations fully inspectable (Lipton, 2018). 1.2 Problem Statement This work extends Lipton’s taxonomy from its original machine-learning context to process-based Complex simulation models are epistemically simulation models. Ultimately, the graph represents demanding: the steps by which they produce results the model’s declared topology exclusively; it infers no are not accessible to unaided human inspection unstated relationships from raw data, assumes no (Humphreys, 2009),