Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
MAINT: extended central README
  • Loading branch information
pebert committed Oct 20, 2016
1 parent 2f8a711 commit e295132
Showing 1 changed file with 15 additions and 1 deletion.
16 changes: 15 additions & 1 deletion README.md
@@ -1,12 +1,24 @@
# DEEP Computational Metadata

## Identification
This repository can be cited in publications using the following DOI:

[DOI: 10.17617/1.2W](http://doi.org/10.17617/1.2W "https://github.molgen.mpg.de/DEEP/comp-metadata")

Also consider citing the corresponding publication listed [below](#Reference).

## Process documentation
In DEEP, standardized computational analysis pipelines are documented in form of so-called *Process* specifications.
A *Process* document lists required input and reference files, specifies the output generated by the pipeline and
provides a step-by-step description of the computational analysis.
*Processes* are in XML format and are rendered into a readable form when opened in a standard web browser
(assuming an active internet connection). They are lightweight enough to be send via e-mail to collaboration partners.

[Proceed to Process documentation](docs/process.md)

## Creating new *Process* documents


## Analysis documentation
Each run of a standardized pipeline produces an *Analysis* metadata document at the end. These are simple tab-separated
text files listing all input, output and reference files as well as non-default parameters in form of *key-value*
Expand All @@ -16,4 +28,6 @@ an *Analysis* metadata file is created automatically. Consequently, these files
## Reference
See the corresponding publication in Oxford Database for details:

["A general concept for consistent documentation of computational analyses", *Database* 2015](https://dx.doi.org/10.1093/database/bav050)
["A general concept for consistent documentation of computational analyses", *Database* 2015](https://dx.doi.org/10.1093/database/bav050)

The [supplemental material](publication/suppmat.md) is also available in this repository. Please note that this material is just kept for reference, and is considered outdated. Please **do not use it** to create new *Process* documents.

0 comments on commit e295132

Please sign in to comment.