Rdistance (version 4.1.1)

ESW: Effective Strip Width (ESW) for line transects

Description

Returns effective strip width (ESW) for line-transect detection functions. See EDR is for point transects.

Usage

ESW(object, newdata = NULL)

Value

If newdata is present, the returned value is a vector of effective sampling distances associated with covariate values in newdata. Length of return in this case is the number of rows in newdata. If newdata is NULL, the returned value is a vector of effective sampling distances associated with covariate values in object. Length of return in this case is the number of detected groups. The returned vector has measurement units, i.e., object$outputUnits.

Arguments

object

An Rdistance model frame or fitted distance function, normally produced by a call to dfuncEstim.

newdata

A data frame containing new values for covariates at which either ESW's or EDR's will be computed. If NULL and object contains covariates, the covariates stored in object are used (like predict.lm). If not NULL, covariate values in newdata are used. See Value section for more information.

Details

ESW is area under a scaled distance function between its left-truncation limit (obj$w.lo) and its right-truncation limit (obj$w.hi).

If detection does not decline with distance, the detection function is flat (horizontal), and area under the detection function is \(g(0)(w.hi - w.lo)\). If, in this case, \(g(0) = 1\), effective sampling distance is the half-width of the surveys, \((w.hi - w.lo)\)

See Also

dfuncEstim, EDR, effectiveDistance

Examples

data(sparrowDfuncObserver)

ESW(sparrowDfuncObserver) # vector length 356 = number of groups
ESW(sparrowDfuncObserver, newdata = data.frame(observer = 
   c("obs2", "obs4"))) # vector length 2