Package 'future.callr'

Title: A Future API for Parallel Processing using 'callr'
Description: Implementation of the Future API on top of the 'callr' package. This allows you to process futures, as defined by the 'future' package, in parallel out of the box, on your local (Linux, macOS, Windows, ...) machine. Contrary to backends relying on the 'parallel' package (e.g. 'future::multisession') and socket connections, the 'callr' backend provided here can run more than 125 parallel R processes.
Authors: Henrik Bengtsson [aut, cre, cph]
Maintainer: Henrik Bengtsson <[email protected]>
License: LGPL (>= 2.1)
Version: 0.8.2
Built: 2023-09-08 07:39:56 UTC
Source: https://github.com/HenrikBengtsson/future.callr

Help Index


callr futures

Description

A callr future is an asynchronous multiprocess future that will be evaluated in a background R session.

Usage

callr(
  expr,
  envir = parent.frame(),
  substitute = TRUE,
  globals = TRUE,
  label = NULL,
  workers = availableCores(),
  ...
)

Arguments

expr

The R expression to be evaluated.

envir

The environment in which global environment should be located.

substitute

Controls whether expr should be substitute():d or not.

globals

(optional) a logical, a character vector, a named list, or a globals::Globals object. If TRUE, globals are identified by code inspection based on expr and tweak searching from environment envir. If FALSE, no globals are used. If a character vector, then globals are identified by lookup based their names globals searching from environment envir. If a named list or a Globals object, the globals are used as is.

label

(optional) Label of the future.

workers

The number of processes to be available for concurrent callr futures.

...

Additional arguments passed to CallrFuture().

Details

callr futures rely on the callr package, which is supported on all operating systems.

Value

An object of class CallrFuture.


future.callr: A Future for callr

Description

The future.callr package implements the Future API on top of callr. The Future API is defined by the future package.

Details

To use callr futures, load future.callr, and select the type of future you wish to use, e.g. plan(callr).

Examples

plan(callr)
demo("mandelbrot", package = "future", ask = FALSE)