Data Product Ro Crate

The RO Crate for a DataProduct.

An RO Crate is research object (RO) that has been packaged up, in this case as a zip file. This research object is centred around the creation of a DataProduct. The DataProduct file is packaged up along with any other local files that were used to produce it. Also included in the RO Crate is the metadata file ro-crate-metadata.json. The ro-crate-metadata.json file is made available under the CC0 Public Domain Dedication. Please note individual files may have their own licenses. All of the packaged files are represented as File data entities in the metadata file.

External files may point directly to data, in which case they will be used directly as inputs to a CodeRun. External files will have a link to them in the metadata file, but will not be packaged in the zip file. However, it maybe that data has had to be extracted from an external file before it can be used by a CodeRun, i.e. from a journal article, In which case there will be an associated DataProduct that would have been made to contain the data so that it can be used in a CodeRun. If this is the case the relationship between the external file and DataProduct is modelled as a RO Crate ContextEntity of type CreateAction.

The CodeRun has been modelled as a RO Crate ContextEntity of type CreateAction, see software-used-to-create-files.

A CreateAction has instrument property, which represents the software used to generate the product. For our purposes instrument is the link to the repo.

CreateAction (CodeRun) properties:

instrument: the software used to generate the output
object: the input files
result: the output file
agent: the Author

The RO Crate is available as a zip file.

The contents of the ro-crate-metadata file can be viewed as JSON or JSON-LD.

Query parameters:

depth (optional): An integer used to determine how many code runs to include, the default is 1.

GET /api/ro-crate/data-product/1/

HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "@context": "https://w3id.org/ro/crate/1.1/context",
    "@graph": [
        {
            "@id": "./",
            "@type": "Dataset",
            "datePublished": "2024-05-19T21:48:27.401728",
            "publisher": "FAIR Data Pipeline",
            "name": "RO Crate for SEIRS_model/parameters",
            "license": {
                "@id": "https://creativecommons.org/licenses/by/4.0/"
            },
            "hasPart": [
                {
                    "@id": "https://doi.org/10.1038/s41592-020-0856-2"
                }
            ]
        },
        {
            "@id": "ro-crate-metadata.json",
            "@type": "CreativeWork",
            "conformsTo": {
                "@id": "https://w3id.org/ro/crate/1.1"
            },
            "about": {
                "@id": "./"
            },
            "license": {
                "@id": "https://creativecommons.org/publicdomain/zero/1.0/"
            }
        },
        {
            "@id": "https://creativecommons.org/licenses/by/4.0/",
            "@type": "CreativeWork",
            "description": "Attribution 4.0 International",
            "identifier": "https://creativecommons.org/licenses/by/4.0/",
            "name": "CC BY 4.0"
        },
        {
            "@id": "https://creativecommons.org/publicdomain/zero/1.0/",
            "@type": "CreativeWork",
            "description": "CC0 1.0 Universal (CC0 1.0) Public Domain Dedication",
            "identifier": "https://creativecommons.org/publicdomain/zero/1.0/",
            "name": "CC0 Public Domain Dedication"
        },
        {
            "@id": "https://doi.org/10.1038/s41592-020-0856-2",
            "@type": "File",
            "name": "Static parameters of the model",
            "datePublished": "2021-09-20 12:00:00+00:00",
            "author": [
                {
                    "@id": "https://github.com/RyanJField"
                }
            ]
        },
        {
            "@id": "https://github.com/RyanJField",
            "@type": "Person",
            "name": "Ryan J Field"
        }
    ]
}