varcount

0th

Percentile

Predicted Variance of the Number of Points

Given a fitted point process model, calculate the predicted variance of the number of points in a nominated set B.

Keywords
models, spatial
Usage
varcount(model, B, …, dimyx = NULL)
Arguments
model

A fitted point process model (object of class "ppm", "kppm" or "dppm").

B

A window (object of class "owin" specifying the region in which the points are counted. Alternatively a pixel image (object of class "im") or a function of spatial coordinates specifying a numerical weight for each random point.

Additional arguments passed to B when it is a function.

dimyx

Spatial resolution for the calculations. Argument passed to as.mask.

Details

This command calculates the variance of the number of points falling in a specified window B according to the model. It can also calculate the variance of a sum of weights attached to each random point.

The model should be a fitted point process model (object of class "ppm", "kppm" or "dppm").

  • If B is a window, this command calculates the variance of the number of points falling in B, according to the fitted model.

    If the model depends on spatial covariates other than the Cartesian coordinates, then B should be a subset of the domain in which these covariates are defined.

  • If B is a pixel image, this command calculates the variance of \(T = \sum_i B(x_i)\), the sum of the values of B over all random points falling in the domain of the image.

    If the model depends on spatial covariates other than the Cartesian coordinates, then the domain of the pixel image, as.owin(B), should be a subset of the domain in which these covariates are defined.

  • If B is a function(x,y) or function(x,y,...) this command calculates the variance of \(T = \sum_i B(x_i)\), the sum of the values of B over all random points falling inside the window W=as.owin(model), the window in which the original data were observed.

The variance calculation involves the intensity and the pair correlation function of the model. The calculation is exact (up to discretisation error) for models of class "kppm" and "dppm", and for Poisson point process models of class "ppm". For Gibbs point process models of class "ppm" the calculation depends on the Poisson-saddlepoint approximations to the intensity and pair correlation function, which are rough approximations. The approximation is not yet implemented for some Gibbs models.

Value

A single number.

See Also

predict.ppm, predict.kppm, predict.dppm

Aliases
  • varcount
Examples
# NOT RUN {
   fitT <- kppm(redwood ~ 1, "Thomas")
   B <- owin(c(0, 0.5), c(-0.5, 0))
   varcount(fitT, B)

   fitS <- ppm(swedishpines ~ 1, Strauss(9))
   BS <- square(50)
   varcount(fitS, BS)
# }
Documentation reproduced from package spatstat, version 1.55-1, License: GPL (>= 2)

Community examples

Looks like there are no examples yet.