Learn R Programming

siland (version 2.0.5)

Bsiland: Estimation of landscape influence using Bsiland method (Buffers)

Description

Function estimating landscape effect (and eventual local effects) using Bsiland method, i.e. estimating simultaneously : the buffer size (radius) and the effect of each landscape variable (and the effect of each local variable).

Usage

Bsiland(formula, land, data, family = "gaussian", init = 200, border = F)

Value

Bsiland returns an object of type Bsiland, a list :

coefficients

a vector of the estimated coefficients

parambuffer

a vector of the estimated buffer radii

formula

an object of class formula that indicates the model

buffer

a dataframe indicating the percentages of landscape variables in buffer of estimated sizes centered on observations. The landscape variables are in columns, the observations in rows.

loglik

the estimated maximum loglikelihood

loglik0

the estimated maximum loglikelihood of the local model (no landscape variable)

fitted

the fitted values

resoptim

an object of class optim or optimize giving informations about the optimization procedure see optim() or optimize() for further details.

result

a lm/glm/lmer type object that corresponds to the model estimate knowing the estimated buffer sizes of landscape variables

AIC

the akaike information criterion of the model

AIC0

the akaike information criterion of the local model (no landscape variable)

nparam

the number of parameters

pval0

the p.value of the test of the landscape effect (the global effect of all spatial variables). Issued from the likelihood ratio test of the (complete) model vs the local model (complete model without landscape variables).

family

the family distribution of the model

sd.error

the estimated standard error for gaussian family, NA in other case

model.Type

the type of local model: GLM for generalised model, LMM for linear mixed model or GLMM for generalised linear mixed model

rand.StdDev

the estimated standard deviations of the random effects for LMM or GLMM

err

the estimated residuals

newdata

a dataframe containing the local variables and the percentages of the landscape variables in buffers of estimated buffer sizes for each observation (in rows).

border

a logical indicating the value used for estimation

Arguments

formula

a symbolic description (see lm() or glm()) of the model to be fitted. The details of model specification are given under 'Details'.

land

an object of class sf containing the landscape variables.

data

a dataframe containing the response variable and the local variables.

family

the distribution of response variable. family can be "gaussian", "poisson" or "binomial" and the associated link function are identity, log and logit respectively.

init

a vector indicating the starting values for buffer sizes in the estimation procedure. By default, starting values of buffer sizes of all landscape variable are equal to 200.

border

a logical indicating wether buffers are computed from the observation locations ( border=FALSE) or from the border of the polygon where observations are located ( border=TRUE))

Author

O. Martin and F. Carpentier

Details

The Bsiland method is based on the model: $$ E(Y_i)= \mu + \sum_l \alpha_l x_{l,i}+ \sum_k \beta_k p^k_{\delta_k,i}$$ with

  • Y_i, response variable,

  • x_l,i, local variable l,

  • \(p^k_{\delta_k,i}\), the percentage of the landscape variable k in a buffer of radius \(\delta_k\), centered on site i

  • \(\mu\), the intercept

  • \(\alpha_l\) and \(\beta_k\), the effects of local and landscape variables, respectively.

All parameters, \(\mu\), \( {\alpha_1,\dots,\alpha_L}\), \( {\beta_1,\dots,\beta_K}\) but also \( {\delta_1,\dots,\delta_K}\) radii of the buffers of the landscape variables are simultaneously estimated by likelihood maximization.

Models for Bsiland have the form response ~ terms where response is the columns name of the response variable in data and terms is a series of terms which specifies the names of landscape and local explanatory variables. The explanatory variables described in data are considered as local in the model, those described in the sf object land are considered as landscape variables.

For local variables, random effects can be considered using the syntax (1|x) similar to package lme4 (see lmer() function in package lme4).

The explanatory variables are added using the symbol "+". Interaction terms can be considered using the usual symbols "*" or ":". Notice that only interactions between local x local and local x landscape variables are considered.

References

Carpentier, F., & Martin, O. (2019). SILand: an R package for estimating the spatial influence of landscape. bioRxiv, 692566.

Examples

Run this code
# \donttest{
data(dataSiland)
data(landSiland)
resB=Bsiland(obs~x1+L1+L2,land=landSiland,data=dataSiland,init = c(50))
resB
summary(resB)

# }

Run the code above in your browser using DataLab