Reconstruct the branch names and the names of their dependencies.
Source:R/tar_branches.R
tar_branches.Rd
Given a branching pattern, use available metadata to reconstruct branch names and the names of each branch's dependencies. The metadata of each target must already exist and be consistent with the metadata of the other targets involved.
Usage
tar_branches(name, pattern, store = targets::tar_config_get("store"))
Arguments
- name
Symbol, name of the target.
- pattern
Language to define branching for a target. For example, in a pipeline with numeric vector targets
x
andy
,tar_target(z, x + y, pattern = map(x, y))
implicitly defines branches ofz
that each computex[1] + y[1]
,x[2] + y[2]
, and so on. See the user manual for details.- store
Character of length 1, path to the
targets
data store. Defaults totar_config_get("store")
, which in turn defaults to_targets/
. When you set this argument, the value oftar_config_get("store")
is temporarily changed for the current function call. Seetar_config_get()
andtar_config_set()
for details about how to set the data store path persistently for a project.
Value
A tibble
with one row per branch and one column for each target
(including the branched-over targets and the target with the pattern.)
Details
The results from this function can help you retroactively figure out correspondences between upstream branches and downstream branches. However, it does not always correctly predict what the names of the branches will be after the next run of the pipeline. Dynamic branching happens while the pipeline is running, so we cannot always know what the names of the branches will be in advance (or even how many there will be).
See also
Other branching:
tar_branch_index()
,
tar_branch_names_raw()
,
tar_branch_names()
,
tar_pattern()
Examples
if (identical(Sys.getenv("TAR_EXAMPLES"), "true")) {
tar_dir({ # tar_dir() runs code from a temporary directory.
tar_script({
list(
tar_target(x, seq_len(2)),
tar_target(y, head(letters, 2)),
tar_target(z, head(LETTERS, 2)),
tar_target(dynamic, c(x, y, z), pattern = cross(z, map(x, y)))
)
}, ask = FALSE)
tar_make()
tar_branches(dynamic, pattern = cross(z, map(x, y)))
})
}