make_model_object {disaggregation} | R Documentation |
Create the TMB model object for the disaggregation model
Description
make_model_object function takes a disag_data object created by prepare_data
and creates a TMB model object to be used in fitting.
Usage
make_model_object(
data,
priors = NULL,
family = "gaussian",
link = "identity",
field = TRUE,
iid = TRUE,
silent = TRUE
)
Arguments
data |
disag_data object returned by |
priors |
list of prior values |
family |
likelihood function: gaussian, binomial or poisson |
link |
link function: logit, log or identity |
field |
logical. Flag the spatial field on or off |
iid |
logical. Flag the iid effect on or off |
silent |
logical. Suppress verbose output. |
Details
The model definition
The disaggregation model make predictions at the pixel level:
And then aggregates these predictions to the polygon level using the weighted sum (via the aggregation raster, ):
The different likelihood correspond to slightly different models ( is the response count data):
Gaussian: If
is the dispersion of the pixel data,
is the dispersion of the polygon data, where
- predicts incidence rate.
Binomial: For a survey in polygon j,
is the number positive and
is the number tested.
- predicts prevalence rate.
Poisson:
- predicts incidence count.
Specify priors for the regression parameters, field and iid effect as a single named list. Hyperpriors for the field
are given as penalised complexity priors you specify and
for the range of the field
where
, and
and
for the variation of the field
where
. Also, specify pc priors for the iid effect.
The precise names and default values for these priors are:
priormean_intercept: 0
priorsd_intercept: 10.0
priormean_slope: 0.0
priorsd_slope: 0.5
prior_rho_min: A third the length of the diagonal of the bounding box.
prior_rho_prob: 0.1
prior_sigma_max: sd(response/mean(response))
prior_sigma_prob: 0.1
prior_iideffect_sd_max: 0.1
prior_iideffect_sd_prob: 0.01
The family and link arguments are used to specify the likelihood and link function respectively. The likelihood function can be one of gaussian, poisson or binomial. The link function can be one of logit, log or identity. These are specified as strings.
The field and iid effect can be turned on or off via the field and iid logical flags. Both are default TRUE.
The iterations argument specifies the maximum number of iterations the model can run for to find an optimal point.
The silent argument can be used to publish/supress verbose output. Default TRUE.
Value
The TMB model object returned by MakeADFun
.
Examples
## Not run:
polygons <- list()
n_polygon_per_side <- 10
n_polygons <- n_polygon_per_side * n_polygon_per_side
n_pixels_per_side <- n_polygon_per_side * 2
for(i in 1:n_polygons) {
row <- ceiling(i/n_polygon_per_side)
col <- ifelse(i %% n_polygon_per_side != 0, i %% n_polygon_per_side, n_polygon_per_side)
xmin = 2*(col - 1); xmax = 2*col; ymin = 2*(row - 1); ymax = 2*row
polygons[[i]] <- list(cbind(c(xmin, xmax, xmax, xmin, xmin),
c(ymax, ymax, ymin, ymin, ymax)))
}
polys <- lapply(polygons,sf::st_polygon)
N <- floor(runif(n_polygons, min = 1, max = 100))
response_df <- data.frame(area_id = 1:n_polygons, response = runif(n_polygons, min = 0, max = 1000))
spdf <- sf::st_sf(response_df, geometry = polys)
# Create raster stack
r <- terra::rast(ncol=n_pixels_per_side, nrow=n_pixels_per_side)
terra::ext(r) <- terra::ext(spdf)
r[] <- sapply(1:terra::ncell(r), function(x){
rnorm(1, ifelse(x %% n_pixels_per_side != 0, x %% n_pixels_per_side, n_pixels_per_side), 3))}
r2 <- terra::rast(ncol=n_pixels_per_side, nrow=n_pixels_per_side)
terra::ext(r2) <- terra::ext(spdf)
r2[] <- sapply(1:terra::ncell(r), function(x) rnorm(1, ceiling(x/n_pixels_per_side), 3))
cov_stack <- c(r, r2)
names(cov_stack) <- c('layer1', 'layer2')
test_data <- prepare_data(polygon_shapefile = spdf,
covariate_rasters = cov_stack)
result <- make_model_object(test_data)
## End(Not run)