DoparParam-class {BiocParallel} | R Documentation

## Enable parallel evaluation using registered dopar backend

### Description

This class is used to dispatch parallel operations to the dopar backend registered with the foreach package.

### Usage

    DoparParam(catch.errors = TRUE, stop.on.error=TRUE)

### Arguments

`catch.errors` | DEPRECATED `logical(1)`

Flag to determine in apply-like functions (see e.g. `bplapply`) whether to quit with an error as soon as one application fails or encapsulation of function calls in `try` blocks which triggers a resume mechanism (see bpresume). Defaults to `TRUE`.

`stop.on.error` | `logical(1)`

Stop all jobs as soon as one jobs fails (`stop.on.error == TRUE`) or wait for all jobs to terminate. Default is `TRUE`.

### Details

`DoparParam` can be used for shared or non-shared memory computing depending on what backend is loaded. The `doSNOW` package supports non-shared memory, `doParallel` supports both shared and non-shared. When not specified, the default number of workers in `DoparParam` is determined by `getDoParWorkers()`. See the `foreach` package vignette for details using the different backends:

http://cran.r-project.org/web/packages/foreach/vignettes/foreach.pdf

### DoparParam constructor

Return a proxy object that dispatches parallel evaluation to the registered foreach parallel backend.

There are no options to the constructor. All configuration should be done through the normal interface to the foreach parallel backends.

### Methods

The following generics are implemented and perform as documented on the corresponding help page (e.g., `?bpisup`): `bpworkers`, `bpnworkers`, `bpstart`, `bpstop`, `bpisup`, `bpbackend`, `bpbackend<-`, `bpvec`.

### Author(s)

Martin Morgan mailto:mtmorgan@fhcrc.org

### See Also

`getClass("BiocParallelParam")` for additional parameter classes.

`register` for registering parameter classes for use in parallel evaluation.

`foreach-package` for the parallel backend infrastructure used by this param class.

### Examples

    ## Not run:
    # First register a parallel backend with foreach
    library(doParallel)
    registerDoParallel(2)

    p <- DoparParam()
    bplapply(1:10, sqrt, BPPARAM=p)
    bpvec(1:10, sqrt, BPPARAM=p)

    register(DoparParam(), default=TRUE)

    ## End(Not run)

[Package BiocParallel version 1.14.2 Index]