Schema for a generic (data) provenance annotation

This schema builds on the Thing schema, and diversifies it to capture the key provenance concepts Agent, Activity, Entity, and their relationships. It does that by drawing on (a subset) of the PROV data model PROV-DM.

Central paradigm of the schema is the qualified relation pattern. The three Thing derived key concepts Agent, Activity, and Entity build on the Thing slot relations (symmetric property) for inline declaration of related things, and extend the basic means of qualifying a relationship via characterized_by and with provenance specific slots, and qualified_relations for declaring the roles of related things.

Specifically the latter approach takes the place of all of the various qualified* properties defined in PROV. Rather than supporting association classes like prov:Derivation or prov:Generation, such relationships are annotated by linking to things via slots like derived_from or generated_by, and characterizing the relationship via qualified_relations, and a (custom) Role declaration.

The schema is entity-centric, meaning that entity properties are preferred over activity properties expressing the same (inverse) relationship. For example, an entity's generated_by is implemented, but not an activity's generated.

This schema also incorporates the schemas

• identifiers
• things
• roles
• spatial
• temporal

The schema definition is available as

• JSON-LD context
• LinkML YAML
• LinkML YAML (static/resolved)
• OWL TTL
• SHACL TTL

URI: https://concepts.datalad.org/s/prov/unreleased

Name: prov-schema

Schema Diagram

erDiagram
Activity {
    W3CISO8601 ended_at  
    W3CISO8601 started_at  
    uriorcurie pid  
    uriorcurieList broad_mappings  
    uriorcurieList close_mappings  
    string description  
    uriorcurieList exact_mappings  
    uriorcurieList narrow_mappings  
    uriorcurieList related_mappings  
    NodeUriOrCurie schema_type  
}
Agent {
    uriorcurie pid  
    uriorcurieList broad_mappings  
    uriorcurieList close_mappings  
    string description  
    uriorcurieList exact_mappings  
    uriorcurieList narrow_mappings  
    uriorcurieList related_mappings  
    NodeUriOrCurie schema_type  
}
Annotation {
    string annotation_value  
}
AttributeSpecification {
    uriorcurieList broad_mappings  
    uriorcurieList close_mappings  
    string description  
    uriorcurieList exact_mappings  
    uriorcurieList narrow_mappings  
    uriorcurieList related_mappings  
    NodeUriOrCurie schema_type  
    uriorcurie range  
    string value  
}
Checksum {
    uriorcurie creator  
    HexBinary notation  
    NodeUriOrCurie schema_type  
}
ComputedIdentifier {
    uriorcurie creator  
    string notation  
    NodeUriOrCurie schema_type  
}
DOI {
    string schema_agency  
    uriorcurie creator  
    string notation  
    NodeUriOrCurie schema_type  
}
Entity {
    uriorcurie pid  
    uriorcurieList broad_mappings  
    uriorcurieList close_mappings  
    string description  
    uriorcurieList exact_mappings  
    uriorcurieList narrow_mappings  
    uriorcurieList related_mappings  
    NodeUriOrCurie schema_type  
}
Identifier {
    uriorcurie creator  
    string notation  
    NodeUriOrCurie schema_type  
}
InstantaneousEvent {
    W3CISO8601 at_time  
    uriorcurie pid  
    uriorcurieList broad_mappings  
    uriorcurieList close_mappings  
    string description  
    uriorcurieList exact_mappings  
    uriorcurieList narrow_mappings  
    uriorcurieList related_mappings  
    NodeUriOrCurie schema_type  
}
IssuedIdentifier {
    string schema_agency  
    uriorcurie creator  
    string notation  
    NodeUriOrCurie schema_type  
}
Location {
    uriorcurie pid  
    uriorcurieList broad_mappings  
    uriorcurieList close_mappings  
    string description  
    uriorcurieList exact_mappings  
    uriorcurieList narrow_mappings  
    uriorcurieList related_mappings  
    NodeUriOrCurie schema_type  
}
Property {
    uriorcurie pid  
    uriorcurieList broad_mappings  
    uriorcurieList close_mappings  
    string description  
    uriorcurieList exact_mappings  
    uriorcurieList narrow_mappings  
    uriorcurieList related_mappings  
    NodeUriOrCurie schema_type  
}
Relationship {
    NodeUriOrCurie schema_type  
}
Role {
    uriorcurie pid  
    uriorcurieList broad_mappings  
    uriorcurieList close_mappings  
    string description  
    uriorcurieList exact_mappings  
    uriorcurieList narrow_mappings  
    uriorcurieList related_mappings  
    NodeUriOrCurie schema_type  
}
SoftwareAgent {
    uriorcurie pid  
    uriorcurieList broad_mappings  
    uriorcurieList close_mappings  
    string description  
    uriorcurieList exact_mappings  
    uriorcurieList narrow_mappings  
    uriorcurieList related_mappings  
    NodeUriOrCurie schema_type  
}
Statement {

}
Thing {
    uriorcurie pid  
    uriorcurieList broad_mappings  
    uriorcurieList close_mappings  
    string description  
    uriorcurieList exact_mappings  
    uriorcurieList narrow_mappings  
    uriorcurieList related_mappings  
    NodeUriOrCurie schema_type  
}
ThingMixin {
    uriorcurieList broad_mappings  
    uriorcurieList close_mappings  
    string description  
    uriorcurieList exact_mappings  
    uriorcurieList narrow_mappings  
    uriorcurieList related_mappings  
    NodeUriOrCurie schema_type  
}
TransientRelationship {
    W3CISO8601 started_at  
    W3CISO8601 ended_at  
    NodeUriOrCurie schema_type  
}
ValueSpecification {
    uriorcurie range  
    string value  
    uriorcurie pid  
    uriorcurieList broad_mappings  
    uriorcurieList close_mappings  
    string description  
    uriorcurieList exact_mappings  
    uriorcurieList narrow_mappings  
    uriorcurieList related_mappings  
    NodeUriOrCurie schema_type  
}
ValueSpecificationMixin {
    uriorcurie range  
    string value  
}

Activity ||--|o Location : "at_location"
Activity ||--}o Activity : "informed_by"
Activity ||--}o Agent : "associated_with"
Activity ||--}o Annotation : "annotations"
Activity ||--}o AttributeSpecification : "attributes"
Activity ||--}o Identifier : "identifiers"
Activity ||--}o Relationship : "qualified_relations"
Activity ||--}o Statement : "characterized_by"
Activity ||--}o Thing : "relations"
Agent ||--|o Location : "at_location"
Agent ||--}o Agent : "acted_on_behalf_of"
Agent ||--}o Annotation : "annotations"
Agent ||--}o AttributeSpecification : "attributes"
Agent ||--}o Identifier : "identifiers"
Agent ||--}o Relationship : "qualified_relations"
Agent ||--}o Statement : "characterized_by"
Agent ||--}o Thing : "relations"
Annotation ||--|o Thing : "annotation_tag"
AttributeSpecification ||--|| Property : "predicate"
AttributeSpecification ||--}o Annotation : "annotations"
AttributeSpecification ||--}o AttributeSpecification : "attributes"
AttributeSpecification ||--}o Statement : "characterized_by"
Entity ||--}o Activity : "generated_by"
Entity ||--}o Agent : "attributed_to"
Entity ||--}o Annotation : "annotations"
Entity ||--}o AttributeSpecification : "attributes"
Entity ||--}o Entity : "derived_from"
Entity ||--}o Identifier : "identifiers"
Entity ||--}o Relationship : "qualified_relations"
Entity ||--}o Statement : "characterized_by"
Entity ||--}o Thing : "relations"
InstantaneousEvent ||--}o Annotation : "annotations"
InstantaneousEvent ||--}o AttributeSpecification : "attributes"
InstantaneousEvent ||--}o Identifier : "identifiers"
InstantaneousEvent ||--}o Relationship : "qualified_relations"
InstantaneousEvent ||--}o Statement : "characterized_by"
InstantaneousEvent ||--}o Thing : "relations"
Location ||--}o Annotation : "annotations"
Location ||--}o AttributeSpecification : "attributes"
Location ||--}o Identifier : "identifiers"
Location ||--}o Relationship : "qualified_relations"
Location ||--}o Statement : "characterized_by"
Location ||--}o Thing : "relations"
Property ||--}o Annotation : "annotations"
Property ||--}o AttributeSpecification : "attributes"
Property ||--}o Statement : "characterized_by"
Property ||--}o Thing : "relations"
Relationship ||--|| Thing : "object"
Relationship ||--}o Role : "roles"
Role ||--}o Annotation : "annotations"
Role ||--}o AttributeSpecification : "attributes"
Role ||--}o Statement : "characterized_by"
Role ||--}o Thing : "relations"
SoftwareAgent ||--|o Location : "at_location"
SoftwareAgent ||--}o Agent : "acted_on_behalf_of"
SoftwareAgent ||--}o Annotation : "annotations"
SoftwareAgent ||--}o AttributeSpecification : "attributes"
SoftwareAgent ||--}o Identifier : "identifiers"
SoftwareAgent ||--}o Relationship : "qualified_relations"
SoftwareAgent ||--}o Statement : "characterized_by"
SoftwareAgent ||--}o Thing : "relations"
Statement ||--|| Property : "predicate"
Statement ||--|| Thing : "object"
Thing ||--}o Annotation : "annotations"
Thing ||--}o AttributeSpecification : "attributes"
Thing ||--}o Statement : "characterized_by"
Thing ||--}o Thing : "relations"
ThingMixin ||--}o Annotation : "annotations"
ThingMixin ||--}o AttributeSpecification : "attributes"
ThingMixin ||--}o Statement : "characterized_by"
TransientRelationship ||--|| Thing : "object"
TransientRelationship ||--}o Role : "roles"
ValueSpecification ||--}o Annotation : "annotations"
ValueSpecification ||--}o AttributeSpecification : "attributes"
ValueSpecification ||--}o Statement : "characterized_by"
ValueSpecification ||--}o Thing : "relations"

Classes

Slots

Enumerations

Types

Subsets