Skip to main content

COMBINE archive and OMEX format: one file to share all information to reproduce a modeling project

Abstract

Background

With the ever increasing use of computational models in the biosciences, the need to share models and reproduce the results of published studies efficiently and easily is becoming more important. To this end, various standards have been proposed that can be used to describe models, simulations, data or other essential information in a consistent fashion. These constitute various separate components required to reproduce a given published scientific result.

Results

We describe the Open Modeling EXchange format (OMEX). Together with the use of other standard formats from the Computational Modeling in Biology Network (COMBINE), OMEX is the basis of the COMBINE Archive, a single file that supports the exchange of all the information necessary for a modeling and simulation experiment in biology. An OMEX file is a ZIP container that includes a manifest file, listing the content of the archive, an optional metadata file adding information about the archive and its content, and the files describing the model. The content of a COMBINE Archive consists of files encoded in COMBINE standards whenever possible, but may include additional files defined by an Internet Media Type. Several tools that support the COMBINE Archive are available, either as independent libraries or embedded in modeling software.

Conclusions

The COMBINE Archive facilitates the reproduction of modeling and simulation experiments in biology by embedding all the relevant information in one file. Having all the information stored and exchanged at once also helps in building activity logs and audit trails. We anticipate that the COMBINE Archive will become a significant help for modellers, as the domain moves to larger, more complex experiments such as multi-scale models of organs, digital organisms, and bioengineering.

Background

The ability to obtain similar results when reproducing an experiment is a tenet of modern science. Reproducible science has even become a field of research in its own right [1],[2]. The reproducibility of a scientific study depends on the careful description of the original experiment, including the methods and tools used to perform the experiment, the substrate on which to perform the experiment, and the precise experimental setup, including all necessary influences from the environment. When the result is meant to be presented after post-processing, it is also imperative to provide the details of the processing steps. With the rise of systems biology, computational models have been increasingly used for in silico experiments and this has led to a corresponding need to reproduce the results reliably.

The need for exchanging mathematical model structure - that is the list of variables and how they are related - was recognized early on. It led to the generation of tool-independent structured formats, such as SBML [3], CellML [4], and NeuroML [5] to cite only a few. While the exchange of model structure helped with model reuse, the research community recognized that more contextual information was required to fully reproduce the results obtained from a model. Several guidelines were developed to list this information, including the Minimum Information Requested in the Annotation of Models (MIRIAM) [6] and the Minimum Information About Simulation Experiments (MIASE) [7]. Further structured formats were needed to implement these guidelines, such as SBRML [8] for result data and SED-ML [9] for the description of simulation setups.

The modeling and simulation life cycle includes several steps [10] which need to be documented and described in order to be reproduced. Typically, a model is built based upon prior knowledge, either manually or through automated means. Although not generally encoded in a standard form, the description of the procedure used to build it, including accompanying hypotheses, assumptions and approximations, is often crucial to guarantee proper use of a model [11]. The model itself (the variables, their interrelationships and the constraints) must be precisely described. In addition, a precise description of simulation and analysis procedures must also be given in order to allow them to be reproduced. Simulation results might be needed as well, either for comparison to other data or as models for further analysis (for instance individuals generated from a population model). One may also want to add other information, for instance experimental result data (to fit the model or representative simulation results) encoded in NuML [12] or FieldML [13], model structure represented in the SBGN [14] and encoded in SBGN-ML [15], or a description of the biological system being modeled, such as a synthetic biology construct encoded in SBOL [16]. Therefore in order to fully reproduce a modeling and simulation procedure, one needs to access a constellation of files in different formats, including model and simulation descriptions, numerical data and links to additional information (metadata).

The increasing complexity of systems under study has led to the development of modular approaches, where models are built from several files describing different parts of the model. This is, for instance, the case for models encoded using CellML, NeuroML, or the SBML Level 3 Hierarchical Model Composition package [17]. Furthermore, other fields in the life sciences, such as ecology [18] and drug development [19], have also started to develop standards to encode their specialized mathematical models. In these fields, datasets and simulation procedures are integral parts of the model descriptions. All the files necessary for the description of a model must therefore be exchanged in order to fully understand and use the model.

Managing multiple files presents difficulties. Sharing those files can be a tedious and error-prone affair. Some files necessary to build or process a model might have moved, or even be deleted, precluding the reproduction of results and ultimately even re-using the model. Another difficulty with handling multiple files is that models evolve over time. Some changes, such as corrections of parameter values or changes in the network structure, affect the outcome of the scientific study. Corrections of previously published model code must be communicated and propagated to all instances of the model that have been reused in other studies. It is therefore necessary to specify the version of a model that has been used in a simulation [20]. Solutions towards improved management of computational models have recently been proposed, including better accessibility of models and versions thereof, and better links between all files related to a specific study [20]-[24]. However, all these approaches focus on long-term availability and management of modeling experiments. They do not provide the means for easy export and exchange of models in structured and well-defined formats. One advantage of an archive is that a single file can encapsulate everything there is to know about a specific modeling project, including the instructions on how to “open” the archive and interpret it. Similar examples from the domain of computer science are the packages of the Debian GNU/Linux operating system [25], the Java Archives [26], the Microsoft Office Open XML [27], and the Open Document Formats [28].

In this article, we describe a type of archive developed by the COMBINE initiative [29] that enables the exchange of all information required to reproduce a modeling project.

Implementation

Format of the archive

The COMBINE Archive is encoded using the “Open Modeling EXchange format” (OMEX). The archive itself is a “ZIP” file [30]. ZIP is used for data compression and archiving purposes. A ZIP file contains one or more files that have been compressed, to reduce file size, or stored as is (Figure 1). The technical specification of the ZIP format is available from the PKWARE website [31]. The default file extension for the COMBINE Archive is .omex. Additional extensions are available to indicate what is the main standard format used within the archive. This helps users choose between different archives, and select appropriate software tools with which to open them.

.sedx - SED-ML archive

.sbex - SBML archive

.cmex - CellML archive

.sbox - SBOL archive

.neux - NeuroML archive

.phex – DDMoRe archive using the PharmML format

Figure 1
figure 1

Schematic representation of the structure of a COMBINE Archive, a (possibly encrypted) zipped version of an archive containing descriptions of models, simulations, graphical representations, metadata and other sources of information.

Note that a COMBINE Archive may contain files in several different standard formats. Therefore the specific file extension is only an indication provided for the convenience of the user. For instance, a database of models could distribute archives of the same models encoded in SBML .sbex and CellML .cmex. However, archives containing models in both formats could also be distributed and the extension .omex used. If the archives contain SED-ML files, the extension .sedx could be used and the selection between the model formats be devolved to the SED-ML file.

Manifest file

Every COMBINE Archive contains at least one file, located at the root, i.e. highest in the hierarchy of files inside the archive. This mandatory file is called manifest.xml. It is an XML file that contains a flat list of names of all files constituting the archive, and it describes each file’s type and location inside the archive. Figure 2 shows an example manifest file. A valid manifest file must have at least one entry, the one for the archive itself (first content entry in Figure 2). However, the manifest may contain as many entries as needed. In the current version of OMEX, all the files listed in the manifest must be included in the archive itself. The location of those files is defined by a relative Uniform Resource Identifier (URI) [32].

Figure 2
figure 2

Example of manifest file describing 5 files: the manifest itself, an SBML file with the structure of the model, a SED-ML file with the description of a simulation, a PDF version of the article describing the modeling and simulation experience, and an RDF file containing metadata about the archive. In this specific archive, the SED-ML file should be read first, which is indicated by the master attribute set to “true” on the file simulation.xml.

Each entry is encoded in an XML element named <content>, and characterized by three attributes. The attribute location contains a URI that specifies where the file is located with respect to the root of the archive. The attribute format specifies the file format, using either an Identifiers.org URI [33] if it exists (i.e. for any format part of COMBINE, e.g. http://identifiers.org/combine.specifications/sed-ml.level-1.version-2), or an Internet Media Type URI [34] (e.g. http://purl.org/NET/mediatypes/application/pdf). If a format is neither registered with COMBINE nor with IANA, an unregistered Internet media type can be used. Such unregistered Media Type should take the form type/x.name (i.e. using URIs such as http://purl.org/NET/mediatypes/application/x.matlab or http://purl.org/NET/mediatypes/application/x.copasi). Finally, the optional master attribute is a Boolean which indicates that the content should be considered the main one, to be read or presented to a user. The master attribute, read by the processing software once the archive is loaded and parsed, is different from the extensions described above. For instance, the manifest of an archive containing a simulation description and all the models necessary to run a simulation, could have the master flag set to “true” for the SED-ML file. In an archive containing a modular model made up of many parts that are hierarchically linked, the master flag should be set to “true” for the master model, which in turn is importing sub-models but is not called by any.

Metadata

Any type of file can be included in a COMBINE Archive, and therefore any type of metadata format may be used to encode clerical information or add semantics to the modeling contents in the archive. However, in the interests of interoperability and to ease the development of software support for metadata, the archive specification recommends an XML serialization of the Resource Description Framework [35] contained in a file called metadata.rdf (Figure 3). The format reuses several existing standard terminologies:

The Resource Description Format itself.

vCard 4 [36], a standard for electronic business cards; in particular its terms hasName, given-name, family-name, hasEmail, organization-name. How to use vCard in RDF is specified by the vCard ontology, a recommendation from the W3C [37].

Metadata terms of the Dublin Core Metadata Initiative [38], in particular the terms description, creator, created, modified, W3CDTF (to encode a date, see [39]). More information on the use of Dublin Core in RDF can be found on the Dublin Core website [40].

Figure 3
figure 3

Example of a metadata file bringing additional information about the archive itself (identified by the relative path “.”): a short description of what the archive is about, details about its creator, and dates of creation and last modification.

The metadata file should provide sufficient information to follow the MIRIAM and MIASE guidelines whenever possible. At the very least, the metadata file should provide the archive creation date, the date of last update, and who created it. COMBINE Archive creators could also provide a description of the software tool that generated the archive, as well as a reference to external information describing the work. In addition to the information about the archive itself, one could provide metadata about any of the archive content files. This information helps building logs of actions performed as well as audit trails, which are, for instance, important for models used in drug development. Future development of the metadata content and format is the topic of discussions of the combine-metadata Google group.

Results and discussion

The SED-ML community initially developed the concept behind the COMBINE Archive, when faced with the need to encapsulate the simulation experiment description and the models needed to perform that experiment [41]. Members of the community extended the aim of the SED-ML archive to encompass any file type that would be useful during a modeling and simulation procedure, and wrote an initial technical description. This draft was discussed during several COMBINE meetings, on the combine-discuss mailing list and subsequently on the dedicated combine-archive mailing list. The discussions converged towards the specification described in this manuscript. A first release candidate was published on July 4 2014. Comments were taken into account in a second release candidate published on July 25 2014. No further comments on the document were received and OMEX version 1 was released on September 15th 2014. Its specification is described in a document available at http://identifiers.org/combine.specifications/omex.

Several tools providing support for the COMBINE Archive have already been released (Table 1) either as independent libraries or embedded within modeling software such as PySCeS [42], VCell [43] or Tellurium [44].

Table 1 Different implementations that support the COMBINE Archive today

Use cases

Combining several types of information encoded in different formats into a single file will be useful for many researchers. Here we showcase a few applications of the COMBINE Archive. These examples demonstrate the current usage of the archive and are not meant to be limiting.

Use case 1, systems biology models

As recognized by the MIRIAM and MIASE guidelines, the sole description of model variables and their relationships (the structural model) is not sufficient to allow the reproduction of simulation results. The description of the simulation and analysis tasks is also necessary. Many modeling and simulation software configuration formats include both model description and experiments. In order to exchange this information in standard, tool-independent, formats, one must provide the models (for instance encoded in SBML) and the simulation description (in SED-ML). An example of such archive is provided in Additional file 1. Although a SED-ML file can describe an experiment using models available remotely (using URIs to allow for their identification and retrieval), it is often useful to be able to provide all the necessary information at once. One might also need several models to reproduce a simulation experiment, for instance to compare results generated from different models, to parametrize a model using the results of another model or to run several models concurrently (see also use case 3). Moreover, a model can be described in multiple documents, for instance when encoded in CellML 1.1 [45] or in SBML Level 3 with the model composition package [17]. The COMBINE Archive permits researchers to share all the documents describing a model and associated simulations in a single file.

Use case 2, drug discovery models

Assessing the effects of a drug using mathematical models involves several steps, including model selection, parameter estimation, population simulations etc., both on the pharmacokinetics (drug concentration over time) and pharmacodynamics (drug effect versus drug concentration) side. The US Food and Drug Administration requires the provision of information sufficient to completely reproduce the evaluation of a drug [46]. This includes SAS transport files [47] to represent all datasets used for model development and validation; ASCII text files of model codes or control streams and output listings for all major model building steps (base structural model, covariates models, final model, and validation model); individual plots for a representative number of subjects for population analysis; and standard model diagnostic plots. Each data item must be accompanied by a description provided in a PDF file. A structured archive containing all these components is a convenient method of ensuring that all information is faithfully transmitted, and that the correct versions of each piece of information are included in the transmission. PharmML, the emerging standard for pharmacometrics models, already supports the COMBINE Archive as a container that encapsulates all the information pertaining to a pharmacometrics modeling project [19].

Use case 3, large hybrid modular models

As systems biology moves toward the description of more complex systems, such as comprehensive biological processes [48], whole cells [49], and organs [50], larger and more detailed models are being developed. These models encompass biological processes that might require the use of different modeling approaches. Their simulations sometimes require the use of several simulation tools. The tools’ results influence each other, for instance using synchronization [49],[51]. To be able to reproduce such simulation experiments, one must provide all the submodels, all the simulation descriptions, and the descriptions of the overall experiments with the coordination of the elementary simulations. All files must be at the right place and in the right version. A single file archive offers a convenient way to share consistent instances of those models.

Use case 4, automatic (machine-only) transfer of research results

Given a suitable technical infrastructure, no human interaction is necessary to transfer tasks and results between machines or applications. The COMBINE Archive can be seen as a container for all files necessary for the job to run a simulation on a computational model. The archive can be submitted to compute nodes which can then automatically read and process the corresponding tasks. For example, the Functional Curation project of Chaste [11],[52] uses the COMBINE Archive as the standard format to transfer data between the web interface and the backend. The goal of the Functional Curation project is to compare a model’s behavior under different experimental scenarios. On the web page, a user may choose the set of computational models of interest together with a set of experiment descriptions they would like to test against these models. All selected files are compiled into a COMBINE Archive, for instance using the CombineArchive library [53], and sent to a node in a back-end, which is able to understand the encoded job and run the experiment. Afterwards, the simulation results are again packed into a COMBINE Archive and sent back to the web server where they are presented to the user. Thus, the COMBINE Archive eases the communication between nodes in a network.

Related efforts

The idea of a single package to run a simulation experiment in biology was pioneered by the JSim “Project File”, which are text files that encapsulate everything used by the JSim program: the notes, the model code, and the control parameters for all the steps in the analysis [54]. More recently, the Workflow4Ever project (Wf4ever), developed the Research Object Bundle [55], focusing on the preservation of scientific experiments in data-intensive science [56]. The structure of the Research Object Bundle is close to the COMBINE Archive. Based on Adobe Universal Container Format (UCF) [57], it is also a ZIP file containing a manifest and metadata. One way to start converging the efforts is to share metadata vocabularies and formats, as demonstrated in the tool ro-combine-archive [58], which enriches a COMBINE Archive such that it can co-exist as a Research Object Bundle and vice versa.

Beyond scientific research, several industry standards are being widely used to build document archives based on ZIP files. They mostly belong to two large families. The aforementioned UCF bears strong similarities with the Open Document Format [28] developed by the Organization for the Advancement of Structured Information Standards (OASIS), and the EPUB Open Container Format (OCF) [59] developed by the International Digital Publication Forum (IDPF). As with OMEX, those archives contain a manifest file that lists and identifies the contents of the archive and a metadata file, either in XML or in RDF. In parallel, Microsoft developed the Open Packaging Convention [60] used in its Office Suite and some other software such as MathWorks’ Simulink. Those packages also list their contents in an XML file, and can carry metadata .

However, these industry standards can be relatively complex and rigid. In this initial iteration of the OMEX specification, the community opted for simplicity and flexibility, in order to encourage rapid support and usage. The main differences between the COMBINE Archive and the formats discussed above lie in the structure of the archive and the format of the file describing the content. Since the COMBINE Archive is in general less restrictive, future convergences will be easy to implement once agreed upon.

General discussion

A COMBINE Archive contains files encoded in various formats. Currently OMEX does not provide a standard mean to describe the relationships between the different files beyond the mechanisms used by the various file encoding formats. For example, SED-ML documents define links to the models and datasets it uses; Similarly, hierarchical model documents in CellML or SBML contains links to the required sub-models. Some work remains to be done in order to specify the relationship between given elements of a file with elements in another file. For instance, there is currently no well defined way to link glyphs encoded in SBGN-ML with the corresponding elements of an SBML file. Some solutions have been discussed, including systems similar to the SED-ML link to models or more general mapping files.

In addition to the multi-files packaging aspect, the use of the ZIP format with OMEX allows for significant compression of file contents and resultant reduction in file size. This provides a notable benefit when sharing state-of-the-art models and associated files, which can be quite large. For instance an archive containing the expanded version of the human metabolic reconstruction Recon2.1 [61] is approximately 23 MB bytes, while the sum of its contained files is 230 MB, i.e. 90% compression ratio (Additional file 2).

The current specification requires that all the components are encapsulated within the archive. Accessing documents outside the archive might be more flexible and fit with a semantic web approach. However, it would require more complex verification and validation systems to answer questions such as “Are the links still valid? Are the versions of the files meant to be used in the archive the same as the version accessible through the URLs? How do users and software tools discriminate between network failure, non-existent file, file in the wrong format, etc.?”. For the time being, it was felt that including everything in the archive file was a better choice. If an archive cannot be read or interpreted, one can attribute the fault to either the tool reading the archive or the archive builder. The reliability of third parties is inconsequential in this scheme.

Conclusions

The ability to distribute an entire modeling project as a single file, containing all the necessary protocols and data needed for its implementation, will lead to easier reuse of models, improved reproducibility of results, and better tracking of the model development process.

Availability and requirements

Project name: COMBINE archive

Project home page: http://identifiers.org/combine.specifications/omex

Operating system(s): platform independent

Programming language: XML

Other requirements: none

License: non-applicable

Any restrictions to use by non-academics: none

Availability of supporting data

The data set supporting the results of this article is included within the article (and its Additional files 1 and 2).

Additional files

Abbreviations

COMBINE:

Computational Modeling in Biology Network

MIASE:

Minimum Information About a Simulation Experiment

MIRIAM:

Minimum Information Required in the Annotation of Models

NuML:

Numerical Markup Language

OCF:

Open Container Format

ODF:

Open Document Format

OMEX:

Open Modeling EXchange format

OOXML:

Office Open XML

OPC:

Open Packaging Convention

SBGN:

Systems Biology Graphical Notation

SBGN-ML:

Systems Biology Graphical Notation Markup Language

SBML:

Systems Biology Markup Language

SBRML:

Systems Biology Result Markup Language

SED-ML:

Simulation Experiment Description Markup Language

UCF:

Universal Container Format

URI:

Uniform Resource Identifier

References

  1. Mesirov JP: Computer science: accessible reproducible research. Science. 2010, 327: 415-416. 10.1126/science.1179653.

    Article  PubMed  CAS  Google Scholar 

  2. Sandve GK, Nekrutenko A, Taylor J, Hovig E: Ten simple rules for reproducible computational research. PLoS Comput Biol. 2013, 9: e1003285-10.1371/journal.pcbi.1003285.

    Article  PubMed Central  PubMed  Google Scholar 

  3. Hucka M, Bolouri H, Finney A, Sauro HM, Doyle JC, Kitano H, Arkin AP, Bornstein BJ, Bray D, Cornish-Bowden A, Cuellar AA, Dronov S, Ginkel M, Gor V, Goryanin II, Hedley WJ, Hodgman TC, Hunter PJ, Juty NS, Kasberger JL, Kremling A, Kummer U, Le Novère N, Loew LM, Lucio D, Mendes P, Mjolsness ED, Nakayama Y, Nelson MR, Nielsen PF, et al: The Systems Biology Markup Language (SBML): a medium for representation and exchange of biochemical network models. Bioinformatics. 2003, 19: 524-531. 10.1093/bioinformatics/btg015.

    Article  PubMed  CAS  Google Scholar 

  4. Hedley WJ, Nelson MR, Bullivant DP, Nielsen PF: A short introduction to CellML. Phil Trans Roy Soc London Series A. 2001, 359: 1073-1089. 10.1098/rsta.2001.0817.

    Article  Google Scholar 

  5. Goddard NH, Hucka M, Howell F, Cornelis H, Shankar K, Beeman D: Towards NeuroML: model description methods for collaborative modelling in neuroscience. Phil Trans Roy Soc London Series B. 2001, 356: 1209-1228. 10.1098/rstb.2001.0910.

    Article  CAS  Google Scholar 

  6. Le Novère N, Finney A, Hucka M, Bhalla US, Campagne F, Collado-Vides J, Crampin EJ, Halstead M, Klipp E, Mendes P, Nielsen P, Sauro H, Shapiro B, Snoep JL, Spence HD, Wanner BL: Minimum Information Requested In the Annotation of biochemical Models (MIRIAM). Nat Biotechnol. 2005, 23: 1509-1515. 10.1038/nbt1156.

    Article  PubMed  Google Scholar 

  7. Waltemath D, Adams R, Beard DA, Bergmann FT, Bhalla US, Britten R, Chelliah V, Cooling MT, Cooper J, Crampin E, Garny A, Hoops S, Hucka M, Hunter P, Klipp E, Laibe C, Miller A, Moraru I, Nickerson D, Nielsen P, Nikolski M, Sahle S, Sauro HM, Schmidt H, Snoep JL, Tolle D, Wolkenhauer O, Le Novère N: Minimum Information About a Simulation Experiment (MIASE). PLoS Comput Biol. 2011, 7: e1001122-10.1371/journal.pcbi.1001122.

    Article  PubMed Central  PubMed  CAS  Google Scholar 

  8. Dada JO, Spasić I, Paton NW, Mendes P: SBRML: a markup language for associating systems biology data with models. Bioinformatics. 2010, 26: 932-938. 10.1093/bioinformatics/btq069.

    Article  PubMed  CAS  Google Scholar 

  9. Waltemath D, Adams R, Bergmann FT, Hucka M, Kolpakov F, Miller AK, Moraru II, Nickerson D, Sahle S, Snoep JL, Le Novère N: Reproducible computational biology experiments with SED-ML – the simulation experiment description markup language. BMC Syst Biol. 2011, 5: 198-10.1186/1752-0509-5-198.

    Article  PubMed Central  PubMed  Google Scholar 

  10. Courtot M, Juty N, Knüpfer C, Waltemath D, Zhukova A, Dräger A, Dumontier M, Finney A, Golebiewski M, Hastings J, Hoops S, Keating S, Kell DB, Kerrien S, Lawson J, Lister A, Lu J, Machne R, Mendes P, Pocock M, Rodriguez N, Villeger A, Wilkinson DJ, Wimalaratne S, Laibe C, Hucka M, Le Novère N: Controlled vocabularies and semantics in systems biology. Mol Syst Biol. 2011, 7: 543-10.1038/msb.2011.77.

    Article  PubMed Central  PubMed  Google Scholar 

  11. Cooper J, Mirams G, Niederer S: High throughput functional curation of cellular electrophysiology models. Prog Biophys Mol Biol. 2011, 107: 11-20. 10.1016/j.pbiomolbio.2011.06.003.

    Article  PubMed  Google Scholar 

  12. Numerical Markup Language. http://code.google.com/p/numl/. Accessed 09 April 2014.

  13. Christie GR, Nielsen PMF, Blackett SA, Bradley CP, Hunter PJ: FieldML: concepts and implementation. Phil Trans R Soc A. 2009, 367: 1869-1884. 10.1098/rsta.2009.0025.

    Article  PubMed Central  PubMed  Google Scholar 

  14. Le Novère N, Hucka M, Mi H, Moodie S, Shreiber F, Sorokin A, Demir E, Wegner K, Aladjem M, Wimalaratne S, Bergman FT, Gauges R, Ghazal P, Kawaji H, Li L, Matsuoka Y, Villéger A, Boyd SE, Calzone L, Courtot M, Dogrusoz U, Freeman T, Funahashi A, Ghosh S, Jouraku A, Kim S, Kolpakov F, Luna A, Sahle S, Schmidt E, et al: The systems biology graphical notation. Nat Biotechnol. 2009, 27: 735-741. 10.1038/nbt.1558.

    Article  PubMed  Google Scholar 

  15. van Iersel MP, Villéger AC, Czauderna T, Boyd SE, Bergmann FT, Luna A, Demir E, Sorokin A, Dogrusoz U, Matsuoka Y, Funahashi A, Aladjem MI, Mi H, Moodie SL, Kitano H, Le Novère N, Schreiber F: Software support for SBGN maps: SBGN-ML and LibSBGN. Bioinformatics. 2012, 28: 2016-2021. 10.1093/bioinformatics/bts270.

    Article  PubMed Central  PubMed  CAS  Google Scholar 

  16. Galdzicki M, Clancy KP, Oberortner E, Pocock M, Quinn JY, Rodriguez CA, Roehner N, Wilson ML, Adam L, Anderson JC, Bartley BA, Beal J, Chandran D, Chen J, Densmore D, Endy D, GrĂĽnberg R, Hallinan J, Hillson NJ, Johnson JD, Kuchinsky A, Lux M, Misirli G, Peccoud J, Plahar HA, Sirin E, Stan GB, Villalobos A, Wipat A, Gennari JH, et al: The Synthetic Biology Open Language (SBOL) provides a community standard for communicating designs in synthetic biology. Nat Biotechnol. 2014, 32: 545-550. 10.1038/nbt.2891.

    Article  PubMed  CAS  Google Scholar 

  17. Smith LP, Hucka M, Hoops S, Finney A, Ginkel M, Myers CJ, Moraru I, Liebermeister W: Hierarchical Model Composition, Version 1 Release 2. Available from COMBINE 2013 http://identifiers.org/combine.specifications/sbml.level-3.version-1.comp.

  18. Grimm V, Berger U, Bastiansen F, Eliassen S, Ginot V, Giske J, Goss-Custard J, Grand T, Heinz SK, Huse G, Huth A, Jepsen JU, Jørgensen , Mooij WM, Müller B, Pe’er G, Piou C, Railsback SF, Robbins AM, Robbins MM, Rossmanith E, Rüger N, Strand E, Souissi S, Stillman RA, Vabø R, Visser U, DeAngelis DL: A standard protocol for describing individual-based and agent-based models. Ecol Model. 2006, 198: 115-126. 10.1016/j.ecolmodel.2006.04.023.

    Article  Google Scholar 

  19. Pharmacometrics Markup Language http://pharmml.org Accessed 12 Feb 2014

  20. Waltemath D, Henkel R, Hälke R, Scharm M, Wolkenhauer O: Improving the reuse of computational models through version control. Bioinformatics. 2013, 29: 742-748. 10.1093/bioinformatics/btt018.

    Article  PubMed  CAS  Google Scholar 

  21. Li C, Donizelli M, Rodriguez N, Dharuri H, Endler L, Chelliah V, Li L, He E, Henry A, Stefan MI, Snoep JL, Hucka M, Le Novère N, Laibe C: BioModels database: an enhanced, curated and annotated resource for published quantitative kinetic models. BMC Syst Biol. 2010, 4: 92-10.1186/1752-0509-4-92.

    Article  PubMed Central  PubMed  Google Scholar 

  22. Wolstencroft K, Owen S, du Preez F, Krebs O, Mueller W, Goble C, Snoep JL: The SEEK: a platform for sharing data and models in systems biology. Meth Enzymol. 2011, 500: 629-655. 10.1016/B978-0-12-385118-5.00029-3.

    Article  PubMed  CAS  Google Scholar 

  23. Miller AK, Yu T, Britten R, Cooling MT, Lawson J, Cowan D, Garny A, Halstead MD, Hunter PJ, Nickerson DP, Nunns G, Wimalaratne SM, Nielsen PM: Revision history aware repositories of computational models of biological systems. BMC Bioinformatics. 2011, 12: 22-10.1186/1471-2105-12-22.

    Article  PubMed Central  PubMed  Google Scholar 

  24. Henkel R, Le Novère N, Wolkenhauer O, Waltemath D: Considerations of graph-based concepts to manage of computational biology models and associated simulations. GI-Jahrestagung. 2012, 2012: 1545-1551.

    Google Scholar 

  25. deb (file format) http://en.wikipedia.org/wiki/Deb_%28file_format%29. Accessed 12 Feb 2014.

  26. JAR (file format) http://en.wikipedia.org/wiki/JAR_%28file_format%29. Accessed 12 Feb 2014.

  27. [OOXML] Office Open XML file formats. http://en.wikipedia.org/wiki/Office_Open_XML_file_formats. Accessed 12 Feb 2014.

  28. OpenDocument technical specification http://en.wikipedia.org/wiki/OpenDocument_technical_specification. Accessed 12 Feb 2014.

  29. The Computational Modeling in Biology Initiative (COMBINE) http://co.mbine.org. Accessed 12 Feb 2014.

  30. Zip (file format) http://en.wikipedia.org/wiki/Zip_%28file_format%29. Accessed 12 Feb 2014.

  31. [ZipSpec] APPNOTE.TXT - .ZIP File Format Specification http://www.pkware.com/documents/casestudies/APPNOTE.TXT. Accessed 12 Feb 2014.

  32. Berners-Lee T, Fielding R, Masinter L: Uniform Resource Identifier (URI): Generic Syntax. The Internet Society 2005 http://tools.ietf.org/html/rfc3986. Accessed 12 Feb 2014.

  33. Juty N, Le Novère N, Laibe C: Identifiers.org and MIRIAM Registry: community resources to provide persistent identification. Nucleic Acids Res. 2012, 40: D580-D586. 10.1093/nar/gkr1097.

    Article  PubMed Central  PubMed  CAS  Google Scholar 

  34. Freed N, Klensin J: Media Type Specifications and Registration Procedures. Internet Soc 2005 http://tools.ietf.org/html/rfc4288. Accessed 12 Feb 2014.,

  35. Resource Description Framework (RDF) http://www.w3.org/RDF/. Accessed 13 Feb 2014.

  36. Perreault S: vCard Format Specification. 2011 http://tools.ietf.org/html/rfc6350. Accessed 13 Feb 2014.

  37. Iannella R, McKinney J: vCard Ontology. 2013 http://www.w3.org/TR/vcard-rdf/. Accessed 13 Feb 2014.

  38. DCMI Usage Board: DCMI Metadata Terms. 2012 http://dublincore.org/documents/dcmi-terms/. Accessed 13Feb 2014.

  39. Wolf M, Wicksteed C: Date and Time Formats. 1997 http://www.w3.org/TR/NOTE-datetime. Accessed 13 Feb 2014.

  40. Nilsson M, Powell A, Johnston P, Naeve A: Expressing Dublin Core metadata using the Resource Description Framework (RDF) http://dublincore.org/documents/dc-rdf/. Accessed 13 Feb 2014.

  41. Waltemath D, Bergmann FT, Adams R, Le Novère N: Simulation Experiment Description Markup Language (SED-ML): Level 1 Version 1. 2011 http://identifiers.org/combine.specifications/sed-ml.level-1.version-1. Accessed 14 Feb 2014.

  42. Olivier BG, Rohwer JM, Hofmeyr JS: Modelling cellular systems with PySCeS. Bioinformatics. 2005, 21: 560-561. 10.1093/bioinformatics/bti046.

    Article  PubMed  CAS  Google Scholar 

  43. Loew LM, Schaff JC: The virtual cell: a software environment for computational cell biology. TRENDS Biotechnol. 2001, 19: 401-406. 10.1016/S0167-7799(01)01740-1.

    Article  PubMed  CAS  Google Scholar 

  44. Integrated Python Based Modeling Environment http://tellurium.analogmachine.org. Accessed 2 July 2014.

  45. Nickerson D, Buist M: Practical application of CellML 1.1: the integration of new mechanisms into a human ventricular myocyte model. Prog Biophys Mol Biol. 2008, 98: 38-51. 10.1016/j.pbiomolbio.2008.05.006.

    Article  PubMed  CAS  Google Scholar 

  46. FDA center for drug evaluation and research: Model/Data Format. http://www.fda.gov/AboutFDA/CentersOffices/OfficeofMedicalProductsandTobacco/CDER/ucm180482.htm. Accessed 26 February 2014.

  47. TS-140. The record layout of a data set in SAS transport (XPORT) format. http://support.sas.com/techsup/technote/ts140.html. Accessed 26 February 2014.

  48. Thiele I, Swainston N, Fleming RMT, Hoppe A, Sahoo S, Aurich MK, Haraldsdottir H, Mo ML, Rolfsson O, Stobbe MD, Thorleifsson SG, Agren R, Bölling C, Bordel S, Chavali AK, Dobson P, Dunn WB, Endler L, Goryanin I, Gudmundsson S, Hala D, Hucka M, Hull D, Jameson D, Jamshidi N, Jonsson JJ, Juty N, Keating S, Nookaew I, Le Novère N, et al: A community-driven global reconstruction of human metabolism. Nat Biotechnol. 2013, 31: 419-425. 10.1038/nbt.2488.

    Article  PubMed  CAS  Google Scholar 

  49. Karr JR, Sanghvi JC, Macklin DN, Gutschow MV, Jacobs JM, Bolival B, Assad-Garcia N, Glass JI, Covert MW: A whole-cell computational model predicts phenotype from genotype. Cell. 2012, 150: 389-401. 10.1016/j.cell.2012.05.044.

    Article  PubMed Central  PubMed  CAS  Google Scholar 

  50. Schliess F, Hoehme S, Henkel SG, Ghallab A, Driesch D, Böttger J, Guthke R, Pfaff M, Hengstler JG, Gebhardt R, Häussinger D, Drasdo D, Zellmer S: Integrated metabolic spatial-temporal model for the prediction of ammonia detoxification during liver damage and regeneration. Hepatology 2014 advanced online publication doi:10.1002/hep.27136,

  51. Mattioni M, Le Novère N: Integration of biochemical and electrical signaling - multiscale model of the medium spiny neuron of the striatum. PLoS One. 2013, 8: e66811-10.1371/journal.pone.0066811.

    Article  PubMed Central  PubMed  CAS  Google Scholar 

  52. Functional Curation for Cardiac Electrophysiology https://chaste.cs.ox.ac.uk/FunctionalCuration. Accessed 27 May 2014.

  53. Scharm M, Wendland F, Peters M, Wolfien M, Theile T, Waltemath D: The CombineArchive Toolkit - facilitating the transfer of research results. PeerJ PrePrints 2:e514v1 http://dx.doi.org/10.7287/peerj.preprints.514v1.

  54. Butterworth E, Jardine BE, Raymond GM, Neal ML, Bassingthwaighte JB: JSim, an open-source modeling system for data analysis. F1000Research 2013 (doi:10.12688/f1000research.2-288.v1).,

  55. Soiland-Reyes S: Wf4Ever Research Object Bundle 2013 http://purl.org/wf4ever/ro-bundle/2013-05-21/. Accessed 13 Feb 2014.

  56. Hettne KM, Dharuri H, Garrido J, De Roure D, Corcho O, Klyne G, van Schouwen R, 't Hoen PAC, Bechhofer S, Goble C, Roos M, Zhao J, Wolstencroft K, Belhajjame K, Soiland-Reyes S, Mina E, Thompson M, Cruickshank D, Verdes-Montenegro L: Structuring research methods and data with the Research Object model: genomics workflows as a case study. J Biomed Semant. 2014; 5(41) doi:10.1186/2041-1480-5-41.,

  57. Universal Container Format: https://wikidocs.adobe.com/wiki/display/PDFNAV/Universal+Container+Format. Accessed 27 Feb 2014.

  58. Soiland-Reyes S, Gamble M: ro-combine-archive 0.1.0. ZENODO (2014). https://github.com/stain/ro-combine-archive doi:10.5281/zenodo.10439.

  59. EPUB Open Container Format (OCF) 3.0. http://www.idpf.org/epub/30/spec/epub30-ocf.html. Accessed 05 March 2014.

  60. Open Packaging Convention. http://en.wikipedia.org/wiki/Open_Packaging_Convention. Accessed 05 March 2014.

  61. Smallbone K: Striking a balance with Recon 2.1. 2014, arXiv:1311.5696

Download references

Acknowledgements

SM, MG, CL received funding from the Innovative Medicines Initiative Joint Undertaking (grant agreement no. 115156, DDMoRe). JC was supported through the EPSRC Cross-Disciplinary Interface Programme (grant number EP/I017909/1) and Microsoft Research Ltd. MH and NR were supported by US National Institute of General Medical Sciences (GM070923). DPN is supported by The Virtual Physiological Rat Project (NIH P50-GM094503) and the Maurice Wilkins Centre for Molecular Biodiversity. BO is supported by a ZonMW Zenith grant 40-41009-98-10038. HMS was partly supported by US National Institute of General Medical Sciences (R01GM081070). MS and DW are funded by the German Federal Ministry of Education and Research (e:Bio program SEMS, FKZ 031 6194). SSR was supported by the EU (FP7 RI-283359 and FP7-ICT-2007-6 270192). NR and NLN were supported by the UK Biotechnology and Biological Science Research Council (BBS/E/B/000C0419).

Author information

Authors and Affiliations

Authors

Corresponding author

Correspondence to Nicolas Le Novère.

Additional information

Competing interests

The authors declare that they have no competing interests.

Authors’ contributions

FTB, RA, NLN wrote the initial version of COMBINE Archive, SM, JC, MaGo, MH, CL, AKM,, DPN, SSR, NR, HMS, DW contributed to the current specification, SM, MiGl, BO, MS, FY, SSR developed implementations. All authors contributed to the manuscript. All authors read and approved the final manuscript.

Electronic supplementary material

12859_2014_369_MOESM1_ESM.zip

Additional file 1: COMBINE Archive containing a model of the Repressilator encoded in SBML and the simulation experiment description provided as supporting information for [ [9]]. (ZIP 9 KB)

12859_2014_369_MOESM2_ESM.zip

Additional file 2: COMBINE Archive containing the expanded version of the Recon1.1 model [ [61]]. (ZIP 22 MB)

Authors’ original submitted files for images

Rights and permissions

Open Access  This article is licensed under a Creative Commons Attribution 4.0 International License, which permits use, sharing, adaptation, distribution and reproduction in any medium or format, as long as you give appropriate credit to the original author(s) and the source, provide a link to the Creative Commons licence, and indicate if changes were made.

The images or other third party material in this article are included in the article’s Creative Commons licence, unless indicated otherwise in a credit line to the material. If material is not included in the article’s Creative Commons licence and your intended use is not permitted by statutory regulation or exceeds the permitted use, you will need to obtain permission directly from the copyright holder.

To view a copy of this licence, visit https://creativecommons.org/licenses/by/4.0/.

The Creative Commons Public Domain Dedication waiver (https://creativecommons.org/publicdomain/zero/1.0/) applies to the data made available in this article, unless otherwise stated in a credit line to the data.

Reprints and permissions

About this article

Check for updates. Verify currency and authenticity via CrossMark

Cite this article

Bergmann, F.T., Adams, R., Moodie, S. et al. COMBINE archive and OMEX format: one file to share all information to reproduce a modeling project. BMC Bioinformatics 15, 369 (2014). https://doi.org/10.1186/s12859-014-0369-z

Download citation

  • Received:

  • Accepted:

  • Published:

  • DOI: https://doi.org/10.1186/s12859-014-0369-z

Keywords