taf.boot: Bootstrap TAF Analysis

View source: R/taf.boot.R

taf.bootR Documentation

Bootstrap TAF Analysis


Process metadata files ‘SOFTWARE.bib’ and ‘DATA.bib’ to set up software and data files required for the analysis.


taf.boot(software = TRUE, data = TRUE, clean = TRUE, force = FALSE,
  taf = NULL, quiet = FALSE)



whether to process SOFTWARE.bib.


whether to process DATA.bib.


whether to clean directories during the boot procedure.


whether to remove existing bootstrap/data, bootstrap/library, and bootstrap/software directories before the boot procedure.


a convenience flag where taf = TRUE sets software, data, clean, and force to TRUE, as is done on the TAF server. Any other value of taf is ignored.


whether to suppress messages reporting progress.


If clean = TRUE then:

  1. clean.software and clean.library are run if ‘SOFTWARE.bib’ is processed.

  2. clean.data is run if ‘DATA.bib’ is processed.

The default behavior of taf.boot is to skip downloading of remote files (GitHub resources, URLs, boot scripts) and also skip installing R packages from GitHub if the files seem to be already in place. This is done to speed up the boot procedure as much as possible. To override this and guarantee that all data and software files are updated, pass force = TRUE to download and install everything declared in SOFTWARE.bib and DATA.bib.


Logical vector indicating which metadata files were processed.


This function should be called from the top directory of a TAF analysis. It looks for a directory called ‘bootstrap’ and prepares data files and software according to metadata specifications.

The boot procedure consists of the following steps:

  1. If a bootstrap/SOFTWARE.bib metadata file exists, it is processed.

  2. If a bootstrap/DATA.bib metadata file exists, it is processed.

After the boot procedure, software and data have been documented and are ready to be used in the subsequent analysis. Specifically, the procedure populates up to three new directories:

  • bootstrap/data with data files.

  • bootstrap/library with R packages compiled for the local platform.

  • bootstrap/software with software files, such as R packages in tar.gz source code format.

Model settings and configuration files can be set up within DATA.bib, see TAF Wiki.

See Also

draft.data and draft.software can be used to create initial draft versions of ‘DATA.bib’ and ‘SOFTWARE.bib’ metadata files.

taf.library loads a package from bootstrap/library.

TAF-package gives an overview of the package.


## Not run: 

## End(Not run)

TAF documentation built on Jan. 23, 2023, 5:25 p.m.