Skip to content

Commit 2fb4225

Browse files
committed
Merge remote-tracking branch 'origin/master'
2 parents 008ee55 + 3ecad40 commit 2fb4225

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

53 files changed

+56896
-0
lines changed
Binary file not shown.

APD-April2023/Current_Workshop.Rproj

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
Version: 1.0
2+
3+
RestoreWorkspace: Default
4+
SaveWorkspace: Default
5+
AlwaysSaveHistory: Default
6+
7+
EnableCodeIndexing: Yes
8+
UseSpacesForTab: Yes
9+
NumSpacesForTab: 2
10+
Encoding: UTF-8
11+
12+
RnwWeave: Sweave
13+
LaTeX: pdfLaTeX

APD-April2023/LICENSE

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
MIT License
2+
3+
Copyright (c) 2022 Socorro Dominguez Vidana
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.
Lines changed: 188 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,188 @@
1+
# neotoma2 PNW Virtual Workshop Workshop
2+
3+
March 1st, 2023
4+
5+
8:30am - 11:20am Pacific Standard Time [Time Zone Converter](https://dateful.com/convert/pst-pdt-pacific-time?t=0830&d=2023-03-01)
6+
7+
## Socorro Dominguez Vidaña, Simon Goring
8+
9+
# Overview
10+
11+
This workshop is designed to provide users of the Neotoma Database with an overview of the new [`neotoma2` R package](https://github.com/NeotomaDB/neotoma2), and its use in obtaining data from the Neotoma Paleoecology Database.
12+
13+
At the end of this workshop, users will understand the following concepts:
14+
15+
1. How data is structured within Neotoma and in the R package
16+
2. How to search for data in space and time
17+
3. How to extract summary objects from individual sites and collections of sites
18+
4. How to manipulate data to add new chronologies
19+
20+
Online resources for users include links embedded within the agenda, as well as:
21+
22+
* Participant slides: [Google Slides](https://docs.google.com/presentation/d/1lDZAam5zPBf0aK0zrcOgqb9f8-OPCCZk7bOiCw9QFLc/edit?usp=sharing)
23+
* Online slides: [Google Slides](https://docs.google.com/presentation/d/1SN308n1-3q94lV_oF7NMI04Rs-X4kutiI29eJp2B-Vg/edit?usp=sharing)
24+
* An online version of RStudio built for this workshop: [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/NeotomaDB/Current_Workshop/main?urlpath=rstudio)
25+
* The code repository for the workshop: [https://github.com/NeotomaDB/Current_Workshop](https://github.com/NeotomaDB/Current_Workshop)
26+
27+
## Getting Started
28+
29+
The course is designed to be run using RStudio in your browser. You will not need to install any files or packages, however, if you do want to install the R package on your computer, you can simply open your R session and type:
30+
31+
```
32+
install.packages('devtools')
33+
devtools::install_github('NeotomaDB/neotoma2')
34+
```
35+
36+
# Resources
37+
38+
Neotoma maintains an online community on Slack that includes a channel for help using R and Neotoma (#it_r). Come join our community: [https://bit.ly/3PT8zuP](https://bit.ly/3PT8zuP)
39+
40+
This allows us to better help you during the workshop and in the future.
41+
42+
* The Neotoma Database Manual: [https://open.neotomadb.org/manual/](https://open.neotomadb.org/manual/)
43+
* The `neotoma2` GitHub Repository: [https://github.com/neotomadb/neotoma2](https://github.com/neotomadb/neotoma2)
44+
45+
# Agenda
46+
47+
3 Hours (8:30am - 11:20pm)
48+
49+
<table>
50+
<tr>
51+
<td>Time
52+
</td>
53+
<td>Topic
54+
</td>
55+
<td>Overview
56+
</td>
57+
<td>Link
58+
</td>
59+
</tr>
60+
<tr>
61+
<td>8:30 - 8:45am
62+
</td>
63+
<td>Introductions
64+
</td>
65+
<td>Run through each individual’s profile quickly, say hi & introduce ourselves.
66+
</td>
67+
<td><a href="https://docs.google.com/presentation/d/1lDZAam5zPBf0aK0zrcOgqb9f8-OPCCZk7bOiCw9QFLc/edit?usp=sharing">Participant Slides</a>
68+
</td>
69+
</tr>
70+
<tr>
71+
<td>8:45 - 8:50am
72+
</td>
73+
<td>Why `neotoma2`?
74+
</td>
75+
<td>Explaining why we’ve moved to a new package, rather than updating the `neotoma` R package.
76+
</td>
77+
<td><a href="https://docs.google.com/presentation/d/1UhIJ3HJskE9ymmFZ109ktsKKuqzW21JZc8fiWQLkyZw/edit?usp=sharing">Why neotoma2?</a>
78+
</td>
79+
</tr>
80+
<tr>
81+
<td><strong>8:50 - 9:00am</strong>
82+
</td>
83+
<td><strong>A simple workflow</strong>
84+
</td>
85+
<td colspan="2" ><a href="https://open.neotomadb.org/Current_Worksop/simple_workflow.html">https://open.neotomadb.org/EPD_binder/simple_workflow.html</a>
86+
</td>
87+
</tr>
88+
<tr>
89+
<td>9:20 - 9:30
90+
</td>
91+
<td>Simple Site Search
92+
</td>
93+
<td>How to search for sites by space & name.
94+
</td>
95+
<td>
96+
</td>
97+
</tr>
98+
<tr>
99+
<td>9:30 - 9:35
100+
</td>
101+
<td>Independent Searching
102+
</td>
103+
<td>Individuals will use the geoJSON site to select an area, perform a search and plot the results. Paste the image on your personal slide.
104+
</td>
105+
<td>
106+
</td>
107+
</tr>
108+
<tr>
109+
<td>9:35 - 9:40
110+
</td>
111+
<td>Quick Debrief
112+
</td>
113+
<td>One or two people, what did you find?
114+
</td>
115+
<td>
116+
</td>
117+
</tr>
118+
<tr>
119+
<td>9:40 - 9:50am
120+
</td>
121+
<td>Searching for Datasets and Filtering
122+
</td>
123+
<td>How to extract datasets by dataset type & see summary information about records.
124+
</td>
125+
<td>
126+
</td>
127+
</tr>
128+
<tr>
129+
<td>9:50 - 10:00am
130+
</td>
131+
<td>Independent filtering
132+
</td>
133+
<td>Users will filter by time, space &cetera.
134+
</td>
135+
<td>
136+
</td>
137+
</tr>
138+
<tr>
139+
<td>10:05 - 10:10am
140+
</td>
141+
<td>Quick debrief
142+
</td>
143+
<td>What do you need from Neotoma?
144+
</td>
145+
<td>
146+
</td>
147+
</tr>
148+
<tr>
149+
<td>10:10 - 10:30am
150+
</td>
151+
<td>Samples & Stratigraphic plotting
152+
</td>
153+
<td>How to pull them from sites/datasets. Key features, filtering.
154+
</td>
155+
<td>Intro to taxonomic harmonization is in the simple_workflow.html
156+
</td>
157+
</tr>
158+
<tr>
159+
<td>10:30 - 11:00am
160+
</td>
161+
<td>Break
162+
</td>
163+
<td>
164+
</td>
165+
<td>
166+
</td>
167+
</tr>
168+
<tr>
169+
<td>11:00 - 11:20am
170+
</td>
171+
<td>Spatial Analysis
172+
</td>
173+
<td>Using climate data from WorldClim rasters, examine taxon distributions in climate space
174+
</td>
175+
<td>
176+
</td>
177+
</tr>
178+
<tr>
179+
<td>11:20am - end
180+
</td>
181+
<td>Independent Breakout 1
182+
</td>
183+
<td>See instructions in the slide
184+
</td>
185+
<td>Link removed for online version.
186+
</td>
187+
</tr>
188+
</table>

APD-April2023/README.md

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
[![lifecycle](https://img.shields.io/badge/lifecycle-experimental-orange.svg)](https://www.tidyverse.org/lifecycle/#experimental)
2+
[![NSF-1948926](https://img.shields.io/badge/NSF-1948926-blue.svg)](https://nsf.gov/awardsearch/showAward?AWD_ID=1948926)
3+
4+
# Neotoma Current R Workshop
5+
6+
A repository to host interactive R workshops. This repository will always be set up for the most recent/current Neotoma Workshop. All past workshops will be archived in the [Neotoma Workshops](https://github.com/NeotomaDB/Workshops) repository.
7+
8+
This repository is built with the structure required to serve the content through an interactive, online RStudio session using Binder (and Docker). Clicking the Binder link will open RStudio in the user's browser.
9+
10+
**Currently, this repo hosts the Workshop to be delivered for the INQUA Sponsored Workshop in India.**
11+
12+
[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/NeotomaDB/Current_Workshop/main?urlpath=rstudio)
13+
14+
## Contributors
15+
16+
This is an open project and contributions are welcome from any individual. All contributors to this project are bound by a [code of conduct](CODE_OF_CONDUCT.md). Please review and follow this code of conduct as part of your contribution.
17+
18+
* [![orcid](https://img.shields.io/badge/orcid-0000--0002--7926--4935-brightgreen.svg)](https://orcid.org/0000-0002-7926-4935) [Socorro Dominguez Vidana](https://sedv8808.github.io/)
19+
20+
* [![orcid](https://img.shields.io/badge/orcid-0000--0002--2700--4605-brightgreen.svg)](https://orcid.org/0000-0002-2700-4605) [Simon Goring](http://goring.org)
21+
22+
## How to use this repository
23+
24+
This repository contains two different R workflows, a complex workflow that shows how to manage and modify chronologies with the R package, and a simple workflow that shows how to access data and perform relatively simple analysis. These workflows may be modified for content (e.g., focusing on different dataset types or geospatial contexts).
25+
26+
Users may clone this workshop and modify the content, but be aware that the Binder links are specific to this repository, and must be modified through the users' own Binder setup.
27+
28+
* `runtime.txt` is used to define the R environment to be used by Docker/Binder
29+
* `apt.txt` defines a set of packages required by Binder/Docker to enable the spatial tools in the `neotoma2` R package.

APD-April2023/apt.txt

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
libudunits2-dev
2+
libgdal-dev
3+
libgeos-dev
4+
libproj-dev
5+
libglpk-dev

0 commit comments

Comments
 (0)