1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
|
#' Options used for batchtools futures
#'
#' Below are the \R options and environment variables that are used by the
#' \pkg{future.batchtools} package.
#' See [future::future.options] for additional ones that apply to futures
#' in general.\cr
#' \cr
#' _WARNING: Note that the names and the default values of these options may change in future versions of the package. Please use with care until further notice._
#'
#' @section Settings for batchtools futures:
#' \describe{
#' \item{\option{future.batchtools.workers}:}{(a positive numeric or `+Inf`)
#' The default number of workers available on HPC schedulers with
#' job queues. If not set, the value of the
#' \env{R_FUTURE_BATCHTOOLS_WORKERS} environment variable is used.
#' (Default: `100`)}
#'
#' \item{\option{future.batchtools.output}:}{(logical)
#' If TRUE, \pkg{batchtools} will produce extra output.
#' If FALSE, such output will be disabled by setting \pkg{batchtools}
#' options \option{batchtools.verbose} and \option{batchtools.progress}
#' to FALSE.
#' (Default: `getOption("future.debug", FALSE)`)}
#'
#' \item{\option{future.batchtools.expiration.tail}:}{(a positive numeric)
#' When a \pkg{batchtools} job expires, the last few lines will be
#' relayed by batchtools futures to help troubleshooting.
#' This option controls how many lines are displayed.
#' (Default: `48L`)}
#'
#' \item{\option{future.cache.path} / \env{R_FUTURE_CACHE_PATH}:}{
#' (character string)
#' An absolute or relative path specifying the root folder in which
#' \pkg{batchtools} registry folders are stored.
#' This folder needs to be accessible from all hosts ("workers").
#' Specifically, it must _not_ be a folder that is only local to the
#' machine such as `file.path(tempdir(), ".future"` if an job scheduler
#' on a HPC environment is used.
#' (Default: `.future` in the current working directory)}
#'
#' \item{\option{future.delete}:}{(logical)
#' Controls whether or not the future's \pkg{batchtools} registry folder
#' is deleted after the future result has been collected.
#' If TRUE, it is always deleted.
#' If FALSE, it is never deleted.
#' If not set or NULL, the it is deleted, unless running in non-interactive
#' mode and the batchtools job failed or expired, which helps to
#' troubleshoot when running in batch mode.
#' (Default: NULL (not set))}
#' }
#'
#' @examples
#' # Set an R option:
#' options(future.cache.path = "/cluster-wide/folder/.future")
#'
#' # Set an environment variable:
#' Sys.setenv(R_FUTURE_CACHE_PATH = "/cluster-wide/folder/.future")
#'
#' @aliases
#' future.cache.path
#' future.delete
#' future.batchtools.expiration.tail
#' future.batchtools.output
#' future.batchtools.workers
#' R_FUTURE_BATCHTOOLS_WORKERS
#' R_FUTURE_FUTURE_CACHE_PATH
#'
#' @keywords internal
#' @name future.batchtools.options
NULL
|
