Summarize feature coverage without imposing an analysis policy

Usage

validity_coverage(x, name = NULL, domain = c("entity", "observation"))

Arguments

x: An fmri_frame or view.
name: Validity relation name.
domain: Weight unique entities or frame observations.

Value

Named fraction-valid vector over frame features.

Examples

space <- index_space(4, ids = paste0("f", 1:4), namespace = "validity-ex")
subjects <- entity_frame(
  data.frame(subject_id = c("sub-1", "sub-2")),
  key = "subject_id"
)
validity <- entity_feature_validity(
  entity = "subject", entity_ids = c("sub-1", "sub-2"),
  masks = rbind(
    c(TRUE, TRUE, FALSE, TRUE),
    c(TRUE, FALSE, FALSE, TRUE)
  ),
  space = space
)
frame <- fmri_frame(
  assays = list(signal = matrix(1:8, nrow = 2)),
  observations = data.frame(.obs_id = c("o1", "o2"), subject_id = c("sub-1", "sub-2")),
  space = space,
  entities = list(subject = subjects),
  relations = list(
    observation_subject = key_relation("subject_id"),
    subject_feature_validity = validity
  )
)
validity_coverage(frame)
#>  f1  f2  f3  f4 
#> 1.0 0.5 0.0 1.0