Biolink Model is a high-level data model built to provide a schema for representing biological and biomedical knowledge. The model itself is agnostic to the graph formalism used to represent knowledge. i.e. You can use Biolink Model as a schema for labelled property graphs (Neo4j) or for edge labelled graphs (RDF).
Biolink Model was built with the following aims:
- Bridge between labelled property graphs and edge labelled graphs
- Formal representation where the semantics are well defined within the model
- Focus on the actual schema and its semantics instead of being weighed down by limitations of a technology
- Extensible, self-documenting, and unambiguous
- Maps to external ontologies, thesauri, controlled vocabularies, and taxonomies
To that end, Biolink Model makes use of linkML (Biolink Modeling Language) for defining the various semantics of the model.
linkML is a general purpose modeling language that follows object-oriented and ontological principles. The modeling language inherits features from the Web Ontology Language (OWL) and thus is capable of representing semantics in addition to the standard object-oriented hierarchy of a data model.
Models are authored in YAML; using linkML one can generate a variety of artifacts including JSON-Schema, OWL, RDF, Python data classes, Shape Expressions, and Markdown.
The modeling language provides the following idioms,
- Class definition
- Used to define classes
- Slot definition
- Used to define class properties
- Type definition
- Used to define data types
- Schema definition
- Used to define properties of the model itself
Refer to linkML on GitHub for a more detailed guide on linkML.
Note: Biolink Model is authored using linkML. While Biolink Model and linkML share a “Biolink” in its name, that is where the similarities end. One can use linkML to author any schema for any domain.
Biolink Model is a high-level data model where entities, associations, and predicates are arranged in a hierarchy. The model also defines node properties, edge properties, and types.
The model itself is organized using linkML Class definition (class), Slot definition (slot), Type definition (type) and Schema definition.
In Biolink Model YAML any class, slot, or type is defined in
sentence caseform. When this model is compiled to various forms (like JSON-Schema, OWL, Markdown) the representation is based on the following convention,
- classes are named in
- slots are named in
- types are named in
To avoid ambiguity in semantics, prefixes are MUST for classes and certain slots.
To avoid ambuguity it semantics, prefixes are RECOMMENDED for all slots.
At a glance the structure is as follows,
A class represents an entity or an association. A class can have one more more slots (properties).
In RDF sense, a class is basically
Within the Biolink Model there are two hierarchies of classes:
where Named Things are disjoint from Associations.
But they do share a common ancestor class:
Named Things are classes that represent real world entities such as genes, diseases, chemical substances, etc.
In a graph formalism, ‘Named Things’ are represented by nodes in a graph.
Each class in the
named thing has one or more slots (properties).
The root of all entities is the
named thing class.
Note: While we say
named thingwhen defining the model using linkML, the actual CURIE for this class is
Associations are classes that represent an assertion or statement.
In RDF sense, an association is an
In a graph formalism, associations are represented using edges in a graph.
Each class has one or more slots (or properties).
The root of all associations is the
Note: While we say
associationwhen defining the model using linkML, the acutal CURIE for this class is
Mixins are classes that contain slots (properties) or slots which embody a generic slot semantic definition, for use across several other classes or slots.
Mixins are abstract classes/slots and they cannot be instantiated by themselves. That is, there cannot be an instance of a mixin class or slot value (e.g. predicate slot) used as ‘data’.
However, a class
mixin may be given as the
range specification of an association or a
mixin slot may be given as a
subproperty_of constraint, with the strict understanding that when the given association or slot is deployed as an element in a knowledge graph, that the actual values used in the instantiated nodes and edges of the graph will be “concrete” classes or slots that have or inherited those
mixin elements as
Mixins are defined as a way of encouraging reuse of specific slots (properties) while ensuring a clear inheritance chain.
For example, the
entity to feature or disease qualifiers class is a mixin that defines slots
severity qualifier and
onset qualifier. The mixin also inherits the slot
frequency qualifier from its parent mixin class
frequency qualifier mixin.
The mixin class
entity to feature or disease qualifiers is used in the
entity to phenotypic feature association class and thus by design the class will have
onset qualifier, and
frequency qualifier in addition to all other slots it inherits from its own parent
Note: Even though
entity to phenotypic feature associationuses the mixin class
entity to feature or disease qualifiersthat does not mean that
entity to phenotypic feature associationis a child of
entity to feature or disease qualifiers. i.e. Mixins do not contribute to the inheritance hierarchy of the class that uses them.
In Biolink Model, slots represent properties that a class can have.
A slot is similar to
rdf:Property where it can link
- an instance of a class to another instance of a class
- an instance of a class to a literal/data type
In Biolink Model slots are used to represent
Predicates are slots that connect instances of classes.
In a graph formalism, predicates are relationships that link two instances.
In an OWL sense, predicates are similar to
For example, a predicate
treats can be used to link an instance of class
chemical substance with an instance of class
Node properties are slots that an entity class (i.e, a node) can have.
The root of all node properties is
node property slot.
In an OWL sense, node properties are similar to
xref are children of the
node property slot and they are assigned to the entity class
named thing. So all instances of this class can have
xref as properties that further describes the instance.
Note: In many cases you may see node properties without the
biolinkprefix. This is normal since we can assume that if there is a biolink typed node in a graph, with
nameas its properties, then they correspond to
biolink:name. But to be sure of the semantics it is advised to use the full CURIE to represent property names in your graph.
Edge properties are slots that an association class (i.e., an edge) can have.
The root of all edge properties is
association slot slot.
In an OWL sense, edge properties are similar to
object are children of the
association_slot slot and they are assigned to association class
association. So all instances of this class can have
object as its properties that further describes the instance.
Note: In many cases you may see edge properties without the
biolinkprefix. This is normal since we can assume that if there is a biolink typed edge in a graph with
objectas its properties then they correspond to
biolink:object, respectively. But to be sure of the semantics it is advised to use the full CURIE to represent property names in your graph.
linkML provides a handful of inbuilt data types. But you can also define custom data types using the modeling language.
In Biolink Model we have several data types.
Data types do not have any inheritance and thus are not arranged in any hierarchy.
iri type is a type defined in the Biolink Model where the value space is constrained to
uriorcurieis an inbuilt data type provided by linkML where the value space is constrained to either a URI or a CURIE representation.