Create the future argument of tar_resources() to specify optional high-performance computing settings for tar_make_future(). This is how to supply the resources argument of future::future() for targets. Resources supplied through future::plan() and future::tweak() are completely ignored. For details, see the documentation of the future R package and the corresponding argument names in this help file.

tar_resources_future(plan = NULL, resources = list())

Arguments

plan

A future::plan() object or NULL, a target-specific future plan.

resources

Named list, resources argument to future::future(). This argument is not supported in some versions of future. For versions of future where resources is not supported, instead supply resources to future::tweak() and assign the returned plan to the plan argument of tar_resources_future().

Value

Object of class "tar_resources_future", to be supplied to the future argument of tar_resources().

Resources

Functions tar_target() and tar_option_set() each takes an optional resources argument to supply non-default settings of various optional backends for data storage and high-performance computing. The tar_resources() function is a helper to supply those settings in the correct manner. Resources are all-or-nothing: if you specify any resources with tar_target(), all the resources from tar_option_get("resources") are dropped for that target. In other words, if you write tar_option_set(resources = resources_1) and then tar_target(x, my_command(), resources = resources_2), then everything in resources_1 is discarded for target x.

See also

Examples

# Somewhere in you target script file (usually _targets.R): tar_target( name, command(), resources = tar_resources( future = tar_resources_future(resources = list(n_cores = 2)) ) )
#> <tar_stem> #> name: name #> command: #> command() #> format: rds #> iteration method: vector #> error mode: stop #> memory mode: persistent #> storage mode: main #> retrieval mode: main #> deployment mode: worker #> priority: 0 #> resources: #> future: <environment> #> cue: #> mode: thorough #> command: TRUE #> depend: TRUE #> format: TRUE #> iteration: TRUE #> file: TRUE #> packages: #> targets #> stats #> graphics #> grDevices #> utils #> datasets #> methods #> base #> library: #> NULL