coverage_roots: Evaluate contextual root coverage

View source: R/coverage_roots.R

coverage_rootsR Documentation

Evaluate contextual root coverage

Description

Evaluates whether observational aggregation units are included in a set of contextual roots.

Usage

coverage_roots(provenance, roots)

Arguments

provenance

Output from observe_universe().

roots

Character vector of contextual roots or a context object.

Details

The function operates on observational universes created by observe_universe() and performs scale-aware matching between:

  • observational aggregation units;

  • contextual roots.

Matching is performed using:

  • normalized filesystem paths;

  • aggregation depth.

Contextual roots and observational units are therefore only matched within the same aggregation depth.

The function does not compute coverage summaries or percentages. It only classifies observational units as included or excluded relative to contextual roots.

Value

A tibble containing observational aggregation units with contextual inclusion status.


fscontext documentation built on Nov. 19, 2026, 5:11 p.m.