Package 'reproducibleRchunks'

Get the total number of failed reproduction attempts

Description

Get the total number of failed reproduction attempts

Usage

get_num_reproducibility_errors(envir = .cache)

Arguments

envir

Environment to retrieve data from. This defaults to a internal package namespace.

Value

Returns the number of errors encountered when reproducing a Markdown document

---

Get a summary about all reproduction attempts

Description

This function returns a data frame, in which details about reproduction attempts are collected. The data frame has three columns named "Chunk","Variable", and "Success". Every row in the data frame corresponds to one variable, for which reproducibility was tested. Chunk stores the name of the surrounding chunk, Variable stores the name of the variable, and Success is a boolean variable, which indicates whether the reproduction attempt was successful.

Usage

get_reproducibility_summary(envir = .cache)

Arguments

envir

Environment to retrieve data from. This defaults to a internal package namespace.

Value

Returns a data.frame with three columns.

---

Test reproducibility of an R Markdown file

Description

Test reproducibility of an R Markdown file

Usage

isReproducible(filename, resetOptions = TRUE, ...)

Arguments

filename	Character. An R Markdown file to check for reproducibility
resetOptions	Boolean. Should all package options be reset to defaults? TRUE by default. This avoids problems if multiple checks on multiple documents with varying options are made in a row
...	Optional arguments passed down to rmarkdown::render()

---

Loading reproducibility data

Description

This function loads reproducibility meta data from a file and stores the meta information about the variable contents in the specified environment. Reproducibility meta data can be loaded from either a json (preferred) or a binary saved R object. The function returns a named list with meta information restored from file. The named elements include "hashing" indicating whether a hashing algorithm was used, "hashing_algorithm" indicating the name of the hashing algorithm, "hashing_package" indicating the name of the R package, from which the hashing algorithm was used, "hashing_package_version" indicating the package version, "digits" the numeric precision used before hashing numeric values, and "code_fingerprint" the actual hashed string of the chunk code.

Usage

load_repro_data(filename, envir, filetype = c("json", "rda"))

Arguments

filename	Character. File name to load objects from.
envir	Environment to load the objects into. By default, this is the global environment.
filetype	Character. Currently supported is json and rda.

Value

Returns a named list with meta information restored from file. See description for more details.

See Also

save_repro_data()

---

Knitr Hook

Description

This is the main RMarkdown chunk hook for processing the automated reproducibility tests of code chunks. This function is not intended to be called directly. Rather, it is expected that RStudio calls this function when rendering chunks with the label identical to this function name.

Usage

reproducibleR(options)

Arguments

options

A list of chunk options passed from the knitr engine. Usually this is just the object options passed to the engine function; see knit_engines.

Details

This function first executes the R code from a given chunk. If a variable is declared within the scope of the chunk, meta information about the variable's content are generated. If no metadata exists, this metadata is stored in a separate file. If metadata exists, it is compared against the metadata of the reproduction attempt.

Value

A character string generated from the source code and output.

Author(s)

Andreas M. Brandmaier

Examples

reproducibleR(knitr::opts_chunk$merge(list(engine="reproducibleR",code="1+1")))

---

Storing reproducibility data

Description

Storing reproducibility data

Usage

save_repro_data(
  x,
  filename,
  filetype = default_filetype(),
  envir = NULL,
  extra = NULL
)

Arguments

x	Object to be stored.
filename	Name (possible including full path) of the save file
filetype	Character. Currently supported is json and rda.
envir	Environment to load the objects into. By default, this is the global environment.
extra	List. Extra payload to store in the meta data

Value

No return value

See Also

load_repro_data()

---