# Creation date: 2021-07-24
# File created by: 
# Joeri Rogelj
# email: j.rogelj@imperial.ac.uk
# -
# Sophie SZOPA
# email: sophie.szopa@lsce.ipsl.fr
# ========================
# GENERAL INFORMATION 
# 
# *Title 
# Readme for data for Figure SPM4 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 & FILE OVERVIEW
#
# List of all files and subfolders
# 
# --------------------------
# Panel a
#
# --------------------------
#
# 
# * Data providers: Joeri Rogelj (Lead Author, Chapter 5), Chris Smith (Contributing Author, Chapters 6 and 7), Gian-Kasper Plattner (Lead Author, Chapter 1), Malte Meinshausen (Lead Author, Chapter 1), Sophie Szopa (Coordinating Lead Author, Chapter 6), Sebastian Milinski (Contributing Author, Chapter 4), Jochem Marotzke (Coordinating Lead Author, Chapters 4).
# 
# *Comments 
# The following original literature references accompany this data:  
# 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, 5175-5190. DOI:10.5194/gmd-13-5175-2020
#
# --------------------------
# filename 1: Carbon_dioxide_Gt_CO2_yr.csv
# --------------------------
#
# N of columns: 6
# Column headings: years, ssp370, ssp119, ssp126, ssp245, ssp585     
#
# column_name 1: years
# long_name: "year of emission" 
# units: year
# missing_value: N/A
# type (int/float/char): int
# comments:  None
#
# column_name 2: ssp370
# long_name: "Annual total anthropogenic emissions of carbon dioxide (CO2) under the SSP3-7.0 scenario" 
# units: Gt CO2 / year
# 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)
#
# column_name 3: ssp119
# long_name: "Annual total anthropogenic emissions of carbon dioxide (CO2) under the SSP1-1.9 scenario" 
# units: Gt CO2 / year
# 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)
#
# column_name 4: ssp126
# long_name: "Annual total anthropogenic emissions of carbon dioxide (CO2) under the SSP1-2.6 scenario" 
# units: Gt CO2 / year
# 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)
#
# column_name 5: ssp245
# long_name: "Annual total anthropogenic emissions of carbon dioxide (CO2) under the SSP2-4.5 scenario" 
# units: Gt CO2 / year
# 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)
#
# column_name 6: ssp585
# long_name: "Annual total anthropogenic emissions of carbon dioxide (CO2) under the SSP5-8.5 scenario" 
# units: Gt CO2 / year
# 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)
#
# --------------------------
# filename 2: Methane_Mt_CO2_yr.csv
# --------------------------
#
# N of columns: 6
# Column headings: years, ssp370, ssp119, ssp126, ssp245, ssp585     
#
# column_name 1: years
# long_name: "year of emission" 
# units: year
# missing_value: N/A
# type (int/float/char): int
# comments:  None
#
# column_name 2: ssp370
# long_name: "Annual total anthropogenic emissions of methane (CH4) under the SSP3-7.0 scenario" 
# units: Mt CH4 / year
# 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)
#
# column_name 3: ssp119
# long_name: "Annual total anthropogenic emissions of methane (CH4) under the SSP1-1.9 scenario" 
# units: Mt CH4 / year
# 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)
#
# column_name 4: ssp126
# long_name: "Annual total anthropogenic emissions of methane (CH4) under the SSP1-2.6 scenario" 
# units: Mt CH4 / year
# 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)
#
# column_name 5: ssp245
# long_name: "Annual total anthropogenic emissions of methane (CH4) under the SSP2-4.5 scenario" 
# units: Mt CH4 / year
# 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)
#
# column_name 6: ssp585
# long_name: "Annual total anthropogenic emissions of methane (CH4) under the SSP5-8.5 scenario" 
# units: Mt CH4 / year
# 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)
#
# --------------------------
# filename 3: Nitrous_oxide_Mt N2O_yr.csv
# --------------------------
#
# N of columns: 6
# Column headings: years, ssp370, ssp119, ssp126, ssp245, ssp585     
#
# column_name 1: years
# long_name: "year of emission" 
# units: year
# missing_value: N/A
# type (int/float/char): int
# comments:  None
#
# column_name 2: ssp370
# long_name: "Annual total anthropogenic emissions of nitrous oxide (N2O) under the SSP3-7.0 scenario" 
# units: Mt N2O / year
# 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)
#
# column_name 3: ssp119
# long_name: "Annual total anthropogenic emissions of nitrous oxide (N2O) under the SSP1-1.9 scenario" 
# units: Mt N2O / year
# 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)
#
# column_name 4: ssp126
# long_name: "Annual total anthropogenic emissions of nitrous oxide (N2O) under the SSP1-2.6 scenario" 
# units: Mt N2O / year
# 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)
#
# column_name 5: ssp245
# long_name: "Annual total anthropogenic emissions of nitrous oxide (N2O) under the SSP2-4.5 scenario" 
# units: Mt N2O / year
# 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)
#
# column_name 6: ssp585
# long_name: "Annual total anthropogenic emissions of nitrous oxide (N2O) under the SSP5-8.5 scenario" 
# units: Mt N2O / year
# 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)
#
# --------------------------
# filename 4: Sulfur_dioxide_Mt SO2_yr.csv
# --------------------------
#
# N of columns: 6
# Column headings: years, ssp370, ssp119, ssp126, ssp245, ssp585     
#
# column_name 1: years
# long_name: "year of emission" 
# units: year
# missing_value: N/A
# type (int/float/char): int
# comments:  None
#
# column_name 2: ssp370
# long_name: "Annual total anthropogenic emissions of sulphur dioxide (SO2) under the SSP3-7.0 scenario" 
# units: Mt SO2 / year
# 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)
#
# column_name 3: ssp119
# long_name: "Annual total anthropogenic emissions of sulphur dioxide (SO2) under the SSP1-1.9 scenario" 
# units: Mt SO2 / year
# 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)
#
# column_name 4: ssp126
# long_name: "Annual total anthropogenic emissions of sulphur dioxide (SO2) under the SSP1-2.6 scenario" 
# units: Mt SO2 / year
# 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)
#
# column_name 5: ssp245
# long_name: "Annual total anthropogenic emissions of sulphur dioxide (SO2) nder the SSP2-4.5 scenario" 
# units: Mt SO2 / year
# 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)
#
# column_name 6: ssp585
# long_name: "Annual total anthropogenic emissions of sulphur dioxide (SO2) under the SSP5-8.5 scenario" 
# units: Mt SO2 / year
# 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)
#
#
# --------------------------
# Panel b
#
# --------------------------
#
# *Data creators
# Name: Chris Smith
# Institution: School of Earth and Environment, University of Leeds / International Institute for Applied Systems Analysis (IIASA)
# email: C.J.Smith1@leeds.ac.uk
#
#
# *Comments
# GSAT changes in 2081-2100 relative to 1850-1900 for the 5 core-set scenario used in WG1. 
# The results were obtained by (i) deriving the ERF time series from SSP emissions (for aerosols, contrails, and black carbon on snow, non-CH4 ozone precursors) and concentrations (for well-mixed GHGs) including chemical adjustments for CH4 as described in 7.SM.1.4. and (ii) applying an emulator (two-layer energy balance model) to infer an ensemble of temperature change time series as described in 7.SM.2.4
# Data produced similarly are also used for Figure 4.35 (Chapter 4 of the AR6 WG1 report)
#
#
# --------------------------
# filename 1: ts_warming_ranges_1850-1900_base_panel_b.csv
# -----------------------
#
# N of columns: 5
# Column headings: scenario, forcing, p50, p05, p95         
#
# column_name 1: scenario
# long_name: SSP scenario 
# units: -
# missing_value: -
# type (int/float/char): char
# comments:  can be ssp119 for SSP1-1.9; ssp126 for SSP1-2.6; ssp245 for SSP2-4.5; ssp370 for SSP3-7.0; ssp585 for SSP5-8.5; observations: The global surface temperature warming (2010-2019) relative to 1850-1900 calculated from HadCRUT4.6 observations.
#
# column_name 2: forcing
# long_name: Forcing agent or group of forcing agents
# units: -
# missing_value: -
# type (int/float/char): char
# comments: can be co2 for forcing due to change in CO2 only; non_CO2_GHGs for forcing due to N2O, Halogenated gases, O3, CH4 and its indirect effect though chemistry on stratospheric water vapour, ozone and CH4 lifetime; Aersols_Landuse for other anthropogenic components i.e. aerosols, land-use change (irrigation+reflectance), contrails and light-absorbing particles on snow and ice; 'total' for total warming. The total bar represents the AR6 assessment, consistent with Table SPM1.
#
# column_name 3: p50
# long_name: 50th percentile of the temperature change in 2081-2100 relative to 1850-1900 considered as the best-estimate
# units: C
# missing_value: -
# type (int/float/char): float
# comments: 50th percentile
#
# column_name 4: p05
# long_name: 5th percentile of the temperature change in 2081-2100 relative to 1850-1900 considered as the lower limit of the very likely range
# units: C
# missing_value: -
# type (int/float/char): float
# comments: 5th percentile
#
# column_name 5: p95
# long_name: 95th percentile of the temperature change in 2081-2100 relative to 1850-1900 considered as the upper limit of the very likely range
# units: C
# missing_value: -
# type (int/float/char): float
# comments: 95th percentile
#
# ========================


