Bco-domains: Difference between revisions
No edit summary |
|||
| (6 intermediate revisions by one other user not shown) | |||
| Line 1: | Line 1: | ||
'''Go back to [[Main_Page|BioCompute Objects]].''' | |||
== BCO domains == | == BCO domains == | ||
A BCO JSON object is split into different parts, or domains, detailed below. | A [[Main Page|BCO]] JSON object is split into different parts, or domains, detailed below. | ||
Condensed example: | Condensed example: | ||
| Line 24: | Line 26: | ||
"error_domain": { | "error_domain": { | ||
} | } | ||
=== BioCompute Objects Visualization === | |||
An Observable documentation showing a visualization of a BCO object workflow can be found [https://observablehq.com/@neurogenomics/biocompute-objects-visualization-student-workflows here]. | |||
=== Top Level Fields === | === Top Level Fields === | ||
| Line 31: | Line 36: | ||
Definition: | Definition: | ||
* Top-level fields | * [[Top-level|Top-level fields]] | ||
The remaining top-level fields detail different domains of the BCO, as listed below. | The remaining top-level fields detail different domains of the BCO, as listed below. | ||
=== Provenance Domain “provenance_domain” === | |||
The provenance_domain defines the history, version and status of this BCO as part of the review process. | |||
Definition: | |||
*[[Provenance-domain|Provenance domain]] | |||
=== Usability Domain “usability_domain” === | |||
The usability_domain is meant to improve searchability by allowing a free-text description of the BCO. | |||
Definition: | |||
* [[Usability-domain|Usability domain]] | |||
=== Extension Domain “extension_domain” === | |||
The extension_domain is a space for a user to add additional structured information that is not defined in the BioCompute schema. While the extension_domain is not defined by IEEE-2791-2020, each extension in the extension domain must provide a reference to the schema that defines it in order to validate. The extension domain is the place to add any additional structured information. We provide an example here that is neither exclusive nor exhaustive. | |||
Definitions: | |||
*[[Extension-domain|Extension domain]] | |||
=== Description Domain “description_domain” === | |||
The description_domain contains a structured field for the description of external references, the pipeline steps, and the relationship of I/O objects. | |||
Definition: | |||
*[[Description-domain|Description domain]] | |||
=== Execution Domain “execution_domain” === | |||
The execution_domain contains fields for the execution of the BCO. | |||
Definition: | |||
*[[Execution-domain|Execution domain]] | |||
=== Parametric Domain “parametric_domain” === | |||
The parametric_domain represents the list of parameters customizing the computational flow which can affect the output of the calculations. | |||
Definition: | |||
*[[Parametric-domain|Parametric domain]] | |||
=== Input and Output Domain “io_domain” === | |||
The io_domain represents the list of global input and output files created by the computational workflow. | |||
Definition: | |||
*[[Iodomain|Input and Output domain]] | |||
=== Error Domain, acceptable range of variability “error_domain” === | |||
The error_domain defines the empirical and algorithmic limits and error sources of the BCO. | |||
Definition: | |||
*[[Error-domain|Error domain]] | |||
Latest revision as of 17:53, 29 January 2026
Go back to BioCompute Objects.
BCO domains
A BCO JSON object is split into different parts, or domains, detailed below.
Condensed example:
"spec_version" : "https://w3id.org/biocompute/1.3.0/", "object_id": "https://example.com/bco/9487ae7e-c1aa-4a3c-b18f-3d3695b33ace", "type": "antiviral_resistance_detection", "etag": "584C7FE128717E1712426AB19CAAEA8BC1E27365B54285BBEA1221284C7D3A48", "provenance_domain": { }, "usability_domain": [ ], "extension_domain":{ }, "description_domain": { }, "execution_domain": { }, "parametric_domain": { }, "io_domain": { }, "error_domain": { }
BioCompute Objects Visualization
An Observable documentation showing a visualization of a BCO object workflow can be found here.
Top Level Fields
The top-level JSON object of a BCO includes attributes to define the BCO itself.
Definition:
The remaining top-level fields detail different domains of the BCO, as listed below.
Provenance Domain “provenance_domain”
The provenance_domain defines the history, version and status of this BCO as part of the review process.
Definition:
Usability Domain “usability_domain”
The usability_domain is meant to improve searchability by allowing a free-text description of the BCO.
Definition:
Extension Domain “extension_domain”
The extension_domain is a space for a user to add additional structured information that is not defined in the BioCompute schema. While the extension_domain is not defined by IEEE-2791-2020, each extension in the extension domain must provide a reference to the schema that defines it in order to validate. The extension domain is the place to add any additional structured information. We provide an example here that is neither exclusive nor exhaustive.
Definitions:
Description Domain “description_domain”
The description_domain contains a structured field for the description of external references, the pipeline steps, and the relationship of I/O objects.
Definition:
Execution Domain “execution_domain”
The execution_domain contains fields for the execution of the BCO.
Definition:
Parametric Domain “parametric_domain”
The parametric_domain represents the list of parameters customizing the computational flow which can affect the output of the calculations.
Definition:
Input and Output Domain “io_domain”
The io_domain represents the list of global input and output files created by the computational workflow.
Definition:
Error Domain, acceptable range of variability “error_domain”
The error_domain defines the empirical and algorithmic limits and error sources of the BCO.
Definition: