API4KP Ontology of Series
type: Ontology
abstract: This ontology extends the core API4KP ontology to incorporate notions of snapshots and versions of knowledge artifacts as they change over time.
contributor: Elisa Kendall (ekendall at thematix.com)
creator: Davide Sottara (sottara.davide at mayo.edu)
license: http://opensource.org/licenses/MIT
imports: api4kp
imports: AnnotationVocabulary
imports: CodesAndCodeSets
imports: Collections
imports: Identifiers
imports: DOL-terms
imports: LanguageRepresentation
version IRI: api4kp-series
change note: The https://www.omg.org/spec/API4KP/20210201/api4kp-series.rdf version of this ontology was modified to leverage the Commons Ontology Library (API4KP-22), including replacement of references to Specification Metadata and references to LCC with the Commons Annotation Vocabulary and other Commons ontologies, and to reduce the dependency on DOL as appropriate.
copyright: Copyright (c) 2014-2023 Athan Services
copyright: Copyright (c) 2014-2023 Fraunhofer Gesellschaft
copyright: Copyright (c) 2014-2023 Freie Universität Berlin
copyright: Copyright (c) 2014-2023 Mayo Foundation for Medical Education and Research (MFMER)
copyright: Copyright (c) 2014-2023 Raytheon Technologies
copyright: Copyright (c) 2014-2023 Thematix Partners LLC
copyright: Copyright (c) 2015-2023 Object Management Group, Inc.
copyright: Copyright (c) 2019-2023 Universität Leipzig
copyright: Copyright (c) 2020-2023 Micro Focus

combined date time
type: Datatype
equivalent class: Datatype
  union of: string
  union of: dateTime
  union of: dateTimeStamp
definition: datatype that maps to several base types for dates and times
note: Valid values must use the ISO 8601 representation for a date, or the corresponding XML Schema Datatypes representation for a date and time, or date and time including the time zone.
scope note: There are many cases where the representation of a date may or may not include a time, and where the underlying data representation varies. This composite datatype should only be used in cases where a standard representation using one of the options in the union for date or date and time value specification does not work, for example, when resolution beyond microseconds is needed.

immutable
type: Class
disjoint with: mutable
definition: entity whose state does not, or cannot, change over time without preserving the identity of the entity

mutable
type: Class
definition: continuant entity whose state, determined by the configuration of its qualia, changes over time while maintaining a principle of identity

series
type: Class
subclass of: mutable
subclass of: Collection
subclass of: Restriction
  on property: is series of
  some values from: mutable
subclass of: Restriction
  on property: hasMember
  some values from: version
subclass of: Restriction
  on property: hasPart
  some values from: IdentificationScheme
definition: set of all versions of the same entity
note: The set is implicitly equipped with a total order determined by the points in time at which the snapshots were taken, as well as an identification scheme that supports version identifiers.

snapshot
type: Class
subclass of: immutable
definition: immutable entity that reflects and maintains the state of a mutable entity at a particular point in time

version
type: Class
subclass of: snapshot
equivalent class: Class
  intersection of: snapshot
  intersection of: Restriction
    on property: isIdentifiedBy
    some values from: Identifier
  intersection of: Restriction
    on property: has observed date and time
    some values from: combined date time
definition: snapshot was observed at some point in time and that is assigned an identifier in some context

version identifier
type: Class
subclass of: Identifier
subclass of: Restriction
  on property: hasPart
  some values from: Restriction
    on property: identifies
    some values from: mutable
subclass of: Restriction
  on property: identifies
  some values from: version
definition: identifier of a particular version of an entity, and has a part that identifies the entity (series) itself
example: the IRI / versionIRI pair used to identify versions of an OWL ontology
synonym: version-aware identifier

has latest
type: ObjectProperty
sub property of: hasMember
domain: series
range: version
definition: has member version that is the successor of every other member of the series, and does not have any successor itself
note: this property is mutable as the series mutates over time

has next version
type: ObjectProperty
sub property of: has successor version
inverse of: has previous version
definition: is a version V1 that has successor version V2, and there is no other distinct version that is successor of V1 and predecessor of V2
synonym: has next immediate version

has observed date and time
type: DatatypeProperty
type: FunctionalProperty
range: combined date time
definition: indicates a date and time for an event, measurement, snapshot or other observation

has original
type: ObjectProperty
sub property of: hasMember
domain: series
range: version
definition: has member version that is the predecessor of every other member of the series, and it is not possible for it to have any predecessor itself

has predecessor version
type: ObjectProperty
sub property of: is in series with
domain: version
range: version
inverse of: has successor version
definition: is in the same series with a version whose timestamp is before the timestamp of this version
synonym: has prior version

has previous version
type: ObjectProperty
sub property of: has predecessor version
definition: is a version V1 that has predecessor version V2, and there is no other distinct version that is predecessor of V1 and successor of V2
synonym: has previous immediate version

has snapshot
type: ObjectProperty
domain: mutable
range: snapshot
inverse of: is snapshot of
definition: had a state at some point in time that is reflected by the target immutable entity

has successor version
type: ObjectProperty
sub property of: is in series with
definition: is in the same series with a version whose timestamp is after the timestamp of this version

has version
type: ObjectProperty
sub property of: has snapshot
domain: mutable
range: version
inverse of: is version of
definition: has a snapshot that is explicitly identified

is in series with
type: ObjectProperty
type: SymmetricProperty
domain: snapshot
range: snapshot
definition: is a different snapshot of the same entity

is series of
type: ObjectProperty
domain: series
range: mutable
definition: is the set of all versions of the same mutable entity

is snapshot of
type: ObjectProperty
domain: snapshot
range: mutable
definition: reflects the state of, at a particular point in time

is version of
type: ObjectProperty
sub property of: is snapshot of
domain: version
range: mutable
definition: is an explicitly identified snapshot of the target entity