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
71
72
73
|
% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/options.R
\name{future.batchtools.options}
\alias{future.batchtools.options}
\alias{future.cache.path}
\alias{future.delete}
\alias{future.batchtools.expiration.tail}
\alias{future.batchtools.output}
\alias{future.batchtools.workers}
\alias{R_FUTURE_BATCHTOOLS_WORKERS}
\alias{R_FUTURE_FUTURE_CACHE_PATH}
\title{Options used for batchtools futures}
\description{
Below are the \R options and environment variables that are used by the
\pkg{future.batchtools} package.
See \link[future:future.options]{future::future.options} for additional ones that apply to futures
in general.\cr
\cr
\emph{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 \code{+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: \code{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: \code{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: \code{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 \emph{not} be a folder that is only local to the
machine such as \verb{file.path(tempdir(), ".future"} if an job scheduler
on a HPC environment is used.
(Default: \code{.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")
}
\keyword{internal}
|
