| 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 to be evaluated. |
envir |
The environment from where global
objects should be identified. Depending on the future
strategy (the |
substitute |
If TRUE, argument |
lazy |
Specifies whether a future should be resolved lazily or eagerly (default). |
seed |
(optional) A L'Ecuyer-CMRG RNG seed. |
globals |
A logical, a character vector, or a named list for controlling how globals are handled. For details, see below section. |
persistent |
If FALSE, the evaluation environment is cleared from objects prior to the evaluation of the future. |
workers |
The maximum number of multiprocess futures that can be active at the same time before blocking. |
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. |
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)