An introduction to the use of TERRA REF data and software
This repository provides a set of tutorials that are divided by data types and use cases.
In the repository, you will find three folders that contain examples of how to access data:
Within each folder there are both R markdown and Jupyter notebooks. These describe different approaches to accessing data. These are intended to cover diverse use cases, and you will find information about accessing data from web interfaces but the primary focus is on accessing data using R, Python, SQL, and REST APIs. These are intended to provide quick-start introductions to access data along with computing environments required for further exploration. They are not intended to teach analyses, although some illustrative visualizations and statistical models are provided.
This is a work in progress, and an open source community that welcomes contributions in many forms. Please feel welcome to ask questions, provide suggestions or share analyses that may be of interest to others.
All of the tutorials have been designed to work in the cloud and can be accessed using a web browser. Therefore, the only technical requirements are:
- Web browser
- Internet connection
In addition, you will need to:
- Sign up as as a TERRA REF Beta User by filling out this application.
- Sign up for an account on the TERRA REF Workbench, and wait for approval.
Using the Workbench
The Workbench uses the National Data Service Labs Workbench (NDS Labs Workbench) software. The Workbench is a cloud analysis environment that minimizes and standardizes the software requirements so users can get started quickly. It also provides access to large files and databases that would otherwise be slow and impractical for users to download and store.
Although we provide a few pre-configured computing environments, Workbench is designed to support any Docker container - that is, anything you can install on a linux computer can be used in the workbench - for an idea of what is possible, see the large number of options on Docker Hub.
To get started, follow the Workbench Quick Start.
This will walk you through the process of getting started with the first tutorials on how to access data.