Access & Use of NEON Data, Aquatics Training Palooza 2018

Through participation in this workshop,  full-time field ecologists on the NEON project will improve their ability to work with the local scientific community (site hosts, local researchers, and other potential NEON data users) by increasing their knowledge of the online resources available from NEON and the skills needed to access NEON data. In addition, the workshop will enable the field ecologists to directly work with NEON data by teaching them basic data skills that will increase their ability to conduct basic QA/QC on the data.

Objectives

At the end of the workshop, NEON aquatic field ecologists will be able to:

• Explain to site hosts and researchers at the sites where to go for more information on NEON, NEON data collection methods, NEON data, and training on using NEON data (neonscience.org).
• Explain to site hosts and researchers at field sites where to find information on what data is available for download (data.neonscience.org).
• Explain to potential data users multiple methods for accessing NEON data:
  • through NEON data portal
  • direct API calls
  • through software packages, like the R package nneo
• Download data for a specified data product, site, and time frame from the data portal.
• Use the neonstackR package to combine multiple site/months .csv files to get a complete data set of interest.
• Produce line/bar plots of data products of interest.

Things You’ll Need To Complete This Workshop

1) Install/Update Software

To participant in this workshop, you will need a laptop with the most current version of R, and, preferably, RStudio loaded on your computer. For details on installing RStudio in Mac, PC, or Linux operating systems, please see the Additional Set Up Instructions section at the bottom of this page.

Please note, while these packages are required, a working knowledge of using R and RStudio is not required.

If you already have these installed on your laptop, please be sure that you are running the most current version of RStudio, R and all packages that we'll be using in the workshop (listed below).

2) Install R Packages

We will be using the package neonDataStackR in this workshop. To install, open up RStudio, in the bottom left window of RStudio -- the "console" type in the following set of commands.

install.packages("devtools")

library(devtools)

devtools::install_github("NEONScience/NEON-utilities/neonDataStackR")

Then to make sure the installation worked:

library(neonDataStackR)

If you get no output, it is correctly installed. If you get an error, please repeat the steps.

If you already have neonDataStackR installed, please update you version of neonDataStackR as it is frequently updated.

More on Packages in R

3) Data to Download

Assuming there are no internet problems, we will be using data directly from the portal. However, please download this sample data file so that, if internet issues arise during the workshop, we will have data to work with.

DOWNLOAD NEON SURFACE WATER CHEMISTRY DATA SUBSET

Please keep the downloaded data in your "Downloads" folder. This data is downloaded as back up in case there are issues with the internet connectivity or data portal during the workshop.

Workshop Instructor

• Megan A. Jones; @meganahjones; Staff Scientists/Science Educator, NEON

Please get in touch with the instructor prior to the workshop with any questions.

Twitter?

Please tweet @NEON_sci and with the #WorkWithData hashtag during the workshop.

Schedule

Please note that the schedule listed below may change depending upon the pace of the workshop!

Additional Set Up Resources

Setting Up R & RStudio

Windows R/RStudio Setup

• Download R for Windows here
• Run the .exe file that was just downloaded
• Go to the RStudio Download page
• Under Installers select RStudio X.XX.XXX - Windows Vista/7/8/10
• Double click the file to install it

Once R and RStudio are installed, click to open RStudio. If you don't get any error messages you are set. If there is an error message, you will need to re-install the program.

Mac R/RStudio Setup

• Go to CRAN and click on Download R for (Mac) OS X
• Select the .pkg file for the version of OS X that you have and the file will download.
• Double click on the file that was downloaded and R will install
• Go to the RStudio Download page
• Under Installers select RStudio 0.98.1103 - Mac OS X XX.X (64-bit) to download it.
• Once it's downloaded, double click the file to install it

Once R and RStudio are installed, click to open RStudio. If you don't get any error messages you are set. If there is an error message, you will need to re-install the program.

Linux R/RStudio Setup

• R is available through most Linux package managers. You can download the binary files for your distribution from CRAN. Or you can use your package manager (e.g. for Debian/Ubuntu run sudo apt-get install r-base and for Fedora run sudo yum install R).
• To install RStudio, go to the RStudio Download page
• Under Installers select the version for your distribution.
• Once it's downloaded, double click the file to install it

Once R and RStudio are installed, click to open RStudio. If you don't get any error messages you are set. If there is an error message, you will need to re-install the program.