===========================================================================================================
README for DATASET: "Data from: Transboundary effects from idealized regional geoengineering"
===========================================================================================================

This readme document describes the datasets used in the Environmental Research Communications paper: MacMartin, D. G., Kravitz, B., and Goddard, P. (2023), Transboundary effects from idealized regional geoengineering

Please cite this dataset as: MacMartin, D. G., Kravitz, B., and Goddard P., (2023). Data from: Transboundary effects from idealized regional geoengineering [Dataset] Cornell University eCommons Repository. https://doi.org/ 10.7298/meww-pd29

Contact Information: 
Douglas G. MacMartin, dgm224@cornell.edu
Ben Kravitz, bkravitz@iu.edu

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 the climate model CESM1(WACCM) https://www.cesm.ucar.edu/working_groups/Whole-Atmosphere/. 

These data are shared under a Creative Commons Attribution 4.0 International license (CC-BY 4.0, 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.

There are two data files, one for the Gulf of Mexico simulation (GMdata.nc) and one for the Great Barrier Reef simulation (GBRdata.nc).  Simulation data for the preindustrial control are already available from ESG.
Spatial and temporal coordinates (i.e. latitude, longitude, and time) are described in each file; units are also defined in the netcdf header; e.g., in matlab, use ncdisp(‘GMdata.nc’).  Data are saved monthly for 51 years of simulation.

The variables in each file are named according to the CESM naming convention and include FSNS (net solar flux at surface), FSNT (net solar flux at top of model), PRECT (Total convective and large-scale precipitation), QFLX (surface water flux), SST (sea surface temperature) and TREFHT (reference height temperature).

In addition to the data file, the repository includes the Fortran source-code for the CESM subroutine that was modified to produce the simulations, first for the Gulf of Mexico simulation, and for the Great Barrier Reef simulation.  Finally, the matlab m-file that was used to analyze simulation output and generate plots is also included.

Acknowledgements
We would like to acknowledge high-performance computing support from Cheyenne (https://doi.org/10.5065/D6RX99HX) provided by NCAR's Computational and Information Systems Laboratory, sponsored by the National Science Foundation. Support was provided by the National Science Foundation through agreement CBET- 1931641 as well as CBET-2038246 for DM and BK. Support for B. Kravitz was also provided in part by the Indiana University Environmental Resilience Institute, and the Prepared for Environmental Change Grand Challenge initiative. The Pacific Northwest National Laboratory is operated for the U.S. Department of Energy by Battelle Memorial Institute under contract DEAC05-76RL01830. The CESM project is supported primarily by the National Science Foundation.