Jobs and Experiments are abstract objects which hold all information necessary to execute a single computational job for a Registry or ExperimentRegistry, respectively.

They can be created using the constructor makeJob which takes a single job id. Jobs and Experiments are passed to reduce functions like reduceResults. Furthermore, Experiments can be used in the functions of the Problem and Algorithm. Jobs and Experiments hold these information:

Job ID as integer.


Job parameters as named list. For ExperimentRegistry, the parameters are divided into the sublists “” and “”.


Seed which is set via doJobCollection as scalar integer.


Computational resources which were set for this job as named list.


Path to a directory which is created exclusively for this job. You can store external files here. Directory is persistent between multiple restarts of the job and can be cleaned by calling resetJobs.


Job only: User function passed to batchMap.

Experiments only: Problem id.

Experiments only: Algorithm id.


Experiments only: Problem.


Experiments only: Problem instance.


Experiments only: Algorithm.


Experiments only: Replication number.

Note that the slots “pars”, “fun”, “algorithm” and “problem” lazy-load required files from the file system and construct the object on the first access. The realizations are cached for all slots except “instance” (which might be stochastic).

Jobs and Experiments can be executed manually with execJob.

makeJob(id, reader = NULL, reg = getDefaultRegistry())



[integer(1) or data.table]
Single integer to specify the job or a data.table with column and exactly one row.


[RDSReader | NULL]
Reader object to retrieve files. Used internally to cache reading from the file system. The default (NULL) does not make use of caching.


Registry. If not explicitly passed, uses the default registry (see setDefaultRegistry).


[Job | Experiment].


batchtools:::example_push_temp(1) tmp = makeRegistry(file.dir = NA, make.default = FALSE)
#> No readable configuration file found
#> Created registry in '/tmp/batchtools-example/reg' using cluster functions 'Interactive'
batchMap(function(x, y) x + y, x = 1:2, more.args = list(y = 99), reg = tmp)
#> Adding 2 jobs ...
submitJobs(resources = list(foo = "bar"), reg = tmp)
#> Submitting 2 jobs in 2 chunks using cluster functions 'Interactive' ...
job = makeJob(1, reg = tmp) print(job)
#> <Job> #> Inherits from: <BaseJob> #> Public: #> external.dir: active binding #> file.dir: /tmp/batchtools-example/reg #> fun: active binding #> id: 1 #> initialize: function (file.dir, reader, id,, seed, resources) #> active binding #> list #> pars: active binding #> reader: RDSReader, R6 #> resources: list #> seed: 15284
# Get the parameters: job$pars
#> $x #> [1] 1 #> #> $y #> [1] 99 #>
# Get the job resources: job$resources
#> $foo #> [1] "bar" #>
# Execute the job locally: execJob(job)
#> ### [bt]: Setting seed to 15284 ...
#> [1] 100