Skip to content

Commit

Permalink
version 1.0.2
Browse files Browse the repository at this point in the history
  • Loading branch information
meblair authored and cran-robot committed Dec 22, 2022
1 parent 636fd81 commit 97f4df7
Show file tree
Hide file tree
Showing 8 changed files with 32 additions and 22 deletions.
6 changes: 3 additions & 3 deletions DESCRIPTION
@@ -1,7 +1,7 @@
Package: changeRangeR
Type: Package
Title: Change Metrics for Species Geographic Ranges
Version: 1.0.1
Version: 1.0.2
Authors@R: c(person('Peter J.', 'Galante',email='pgalante@amnh.org',role=c('aut')),
person('Samuel','Chang',email='changalfsam@gmail.com',role=c('aut')),
person('Andrea','Paz',email='paz.andreita@gmail.com',role=c('aut')),
Expand All @@ -24,7 +24,7 @@ Suggests: ape, rgdal, tidyverse, rmarkdown, testthat, tinytex, knitr,
picante, wallace, R.utils, tools, dismo
RoxygenNote: 7.2.2
NeedsCompilation: no
Packaged: 2022-11-28 16:09:58 UTC; kass1
Packaged: 2022-12-22 04:22:36 UTC; kass1
Author: Peter J. Galante [aut],
Samuel Chang [aut],
Andrea Paz [aut],
Expand All @@ -39,4 +39,4 @@ Author: Peter J. Galante [aut],
Mary E. Blair [aut, cre]
Maintainer: Mary E. Blair <mblair1@amnh.org>
Repository: CRAN
Date/Publication: 2022-11-28 19:30:06 UTC
Date/Publication: 2022-12-22 11:40:02 UTC
12 changes: 7 additions & 5 deletions MD5
@@ -1,5 +1,6 @@
0ebe256a4ba383436f5f7a8f132125c2 *DESCRIPTION
1d4b41d3ca9e88d4ac1151309fb92ff4 *DESCRIPTION
031af8234ad76481645504ae0569ba78 *NAMESPACE
2755cde6139914c1848fff7868b68dad *NEWS.md
5b7b0b27caa734faa1b070805421aaf5 *R/PD_from_rasters.R
d6c91a59e549b9b8363582fe00ae5cba *R/SE.R
91ac3633ea49e3b284cc0e1e99d11b82 *R/aooArea.R
Expand All @@ -12,14 +13,15 @@ d0b7a32c7dcadc44f555689e403e9b87 *R/futureOverlap.R
39d4379b2ff4e85835a895be990d9db7 *R/mcpSDM.R
1ecb98c072f17558f6473caf50fffea6 *R/ratioOverlap.R
e8d8b561ce49545824091b793b8e6f1b *R/startup.r
e0be599e40267c00a3aa721b8cb3936d *README.md
ea124a494ad7922985532ad3b308e4d5 *build/partial.rdb
2ff34cd5e8261e854d1bf286bc2ebf8b *build/vignette.rds
5a539d10e014696d1c7532ed5de92dfd *inst/doc/BiodivMetrics.R
1c4f86e49f00256bd0493be1b21ee13b *inst/doc/BiodivMetrics.Rmd
a90afbcdfedfe498ba957ff6677a7307 *inst/doc/BiodivMetrics.pdf
ae42b3f864d841189bfe43219e1e6241 *inst/doc/BiodivMetrics.pdf
a5b2c2eef5a764aab7c40d9b398f25bc *inst/doc/singleSpeciesMetrics.R
f65f0410681547ddc91ca3aed404f384 *inst/doc/singleSpeciesMetrics.Rmd
7189a9069ed76aa6f0c4a6aa1f19e81f *inst/doc/singleSpeciesMetrics.pdf
f386d44ad51c80dde675ac460a16211e *inst/doc/singleSpeciesMetrics.Rmd
21b0457696b357ff0a7b16d6b288b263 *inst/doc/singleSpeciesMetrics.pdf
a14a42ce791f75d64918d91876258ba4 *inst/extdata/DemoData/MODIS/2005_olinguito_Modis_coarse.tif
9eec82c48935f313a42e6198e6646efe *inst/extdata/DemoData/MODIS/2006_olinguito_Modis_coarse.tif
4bc032517313e7185ee6cbf86ad08f3f *inst/extdata/DemoData/MODIS/2008_olinguito_Modis_coarse.tif
Expand Down Expand Up @@ -91,4 +93,4 @@ ae2dad942172359fe4675d1ab02e205e *tests/testthat/test_mcp.R
4aa2e91beedc0f1b5a46caf9ce2e8698 *tests/testthat/test_mcpSDM.R
ddb76735483eae744e0196ac2da1b615 *tests/testthat/test_ratioOverlap.R
1c4f86e49f00256bd0493be1b21ee13b *vignettes/BiodivMetrics.Rmd
f65f0410681547ddc91ca3aed404f384 *vignettes/singleSpeciesMetrics.Rmd
f386d44ad51c80dde675ac460a16211e *vignettes/singleSpeciesMetrics.Rmd
8 changes: 8 additions & 0 deletions NEWS.md
@@ -0,0 +1,8 @@
# changeRangeR 1.0.2

* Fixed broken links that needed updating in the website and vignette.

# changeRangeR 1.0.1

* Reduced file sizes for example data, fixed small errors in tests, fixed small
text mistakes.
8 changes: 8 additions & 0 deletions README.md
@@ -0,0 +1,8 @@
# changeRangeR
R package for calculating metrics of species distributions

To install this development version, use: devtools::install_github('cmerow/changeRangeR')

Please note that demo data used in the vignettes (Single Species Analyses: https://cmerow.github.io/changeRangeR/singleSpeciesMetrics.html and Biodiversity Metrics: https://cmerow.github.io/changeRangeR/BiodivMetrics.html) are available for download at https://github.com/cmerow/changeRangeR/tree/master/inst/extdata/DemoData.

Visit the package website: https://cmerow.github.io/changeRangeR/
Binary file modified inst/doc/BiodivMetrics.pdf
Binary file not shown.
10 changes: 3 additions & 7 deletions inst/doc/singleSpeciesMetrics.Rmd
Expand Up @@ -11,11 +11,7 @@ vignette: >
%\VignetteEngine{knitr::rmarkdown}
%\VignetteEncoding{UTF-8}
---
<!-- CM: Need to add this text into the header above so that devtools::buildvignettes() will work -->
<!-- vignette: > -->
<!-- %\VignetteIndexEntry{changeRanger Single Species Examples} -->
<!-- %\VignetteEngine{knitr::rmarkdown} -->
<!-- %\VignetteEncoding{UTF-8} -->

```{r setup, include=FALSE}
knitr::opts_chunk$set(echo = TRUE, warning=FALSE)
```
Expand All @@ -24,7 +20,7 @@ knitr::opts_chunk$set(echo = TRUE, warning=FALSE)

Translating a species’ current distribution into meaningful conservation metrics in a repeatable and transparent way to inform conservation planning and decision-making remains an outstanding issue in conservation biology. By using a species distribution model (SDM), as well as landscape requirements (e.g., forest cover), we can mask the output of an SDM to only those areas likely to be suitable to estimate the species’ current range (e.g., in [https://cmerow.github.io/maskRangeR/](maskRangeR). From these reduced model outputs, upper bounds of IUCN metrics regarding area of occupancy (AOO) and extent of occurrence (EOO) can be calculated to inform the assessment of a species’ conservation status, in combination with other information [1]. In addition, we can calculate the proportion of a species’ range size that is protected, that is threatened, or that is associated with different land cover types. If past or future model projections or geospatial data on habitat for masking are available, we can also calculate and visualize change in these metrics over time. These change metrics can then inform IUCN red-listing and forward-thinking conservation planning. We provide an example below to calculate these metrics for the olinguito [2] using the changeRangeR package. Beyond single species, we can combine models from multiple species to calculate community-level metrics of conservation interest to learn more about this see our multi-species vignettes (see Biodiversity metrics vignette).

[1] IUCN Standards and Petitions Committee. 2019. Guidelines for Using the IUCN Red List Categories and Criteria. Version 14. Prepared by the Standards and Petitions Committee.
[1] IUCN Standards and Petitions Committee. 2022. Guidelines for Using the IUCN Red List Categories and Criteria. Version 15.1. Prepared by the Standards and Petitions Committee. Available from: http://www.iucnredlist.org/resources/RedListGuidelines

[2] Helgen, K.M., Miguel Pinto, C., Kays, R., Helgen, L.E., Tsuchiya, M. T. N., Quinn, A., Wilson, D.E., Maldonado, J.E. (2013) Taxonomic revision of the olingos (Bassaricyon), with description of a new species, the Olinguito. Zookeys, 324, 1-83. https://doi.org/10.3897/zookeys.324.5827.

Expand Down Expand Up @@ -61,7 +57,7 @@ paste0("area = ", area[1], " km^2")

## EOO Occurrences

IUCN’s EOO is defined as the area contained within the shortest imaginary (continuous) boundary drawn to encompass all the known (current) occurrences of a taxon, excluding vagrant localities. This measure may exclude discontinuities or disjunctions within the overall distribution of a taxon (e.g., large areas of unsuitable habitat, but see AOO below). The EOO is typically measured by drawing a minimum convex polygon (MCP, also called a convex hull) around occurrence localities, but this may include many large areas of obviously unsuitable or unoccupied habitat, making a convex hull around a thresholded SDM more appropriate (cite Jamie’s paper?). It is important to follow the guidelines of the relevant IUCN SSC SG when contributing EOO or AOO measurements to enable consistency across assessments. You can read more about IUCN definitions [here](https://www.iucnredlist.org/resources/categories-and-criteria).
IUCN’s EOO is defined as the area contained within the shortest imaginary (continuous) boundary drawn to encompass all the known (current) occurrences of a taxon, excluding vagrant localities. This measure may exclude discontinuities or disjunctions within the overall distribution of a taxon (e.g., large areas of unsuitable habitat, but see AOO below). The EOO is typically measured by drawing a minimum convex polygon (MCP, also called a convex hull) around occurrence localities, but this may include many large areas of obviously unsuitable or unoccupied habitat, making a convex hull around a thresholded SDM more appropriate. It is important to follow the guidelines of the relevant IUCN SSC SG when contributing EOO or AOO measurements to enable consistency across assessments. You can read more about IUCN definitions [here](https://www.iucnredlist.org/resources/categories-and-criteria).
In changeRangeR, users can calculate IUCN’s EOO via two options 1) MCP/convex hull around occurrence localities, 2) MCP/convex hull area of thresholded (MTP) SDM.

Calculate the extent of occupancy around occurrence localities
Expand Down
Binary file modified inst/doc/singleSpeciesMetrics.pdf
Binary file not shown.
10 changes: 3 additions & 7 deletions vignettes/singleSpeciesMetrics.Rmd
Expand Up @@ -11,11 +11,7 @@ vignette: >
%\VignetteEngine{knitr::rmarkdown}
%\VignetteEncoding{UTF-8}
---
<!-- CM: Need to add this text into the header above so that devtools::buildvignettes() will work -->
<!-- vignette: > -->
<!-- %\VignetteIndexEntry{changeRanger Single Species Examples} -->
<!-- %\VignetteEngine{knitr::rmarkdown} -->
<!-- %\VignetteEncoding{UTF-8} -->

```{r setup, include=FALSE}
knitr::opts_chunk$set(echo = TRUE, warning=FALSE)
```
Expand All @@ -24,7 +20,7 @@ knitr::opts_chunk$set(echo = TRUE, warning=FALSE)

Translating a species’ current distribution into meaningful conservation metrics in a repeatable and transparent way to inform conservation planning and decision-making remains an outstanding issue in conservation biology. By using a species distribution model (SDM), as well as landscape requirements (e.g., forest cover), we can mask the output of an SDM to only those areas likely to be suitable to estimate the species’ current range (e.g., in [https://cmerow.github.io/maskRangeR/](maskRangeR). From these reduced model outputs, upper bounds of IUCN metrics regarding area of occupancy (AOO) and extent of occurrence (EOO) can be calculated to inform the assessment of a species’ conservation status, in combination with other information [1]. In addition, we can calculate the proportion of a species’ range size that is protected, that is threatened, or that is associated with different land cover types. If past or future model projections or geospatial data on habitat for masking are available, we can also calculate and visualize change in these metrics over time. These change metrics can then inform IUCN red-listing and forward-thinking conservation planning. We provide an example below to calculate these metrics for the olinguito [2] using the changeRangeR package. Beyond single species, we can combine models from multiple species to calculate community-level metrics of conservation interest to learn more about this see our multi-species vignettes (see Biodiversity metrics vignette).

[1] IUCN Standards and Petitions Committee. 2019. Guidelines for Using the IUCN Red List Categories and Criteria. Version 14. Prepared by the Standards and Petitions Committee.
[1] IUCN Standards and Petitions Committee. 2022. Guidelines for Using the IUCN Red List Categories and Criteria. Version 15.1. Prepared by the Standards and Petitions Committee. Available from: http://www.iucnredlist.org/resources/RedListGuidelines

[2] Helgen, K.M., Miguel Pinto, C., Kays, R., Helgen, L.E., Tsuchiya, M. T. N., Quinn, A., Wilson, D.E., Maldonado, J.E. (2013) Taxonomic revision of the olingos (Bassaricyon), with description of a new species, the Olinguito. Zookeys, 324, 1-83. https://doi.org/10.3897/zookeys.324.5827.

Expand Down Expand Up @@ -61,7 +57,7 @@ paste0("area = ", area[1], " km^2")

## EOO Occurrences

IUCN’s EOO is defined as the area contained within the shortest imaginary (continuous) boundary drawn to encompass all the known (current) occurrences of a taxon, excluding vagrant localities. This measure may exclude discontinuities or disjunctions within the overall distribution of a taxon (e.g., large areas of unsuitable habitat, but see AOO below). The EOO is typically measured by drawing a minimum convex polygon (MCP, also called a convex hull) around occurrence localities, but this may include many large areas of obviously unsuitable or unoccupied habitat, making a convex hull around a thresholded SDM more appropriate (cite Jamie’s paper?). It is important to follow the guidelines of the relevant IUCN SSC SG when contributing EOO or AOO measurements to enable consistency across assessments. You can read more about IUCN definitions [here](https://www.iucnredlist.org/resources/categories-and-criteria).
IUCN’s EOO is defined as the area contained within the shortest imaginary (continuous) boundary drawn to encompass all the known (current) occurrences of a taxon, excluding vagrant localities. This measure may exclude discontinuities or disjunctions within the overall distribution of a taxon (e.g., large areas of unsuitable habitat, but see AOO below). The EOO is typically measured by drawing a minimum convex polygon (MCP, also called a convex hull) around occurrence localities, but this may include many large areas of obviously unsuitable or unoccupied habitat, making a convex hull around a thresholded SDM more appropriate. It is important to follow the guidelines of the relevant IUCN SSC SG when contributing EOO or AOO measurements to enable consistency across assessments. You can read more about IUCN definitions [here](https://www.iucnredlist.org/resources/categories-and-criteria).
In changeRangeR, users can calculate IUCN’s EOO via two options 1) MCP/convex hull around occurrence localities, 2) MCP/convex hull area of thresholded (MTP) SDM.

Calculate the extent of occupancy around occurrence localities
Expand Down

0 comments on commit 97f4df7

Please sign in to comment.