internal/ann.model.counts: Calculate indices of number of birds caught on CES sites
In btorobrob/cesr: Trend analysis of Constant Effort Site ringing data
ann.model.counts R Documentation
Calculate indices of number of birds caught on CES sites
Description
These functions use glm() to model counts of birds caught as a function of year and CES site. Both site and year are treated as (fixed) factors. Year is usually considered to be annual but a linear trend or comparison with a block of recent previous years is also possible.
Usage
ann.model.counts(x, year=-1, offset=TRUE, cl=0.95)
annc.model.counts(x, compare=1, offset=TRUE, cl=0.95)
annt.model.counts(x, year=-1, trend=100, offset=TRUE, cl=0.95)
annt.model.counts(x, offset=TRUE, cl=0.95)
Arguments
x
A CES data object usually constructed by extract.data()
year
Reference year (i.e. the year when the index equals 1)
offset
Logical, include the correction for missing visits when calculating indices?
cl
Width of confidence limits. 0.95 is default, 0.83 limits don't overlap with (approximate) probability 0.95, so may be useful when comparing values of the index in specific years.
compare
The number of most recent previous years with which to compare the most recent year. For example in 2008 setting compare=5 will set the index value averaged over the years 2003-07 to equal 1, and the 2008 value can then easily be compared to this. Earlier years are modelled as (fixed-effect) annual factors.
trend
The number of most recent years through which to fit a linear trend through the index values; earlier years are modelled as (fixed-effect) annual factors. For example in 2008 setting trend=5 will fit a line through the years 2004-2008; earlier years are modelled as (fixed-effect) annual factors. If the number of years is greater than the number of years for which there are data, then a simple linear trend is fitted.
Details
The basic modelling functions, which will generally be called through the wrapper function index(), since otherwise the 'ces' class may not be set, which may cause these functions to fail or behave unpredictably.
Value
A list containing the following items
model
An lm object containing the model fit
parms
A data frame with the (year) parameter estimates and back-transformed annual indices
test
Details of a significance test for the comparison with previous years or of the linear trend
Author(s)
Rob Robinson
See Also
index, ann.model.prod
Examples
# Should not normally be called directly, use \code{\link{index}}
btorobrob/cesr documentation built on June 9, 2025, 5:39 a.m.
R Package Documentation
Browse R Packages
We want your feedback!
Note that we can't provide technical support on individual packages. You should contact the package authors for that.
| ann.model.counts | R Documentation |
Calculate indices of number of birds caught on CES sites
Description
These functions use glm() to model counts of birds caught as a function of year and CES site. Both site and year are treated as (fixed) factors. Year is usually considered to be annual but a linear trend or comparison with a block of recent previous years is also possible.
Usage
ann.model.counts(x, year=-1, offset=TRUE, cl=0.95)
annc.model.counts(x, compare=1, offset=TRUE, cl=0.95)
annt.model.counts(x, year=-1, trend=100, offset=TRUE, cl=0.95)
annt.model.counts(x, offset=TRUE, cl=0.95)
Arguments
x |
A CES data object usually constructed by extract.data() |
year |
Reference year (i.e. the year when the index equals 1) |
offset |
Logical, include the correction for missing visits when calculating indices? |
cl |
Width of confidence limits. 0.95 is default, 0.83 limits don't overlap with (approximate) probability 0.95, so may be useful when comparing values of the index in specific years. |
compare |
The number of most recent previous years with which to compare the most recent year. For example in 2008 setting compare=5 will set the index value averaged over the years 2003-07 to equal 1, and the 2008 value can then easily be compared to this. Earlier years are modelled as (fixed-effect) annual factors. |
trend |
The number of most recent years through which to fit a linear trend through the index values; earlier years are modelled as (fixed-effect) annual factors. For example in 2008 setting trend=5 will fit a line through the years 2004-2008; earlier years are modelled as (fixed-effect) annual factors. If the number of years is greater than the number of years for which there are data, then a simple linear trend is fitted. |
Details
The basic modelling functions, which will generally be called through the wrapper function index(), since otherwise the 'ces' class may not be set, which may cause these functions to fail or behave unpredictably.
Value
A list containing the following items
model |
An lm object containing the model fit |
parms |
A data frame with the (year) parameter estimates and back-transformed annual indices |
test |
Details of a significance test for the comparison with previous years or of the linear trend |
Author(s)
Rob Robinson
See Also
index, ann.model.prod
Examples
# Should not normally be called directly, use \code{\link{index}}
R Package Documentation
Browse R Packages
We want your feedback!
Note that we can't provide technical support on individual packages. You should contact the package authors for that.
Embedding an R snippet on your website
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.