remote {future} | R Documentation |
A remote future is a future that uses remote cluster evaluation, which means that its value is computed and resolved remotely in another process.
remote(expr, envir = parent.frame(), substitute = TRUE, lazy = FALSE, seed = NULL, globals = TRUE, persistent = TRUE, workers = NULL, user = NULL, revtunnel = TRUE, gc = FALSE, earlySignal = FALSE, myip = NULL, label = NULL, ...)
expr |
An R expression. |
envir |
The environment from where global objects should be identified. |
substitute |
If TRUE, argument |
lazy |
If |
seed |
(optional) A L'Ecuyer-CMRG RNG seed. |
globals |
(optional) a logical, a character vector, or a named list
to control how globals are handled.
For details, see section 'Globals used by future expressions'
in the help for |
persistent |
If FALSE, the evaluation environment is cleared from objects prior to the evaluation of the future. |
workers |
A positive numeric scalar or a function specifying the maximum number of parallel futures that can be active at the same time before blocking. If a function, it is called without arguments when the future is created and its value is used to configure the workers. The function should return a numeric scalar. |
user |
(optional) The user name to be used when communicating with another host. |
revtunnel |
If TRUE, reverse SSH tunneling is used for the PSOCK cluster nodes to connect back to the master R process. This avoids the hassle of firewalls, port forwarding and having to know the internal / public IP address of the master R session. |
gc |
If TRUE, the garbage collector run (in the process that evaluated the future) after the value of the future is collected. Some types of futures ignore this argument. |
earlySignal |
Specified whether conditions should be signaled as soon as possible or not. |
myip |
The external IP address of this machine. If NULL, then it is inferred using an online service (default). |
label |
An optional character string label attached to the future. |
... |
Additional arguments passed to the "evaluator". |
Note that remote futures use persistent = TRUE
by default.
## Not run: \donttest{ ## Use a remote machine plan(remote, workers = "remote.server.org") ## Evaluate expression remotely host %<-% { Sys.info()[["nodename"]] } host [1] "remote.server.org" } ## End(Not run)