GCAM Version 2 Reference Scenario with Water Constraints Downscaled with Demeter to 5-arcmin (Irrigated, Rain-fed)

GCAM Version 2 Reference Scenario with Water Constraints Downscaled with Demeter to 5-arcmin resolution for year 2015 for irrigated and rain-fed GCAM crop breakout along with forest, urban, sparse, snow, shrub land classes.  This run was generated for use by the `teleconnect` package (see https://github.com/IMMM-SFA/teleconnect).  The following is the full README found in the zipped data resource:

GCAM v5.2 to Demeter 

Title:
Demeter output for GCAM v5.2 with water constraints - Reference scenario

Description:
Demeter run conducted using the base layer combining Mirca and Modis v6 type 5 to generate rain-fed and irrigated crops constrained to Modis crop area.  GCAM projection split RockIceDesert into snow and sparse land classes.

Building the Demeter base layer for use with GCAM allocated land classes and use types:
Described in the readme_gcam-reg32basin235_modis-v6-2010_mirca2000_5arcmin.pdf document the docs directory of this data archive.

GCAM Version:  https://github.com/JGCRI/gcam-core/tree/gcam-v5.2 ; https://doi.org/10.5281/zenodo.3528353 

GCAM Reference:
Calvin, K., Patel, P., Clarke, L., Asrar, G., Bond-Lamberty, B., Cui, R. Y., Di Vittorio, A., Dorheim, K., Edmonds, J., Hartin, C., Hejazi, M., Horowitz, R., Iyer, G., Kyle, P., Kim, S., Link, R., McJeon, H., Smith, S. J., Snyder, A., Waldhoff, S., and Wise, M.: GCAM v5.1: representing the linkages between energy, water, land, climate, and economic systems, Geosci. Model Dev., 12, 677–698, https://doi.org/10.5194/gmd-12-677-2019, 2019.

Demeter Reference:
Vernon, C.R., Le Page, Y., Chen, M., Huang, M., Calvin, K.V., Kraucunas, I.P. and Braun, C.J., 2018. Demeter – A Land Use and Land Cover Change Disaggregation Model. Journal of Open Research Software, 6(1), p.15. DOI: http://doi.org/10.5334/jors.208

Run:
GCAM reference scenario with water constraints conducted by Sonny Kim (skim@pnnl.gov) originally retrieved from PNNL's Constance here:  /pic/projects/GCAM/water_market/database_basexdbGCAM51WaterConstr.  

Contents:
teleconnect_agu2019
-- config_gcam5p1_watconstr_ref.ini (Demeter configuration file) 
-- code (code to run Demeter pre-, run, and post-processing)
---- README.txt (Description of run order and process for Demeter on Constance)
---- demeter_preprocess.py (Python script to extract land data from the GCAM database and split RockIceDesert into snow and sparse)
---- demeter_postprocessing.py (Python script to create fractional output of Demeter's native output in square kilometers)
---- run_demeter.py (Python script to run Demeter)
---- run_demeter_gcam5p1_watconstr_ref.sh (sbatch script to submit a Demeter run on Constance)
---- run_postprocessing.sh (sbatch script to submit a post-processing run on Constance)
---- run_preprocessing.sh (sbatch script to submit a pre-processing run on Constance)
---- slurm-11504861.out (Slurm output from Demeter run)
-- GCAM 
---- database_basexdbGCAM51WaterConstr (GCAM output database)
-- inputs (input files used by Demeter) 
---- allocation 
------ gcam_regbasin_modis_v6_type5_mirca_5arcmin_constraint_alloc.csv (weighting of constraints)
------ gcam_regbasin_modis_v6_type5_mirca_5arcmin_observed_alloc.csv (reclassification table for observed land classes to Demeter final land classes)
------ gcam_regbasin_modis_v6_type5_mirca_5arcmin_order_alloc.csv (processing order for land classes)
------ gcam_regbasin_modis_v6_type5_mirca_5arcmin_projected_alloc.csv (reclassification table for GCAM land classes to Demeter final land classes)
------ gcam_regbasin_modis_v6_type5_mirca_5arcmin_transition_alloc.csv (transition order for land classes)
---- constraints
------ 000_nutrientavail_hswd_5arcmin.csv (nutrient availability constraint weighted by grid cell)
------ 001_soilquality_hswd_5arcmin.csv (soil quality constraint weighted by grid cell)
---- observed
------  gcam_reg32_basin235_modis_v6_2010_mirca_2000_5arcmin_sqdeg_wgs84_11Jul2019.csv (Demeter base layer)
---- projected
------gcam_5p1_watconst_reference.csv (output from demeter_preprocess.py from GCAM output)
------gcam_5p1_watconst_reference_split.csv (output from demeter_preprocess.py from GCAM output with RockIceDesert split into snow and sparse land classes)
---- reference (see https://github.com/IMMM-SFA/demeter)
------ aezcoord.csv
------ countrycoord.csv
------ gcam_basin_lookup.csv
------ gcam_regions_32.csv
------ limits.csv
------ query_land_reg32_basin235_gcam5p0.xml (land allocatio query)
------ regioncoord.csv
-- for_teleconnect
---- usa_demeter.csv (file used by the `teleconnect model` containing only 5-arcmin grid cells that are in GCAM region 1 (USA))
-- outputs (output files from Demeter run)
---- ref_watconstr_2019-11-07_07h20m46s (output Demeter run directory)
------  log_files (log file directory)
-------- logfile_ref_watconstr_2019-11-07_07h20m46s.log (log file from Demeter run)
------  spatial_landcover_tabular
-------- landcover_2015_fraction.csv (fraction of land cover per grid cell per land class for 2015)  
-------- landcover_2015_sqkm.csv (square kilometers of land cover per grid cell per land class for 2015)  
-------- landcover_2015_timestep.csv (square kilometers of land cover per grid cell per land class for 2015)  
-- docs 
---- readme_gcam-reg32basin235_modis-v6-2010_mirca2000_5arcmin.pdf (creation of the Demeter base layer)