A scientific workflow that is to be preserved in an ERC. It conducts a number of operations on data and generates an output (text, numbers, plots).
See BagIt specification.
A set of opaque data contained within the structure defined by this specification.
See ERC contents
A receptacle holding a collection of things (“payload” or “contents”). In the context of this specification, several containers are distinguished: runtime container (with Docker container as a concrete instance) and outer container.
A subconstituent of Examine. Checking an ERC is a syntactical validation, which may be largely automated by a software tool reporting the check result and potential errors. A check comprises (a) the validation of a concrete ERC against the ERC specification, e.g. are required files and metadata fields present, and (b) an execution of the contained analysis. The execution includes a comparison of the result files in the just executed inner container with the result stored in the outer container.
One of the major constituents of ERC interaction. The user can create an ERC by following the technical instructions included in the Specification (ERC Spec) or use the o2r reproducibility service, which has been referentially implemented as “o2r platform”. For more information, see [erc-spec/user-guide/creation/]
One of the major constituents of ERC interaction. Discovery comprises the findability of the ERC as well as the exploration of its features, e.g. time and space driven search operations.
Executable Research Compendium, see this article
Schema compliant information about the ERC, its contents and creators.
One of the major constituents of ERC interaction. It comprises Check, Inspect, Manipulate and Substitute. To examine an ERC means to explore its contents in depth, i.e. check the reproduced version, inspect text, code and data, manipulate interactive elements, as well as exchange input data.
A subconstituent of Examine. Inspection includes looking at all the contents of an ERC, such as code or data files, and metadata documents. A user conducting inspection evaluates the meaning of the ERC’s artifacts.
The file in the container that a reader software uses as the first display to a user to read text and explore graphics. The entry point for examination.
A subconstituent of Examine. A manipulation comprises interactive changing of selected, pre-defined parameters that influence the computation packaged in an ERC. For example, the number of layers in a neural network, the size/selection method of the training dataset in supervised machine learning, or the variogram model of geostatistical kriging. These parameters are defined via UI bindings.
Reproducible, Reproducibility, Replication¶
A subconstituent of Examine. During a substitution, compatible parts of an ERC are exchanged, e.g. similar data sets for a given analysis, or exchanging an analysis script. A substution process usually creates a new ERC based on two input ERCs: the base ERC and the overlay ERC. One or several data or code files from the overlay ERC replace corresponding files in the base ERC, to create a new ERC.
The files created by the author of the original analysis, packages together with ERC metadata in the outer container.