
Which export files a one-group run needs from the groups downstream of it
Source:R/lnk_downstream.R
lnk_downstream_files.RdA group's access is classified by walking downstream through the barriers and barrier overrides that every other group persisted. On a machine that holds only some groups, those rows come from the habitat export: this lists, for a target group, every group whose rows its walk can read (the export's dependency map, which errs wide) and the per-group parts holding them.
Usage
lnk_downstream_files(
manifest,
wsg,
config,
cache_dir = tools::R_user_dir("link", "cache")
)Value
A data frame, one row per dependency and table (one row for a
dependency with nothing to fetch): target, config, wsg, class,
reason, table, key, href, rows, bytes, md5, version_id
(the S3 version a publish recorded, fetched as named; NA before it),
run_id, config_hash, link_version, link_sha, fwa_url.
Details
Each dependency is one of:
exported: itsbarriersandbarrier_overridesparts are listed, with the build they came from;skipped: the export asked for it and had no finished build of the config; its rows are not available, andlnk_downstream_load()refuses unless told to go on without them;not_held: the export took every group its schemas held and this one was not among them, so the provincial walk read no rows of it either;not_exported: the export named its groups and left this one out.
The target's own rows are not listed: its run writes them. fwa_url names
the dependency's FWA stream object, which a machine needs loaded for the
downstream check (lnk_wsg_downstream_check()) and for the target's own
gradient search, which runs along whole lines.
See also
Other export:
lnk_catalog(),
lnk_db_load(),
lnk_downstream_load(),
lnk_scenario_export()
Examples
if (FALSE) { # \dontrun{
f <- lnk_downstream_files("s3://fresh-bc/habitat/fwa/v1/manifest.json",
wsg = "PARS", config = "default")
f[, c("wsg", "class", "table", "rows")]
} # }