# Creation date: 2021-07-24
# File created by: Joeri Rogelj
# email: j.rogelj@imperial.ac.uk
# ========================
# GENERAL INFORMATION 
# 
# *Title 
# Readme for data for Figure SPM10 from the Summary for Policymakers of the Working Group I (WGI) Contribution to the Intergovernmental Panel on Climate Change (IPCC) Sixth Assessment Report (AR6).
# 
# *Data creators
# Name: Joeri Rogelj
# Institution: International Institute for Applied Systems Analysis (IIASA) / Imperial College London
# email: j.rogelj@imperial.ac.uk
#
# *Data providers: Joeri Rogelj (Lead Author, Chapter 5), Blair Trewin (Lead Author, Chapter 2), Karsten Haustein (Contributing Author, Chapter 5), Pep Canadell (Coordinating Lead Author,  Chapter 5), Sophie Szopa (Coordinating Lead Author,  Chapter 6), Sebastian Milinski (Contributing Author, Chapter 4), Jochem Marotzke (Coordinating Lead Author,  Chapter 4), Kirsten Zickfeld (Lead Author, Chapter 5). 

#
# *Comments 
# The following original literature references accompany this data:  
# Historical carbon dioxide (CO2) emissions: Friedlingstein, P., et al. (2020) Global Carbon Budget 2020. Earth System Science Data, 12, 3269-3340. DOI:10.5194/essd-12-3269-2020
# Scenario projections of carbon dioxide (CO2) emissions:
# 1) Riahi, K., et al. (2017) The Shared Socioeconomic Pathways and their energy, land use, and greenhouse gas emissions implications: An overview, Global Environmental Change, Volume 42, Pages 153-168, ISSN 0959-3780, DOI:110.1016/j.gloenvcha.2016.05.009
# 2) Rogelj, J., et al. (2018) Scenarios towards limiting global mean temperature increase below 1.5 C. Nature Climate Change 8, 2018, 325-332. DOI:10.1038/s41558-018-0091-3
# 3) Gidden, M. J., et al. (2019) Global emissions pathways under different socioeconomic scenarios for use in CMIP6: a dataset of harmonized emissions trajectories through the end of the century, Geosci. Model Dev., 12, 1443-1475, DOI:10.5194/gmd-12-1443-2019
# 4) Nicholls, Z.R.J., et al. (2020) Reduced Complexity Model Intercomparison Project Phase 1: introduction and evaluation of global-mean temperature response. Geosci. Model Dev., 13, 51755190. DOI:10.5194/gmd-13-5175-2020
# 
#
# ========================
# DATA & FILE OVERVIEW
#
# List of all files and subfolders
# 
# --------------------------
# filename 1: Top_panel_HISTORY.csv
# -----------------------
#
# N of rows: 5
# Row labels: Cumulative CO2 emissions since 1850, Assessed global surface temperature relative to 1850-1900 (Ch2), Human-induced warming (central estimate), Human-induced warming (5th percentile estimate), Human-induced warming (95th percentile estimate)
# comments: Historical global warming        
#
# row_name 1: Cumulative CO2 from 1850,
# long_name: "Cumulative anthropogenic carbon dioxide (CO2) emissions since the year 1850 to 2019" 
# units: Gt CO2 
# missing_value: N/A
# type (int/float/char): float
# comments:  original source = Friedlingstein et al. (2020)
#
# row_name 2: Assessed global surface temperature relative to 1850-1900 (Ch2)
# long_name: "Assessed global surface temperature increase relative to the 1850-1900 period in degrees Celsius, for the 1850-2019 period" 
# units: C
# missing_value: N/A
# type (int/float/char): float
# comments:  original source = IPCC AR6 WG1 Chapter 2
#
# row_name 3: Human-caused warming (central estimate)
# long_name: "Median estimate of human-induced warming based on assessed global surface temperature increase relative to the 1850-1900 period in degrees Celsius, for the 1850-2019 period" 
# units: C
# missing_value: N/A
# type (int/float/char): float
# comments:  None
#
# row_name 4: Human-caused warming (5th percentile estimate)
# long_name: "5th percentile estimate of human-induced warming based on assessed global surface temperature increase relative to the 1850-1900 period in degrees Celsius, for the 1850-2019 period" 
# units: C
# missing_value: N/A
# type (int/float/char): float
# comments:  None
#
# row_name 5: Human-caused warming (95th percentile estimate)
# long_name: "95th percentile estimate of human-induced warming based on assessed global surface temperature increase relative to the 1850-1900 period in degrees Celsius, for the 1850-2019 period" 
# units: C
# missing_value: N/A
# type (int/float/char): float
# comments:  None
#
# --------------------------
# filename 2: Top_panel_SSP1-19.csv
# -----------------------
#
# N of rows: 4
# Row labels: Cumulative CO2 emissions since 1850, Assessed GSAT projection relative to 1850-1900 (Ch4) - central, Assessed GSAT projection relative to 1850-1900 (Ch4) - 5th percentile, Assessed GSAT projection relative to 1850-1900 (Ch4) - 95th percentile        
#
# row_name 1: Cumulative CO2 from 1850,
# long_name: "Cumulative anthropogenic carbon dioxide (CO2) emissions relative to the year 1850 for projected emissions in the SSP1-1.9 scenario, for the period 2015-2050" 
# units: Gt CO2 
# missing_value: N/A
# type (int/float/char): float
# comments:  original sources = Riahi et al. (2017), Rogelj et al. (2018), Gidden et al. (2019), Nicholls et al. (2020)
#
# row_name 2: Assessed GSAT projection relative to 1850-1900 (Ch4) - central
# long_name: "Median assessed global surface temperature increase relative to the 1850-1900 period in degrees Celsius for the SSP1-1.9 scenario, for the period 2015-2050" 
# units: C
# missing_value: N/A
# type (int/float/char): float
# comments:  original source = IPCC AR6 WG1 Chapter 4
#
# row_name 3: Assessed GSAT projection relative to 1850-1900 (Ch4) - 5th percentile
# long_name: "5th percentile of range surrounding assessed global surface temperature increase relative to the 1850-1900 period in degrees Celsius  for the SSP1-1.9 scenario, for the period 2015-2050" 
# units: C
# missing_value: N/A
# type (int/float/char): float
# comments:  original source = IPCC AR6 WG1 Chapter 4
#
# row_name 4: Assessed GSAT projection relative to 1850-1900 (Ch4) - ^95th percentile
# long_name: "95th percentile of range surrounding assessed global surface temperature increase relative to the 1850-1900 period in degrees Celsius  for the SSP1-1.9 scenario, for the period 2015-2050" 
# units: C
# missing_value: N/A
# type (int/float/char): float
# comments:  original source = IPCC AR6 WG1 Chapter 4
#
# --------------------------
# filename 3: Top_panel_SSP1-26.csv
# -----------------------
#
# N of rows: 4
# Row labels: Cumulative CO2 emissions since 1850, Assessed GSAT projection relative to 1850-1900 (Ch4) - central, Assessed GSAT projection relative to 1850-1900 (Ch4) - 5th percentile, Assessed GSAT projection relative to 1850-1900 (Ch4) - 95th percentile        
#
# row_name 1: Cumulative CO2 from 1850,
# long_name: "Cumulative anthropogenic carbon dioxide (CO2) emissions relative to the year 1850 for projected emissions in the SSP1-2.6 scenario, for the period 2015-2050" 
# units: Gt CO2 
# missing_value: N/A
# type (int/float/char): float
# comments:  original sources = Riahi et al. (2017), Rogelj et al. (2018), Gidden et al. (2019), Nicholls et al. (2020)
#
# row_name 2: Assessed GSAT projection relative to 1850-1900 (Ch4) - central
# long_name: "Median assessed global surface temperature increase relative to the 1850-1900 period in degrees Celsius for the SSP1-2.6 scenario, for the period 2015-2050" 
# units:C
# missing_value: N/A
# type (int/float/char): float
# comments:  original source = IPCC AR6 WG1 Chapter 4
#
# row_name 3: Assessed GSAT projection relative to 1850-1900 (Ch4) - 5th percentile
# long_name: "5th percentile of range surrounding assessed global surface temperature increase relative to the 1850-1900 period in degrees Celsius  for the SSP1-2.6 scenario, for the period 2015-2050" 
# units: C
# missing_value: N/A
# type (int/float/char): float
# comments:  original source = IPCC AR6 WG1 Chapter 4
#
# row_name 4: Assessed GSAT projection relative to 1850-1900 (Ch4) - ^95th percentile
# long_name: "95th percentile of range surrounding assessed global surface temperature increase relative to the 1850-1900 period in degrees Celsius  for the SSP1-2.6 scenario, for the period 2015-2050" 
# units: C
# missing_value: N/A
# type (int/float/char): float
# comments:  original source = IPCC AR6 WG1 Chapter 4
#
# --------------------------
# filename 4: Top_panel_SSP2-45.csv
# -----------------------
#
# N of rows: 4
# Row labels: Cumulative CO2 emissions since 1850, Assessed GSAT projection relative to 1850-1900 (Ch4) - central, Assessed GSAT projection relative to 1850-1900 (Ch4) - 5th percentile, Assessed GSAT projection relative to 1850-1900 (Ch4) - 95th percentile        
#
# row_name 1: Cumulative CO2 from 1850,
# long_name: "Cumulative anthropogenic carbon dioxide (CO2) emissions relative to the year 1850 for projected emissions in the SSP2-4.5 scenario, for the period 2015-2050" 
# units: Gt CO2 
# missing_value: N/A
# type (int/float/char): float
# comments:  original sources = Riahi et al. (2017), Rogelj et al. (2018), Gidden et al. (2019), Nicholls et al. (2020)
#
# row_name 2: Assessed GSAT projection relative to 1850-1900 (Ch4) - central
# long_name: "Median assessed global surface temperature increase relative to the 1850-1900 period in degrees Celsius for the SSP2-4.5 scenario, for the period 2015-2050" 
# units: C
# missing_value: N/A
# type (int/float/char): float
# comments:  original source = IPCC AR6 WG1 Chapter 4
#
# row_name 3: Assessed GSAT projection relative to 1850-1900 (Ch4) - 5th percentile
# long_name: "5th percentile of range surrounding assessed global surface temperature increase relative to the 1850-1900 period in degrees Celsius  for the SSP2-4.5 scenario, for the period 2015-2050" 
# units: C
# missing_value: N/A
# type (int/float/char): float
# comments:  original source = IPCC AR6 WG1 Chapter 4
#
# row_name 4: Assessed GSAT projection relative to 1850-1900 (Ch4) - ^95th percentile
# long_name: "95th percentile of range surrounding assessed global surface temperature increase relative to the 1850-1900 period in degrees Celsius  for the SSP2-4.5 scenario, for the period 2015-2050" 
# units: C
# missing_value: N/A
# type (int/float/char): float
# comments:  original source = IPCC AR6 WG1 Chapter 4
#
# --------------------------
# filename 5: Top_panel_SSP3-70.csv
# -----------------------
#
# N of rows: 4
# Row labels: Cumulative CO2 emissions since 1850, Assessed GSAT projection relative to 1850-1900 (Ch4) - central, Assessed GSAT projection relative to 1850-1900 (Ch4) - 5th percentile, Assessed GSAT projection relative to 1850-1900 (Ch4) - 95th percentile        
#
# row_name 1: Cumulative CO2 from 1850,
# long_name: "Cumulative anthropogenic carbon dioxide (CO2) emissions relative to the year 1850 for projected emissions in the SSP3-7.0 scenario, for the period 2015-2050" 
# units: Gt CO2 
# missing_value: N/A
# type (int/float/char): float
# comments:  original sources = Riahi et al. (2017), Rogelj et al. (2018), Gidden et al. (2019), Nicholls et al. (2020)
#
# row_name 2: Assessed GSAT projection relative to 1850-1900 (Ch4) - central
# long_name: "Median assessed global surface temperature increase relative to the 1850-1900 period in degrees Celsius for the SSP3-7.0 scenario, for the period 2015-2050" 
# units: C
# missing_value: N/A
# type (int/float/char): float
# comments:  original source = IPCC AR6 WG1 Chapter 4
#
# row_name 3: Assessed GSAT projection relative to 1850-1900 (Ch4) - 5th percentile
# long_name: "5th percentile of range surrounding assessed global surface temperature increase relative to the 1850-1900 period in degrees Celsius  for the SSP3-7.0 scenario, for the period 2015-2050" 
# units: C
# missing_value: N/A
# type (int/float/char): float
# comments:  original source = IPCC AR6 WG1 Chapter 4
#
# row_name 4: Assessed GSAT projection relative to 1850-1900 (Ch4) - ^95th percentile
# long_name: "95th percentile of range surrounding assessed global surface temperature increase relative to the 1850-1900 period in degrees Celsius  for the SSP3-7.0 scenario, for the period 2015-2050" 
# units: C
# missing_value: N/A
# type (int/float/char): float
# comments:  original source = IPCC AR6 WG1 Chapter 4
#
# --------------------------
# filename 6: Top_panel_SSP5-85.csv
# -----------------------
#
# N of rows: 4
# Row labels: Cumulative CO2 emissions since 1850, Assessed GSAT projection relative to 1850-1900 (Ch4) - central, Assessed GSAT projection relative to 1850-1900 (Ch4) - 5th percentile, Assessed GSAT projection relative to 1850-1900 (Ch4) - 95th percentile        
#
# row_name 1: Cumulative CO2 from 1850,
# long_name: "Cumulative anthropogenic carbon dioxide (CO2) emissions relative to the year 1850 for projected emissions in the SSP5-8.5 scenario, for the period 2015-2050" 
# units: Gt CO2 
# missing_value: N/A
# type (int/float/char): float
# comments:  original sources = Riahi et al. (2017), Rogelj et al. (2018), Gidden et al. (2019), Nicholls et al. (2020)
#
# row_name 2: Assessed GSAT projection relative to 1850-1900 (Ch4) - central
# long_name: "Median assessed global surface temperature increase relative to the 1850-1900 period in degrees Celsius for the SSP5-8.5 scenario, for the period 2015-2050" 
# units: C
# missing_value: N/A
# type (int/float/char): float
# comments:  original source = IPCC AR6 WG1 Chapter 4
#
# row_name 3: Assessed GSAT projection relative to 1850-1900 (Ch4) - 5th percentile
# long_name: "5th percentile of range surrounding assessed global surface temperature increase relative to the 1850-1900 period in degrees Celsius  for the SSP5-8.5 scenario, for the period 2015-2050" 
# units: C
# missing_value: N/A
# type (int/float/char): float
# comments:  original source = IPCC AR6 WG1 Chapter 4
#
# row_name 4: Assessed GSAT projection relative to 1850-1900 (Ch4) - ^95th percentile
# long_name: "95th percentile of range surrounding assessed global surface temperature increase relative to the 1850-1900 period in degrees Celsius  for the SSP5-8.5 scenario, for the period 2015-2050" 
# units: C
# missing_value: N/A
# type (int/float/char): float
# comments:  original source = IPCC AR6 WG1 Chapter 4
#
# --------------------------
# filename 7: Bottom_panel_GtCO2_historical.csv
# -----------------------
#
# N of columns: 2
# Column headings: years, Cumlative historical CO2 emissions     
#
# column_name 1: years
# long_name: "year until which emissions are cumulated starting from 1850" 
# units: year
# missing_value: N/A
# type (int/float/char): int
# comments:  None
#
# column_name 2: Cumlative historical CO2 emissions
# long_name: "Cumulative historical global total carbon dioxide (CO2) emissions since 1850" 
# units: Gt CO2 
# missing_value: N/A
# type (int/float/char): float
# comments:  original source = Friedlingstein, P., et al. (2020) 
#
# --------------------------
# filename 8: Bottom_panel_GtCO2_projections.csv
# -----------------------
#
# N of columns: 6
# Column headings: years, SSP1-19, SSP1-26, SSP2-45, SSP3-70, SSP5-85     
#
# column_name 1: years
# long_name: "year until which emissions are cumulated starting from 1850" 
# units: year
# missing_value: N/A
# type (int/float/char): int
# comments:  None
#
# column_name 2: SSP1-19
# long_name: "Cumulative global total carbon dioxide (CO2) emissions since 1850 for the SSP1-1.9 scenario" 
# units: Gt CO2 
# missing_value: N/A
# type (int/float/char): float
# comments:  original sources for projections = Riahi et al. (2017), Rogelj et al. (2018)
#
# column_name 3: SSP1-26
# long_name: "Cumulative global total carbon dioxide (CO2) emissions since 1850 for the SSP1-2.6 scenario" 
# units: Gt CO2 
# missing_value: N/A
# type (int/float/char): float
# comments:  original sources for projections = Riahi et al. (2017), Rogelj et al. (2018)
#
# column_name 4: SSP2-45
# long_name: "Cumulative global total carbon dioxide (CO2) emissions since 1850 for the SSP2-4.5 scenario" 
# units: Gt CO2 
# missing_value: N/A
# type (int/float/char): float
# comments:  original sources for projections = Riahi et al. (2017), Rogelj et al. (2018)
#
# column_name 5: SSP3-70
# long_name: "Cumulative global total carbon dioxide (CO2) emissions since 1850 for the SSP3-7.0 scenario" 
# units: Gt CO2 
# missing_value: N/A
# type (int/float/char): float
# comments:  original sources for projections = Riahi et al. (2017), Rogelj et al. (2018)
#
# column_name 6: SSP5-85
# long_name: "Cumulative global total carbon dioxide (CO2) emissions since 1850 for the SSP5-8.5 scenario" 
# units: Gt CO2 
# missing_value: N/A
# type (int/float/char): float
# comments:  original sources for projections = Riahi et al. (2017), Rogelj et al. (2018)
#
# ========================

