input checking for make_flocker_data

standard_mfd_checks(
  obs,
  unit_covs,
  event_covs,
  type,
  n_aug,
  quiet,
  newdata_checks,
  level2_group = NULL,
  level2_covs = NULL
)

Arguments

obs

If type = "single" or type = "twolevel_single", an I x J matrix-like object where closure is assumed across rows and columns are repeated sampling events. If type = "multi", an I x J x K array where rows are sites or species-sites, columns are repeated sampling events, and slices along the third dimension are seasons. Allowable values are 1 (detection), 0 (no detection), and NA (no sampling event). If type = "augmented", an L x J x K array where rows L are sites, columns J are repeat sampling events, and slices K are species. Every supplied species must have at least one detection; never-observed pseudospecies are added through n_aug. Species names may be supplied as names on the third dimension. If omitted, observed species are named `species1`, `species2`, and so on. Names matching `pseudospecies[digits]` are reserved for augmented pseudospecies. The data must be packed so that, for a given unit (site, site-species, site-timestep, site-species-timestep) all realized visits come before any missing visits (NAs are trailing within their rows).

unit_covs

If type = "single" or type = "twolevel_single", a dataframe of covariates for each closure unit that are constant across repeated sampling events within units. For type = "twolevel_single", this must include the factor column named by level2_group. If type = "multi", a list of such dataframes, one per timestep. All dataframes must have identical column names and types, and all dataframes must have I rows. If type = "augmented", a dataframe of covariates for each site that are constant across repeated sampling events within sites (no dependence on species is allowed).

event_covs

If type = "single" or type = "twolevel_single", a named list of I x J matrices, each one corresponding to a covariate that varies across repeated sampling events within closure-units. If type = "multi", a named list of I x J x K arrays, each one corresponding to a covariate that varies across repeated sampling events within closure-units. If type = "augmented", a named list of L x J matrices, each one corresponding to a covariate that varies across repeated sampling events within sites (no dependence on species is allowed).

type

The type of occupancy model desired. Options are: "single" for a single-season model, "multi" for a multi-season (dynamic) model, or "augmented" for a single-season multi-species model with data-augmentation for never-observed pseudospecies, or "twolevel_single" for a two-level single-season model.

n_aug

Number of pseudo-species to augment. Only applicable if type = "augmented".

quiet

Hide progress bars and informational messages?

newdata_checks

If TRUE, turn off checks that must pass in order to use the data for model fitting, but not in other contexts (e.g. making predictions or assessing log-likelihoods over new data).

level2_group

The name of a factor column in unit_covs and, if supplied, level2_covs, identifying the level-two group. Only applicable if type = "twolevel_single".

level2_covs

An optional dataframe with one row per level-two group and no unused levels in its grouping factor. Row order is arbitrary; factor-level order determines the internal group order, and every group must be represented in unit_covs. Only applicable if type = "twolevel_single".