A metamodel for defining biolink related schemas
Classes
- AltDescription - an attributed description
- Element - a named element in the model
- Example - usage example and description
- Extension - a tag/value pair used to add non-model information to an entry
- Annotation - a tag/value pair with the semantics of OWL Annotation
- LocalName - an attributed label
- PermissibleValue - a permissible value, accompanied by intended text and an optional mapping to a concept URI
- Prefix - prefix URI tuple
Mixins
- Annotatable - mixin for classes that support annotations
- Extensible - mixin for classes that support extension
Slots
- abstract - an abstract class is a high level class or slot that is typically used to group common slots together and cannot be directly instantiated.
- alias - the name used for a slot in the context of its owning class. If present, this is used instead of the actual slot name.
- aliases
- alt_description➞source - the source of an attributed description
- alt_description➞description - text of an attributed description
- alt_descriptions
- apply_to - Used to extend class or slot definitions. For example, if we have a core schema where a gene has two slots for identifier and symbol, and we have a specialized schema for my_organism where we wish to add a slot systematic_name, we can avoid subclassing by defining a class gene_my_organism, adding the slot to this class, and then adding an apply_to pointing to the gene class. The new slot will be ‘injected into’ the gene class.
- attributes - Inline definition of slots
- base - python base type that implements this type definition
- class_uri - URI of the class in an RDF environment
- classes - class definitions
- code_set - the identifier of an enumeration code set.
- code_set_tag - the version tag of the enumeration code set
- code_set_version - the version identifier of the enumeration code set
- comments - notes and comments about an element intended for external consumption
- created_by - agent that created the element
- created_on - time at which the element was created
- default_curi_maps - ordered list of prefixcommon biocontexts to be fetched to resolve id prefixes and inline prefix variables
- default_prefix - default and base prefix – used for ‘:’ identifiers, @base and @vocab
- default_range - default slot range to be used if range element is omitted from a slot definition
- defining_slots - The combination of is a plus defining slots form a genus-differentia definition, or the set of necessary and sufficient conditions that can be transformed into an OWL equivalence axiom
- definition_uri - the “native” URI of the element
- deprecated - Description of why and when this element will no longer be used
- deprecated element has exact replacement - When an element is deprecated, it can be automatically replaced by this uri or curie
- deprecated element has possible replacement - When an element is deprecated, it can be potentially replaced by this uri or curie
- description - a description of the element’s purpose and use
- domain - defines the type of the subject of the slot. Given the following slot definition
- domain_of - the class(es) that reference the slot in a “slots” or “slot_usage” context
- emit_prefixes - a list of Curie prefixes that are used in the representation of instances of the model. All prefixes in this list are added to the prefix sections of the target models.
- enums - enumerated ranges
- examples - example usages of an element
- extension➞tag - a tag associated with an extension
- extension➞value - the actual annotation
- extensions - a tag/text tuple attached to an arbitrary element
- annotations - a collection of tag/text tuples with the semantics of OWL Annotation
- from_schema - id of the schema that defined the element
- generation_date - date and time that the schema was loaded/generated
- id - The official schema URI
- id_prefixes - the identifier of this class or slot must begin with one of the URIs referenced by this prefix
- identifier - True means that the key slot(s) uniquely identify the container. There can be at most one identifier or key per container
- ifabsent - function that provides a default value for the slot. Possible values for this slot are defined in biolink.utils.ifabsent_functions.default_library:
- imported_from - the imports entry that this element was derived from. Empty means primary source
- imports - other schemas that are included in this schema
- in_subset - used to indicate membership of a term in a defined subset of biolink terms used for a particular domain or application (e.g. the translator_minimal subset holding the minimal set of predicates used in a translator knowledge graph)
- inherited - true means that the value of a slot is inherited by subclasses
- inlined - True means that keyed or identified slot appears in an outer structure by value. False means that only the key or identifier for the slot appears within the domain, referencing a structure that appears elsewhere.
- inlined_as_list - True means that an inlined slot is represented as a list of range instances. False means that an inlined slot is represented as a dictionary, whose key is the slot key or identifier and whose value is the range instance.
- inverse - indicates that any instance of d s r implies that there is also an instance of r s’ d
- is_a - specifies single-inheritance between classes or slots. While multiple inheritance is not allowed, mixins can be provided effectively providing the same thing. The semantics are the same when translated to formalisms that allow MI (e.g. RDFS/OWL). When translating to a SI framework (e.g. java classes, python classes) then is a is used. When translating a framework without polymorphism (e.g. json-schema, solr document schema) then is a and mixins are recursively unfolded
- is_class_field - indicates that any instance, i, the domain of this slot will include an assert of i s range
- is_usage_slot - True means that this slot was defined in a slot_usage situation
- key - True means that the key slot(s) uniquely identify the container. In future releases, it will be possible for there to be compound keys, where several slots combine to produce a unique identifier
- last_updated_on - time at which the element was last updated
- license - license for the schema
- local_name_source - the ncname of the source of the name
- local_name_value - a name assigned to an element in a given ontology
- local_names
- mappings - A list of terms from different schemas or terminology systems that have comparable meaning. These may include terms that are precisely equivalent, broader or narrower in meaning, or otherwise semantically related but not equivalent from a strict ontological perspective.
- broad mappings - A list of terms from different schemas or terminology systems that have broader meaning.
- close mappings - A list of terms from different schemas or terminology systems that have close meaning.
- exact mappings - A list of terms from different schemas or terminology systems that have identical meaning.
- narrow mappings - A list of terms from different schemas or terminology systems that have narrower meaning.
- related mappings - A list of terms from different schemas or terminology systems that have related meaning.
- maximum_value - for slots with ranges of type number, the value must be equal to or lowe than this
- meaning - the value meaning (in the 11179 sense) of a permissible value
- metamodel_version - Version of the metamodel used to load the schema
- minimum_value - for slots with ranges of type number, the value must be equal to or higher than this
- mixin - this slot or class can only be used as a mixin – equivalent to abstract
- mixins - List of definitions to be mixed in. Targets may be any definition of the same type
- modified_by - agent that modified the element
- multivalued - true means that slot can have more than one value
- name - the unique name of the element within the context of the schema. Name is combined with the default prefix to form the globally unique subject of the target class.
- notes - editorial notes about an element intended for internal consumption
- owner - the “owner” of the slot. It is the class if it appears in the slots list, otherwise the declaring slot
- pattern - the string value of the slot must conform to this regular expression
- permissible_values - A list of possible values for a slot range
- prefix_prefix - the nsname (sans ‘:’ for a given prefix)
- prefix_reference - A URI associated with a given prefix
- prefixes - prefix / URI definitions to be added to the context beyond those fetched from prefixcommons in id prefixes
- pv_formula - Defines the specific formula to be used to generate the permissible values.
- range - defines the type of the object of the slot. Given the following slot definition
- readonly - If present, slot is read only. Text explains why
- repr - the name of the python object that implements this type definition
- required - true means that the slot must be present in the loaded definition
- role - the role played by the slot range
- see_also - a reference
- singular_name - a name that is used in the singular form
- schema_definition➞slots - slot definitions
- slot_uri - predicate of this slot for semantic web application
- slot_usage - the redefinition of a slot in the context of the containing class definition.
- slots - list of slot names that are applicable to a class
- source_file - name, uri or description of the source of the schema
- source_file_date - modification date of the source of the schema
- source_file_size - size in bytes of the source of the schema
- status - status of the element
- string_serialization - Used on a slot that stores the string serialization of the containing object. The syntax follows python formatted strings, with slot names enclosed in {}s. These are expanded using the values of those slots.
- subclass_of - rdfs:subClassOf to be emitted in OWL generation
- subproperty_of - Ontology property which this slot is a subproperty of
- subsets - list of subsets referenced in this model
- symmetric - True means that any instance of d s r implies that there is also an instance of r s d
- text
- title - the official title of the schema
- todos - Outstanding issue that needs resolution
- tree_root - indicator that this is the root class in tree structures
- type_definition➞uri - The uri that defines the possible values for the type definition
- typeof - Names a parent type
- types - data types used in the model
- union_of - indicates that the domain class consists exactly of the members of the classes in the range
- usage_slot_name - The name of the slot referenced in the slot_usage
- value - example value
- example➞description - description of what the value is doing
- values_from - the identifier of a “value set” – a set of identifiers that form the possible values for the range of a slot
- version - particular version of schema
Types
Built in
- Bool
- Decimal
- ElementIdentifier
- NCName
- NodeIdentifier
- URI
- URIorCURIE
- XSDDate
- XSDDateTime
- XSDTime
- float
- int
- str
Defined
- Boolean (Bool) - A binary (true or false) value
- Date (XSDDate) - a date (year, month and day) in an idealized calendar
- Datetime (XSDDateTime) - The combination of a date and time
- Decimal (Decimal) - A real number with arbitrary precision that conforms to the xsd:decimal specification
- Double (float) - A real number that conforms to the xsd:double specification
- Float (float) - A real number that conforms to the xsd:float specification
- Integer (int) - An integer
- Ncname (NCName) - Prefix part of CURIE
- Nodeidentifier (NodeIdentifier) - A URI, CURIE or BNODE that represents a node in a model.
- Objectidentifier (ElementIdentifier) - A URI or CURIE that represents an object in the model.
- String (str) - A character string
- Time (XSDTime) - A time object represents a (local) time of day, independent of any particular day
- Uri (URI) - a complete URI
- Uriorcurie (URIorCURIE) - a URI or a CURIE