Introduction
In a world of increasingly online, distributed, and diverse interdisciplinary research, there is a need to provide accessible and user-friendly interactive visualization tools that elucidate complex models and their output products. Hector UI is an R Shiny web interface built to extend the simple global climate model Hector (Hartin et al. 2015), originally designed in C++ with an accompanying R interface. Traditionally, Hector has only had a command line interface available which requires fluency in C++ or R and a full understanding of Hector’s parameter space to run the model and create output. Hector UI provides a fast, efficient solution that makes the model more accessible to a broader user base. This implementation allows users that may not be fluent in R or C++ to interactively explore model scenarios and outputs in an easy to use, guided point and click interface.
Supporting Software
The supporting software for Hector UI is the Hector climate model which is an open source, object-oriented, simple global climate carbon-cycle model. It runs essentially instantaneously while still representing the most critical global scale earth system processes and is one of a class of models heavily used for emulating complex climate models and uncertainty analyses (Hartin et al. 2016). To run the model, a Hector core object is instantiated from an input file that contains a time series of greenhouse gas emissions. Hector comes equipped with input files, or scenarios, based on the Representative Concentration Pathways (RCP) 2.6 (Van Vuuren et al. 2011), 4.5 (Clarke et al. 2007; Thomson et al. 2011), 6.0 (Fujino et al. 2006), and 8.5 (Riahi, Gru¨bler, and Nakicenovic 2007; Riahi et al. 2011). These scenarios were developed to cover the full range of potential emissions scenarios and are used in climate change research and model intercomparison projects. In addition to these baseline scenarios the user can upload a set of custom emissions and run the model using these emissions to generate a time series tailored to research needs. Hector is also an input component for the Global Change Analysis Model (GCAM; Calvin et al. 2019).
Summary
Hector UI provides the full functionality of Hector in a user-friendly web interface that can create Hector cores on demand to view any number of scenarios in parallel. Graphs of up to four output variables can be viewed simultaneously with each scenario represented as a time series. In addition to core Hector functionality, the following describes some new capabilities that the Hector UI offers. First, we provide the ability to configure Hector’s model input parameters to have the model emulate other well-known earth system models. This allows the user to seamlessly switch between models and see the changes reflected in the output. Another new feature provided are downscaled, gridded global maps of both temperature and precipitation based off patterns generated from Hector and the other earth system models (Snyder et al. 2019). The system takes a model, scenario, year, and variable (near-surface air temperature or precipitation) and dynamically calculates a gridded output map by running the model output against pre-generated pattern files.
The ability to visualize and explore the model scenarios and data output for Hector allows insight and discovery into the individual function of each. By creating user-friendly software that is simple to use which offers a generous set of pre-defined functionality, Hector UI equips the end user with the capability to focus on discovery and analysis instead of data processing, transformation, and time-consuming graph and chart development.
Hector UI can be accessed via the web at the public domain https://jgcri.shinyapps.io/HectorUI/ or it can be installed and run locally as a standalone package (see https://github.com/JGCRI/hector-ui#hector-ui) for local installation instructions). We provide an R vignette step-by-step tutorial for users to get start
Published: March 11, 2021
Citation
Evanoff J.E., C.R. Vernon, S.T. Waldhoff, A.C. Snyder, and C.A. Hartin. 2020.hectorui: A web-based interactive scenario builder and visualization application for the Hector climate model.Journal of Open Source Software 5, no. 56:Article No. 2782.PNNL-SA-156861.doi:10.21105/joss.02782