Iodomain

From BCOeditor Wiki
Jump to navigation Jump to search

Required fields for I/O Domain

  • "Input_subdomain"
    • "URI"
    • "output_subdomain"
    • "mediatype"
    • "URI"

Input and Output Domain "io_domain"

This section defines the io_domain part of the BCO.

This represents the list of global input and output files created by the computational workflow, excluding the intermediate files. These fields are pointers to objects that can reside in the system performing the computation or any other accessible system. Just like the fields of the parametric domain, these fields are expected to vary depending on the specific BCO implementation and can refer to named input-output arguments of underlying pipelines. Please refer to the documentation of individual scripts and specific BCO descriptions for further details.

Condensed example:

       "io_domain": {
               "input_subdomain": [
               ], 
               "output_subdomain": [
               ]
       }

Input Subdomain “input_subdomain”

This field records the references and input files for the entire pipeline. Each input file is listed as a uri object. This allows the author to be very specific about a particular type of input file if they so choose. For example, reference files have common names, and adding the common name here, in addition to the uri would make this more readable and understandable (eg, "HCV reference version..." or "human reference GRCH38"). For data integration workflows, the input files can be a table downloaded from a specific source which is then filtered for modification using rules described in the BCO. It is recommended that the values here include filename, uri, and access_time.

       "input_subdomain": [
           {
               "uri": {
                   "filename": "Hepatitis C virus genotype 1", 
                   "uri": "http://www.ncbi.nlm.nih.gov/nuccore/22129792",
                   "access_time": "2017-01-24T09:40:17-0500"
               }
           }, 
           {
               "uri": {
                   "filename": "Hepatitis C virus type 1b complete genome", 
                   "uri": "http://www.ncbi.nlm.nih.gov/nuccore/5420376",
                   "access_time": "2017-01-24T09:40:17-0500"
               }
           }
       ]

Output Subdomain “output_subdomain”

This field records the outputs for the entire pipeline. Each output object is represented as a uri with the addition of a mediatype value.

       "output_subdomain": [
           {
               "mediatype": "text/csv", 
               "uri": { 
                   "uri": "http://example.com/data/514769/dnaAccessionBased.csv",
                   "access_time": "2017-01-24T09:40:17-0500"
               }
           },
           {
               "mediatype": "text/csv", 
               "uri": {
                   "uri": "http://example.com/data/514801/SNPProfile*.csv",
                   "access_time": "2017-01-24T09:40:17-0500"
               }
           }
       ]