next up previous print clean
Next: Testing of documents Up: Schwab: Preparations Previous: Interactivity

Reproducibility

The goal of reproducibility is to help communicate a computational process to a reader by allowing him to apply and modify the process easily. A finished document includes all result files and all the source files to re-create the result files. (The source files I am addressing here are files which are specific to the computational task. The document requires additional ``environment'' files which it assumes to be present such as a compiler, a Xwindow system, a UNIX operating system, or a program displaying dvi files.)

The three basic actions a reader wants to take when reproducing a result are:

The burn and build rules an author does not have to define himself if he lists all his figure names in a definition for RESULTS and includes SEP.idoc.rules. These idoc rules supply a default for the burn and build rule as long as the author adhers to the SEP naming convention for result files.

These standard naming conventions distinguish three classes of files in terms of their reproducibility:


next up previous print clean
Next: Testing of documents Up: Schwab: Preparations Previous: Interactivity
Stanford Exploration Project
3/8/1999