This Directory contains the Scripts and Geospatial data used in and output by the analysis in this article: "Mapping the Yearly Extent of Surface Coal Mining in Central Appalachia using Landsat and Google Earth Engine"

	------------------
	---- Contents ----
	------------------
1. EE Scripts (Directory)
	- This directory contains the Earth Engine scripts used to analyze imagery and
	- identify mining in Central Appalachia

2. Mining-Cumulative (Directory)
	- This directory contains the cumulative mining data as identified from 1985-2015
	- in a variety of formats
		* GeoJSON (Directory)
		* GeoTIFF (Directory)
		* KML (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-2015
		* GeoJSON (Directory)
		* GeoTIFF (Directory)
		* KML (Directory)
		* KML-Simplified (Directory)
		* Shapefile (Directory)

4. Other-Data (Directory)
	- This directory contains geospatial data not output by Earth Engine (Mask & Study
	- Area Boundary) as well as First-Mined.tif (when a pixel was first mined) and 
	- Last-Mined.tif(when a pixel was most recently mined)

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

	------------------
	------ Notes -----
	------------------

- Earth Engine allows vector files to be exported in 2 formats: GeoJSON and KML, the KML
- data has had its geometries simplified (i.e. holes in polygons may be closed)as a part
- of the export process. For this reason, we do not recommend using these KMLs for any
- purpose other than display. As a part of our processing we have created a set of KMLs
- which can be used for analysis. 

- Earth Engine vector exports are all EPSG:4326. All GeoTIFFs are EPSG:5072.

- Earth Engine outputs the Cumulative_Mining_Area_1985-2015 as a multiband image, which
- we provide as CumulativeMineArea_1985-2015_multiband.tiff . We also provide it as a 
- singleband image: CumulativeMineArea_1985-2015_singleband.tiff , this was created 
- using the following gdal_transform command:
--- gdal_translate -b 1 CumulativeMineArea_1985-2015_multiband.tif 
--- CumulativeMineArea_1985-2015_singleband.tif -co TILED=YES -co COMPRESS=DEFLATE
--- -co INTERLEAVE=BAND -co PREDICTOR=2
- Running the above command on Band 2 yields the same result; running the above command
- on Band 3 will create an image with a value of 1 anywhere inside the study area,
- everything outside the study area has a value of 0.

- As previously stated, Earth Engine only allows vector files to be exported as GeoJSON or
- KML. All Shapefiles, and some KML files, were created by converting the GeoJSON output 
- using OGR. 

- In the Yearly-Active-Mining Directory there are 2 subdirectories containing KML data: 
- "KML" and "KML-Simplified". The "KML-Simplified" is the direct KML output of Earth
- Engine and is not recommended for display. The "KML" directory contains KML files which
- were created by converting Earth Engine's geojson output to KML using OGR, these files
- are suitable for display.



Converted geojson files to Shapefiles using:  
for f in *.geojson; do ogr2ogr -f "ESRI Shapefile" Shapefile/${f%.geojson}.shp ${f};done

Converted geojson files to KML using:  
	for f in *.geojson; do ogr2ogr -f “KML” KML/${f%.geojson}.kml ${f};done