source commit: ccadf2e

CODE_OF_CONDUCT.md

@@ -0,0 +1,15 @@
+---
+title: "Contributor Code of Conduct"
+---
+
+As contributors and maintainers of this project,
+we pledge to follow the [The Carpentries Code of Conduct][coc].
+
+Instances of abusive, harassing, or otherwise unacceptable behavior
+may be reported by following our [reporting guidelines][coc-reporting].
+
+[coc]: https://docs.carpentries.org/topic_folders/policies/code-of-conduct.html
+[coc-reporting]: https://docs.carpentries.org/topic_folders/policies/incident-reporting.html
+
+
+

LICENSE.md

@@ -0,0 +1,82 @@
+---
+title: "Licenses"
+---
+
+## Instructional Material
+
+All Carpentries (Software Carpentry, Data Carpentry, and Library Carpentry)
+instructional material is made available under the [Creative Commons
+Attribution license][cc-by-human]. The following is a human-readable summary of
+(and not a substitute for) the [full legal text of the CC BY 4.0
+license][cc-by-legal].
+
+You are free:
+
+- to **Share**\---copy and redistribute the material in any medium or format
+- to **Adapt**\---remix, transform, and build upon the material
+
+for any purpose, even commercially.
+
+The licensor cannot revoke these freedoms as long as you follow the license
+terms.
+
+Under the following terms:
+
+- **Attribution**\---You must give appropriate credit (mentioning that your work
+  is derived from work that is Copyright (c) The Carpentries and, where
+  practical, linking to [https://carpentries.org/](https://carpentries.org/)), provide a [link to the
+  license][cc-by-human], and indicate if changes were made. You may do so in
+  any reasonable manner, but not in any way that suggests the licensor endorses
+  you or your use.
+
+- **No additional restrictions**\---You may not apply legal terms or
+  technological measures that legally restrict others from doing anything the
+  license permits.  With the understanding that:
+
+Notices:
+
+- You do not have to comply with the license for elements of the material in
+  the public domain or where your use is permitted by an applicable exception
+  or limitation.
+- No warranties are given. The license may not give you all of the permissions
+  necessary for your intended use. For example, other rights such as publicity,
+  privacy, or moral rights may limit how you use the material.
+
+## Software
+
+Except where otherwise noted, the example programs and other software provided
+by The Carpentries are made available under the [OSI][osi]\-approved [MIT
+license][mit-license].
+
+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.
+
+## Trademark
+
+"The Carpentries", "Software Carpentry", "Data Carpentry", and "Library
+Carpentry" and their respective logos are registered trademarks of [Community
+Initiatives][ci].
+
+[cc-by-human]: https://creativecommons.org/licenses/by/4.0/
+[cc-by-legal]: https://creativecommons.org/licenses/by/4.0/legalcode
+[osi]: https://opensource.org
+[mit-license]: https://opensource.org/licenses/mit-license.html
+[ci]: https://communityin.org/
+
+
+

config.yaml

@@ -0,0 +1,82 @@
+#------------------------------------------------------------
+# Values for this lesson.
+#------------------------------------------------------------
+
+# Which carpentry is this (swc, dc, lc, or cp)?
+# swc: Software Carpentry
+# dc: Data Carpentry
+# lc: Library Carpentry
+# cp: Carpentries (to use for instructor training for instance)
+# incubator: The Carpentries Incubator
+carpentry: 'dc'
+
+# Overall title for pages.
+title: 'Geospatial Workshop Overview'
+
+# Date the lesson was created (YYYY-MM-DD, this is empty by default)
+created: '2018-03-06'
+
+# Comma-separated list of keywords for the lesson
+keywords: 'software, data, lesson, The Carpentries' # FIXME
+
+# Life cycle stage of the lesson
+# possible values: pre-alpha, alpha, beta, stable
+life_cycle: 'stable'
+
+# License of the lesson
+license: 'CC-BY 4.0'
+
+# Link to the source repository for this lesson
+source: 'https://github.com/datacarpentry/geospatial-workshop'
+
+# Default branch of your lesson
+branch: 'main'
+
+# Who to contact if there are any issues
+contact: 'team@carpentries.org'
+
+# Navigation ------------------------------------------------
+#
+# Use the following menu items to specify the order of
+# individual pages in each dropdown section. Leave blank to
+# include all pages in the folder.
+#
+# Example -------------
+#
+# episodes:
+# - introduction.md
+# - first-steps.md
+#
+# learners:
+# - setup.md
+#
+# instructors:
+# - instructor-notes.md
+#
+# profiles:
+# - one-learner.md
+# - another-learner.md
+
+# Order of episodes in your lesson
+episodes: 
+- introduction.Rmd
+
+# Information for Learners
+learners: 
+
+# Information for Instructors
+instructors: 
+
+# Learner Profiles
+profiles: 
+
+# Customisation ---------------------------------------------
+#
+# This space below is where custom yaml items (e.g. pinning
+# sandpaper and varnish versions) should live
+
+
+url: 'https://datacarpentry.github.io/geospatial-workshop'
+analytics: 'carpentries'
+lang: 'en'
+overview: true

data.md

@@ -0,0 +1,79 @@
+---
+title: Workshop data
+---
+
+## NEON Spatio-temporal Teaching Data Subset
+
+Available on FigShare:
+[NEON Spatio-temporal Teaching Data Subset](https://figshare.com/articles/Spatio_temporal_Series_Teaching_Data_Subsets/2009586).
+
+**CITATION:** Data Skills Teaching Data Subsets, NEON; Wasser, Leah; Jones, Megan A. (2016):
+NEON Spatio-temporal Teaching Data Subset. figshare. Fileset. [https://doi.org/10.6084/m9.figshare.2009586.v10](https://doi.org/10.6084/m9.figshare.2009586.v10)
+
+The data and lessons in this workshop were originally developed through a hackathon funded by the [National Ecological Observatory Network (NEON)](https://www.neonscience.org/) - an NSF funded observatory in Boulder, Colorado - in collaboration with Data Carpentry, SESYNC and CYVERSE. NEON is collecting data for 30 years to help scientists understand
+how our aquatic and terrestrial ecosystems are changing. The data used in these lessons cover two NEON field sites:
+
+- Harvard Forest (HARV) - Massachusetts, USA - [fieldsite description](https://www.neonscience.org/field-sites/field-sites-map/HARV)
+- San Joaquin Experimental Range (SJER) - California, USA - [fieldsite description](https://www.neonscience.org/field-sites/field-sites-map/SJER)
+
+You can download all of the data used in this workshop by clicking
+[this download link](https://ndownloader.figshare.com/articles/2009586/versions/10).
+Clicking the download link will automatically download all of the files to your default download directory as a single compressed
+(`.zip`) file. To expand this file, double click the folder icon in your file navigator application (for Macs, this is the Finder
+application).
+
+These data files represent teaching version of the data, with sufficient complexity to teach many aspects of  data analysis and
+management, but with many complexities removed to allow students to focus on the core ideas and skills being taught.
+
+| Dataset                      | File name                          | Description                                                                                                                                                                                                                                             | 
+| ---------------------------- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Site layout shapefiles       | NEON-DS-Site-Layout-Files.zip      | A set of shapefiles for the NEON's Harvard Forest field site and US and (some) state boundary layers.                                                                                                                                                   | 
+| Meteorological data          | NEON-DS-Met-Time-Series.zip        | Precipitation, temperature and other variables collected from a flux tower at the NEON Harvard Forest site                                                                                                                                              | 
+| Airborne remote sensing data | NEON-DS-Airborne-RemoteSensing.zip | LiDAR data collected by the NEON Airborne Observation Platform (AOP) and processed at NEON including a canopy height model, digital elevation model and digital surface model for NEON's Harvard Forest and San Joaquin Experimental Range field sites. | 
+| Landstat 7 NDVI raster data  | NEON-DS-Landsat-NDVI.zip           | 2011 NDVI data product derived from Landsat 7 and processed by USGS cropped to NEON's Harvard Forest and San Joaquin Experimental Range field sites                                                                                                     | 
+
+### About the Site Layout Shapefiles
+
+These vector data provide information on the site characterization and infrastructure at the
+[National Ecological Observatory Network's](https://www.neonscience.org/)
+[Harvard Forest](https://www.neonscience.org/field-sites/field-sites-map/HARV) field site.
+The Harvard Forest shapefiles are from the [Harvard Forest GIS \& Map](https://harvardforest.fas.harvard.edu/gis-maps/) archives.
+US Country and State Boundary layers are from the [US Census Bureau](https://www.census.gov/geo/maps-data/data/tiger-cart-boundary.html).
+
+### About the Meteorological Data
+
+The data used in this lesson were collected at the [National Ecological Observatory Network's](https://www.neonscience.org/)
+[Harvard Forest](https://www.neonscience.org/field-sites/field-sites-map/HARV). These data are proxy data for what will be available
+for 30 years on the [NEON data portal](https://data.neonscience.org/home) for the Harvard Forest and other field sites located across
+the United States.
+
+### About the Airborne Remote Sensing Data
+
+This data was collected at the [National Ecological Observatory Network's](https://www.neonscience.org/)
+[Harvard Forest](https://www.neonscience.org/field-sites/field-sites-map/HARV) and
+[San Joaquin Experimental Range](https://www.neonscience.org/field-sites/field-sites-map/SJER) field sites.
+
+Data are collected during peak greenness at each field site and are processed to provide useful data products to the community. The following NEON data products are used in these lessons:
+
+Data Created from Discrete Return (point clouds) Lidar Data:
+
+- DSM (Digital Surface Model; full mosaic)
+- DTM (Digital Terrain Model; full mosaic)
+- CHM (Canopy Height Model; full mosaic; Harvard Forest site only)
+  and
+- RGB imagery (Harvard Forest site only) derived from the RGB Camera
+
+Additional information about airborne remote sensing data, including other data types for these and other sites can
+be found on [NEON's Airborne Data](https://www.neonscience.org/data-collection/airborne-remote-sensing) page.
+
+### About the Landstat 7 NDVI Raster Data
+
+The imagery data used to create this raster teaching data subset were collected over the
+[National Ecological Observatory Network's](https://www.neonscience.org/)
+[Harvard Forest](https://www.neonscience.org/field-sites/field-sites-map/HARV)
+and [San Joaquin Experimental Range](https://www.neonscience.org/field-sites/field-sites-map/SJER) field sites.
+The imagery was created by the U.S. Geological Survey (USGS) using a
+[multispectral scanner](https://eros.usgs.gov/#/Find_Data/Products_and_Data_Available/MSS) on a
+[Landsat Satellite](https://landsat.usgs.gov/). The data files are Geographic Tagged Image-File Format (GeoTIFF).
+
+

index.md

@@ -0,0 +1,73 @@
+---
+site: sandpaper::sandpaper_site
+---
+
+Data Carpentry's aim is to teach researchers basic concepts, skills, and tools for working with data so that they can get more done in less time, and with less pain.
+
+Interested in teaching these materials? We have an [onboarding video](https://www.youtube.com/watch?v=Qtnb_eeHt7E) available to prepare Instructors to teach these lessons. After
+watching this video, please contact [team@carpentries.org](mailto:team@carpentries.org) so that we can record your status as an onboarded
+Instructor. Instructors who have completed onboarding will be given priority status for teaching at centrally-organized Data Carpentry Geospatial workshops.
+
+::::::::::::::::::::::::::::::::::::::::::  prereq
+
+## Getting Started
+
+Data Carpentry's teaching is hands-on, so participants are encouraged to use
+their own computers to ensure the proper setup of tools for an efficient
+workflow. To most effectively use these materials, please make sure to download
+the data and install everything before working through this lesson.
+
+This workshop assumes no prior experience with the tools covered in the workshop. However, learners with prior
+experience working with geospatial data may be able to skip the
+[Geospatial Project Organization and Management](https://www.datacarpentry.org/organization-geospatial/) lesson.
+Similarly, learners who have prior experience with the `R` programming language may wish to skip the
+[Introduction to R for Geospatial Data](https://www.datacarpentry.org/r-intro-geospatial/) lesson.
+
+To get started, follow the directions in the [Setup](learners/setup.md) tab to
+get access to the required software and data for this workshop.
+
+::::::::::::::::::::::::::::::::::::::::::::::::::
+
+::::::::::::::::::::::::::::::::::::::::::  prereq
+
+## Data
+
+The data and lessons in this workshop were originally developed through a hackathon funded by the
+[National Ecological Observatory Network (NEON)](https://www.neonscience.org/) - an NSF funded observatory in Boulder, Colorado - in
+collaboration with Data Carpentry, SESYNC and CYVERSE. NEON is collecting data for 30 years to help scientists understand
+how aquatic and terrestrial ecosystems are changing. The data used in these lessons cover two NEON field sites:
+
+- Harvard Forest (HARV) - Massachusetts, USA - [fieldsite description](https://www.neonscience.org/field-sites/field-sites-map/HARV)
+- San Joaquin Experimental Range (SJER) - California, USA - [fieldsite description](https://www.neonscience.org/field-sites/field-sites-map/SJER)
+
+There are four data sets included, all of which are available
+[on Figshare](https://figshare.com/articles/Spatio_temporal_Series_Teaching_Data_Subsets/2009586)
+under a CC-BY license. You can download all of the data used in this workshop by clicking
+[this download link](https://ndownloader.figshare.com/articles/2009586/versions/10).
+Clicking the download link will download all of the files as a single compressed
+(`.zip`) file. To expand this file, double click the folder icon in your file navigator application (for Macs, this is the Finder
+application).
+
+These data files represent the teaching version of the data, with sufficient complexity to teach many aspects of  data analysis and
+management, but with many complexities removed to allow students to focus on the core ideas and skills being taught.
+
+| Dataset                      | File name                                                                                  | Description                                                                                                                                                                                                                                             | 
+| ------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Site layout shapefiles       | NEON-DS-Site-Layout-Files.zip                                                              | A set of shapefiles for the NEON's Harvard Forest field site and US and (some) state boundary layers.                                                                                                                                                   | 
+| Meteorological data          | NEON-DS-Met-Time-Series.zip                                                                | Precipitation, temperature and other variables collected from a flux tower at the NEON Harvard Forest site                                                                                                                                              | 
+| Airborne remote sensing data | NEON-DS-Airborne-RemoteSensing.zip                                                         | LiDAR data collected by the NEON Airborne Observation Platform (AOP) and processed at NEON including a canopy height model, digital elevation model and digital surface model for NEON's Harvard Forest and San Joaquin Experimental Range field sites. | 
+| Landstat 7 NDVI raster data  | NEON-DS-Landsat-NDVI.zip                                                                   | 2011 NDVI data product derived from Landsat 7 and processed by USGS cropped to NEON's Harvard Forest and San Joaquin Experimental Range field sites                                                                                                     | 
+
+[More information on this dataset](instructors/data.md)
+
+::::::::::::::::::::::::::::::::::::::::::::::::::
+
+# Workshop Overview
+
+| Lesson                       | Overview                                                                                   | 
+| ---------------------------------------------------------- | ------------------------------------------------------------ |
+| [Introduction to Geospatial Concepts](https://www.datacarpentry.org/organization-geospatial/)                             | Understand data structures and common storage and transfer formats for spatial data.       | 
+| [Introduction to R for Geospatial Data](https://www.datacarpentry.org/r-intro-geospatial)                             | Import data into R, calculate summary statistics, and create publication-quality graphics. | 
+| [Introduction to Geospatial Raster and Vector Data with R](https://www.datacarpentry.org/r-raster-vector-geospatial)                             | Open, work with, and plot vector and raster-format spatial data in R.                      | 
+
+