diff --git a/DESCRIPTION b/DESCRIPTION
index 035ef58..1500851 100644
--- a/DESCRIPTION
+++ b/DESCRIPTION
@@ -16,7 +16,7 @@ Description: A simple way of fitting detection functions to distance sampling
Horvitz-Thompson-like estimator) if survey area information is provided. See
Miller et al. (2019) for more information on
methods and for example analyses.
-Version: 2.0.0.9005
+Version: 2.0.0.9006
URL: https://github.com/DistanceDevelopment/Distance/
BugReports: https://github.com/DistanceDevelopment/Distance/issues
Language: en-GB
diff --git a/docs/articles/covariates-distill.html b/docs/articles/covariates-distill.html
index 4a4e7ec..2da502d 100644
--- a/docs/articles/covariates-distill.html
+++ b/docs/articles/covariates-distill.html
@@ -1,12 +1,18 @@
-
+
Incorporating covariates in the detection function • Distance
-
+
diff --git a/docs/articles/covariates-distill_files/figure-html/basic-1.png b/docs/articles/covariates-distill_files/figure-html/basic-1.png
index 0dabd4e..a37b35e 100644
Binary files a/docs/articles/covariates-distill_files/figure-html/basic-1.png and b/docs/articles/covariates-distill_files/figure-html/basic-1.png differ
diff --git a/docs/articles/covariates-distill_files/figure-html/bestmod-1.png b/docs/articles/covariates-distill_files/figure-html/bestmod-1.png
index c876694..fc98004 100644
Binary files a/docs/articles/covariates-distill_files/figure-html/bestmod-1.png and b/docs/articles/covariates-distill_files/figure-html/bestmod-1.png differ
diff --git a/docs/articles/covariates-distill_files/figure-html/box-1.png b/docs/articles/covariates-distill_files/figure-html/box-1.png
index 30a286d..aadb810 100644
Binary files a/docs/articles/covariates-distill_files/figure-html/box-1.png and b/docs/articles/covariates-distill_files/figure-html/box-1.png differ
diff --git a/docs/articles/lines-distill.html b/docs/articles/lines-distill.html
index fe5c8d0..4616dbc 100644
--- a/docs/articles/lines-distill.html
+++ b/docs/articles/lines-distill.html
@@ -32,7 +32,7 @@
Distance
- 2.0.0.9004
+ 2.0.0.9005
-
+
Figure 1: Montrave study area; diagonal lines indicate line transects walked to generate these data.
@@ -352,8 +352,6 @@
Model comparison tables
knitr::kable(summarize_ds_models(wren.hn, wren.hr.poly, wren.unif.cos),digits=3, caption="Model comparison table for wren line transect data, Montrave.")
-
## Warning: Passing models via ... will be depricated in the next release, please
-## pass models in a list using the models argument.
Table 1: Model comparison table for wren line transect data, Montrave.
The AIC model selection tools suggest the hazard rate key function is the preferred model. However, examine the shape of the hazard rate detection function in contrast to the uniform cosine fitted detection function (Figure 5).
diff --git a/docs/articles/species-covariate-distill.html b/docs/articles/species-covariate-distill.html
index 1f25cdc..96daa8d 100644
--- a/docs/articles/species-covariate-distill.html
+++ b/docs/articles/species-covariate-distill.html
@@ -1,12 +1,18 @@
-
+
Covariate modeling with rare species • Distance
-
+
@@ -89,7 +95,7 @@
Eric Rexstad
Background
Sometimes the focal species of a distance sampling survey is quite rare. So rare that it is difficult to accumulate sufficient detections to fit a detection function for the species in question. Likewise, it is also common for other species to be detected during the survey for the focal species. Could the detections of the other species be useful in estimating a detection function for the focal species?
-
One approach might be to consider the species to serve as “strata” and proceed to analyse the data as if they were from a stratified survey. See the example for stratified survey analysis. However, if a pooled detection function (one that combines data from multiple species) is fitted, it would be dubious to apply this pooled detection function to data at a lower level of aggregation (species level). Applying the pooled detection function would lead to a biased estimate of abundance for the rare species.
+
One approach might be to consider the species to serve as “strata” and proceed to analyse the data as if they were from a stratified survey. See the example for stratified survey analysis. However, if a pooled detection function (one that combines data from multiple species) is fitted, it would be dubious to apply this pooled detection function to data at a lower level of aggregation (species level). Applying the pooled detection function would lead to a biased estimate of abundance for the rare species.
Instead of treating species as strata, an alternative form of analysis is to treat species as a covariate in the modelling of the detection function (Marques & Buckland, 2003). The principle is that the general key function is shared across species, but the scale parameter \((\sigma)\) differs between species. In this way, the detections of all species is shared, such that the estimation of the detection function for the rare species is bolstered by information from other species; yet the rare species receives its own unique detection function such that bias is not induced in the abundance estimation for that species.
To demonstrate such an analysis, the Montrave songbird study conducted by Buckland (2006) is used. The species covariate approach to analysis of the snapshot point count version of his survey is described in the book by Buckland et al. (2015, sec. 5.3.2.2). The Distance R package (Miller, Rexstad, Thomas, Marshall, & Laake, 2019) is used to analyse the line transect survey Buckland conducted. Results are compared with estimates presented by Buckland (2006).
The data are available online at a website that serves as a companion to Buckland et al. (2015). The data set can be read into R directly from the URL.
Survey design1). Elevation of these pastures was ~2500m. We will not deal with pasture-level analysis of these data in this vignette and will alter the data to remove the strata designations.
-
+
Figure 1: Summer grazed pastures along Illinois River Arapaho National Wildlife Refuge, Colorado. Figure from (Knopf et al., 1988).
@@ -291,6 +297,9 @@
Specifying different detection
transect="point", convert_units=conversion.factor, truncation="5%")
## Warning in ddf.ds(dsmodel = dsmodel, data = data, meta.data = meta.data, :## Estimated hazard-rate scale parameter close to 0 (on log scale). Possible
+## problem in data (e.g., spike near zero distance).
+## Warning in ddf.ds(dsmodel = dsmodel, data = data, meta.data = meta.data, :
+## Estimated hazard-rate scale parameter close to 0 (on log scale). Possible## problem in data (e.g., spike near zero distance).
diff --git a/docs/articles/web-only/points/pointtransects-distill_files/figure-html/basichist-1.png b/docs/articles/web-only/points/pointtransects-distill_files/figure-html/basichist-1.png
index 2ee2d1d..2aa5c6a 100644
Binary files a/docs/articles/web-only/points/pointtransects-distill_files/figure-html/basichist-1.png and b/docs/articles/web-only/points/pointtransects-distill_files/figure-html/basichist-1.png differ
diff --git a/docs/articles/web-only/points/pointtransects-distill_files/figure-html/gof-1.png b/docs/articles/web-only/points/pointtransects-distill_files/figure-html/gof-1.png
index 013f839..56e6ca5 100644
Binary files a/docs/articles/web-only/points/pointtransects-distill_files/figure-html/gof-1.png and b/docs/articles/web-only/points/pointtransects-distill_files/figure-html/gof-1.png differ
diff --git a/docs/articles/web-only/points/pointtransects-distill_files/figure-html/modelfit-1.png b/docs/articles/web-only/points/pointtransects-distill_files/figure-html/modelfit-1.png
index 35023e4..96107a3 100644
Binary files a/docs/articles/web-only/points/pointtransects-distill_files/figure-html/modelfit-1.png and b/docs/articles/web-only/points/pointtransects-distill_files/figure-html/modelfit-1.png differ
diff --git a/docs/articles/web-only/strata/strata-distill.html b/docs/articles/web-only/strata/strata-distill.html
index 0c423a8..ddd3fcc 100644
--- a/docs/articles/web-only/strata/strata-distill.html
+++ b/docs/articles/web-only/strata/strata-distill.html
@@ -1,12 +1,18 @@
-
+
Analysis of stratified survey designs • Distance
-
+
@@ -101,8 +107,8 @@
Survey design1). Elevation of these pastures was ~2500m. In this example, we will perform pasture-level analysis of these data.
-
+
Figure 1: Summer grazed pastures along Illinois River Arapaho National Wildlife Refuge, Colorado.
Figure from (Knopf et al., 1988).
diff --git a/docs/articles/web-only/strata/strata-distill_files/figure-html/threeplot-1.png b/docs/articles/web-only/strata/strata-distill_files/figure-html/threeplot-1.png
index 0b1d208..8929a49 100644
Binary files a/docs/articles/web-only/strata/strata-distill_files/figure-html/threeplot-1.png and b/docs/articles/web-only/strata/strata-distill_files/figure-html/threeplot-1.png differ
diff --git a/vignettes/lines-distill.Rmd b/vignettes/lines-distill.Rmd
index 3958d9c..aa574a8 100644
--- a/vignettes/lines-distill.Rmd
+++ b/vignettes/lines-distill.Rmd
@@ -41,7 +41,7 @@ In this exercise, we use `R` [@r_core_team_r_2019] and the `Distance` package [@
Nineteen line transects were walked twice (Figure \@ref(fig:fig)).
```{r fig, echo=FALSE, fig.cap="Montrave study area; diagonal lines indicate line transects walked to generate these data.", outwidth='100%', eval=TRUE}
-knitr::include_graphics("montrave.JPG")
+knitr::include_graphics("montrave.jpg")
```
The fields of the `wren_lt` data set are:
diff --git a/vignettes/species-covariate-distill.Rmd b/vignettes/species-covariate-distill.Rmd
index 5c938a7..76162e5 100644
--- a/vignettes/species-covariate-distill.Rmd
+++ b/vignettes/species-covariate-distill.Rmd
@@ -34,7 +34,7 @@ options(kableExtra.html.bsTable = TRUE)
Sometimes the focal species of a distance sampling survey is quite rare. So rare that it is difficult to accumulate sufficient detections to fit a detection function for the species in question. Likewise, it is also common for other species to be detected during the survey for the focal species. Could the detections of the other species be useful in estimating a detection function for the focal species?
-One approach might be to consider the species to serve as "strata" and proceed to analyse the data as if they were from a stratified survey. See the [example for stratified survey analysis](http://distancesampling.org/Distance/web-only/strata/strata-distill.html). However, if a pooled detection function (one that combines data from multiple species) is fitted, it would be dubious to apply this pooled detection function to data at a lower level of aggregation (species level). Applying the pooled detection function would lead to a biased estimate of abundance for the rare species.
+One approach might be to consider the species to serve as "strata" and proceed to analyse the data as if they were from a stratified survey. See the [example for stratified survey analysis](https://distancesampling.org/Distance/articles/web-only/strata/strata-distill.html). However, if a pooled detection function (one that combines data from multiple species) is fitted, it would be dubious to apply this pooled detection function to data at a lower level of aggregation (species level). Applying the pooled detection function would lead to a biased estimate of abundance for the rare species.
Instead of treating species as strata, an alternative form of analysis is to treat species as a covariate in the modelling of the detection function [@FMARBUC03]. The principle is that the general key function is shared across species, but the scale parameter $(\sigma)$ differs between species. In this way, the detections of all species is shared, such that the estimation of the detection function for the rare species is bolstered by information from other species; yet the rare species receives its own *unique* detection function such that bias is not induced in the abundance estimation for that species.
diff --git a/vignettes/web-only/points/pointtransects-distill.Rmd b/vignettes/web-only/points/pointtransects-distill.Rmd
index 2c2ba9c..01e9ce0 100644
--- a/vignettes/web-only/points/pointtransects-distill.Rmd
+++ b/vignettes/web-only/points/pointtransects-distill.Rmd
@@ -43,7 +43,7 @@ Steps in this analysis are similar to the steps taken in the [line transect anal
A total of 373 point transects were placed in three pastures in the Arapaho National Wildlife Refuge in Colorado (Figure \@ref(fig:fig)). Elevation of these pastures was ~2500m. We will not deal with pasture-level analysis of these data in this vignette and will alter the data to remove the strata designations.
```{r fig, echo=FALSE, fig.dim=c(7,5), fig.cap="Summer grazed pastures along Illinois River Arapaho National Wildlife Refuge, Colorado. Figure from [@knopf_guild_1988]."}
-knitr::include_graphics("arapaho.JPG")
+knitr::include_graphics("arapaho.jpg")
```