Same as tar_load()
except names
is a character vector.
Do not use in knitr
or R Markdown reports with tarchetypes::tar_knit()
or tarchetypes::tar_render()
.
Usage
tar_load_raw(
names,
branches = NULL,
meta = tar_meta(store = store),
strict = TRUE,
silent = FALSE,
envir = parent.frame(),
store = targets::tar_config_get("store")
)
Arguments
- names
Character vector, names of the targets to load. Names are expected to appear in the metadata in
_targets/meta
. Any target names not in the metadata are ignored.- branches
Integer of indices of the branches to load for any targets that are patterns.
- meta
Data frame of metadata from
tar_meta()
.tar_read()
with the default arguments can be inefficient for large pipelines because all the metadata is stored in a single file. However, if you calltar_meta()
beforehand and supply it to themeta
argument, then successive calls totar_read()
may run much faster.- strict
Logical of length 1, whether to error out if one of the selected targets is in the metadata but cannot be loaded. Set to
FALSE
to just load the targets in the metadata that can be loaded and skip the others.- silent
Logical of length 1. Only relevant when
strict
isFALSE
. Ifsilent
isFALSE
andstrict
isFALSE
, then a message will be printed if a target is in the metadata but cannot be loaded. However, load failures will not stop other targets from being loaded.- envir
Environment to put the loaded targets.
- 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.
Limited scope
tar_read()
and tar_load()
are only for exploratory analysis and literate programming,
and tar_read_raw()
and tar_load_raw()
are only
for exploratory analysis. targets
automatically
loads the correct dependencies into memory when the pipeline
is running, so invoking these functions
from inside a target is rarely advisable.
See also
Other data:
tar_load_everything()
,
tar_load()
,
tar_meta()
,
tar_objects()
,
tar_pid()
,
tar_process()
,
tar_read_raw()
,
tar_read()
Examples
if (identical(Sys.getenv("TAR_EXAMPLES"), "true")) {
tar_dir({ # tar_dir() runs code from a temporary directory.
tar_script({
list(
tar_target(y1, 1 + 1),
tar_target(y2, 1 + 1),
tar_target(z, y1 + y2)
)
}, ask = FALSE)
tar_make()
tar_load_raw(all_of(c("y1", "y2")))
y1
y2
})
}