Learn R Programming

⚠️There's a newer version (1.40.0) of this package.Take me there.

future (version 1.3.0)

Unified Parallel and Distributed Processing in R for Everyone

Description

The purpose of this package is to provide a lightweight and unified Future API for sequential and parallel processing of R expression via futures. The simplest way to evaluate an expression in parallel is to use `x %<-% { expression }` with `plan(multiprocess)`. This package implements sequential, multicore, multisession, and cluster futures. With these, R expressions can be evaluated on the local machine, on in parallel a set of local machines, or distributed on a mix of local and remote machines. Extensions to this package implements additional backends for processing futures via compute cluster schedulers etc. Because of its unified API, there is no need to modify code in order switch from sequential on the local machine to, say, distributed processing on a remote compute cluster. Another strength of this package is that global variables and functions are automatically identified and exported as needed, making it straightforward to tweak existing code to make use of futures.

Copy Link

Version

Install

install.packages('future')

Monthly Downloads

266,253

Version

1.3.0

License

LGPL (>= 2.1)

Issues

Pull Requests

Stars

Forks

Maintainer

Henrik Bengtsson

Last Published

February 19th, 2017

Functions in future (1.3.0)

as.cluster

Coerce an object to a cluster object
ConstantFuture-class

A future with a constant value
availableWorkers

Get set of available workers
backtrace

Back trace the expressions evaluated before a condition was caught
cluster

Create a cluster future whose value will be resolved asynchronously in a parallel process
availableCores

Get number of available cores on current machine
Future-class

A future represents a value that will be available at some point in the future
future.options

Options used for futures
future_lapply

Apply a Function over a List or Vector via Futures
ClusterFuture-class

A cluster future is a future whose value will be resolved asynchronously in a parallel process
%globals%

Specify globals for a future assignment
getGlobalsAndPackages

Retrieves global variables of an expression and their associated packages
%label%

Specify label for a future assignment
FutureError

An error occurred while trying to evaluate a future
getExpression

Inject code for the next type of future to use for nested futures
future

Create a future
%lazy%

Control lazy / eager evaluation for a future assignment
%plan%

Use a specific plan for a future assignment
futureOf

Get the future of a future variable
futures

Gets all futures in an object
%tweak%

Temporarily tweaks the arguments of the current strategy
multisession

Create a multisession future whose value will be resolved asynchronously in a parallel R session
nbrOfWorkers

Gets the number of workers available
MultiprocessFuture-class

An multiprocess future is a future whose value will be resolved asynchronously in a parallel process
MulticoreFuture-class

An multicore future is a future whose value will be resolved asynchronously in a parallel process
multicore

Create a multicore future whose value will be resolved asynchronously in a forked parallel process
multiprocess

Create a multiprocess future whose value will be resolved asynchronously using multicore or a multisession evaluation
%seed%

Set random seed for future assignment
mandelbrot

Mandelbrot convergence counts
makeClusterPSOCK

Create a Parallel Socket Cluster
remote

Create a remote future whose value will be resolved asynchronously in a remote process
run.Future

Run a future
requestCore

Request a core for multicore processing
supportsMulticore

Check whether multicore processing is supported or not
resolve

Wait until all existing futures in an environment are resolved
tweak

Tweaks a future function by adjusting its default arguments
plan

Plan how to resolve a future
sequential

Create a sequential future whose value will be in the current R session
resolved

Check whether a future is resolved or not
sessionDetails

Outputs details on the current R session
value.Future

The value of a future
UniprocessFuture-class

An uniprocess future is a future whose value will be resolved synchronously in the current process
usedCores

Get number of cores currently used
values

Gets all values in an object