Skip to content

Latest commit

 

History

History
82 lines (64 loc) · 8.03 KB

YamlFormat.md

File metadata and controls

82 lines (64 loc) · 8.03 KB

FAIR Genomes YAML format

The FAIR Genomes metadata schema is expressed in a YAML file with a particular structure which is documented below.

Root-level attributes

Attribute Description
name Name of this schema.
description Description of this schema.
version Schema version number, in decimal format.
releaseType Type of project release. SNAPSHOT denotes development, Minor (x.x) or Major (x.0) denotes an official release.
date Date of a Minor or Major release.
lookupGlobalOptions Special lookups that are added to every other lookup list in the schema, unless specified otherwise.
authors A list of contributing schema authors.
copyright A copyright statement about the schema.
license The license under which the schema is released.
technical Specialized options required to generate project artifacts.
modules The actual components of the schema, comparable to classes or tables.

Authors attributes

Attribute Description
name Name of this author.
email Email address of this author.
orcid ORCID of this author.

Copyright attributes

Attribute Description
holder Name of the copyright holder.
years Year of publication and latest revision.

License attributes

Attribute Description
name Name of the active license.
url URL where license can be found.

Technical attributes

Attribute Description
artDecorId Project identifier in the ART-DECOR platform.
ttlLocation Hosting location of the application ontology.
gitLocation GitHub repository location of the project.

Modules attributes

Attribute Description
name Name of this module
description Description of this module, usually adapted from an ontology.
ontology Ontology term that best described this module.
relationWith Described the relationship with one or more other modules in the schema.
elements The elements contained in this module, comparable to attributes, columns or features.

relationWith attributes

Attribute Description
module The module that this module is related to in some way.
relation Ontology term that best describes the relation between two modules.

Elements attributes

Attribute Description
name Name of this element.
description Description of this element, usually adapted from an ontology.
ontology Ontology term that best described this element.
values Value type of this element. See ValueType.java for all options. When using lookups, the additional ofType ontology is used to denote lookup type, e.g. lookup options for Medication are of type ATC codes.
unit Optional ontology term to denote the unit of measurement.
broadMatch Optional ontology term to denote a broad match. See explanation at Match.java.
exactMatch Optional ontology term to denote an exact match. See explanation at Match.java.
relatedMatch Optional ontology term to denote a related match. See explanation at Match.java.
closeMatch Optional ontology term to denote a close match. See explanation at Match.java.
narrowMatch Optional ontology term to denote a narrow match. See explanation at Match.java.