===========================================================================================================
README for DATASET "Data from: Climate response to off-equatorial stratospheric sulfur injections in three Earth System Models"
===========================================================================================================


This readme file describes the dataset used in the following ACP papers:  Visioni, D., Bednarz, E. M., Lee, W. R., Kravitz, B., Jones, A., Haywood, J. M., and MacMartin, D. G.: Climate response to off-equatorial stratospheric sulfur injections in three Earth System Models – Part 1: experimental protocols and surface changes, EGUsphere [preprint], https://doi.org/10.5194/egusphere-2022-401, 2022 and Bednarz, E. M., Visioni, D., Kravitz, B., Jones, A., Haywood, J. M., Richter, J., MacMartin, D. G., and Braesicke, P.: Climate response to off-equatorial stratospheric sulfur injections in three Earth System Models – Part 2: stratospheric and free-tropospheric response, Atmos. Chem. Phys. Discuss. [preprint], https://doi.org/10.5194/acp-2022-372, in review, 2022.

Please cite this dataset as: Visioni D., Bednarz, E. and Lee, W. (2023) Data from: Climate response to off-equatorial stratospheric sulfur injections in three Earth System Models, Atmospheric Chemistry and Physics [Dataset] Cornell University eCommons Digital Repository. https://doi.org/xxx

This dataset is shared under a Attribution 4.0 International (CC BY 4.0) license (https://creativecommons.org/licenses/by/4.0/). The material can be shared and built upon, but attribution to the original authors and a statement of changes made is required.
The .m scripts are being shared under a MIT License (see full license text within Optimization_plot.m, and at end of this document.


All files in the dataset are NetCDF (Network Common Data Form) and can be easily read in common programming languages (python, Matlab, R, NCL, C++, and others).
Files have been produced with multiple climate models (CESM2(WACCM6), UKESM1, GISS-OMA, GISS-MATRIX).


Files have been collected based on model and variables (list below)

The single files are described as follow: 
[Variable name]_[simulation name]_[model name].nc
and contains the variable (with a short description) and the spatial and temporal coordinates (i.e. latitude, and vertical levels (when applicable, in hPa)). All associated coordinates are described in each file.
All variables are in monthly means format.


The variables shared are:
====================================================================================================================
Variable name		dimensions		long name					units			
AOD550nm		lat x time		Aerosol Optical Depth at 550nm			unitless 	
SurfT			lat x time		Reference Air Temperature (2m)			Kelvin
P			lat x time		Precipitation					m/s
aerosol_conc		lat x lev x time	aerosol num concentration (divided by mode)	1/kg
aerosol_mass		lat x lev x time	aerosol mass concentration (divided by mode)	kg/kg
O3			lat x lev x time	ozone concentration 				kg/kg
SAD_AERO		lat x lev x time	surface area density for aerosols		cm2/m3
T			lat x lev x time	air temperature					Kelvin


The Matlab codes for producing Fig. 10 in Part 1 (optimization_plot.m) and for calculating the gains shown in Eqn. 4 and 5 (control_gains_calculator.m) are also included.


Acknowledgments
Support for D. V. and E.B. was provided by the Atkinson Center for a Sustainable Future at Cornell University and by the National Science Foundation through agreement CBET-1818759. 


Full text of MIT license for .m files:

Copyright 2023 Walker Lee

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.