hector

An open source, object-oriented, simple global climate carbon-cycle model.
https://github.com/jgcri/hector

Category: Climate Change
Sub Category: Earth and Climate Modeling

Keywords

climate climate-change climate-model hector science

Keywords from Contributors

economics gcam human-earth-system water coupled-human-natural-systems integrated-assessment land china gcam-china integrated-assessment-model

Last synced: about 14 hours ago
JSON representation

Repository metadata

The Hector Simple Climate Model

• Host: GitHub
• URL: https://github.com/jgcri/hector
• Owner: JGCRI
• License: gpl-3.0
• Created: 2014-08-12T21:20:53.000Z (over 10 years ago)
• Default Branch: main
• Last Pushed: 2025-04-08T16:23:00.000Z (18 days ago)
• Last Synced: 2025-04-11T17:49:31.030Z (15 days ago)
• Topics: climate, climate-change, climate-model, hector, science
• Language: C++
• Homepage: http://jgcri.github.io/hector/
• Size: 65 MB
• Stars: 114
• Watchers: 13
• Forks: 49
• Open Issues: 48
• Releases: 18
• Metadata Files:
  • Readme: README.Rmd
  • Changelog: NEWS.md
  • License: LICENSE.md
  • Code of conduct: CODE_OF_CONDUCT.md
  • Citation: CITATION.cff

README.Rmd

          ---
output: github_document
---



```{r, include = FALSE}
knitr::opts_chunk$set(
    collapse = TRUE,
    comment = "#>",
    fig.path = "man/figures/README-",
    out.width = "100%"
)
library(hector)
library(ggplot2)
```

# hector

[![DOI](https://zenodo.org/badge/22892935.svg)](https://zenodo.org/badge/latestdoi/22892935) [![C++ unit tests](https://github.com/JGCRI/hector/actions/workflows/unit-testing.yaml/badge.svg)](https://github.com/JGCRI/hector/actions/workflows/unit-testing.yaml) [![Command Line Hector](https://github.com/JGCRI/hector/actions/workflows/command-line.yaml/badge.svg)](https://github.com/JGCRI/hector/actions/workflows/command-line.yaml)  [![R-CMD-check](https://github.com/JGCRI/hector/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/JGCRI/hector/actions/workflows/R-CMD-check.yaml) 

This is the repository for **Hector**, an open source, object-oriented, simple 
global climate carbon-cycle model that runs very quickly while still
representing the most critical global scale earth system processes. 
Hector is a simple climate model (SCM, also known as a reduced-complexity climate model),
a class of models that are extremely versatile with a wide
range of applications. Due to their computational efficiency, SCMs can easily
be coupled to other models and used to design scenarios, emulate more complex 
climate models, and conduct uncertainty analyses.

```{r tas_plot, echo=FALSE, fig.width=8, fig.height=4}

# The variable naps and dates of variables to save.
vars_to_plot <- GLOBAL_TAS()
dates_to_plot <- 1850:2100

# Color palette used by the IPCC
SSP_COLORS <- c("ssp119" = "#00a9cf", "ssp126" = "#003466", "ssp245" = "#f69320",
                "ssp370" = "#df0000", "ssp434" = "#2274ae","ssp460" = "#b0724e",
                "ssp585"= "#980002",   "ssp534-overshoot" = "grey", "historical" = "#000000",
                "historical"="#92397a")

# Set up and run hector.
ini_files <- list.files(file.path("inst", "input"), pattern = "ini", full.names = TRUE)
hector_tas_results <- do.call(lapply(ini_files, function(f){
    name <- gsub(pattern = "hector_|.ini", x = basename(path = f), replacement = "")
    hc <- newcore(f, name = name)
    run(hc)
    out <- fetchvars(hc, dates_to_plot, vars = vars_to_plot)
    return(out)
}), what = "rbind")

# Modify the results data frame.
hector_tas_results$scenario <- ifelse(hector_tas_results$scenario == "ssp534-over",
                                      "ssp534-overshoot", hector_tas_results$scenario)
hector_tas_results$scenario <- ifelse(hector_tas_results$year <= 2016, "historical",
                                      hector_tas_results$scenario)
ggplot(hector_tas_results) +
    geom_line(aes(year, value, color = scenario), linewidth = 1) +
    theme_bw(base_size = 15) +
    labs(color = NULL, x = NULL, y = expression("Temperature Anomaly ("~degree~"C)")) +
    scale_color_manual(values = SSP_COLORS)
```

Hector's output for global mean air temperature change for eight Shared Socioeconomic Pathways (SSPs).

## Installation 

The `hector` R package can be installed using the `remotes::install_github` 
function. More detailed installation instructions, including how to set up
Hector as a command line executable, can be found [here](articles/BuildHector.html).

```r
remotes::install_github('jgcri/hector')
library(hector)
```

## Tools and Software That Work with Hector

* [GCAM](https://github.com/JGCRI/gcam-core): Hector can be used as the climate component in [GCAM](http://jgcri.github.io/gcam-doc/)
* [pyhector](https://github.com/openclimatedata/pyhector): a Python
interface to Hector
* [fldgen](https://github.com/JGCRI/fldgen): a spatially resolved temperature & precipitation emulator for CMIP5 ESMs
* [HectorUI](https://jgcri.shinyapps.io/HectorUI/): run Hector in a web interface!

## Contributing to Hector

The Hector team welcomes and values community contributions, but please see 
our [Contribution Guide](https://jgcri.github.io/hector/articles/ContributionsGuide.html) and note by  contributing 
to this project, you agree to abide to our [Contributor Code of Conduct](CODE_OF_CONDUCT.md)

*** 

This research was supported by the U.S. Department of Energy, Office of Science, as part of research in Multi-Sector Dynamics, Earth and Environmental System Modeling Program. The Pacific Northwest National Laboratory is operated for DOE by Battelle Memorial Institute under contract DE-AC05-76RL01830.

        

Citation (CITATION.cff)

cff-version: 3.0.1
message: "If you use this software in your work, please cite it as below."
authors:
- family-names: "Dorheim"
  given-names: "Kalyn"
  orcid: "https://orcid.org/0000-0001-8093-8397"
- family-names: "Bond-Lamberty"
  given-names: "Ben"
  orcid: "https://orcid.org/0000-0001-9525-4633"
- family-names: "Hartin"
  given-names: "Corinne"
  orcid: "https://orcid.org/0000-0003-1834-6539"
- family-names: "Link"
  given-names: "Robert"
  orcid: "https://orcid.org/0000-0002-7071-248X"
- family-names: "Nicholson"
  given-names: "Mat"
- family-names: "Pralit"
  given-names: "Patel"
  orcid: "https://orcid.org/0000-0003-3992-1061"
- family-names: "Pressburger"
  given-names: "Leeya"
  orcid: "https://orcid.org/0000-0002-6850-2504"
- family-names: "Shiklomanov"
  given-names: "Alexey"
  orcid: "https://orcid.org/0000-0003-4022-5979"
- family-names: "Vega-Westhoff"
  given-names: "Benjamin"
  orcid: "https://orcid.org/0000-0001-7881-8388"
- family-names: "Woodard"
  given-names: "Dawn"
  orcid: "https://orcid.org/0000-0002-0468-4660"
title: "Hector a simple carbon-climate model"
version: 3.0.1
doi: 10.5281/zenodo.7617326
date-released: 2023-02-07
url: "https://github.com/jgcri/hector"

---

Owner metadata

• Name: Joint Global Change Research Institute
• Login: JGCRI
• Email:
• Kind: organization
• Description: Advancing fundamental understanding of human and Earth systems
• Website: https://www.pnnl.gov/projects/jgcri
• Location: College Park, MD, USA
• Twitter:
• Company:
• Icon url: https://avatars.githubusercontent.com/u/8431983?v=4
• Repositories: 129
• Last ynced at: 2023-08-13T09:31:28.823Z
• Profile URL: https://github.com/JGCRI

---

GitHub Events

Total

• Create event: 15
• Issues event: 12
• Watch event: 7
• Delete event: 16
• Member event: 1
• Issue comment event: 80
• Push event: 76
• Pull request review event: 37
• Pull request review comment event: 32
• Pull request event: 35
• Fork event: 3

Last Year

• Create event: 15
• Issues event: 12
• Watch event: 7
• Delete event: 16
• Member event: 1
• Issue comment event: 80
• Push event: 76
• Pull request review event: 37
• Pull request review comment event: 32
• Pull request event: 35
• Fork event: 3

---

Committers metadata

Last synced: 4 days ago

Name	Email	Commits
Ben Bond-Lamberty	b****y@p****v	347
Alexey Shiklomanov	a****v@g****m	179
Robert Link	r****k@p****v	158
kdorheim	k****m@p****v	154
cahartin	c****n@p****v	86
crvernon	c****n@g****m	44
leeyap	8****p	37
Pralit Patel	p****l@p****v	28
Ben V-W	b****e@g****m	20
Sven Willner	s****r@p****e	18
Skylar Gering	s****g@g****u	11
mnichol3	n****4@g****m	9
Robert Gieseke	r****g@w****e	9
Steve Smith (PNNL-JGCRI)	s****h@p****v	7
Corinne Hartin	c****n	3
Cary Lynch	c****h@p****v	2
Dawn Woodard	d****d@p****v	2
Tom Payerle	p****e@u****u	2
Ben Elliston	b****e@a****u	1
gaelforget	g****t@m****u	1
mbins	3****s	1

Committer domains:

• pnnl.gov: 8
• mit.edu: 1
• air.net.au: 1
• umd.edu: 1
• g.hmc.edu: 1
• pik-potsdam.de: 1

---

Issue and Pull Request metadata

Last synced: 1 day ago

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/jgcri/hector

---

---

---

Dependencies

Score: 8.132118772955806