R: Create a remote future whose value will be resolved...

remote {future} | R Documentation

## Create a remote future whose value will be resolved asynchronously 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, lazy = FALSE,
      seed = NULL, globals = TRUE, persistent = TRUE, workers = NULL,
      user = NULL, revtunnel = TRUE, gc = FALSE, earlySignal = FALSE,
      myip = NULL, label = NULL, ...)

### Arguments

`expr` | An R expression.
`envir` | The environment from where global objects should be identified.
`substitute` | If TRUE, argument `expr` is `substitute()`:ed, otherwise not.
`lazy` | If `FALSE` (default), the future is resolved eagerly (starting immediately), otherwise not.
`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 `future()`.
`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".

### Details

Note that remote futures use `persistent = TRUE` by default.

### Value

A ClusterFuture.

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

[Package future version 1.9.0 Index]