Skip to content

Commit c82cac9

Browse files
committed
Added spatial autocorrelation text to README
1 parent 6770e6a commit c82cac9

File tree

2 files changed

+23
-0
lines changed

2 files changed

+23
-0
lines changed

README.Rmd

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -185,6 +185,10 @@ create_SAR(occurrences = area_dat, npsi = 1, visualize = TRUE)
185185
```
186186
This is the species-area relationship (SAR) for Anolis including island-based occurrences within a polygon around Caribbean islands from the first 10,000 records for the genus in GBIF! The best-fit model was a segmented regression with one breakpoint. The R console will also output statistical information about the model.
187187

188+
### A Note About Spatial Autocorrelation
189+
190+
Species-area relationships (SARs) and speciation-area relationships (SpARs) are impacted by the environmental and spatial characteristics of the islands (or island-like areas) of interest. When inferring SARs and SpARs, researchers typically treat these effects as part of the broader biogeographic processes that are captured by the SARs and SpARs (Triantis et al. 2012). However, ignoring spatial effects when inferring SARs and SpARs can result in biased parameter estimates (Barros et al. 2023). Please refer to [this vignette to learn more about how to test for spatial autocorrelation when using `ssarp` to create SARs and SpARs](https://kmartinet.github.io/ssarp/articles/Spatial_Autocorrelation.html).
191+
188192
### Workflow Summary for using data from GBIF to create a species-area relationship plot
189193

190194
1. Use `rgbif` to gather occurrence records, or input your own dataframe of occurrence records.
@@ -204,8 +208,10 @@ This is the species-area relationship (SAR) for Anolis including island-based oc
204208
When using `rgbif::occ_search` to gather occurrence records from GBIF, the user can specify a well-known text (WKT) representation of geometry to restrict the geographic location of the returned occurrence records. The `rgbif::occ_search` function requires a counter-clockwise winding order for WKT. I find it helpful to think about WKT polygons in this way: imagine a square around your geographic area of interest and pick one of the corners as a starting point. The order of points in WKT format should follow counter-clockwise from the corner you picked first, and the final entry in the WKT string needs to be the same as the first entry. Additionally, while GPS points are typically represented in "latitude, longitude" format, WKT expects them in "longitude latitude" format with commas separating the points rather than individual longitude and latitude values. WKT polygons can have more specified points than included in this simple square example, and even include polygons nested within others or polygons with holes in the middle.
205209

206210
#### Literature Cited
211+
- Barros, D.D., Mathias, M.d.L., Borges, P.A.V., & Borda-de-Água, L. (2023). The Importance of Including Spatial Autocorrelation When Modelling Species Richness in Archipelagos: A Bayesian Approach. Diversity, 15: 127.
207212
- Jetz, W., Thomas, G.H, Joy, J.B., Harmann, K., & Mooers, A.O. (2012). The global diversity of birds in space and time. *Nature*, 491: 444-448.
208213
- Magallόn, S. & Sanderson, M.J. (2001). Absolute Diversification Rates in Angiosperm Clades. *Evolution*, 55(9): 1762-1780.
209214
- Rabosky, D.L. (2014). Automatic Detection of Key Innovations, Rate Shifts, and Diversity-Dependence on Phylogenetic Trees. PLOS ONE, 9(2): e89543.436
210215
- Rabosky, D.L., Grundler, M., Anderson, C., Title, P., Shi, J.J., Brown, J.W., Huang, H., & Larson, J.G. (2014). BAMMtools: an R package for the analysis of evolutionary dynamics on phylogenetic trees. Methods in Ecology and Evolution, 5: 701-707.
216+
- Triantis, K.A., Guilhaumon, F., & Whittaker, R.J. (2012), The island species–area relationship: biology and statistics. Journal of Biogeography, 39: 215-231.
211217

README.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -301,6 +301,17 @@ the first 10,000 records for the genus in GBIF! The best-fit model was a
301301
segmented regression with one breakpoint. The R console will also output
302302
statistical information about the model.
303303

304+
### A Note About Spatial Autocorrelation
305+
306+
Species-area relationships (SARs) and speciation-area relationships (SpARs) are
307+
impacted by the environmental and spatial characteristics of the islands (or
308+
island-like areas) of interest. When inferring SARs and SpARs, researchers
309+
typically treat these effects as part of the broader biogeographic processes
310+
that are captured by the SARs and SpARs (Triantis et al. 2012). However,
311+
ignoring spatial effects when inferring SARs and SpARs can result in biased
312+
parameter estimates (Barros et al. 2023). Please refer to
313+
[this vignette to learn more about how to test for spatial autocorrelation when using `ssarp` to create SARs and SpARs](https://kmartinet.github.io/ssarp/articles/Spatial_Autocorrelation.html).
314+
304315
### Workflow Summary for using data from GBIF to create a species-area relationship plot
305316

306317
1. Use `rgbif` to gather occurrence records, or input your own
@@ -388,6 +399,9 @@ polygons nested within others or polygons with holes in the middle.
388399

389400
#### Literature Cited
390401

402+
- Barros, D.D., Mathias, M.d.L., Borges, P.A.V., & Borda-de-Água, L. (2023). The
403+
Importance of Including Spatial Autocorrelation When Modelling Species
404+
Richness in Archipelagos: A Bayesian Approach. Diversity, 15: 127.
391405
- Jetz, W., Thomas, G.H, Joy, J.B., Harmann, K., & Mooers, A.O. (2012).
392406
The global diversity of birds in space and time. *Nature*, 491:
393407
444-448.
@@ -400,3 +414,6 @@ polygons nested within others or polygons with holes in the middle.
400414
Brown, J.W., Huang, H., & Larson, J.G. (2014). BAMMtools: an R package
401415
for the analysis of evolutionary dynamics on phylogenetic trees.
402416
Methods in Ecology and Evolution, 5: 701-707.
417+
- Triantis, K.A., Guilhaumon, F., & Whittaker, R.J. (2012), The island
418+
species–area relationship: biology and statistics. Journal of Biogeography,
419+
39: 215-231.

0 commit comments

Comments
 (0)