future (version 1.0.1)

remote: Create a remote future whose value will be resolved asynchroneously in a remote process

Description

A remote future is a future that uses remote cluster evaluation, which means that its value is computed and resolved remotely in another process.

Usage

remote(expr, envir = parent.frame(), substitute = TRUE, persistent = TRUE, workers = NULL, gc = FALSE, earlySignal = FALSE, myip = NULL, ...)

Arguments

expr

An R expression.

envir

The environment in which the evaluation is done and from which globals are obtained.

substitute

If TRUE, argument expr is substitute():ed, otherwise not.

persistent

If FALSE, the evaluation environment is cleared from objects prior to the evaluation of the future.

workers

A cluster object created by makeCluster().

gc

If TRUE, the garbage collector run after the future is resolved (in the process that evaluated the future).

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).

...

Not used.

Value

A ClusterFuture.

Details

Note that remote futures use persistent=TRUE by default.

Examples

## 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)