This directory contains scripts and geospatial data used in, and output by, SkyTruth's updated surface mine analysis. These data are updated versions of those originally published in the PLOS ONE article: "Mapping the Yearly Extent of Surface Coal Mining in Central Appalachia using Landsat and Google Earth Engine". All data are exported from Earth Engine in EPSG:5072, conversions to EPSG:4326 are done locally, using GDAL, RASTERIO, and OGR.

Please direct inquires to Christian Thomas (christian@skytruth.org).
------------------------------------------------------------------------------------------
------------------------------------ CONTENTS --------------------------------------------
------------------------------------------------------------------------------------------

1. EE_Scripts (Directory)
   - This directory contains the Earth Engine scripts used to analyze imagery and identify
     mining in Central Appalachia.
   	* JavaScript (Directory)
	* Python (Directory)

2. Mining_Cumulative (Directory)
   - This directory contains the cumulative mining data as identified from 1985-2019 in a
     a variety of spatial formats.
	* GeoJSON (Directory)
	* GeoTIFF (Directory)
	* Shapefile (Directory)

3. Mining_Yearly (Directory)
   - This directory contains the yearly identified active mining data in a variety of
     formats, for each year from 1985-2019.
	* GeoJSON (Directory)
	* GeoTIFF (Directory) - Footprints only, band value equal year of mining
			       there is no index info stored in these images
	* Shapefile (Directory)

4. Other_Data (Directory)
   - This directory contains geospatial data not output by Earth Engine (Mask & Study Area
     Boundary).

5. readMe.txt (Text File)
   - Overview of the Data and Directories present here.

------------------------------------------------------------------------------------------
-------------------------------------- NOTES ---------------------------------------------
------------------------------------------------------------------------------------------
Every directory which contains spatial data (that is any directory named: GeoJSON, GeoTIFF, or Shapefile), provides the data in two CRSes, EPSG:4326 and EPSG:5072. These are found in subdirectories names 4326 and 5072. All spatial files also have their CRS 
specified in their filename, before the file extension. All conversions between CRSes were done using GDAL and OGR2OGR.
	e.g. 1985_activeMining_4326.shp is EPSG:4326
	     1985_activeMining_5072.shp is EPSG:5072


Vectors were exported from Earth Engine as GeoJSON files, rasters were exported as GeoTIFF files. Conversions to shapefiles were performed locally using ogr2ogr. 


Creation of the single-band Cumulative Mining images were accomplished using the following
rio merge commands:
	rio merge *.tiff -o CumulativeMineArea_1985-2019_5072.tiff --co TILED=YES --co COMPRESS=DEFLATE 
     	--co INTERLEAVE=BAND --co PREDICTOR=2 --nodata 0 -b 1