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).
Bsiland(formula, land, data, family = "gaussian", init = 200, border = F)
Bsiland returns an object of type Bsiland, a list :
a vector of the estimated coefficients
a vector of the estimated buffer radii
an object of class formula that indicates the model
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.
the estimated maximum loglikelihood
the estimated maximum loglikelihood of the local model (no landscape variable)
the fitted values
an object of class optim or optimize giving informations about the optimization procedure see optim()
or optimize()
for further details.
a lm/glm/lmer type object that corresponds to the model estimate knowing the estimated buffer sizes of landscape variables
the akaike information criterion of the model
the akaike information criterion of the local model (no landscape variable)
the number of parameters
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).
the family distribution of the model
the estimated standard error for gaussian family, NA in other case
the type of local model: GLM for generalised model, LMM for linear mixed model or GLMM for generalised linear mixed model
the estimated standard deviations of the random effects for LMM or GLMM
the estimated residuals
a dataframe containing the local variables and the percentages of the landscape variables in buffers of estimated buffer sizes for each observation (in rows).
a logical indicating the value used for estimation
a symbolic description (see lm() or glm()) of the model to be fitted. The details of model specification are given under 'Details'.
an object of class sf containing the landscape variables.
a dataframe containing the response variable and the local variables.
the distribution of response variable. family
can be "gaussian", "poisson" or "binomial" and the associated link function are identity, log and logit respectively.
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.
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)
)
O. Martin and F. Carpentier
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.
Carpentier, F., & Martin, O. (2019). SILand: an R package for estimating the spatial influence of landscape. bioRxiv, 692566.
# \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