Skip to content

Instances: Core Structure

A template instance is an instance artifact. It holds metadata that conforms to a template. In YAML it identifies its template with isBasedOn. As with template and element artifacts, instances hold a value for each field or nested element under children, keyed by the child's name.

type: instance
name: SDY232
description: Metadata for the SDY232 cardiology study
id: https://repo.metadatacenter.org/template-instances/1f9a2b3
isBasedOn: https://repo.metadatacenter.org/templates/ec3f500
children:
  Study Name:
    value: Cardiology cohort

Field values

Which keys a field's value carries depends on the kind of value. A plain literal carries just value. A typed literal adds datatype. A controlled term carries id with a label.

type: instance
name: SDY232
isBasedOn: https://repo.metadatacenter.org/templates/ec3f500
children:
  Study Name:
    value: Cardiology cohort
  Participants:
    value: 2323
    datatype: xsd:int
  Disease:
    id: http://purl.obolibrary.org/obo/DOID_530
    label: eyelid disease

A field with no value is omitted from children entirely.

A controlled term value can carry two further labels drawn from its vocabulary. prefLabel holds the term's preferred label, the canonical name the vocabulary assigns it, which may differ from the label shown to the author. notation holds the term's short code or accession within the vocabulary.

  Disease:
    id: http://purl.obolibrary.org/obo/DOID_530
    label: eyelid disease
    prefLabel: eyelid disease
    notation: DOID:530

Multiple values

A field that accepts more than one value holds a list under its name. Each entry has the same shape it would have as a single value. For a plain literal field, each entry carries a value.

  Keywords:
  - value: genomics
  - value: oncology

A controlled-term field behaves the same way. Each entry is a full controlled term, carrying its id and label.

  Conditions:
  - id: http://purl.obolibrary.org/obo/DOID_2841
    label: asthma
  - id: http://purl.obolibrary.org/obo/DOID_10763
    label: hypertension