refactor: Convert AnnotationMotivationEnum to Type/Types class hierarchy
- Create AnnotationMotivationType abstract base class (oa:Motivation)
- Create 10 concrete motivation subclasses in AnnotationMotivationTypes.yaml:
- 6 W3C Web Annotation standard: classifying, describing, identifying,
tagging, linking, commenting
- 4 heritage-specific: accessibility, discovery, preservation, research
- Update has_annotation_motivation slot to use AnnotationMotivationType range
- Update VideoAnnotation.yaml imports and remove inline enum
- Archive deprecated AnnotationMotivationEnum.yaml
- Add motivation_type_id, motivation_type_name, motivation_type_description slots
Follows Rule 0b (Type/Types naming convention) and Rule 9 (enum-to-class promotion)
This commit is contained in:
parent
7d09e4179c
commit
be8b14f6ac
8 changed files with 850 additions and 47 deletions
|
|
@ -0,0 +1,127 @@
|
||||||
|
id: https://nde.nl/ontology/hc/class/AnnotationMotivationType
|
||||||
|
name: annotation_motivation_type_class
|
||||||
|
title: Annotation Motivation Type
|
||||||
|
prefixes:
|
||||||
|
linkml: https://w3id.org/linkml/
|
||||||
|
hc: https://nde.nl/ontology/hc/
|
||||||
|
oa: http://www.w3.org/ns/oa#
|
||||||
|
skos: http://www.w3.org/2004/02/skos/core#
|
||||||
|
dcterms: http://purl.org/dc/terms/
|
||||||
|
crm: http://www.cidoc-crm.org/cidoc-crm/
|
||||||
|
prov: http://www.w3.org/ns/prov#
|
||||||
|
as: https://www.w3.org/ns/activitystreams#
|
||||||
|
default_prefix: hc
|
||||||
|
imports:
|
||||||
|
- linkml:types
|
||||||
|
- ../metadata
|
||||||
|
- ../slots/motivation_type_id
|
||||||
|
- ../slots/motivation_type_name
|
||||||
|
- ../slots/motivation_type_description
|
||||||
|
- ../slots/specificity_annotation
|
||||||
|
- ../slots/template_specificity
|
||||||
|
- ./SpecificityAnnotation
|
||||||
|
- ./TemplateSpecificityScores
|
||||||
|
|
||||||
|
classes:
|
||||||
|
AnnotationMotivationType:
|
||||||
|
class_uri: oa:Motivation
|
||||||
|
abstract: true
|
||||||
|
description: |
|
||||||
|
Abstract base class for annotation motivation types in the heritage domain.
|
||||||
|
|
||||||
|
**DEFINITION**:
|
||||||
|
|
||||||
|
AnnotationMotivationType represents CATEGORIES of motivations for creating
|
||||||
|
annotations. Each subclass defines a specific purpose or intent behind
|
||||||
|
annotation creation.
|
||||||
|
|
||||||
|
**W3C WEB ANNOTATION ALIGNMENT**:
|
||||||
|
|
||||||
|
The W3C Web Annotation Data Model defines `oa:Motivation` as:
|
||||||
|
> The class for Motivation resources that describe the user's intent
|
||||||
|
> or motivation for the creation of the Annotation.
|
||||||
|
|
||||||
|
The `oa:Motivation` class is a subclass of `skos:Concept`:
|
||||||
|
```turtle
|
||||||
|
oa:Motivation a rdfs:Class ;
|
||||||
|
rdfs:subClassOf skos:Concept .
|
||||||
|
```
|
||||||
|
|
||||||
|
**STANDARD MOTIVATIONS** (from W3C Web Annotation):
|
||||||
|
|
||||||
|
| Motivation | URI | Description |
|
||||||
|
|------------|-----|-------------|
|
||||||
|
| classifying | oa:classifying | Categorizing or classifying content |
|
||||||
|
| commenting | oa:commenting | Adding commentary |
|
||||||
|
| describing | oa:describing | Adding descriptive information |
|
||||||
|
| identifying | oa:identifying | Identifying depicted entities |
|
||||||
|
| linking | oa:linking | Linking to external resources |
|
||||||
|
| tagging | oa:tagging | Adding tags or keywords |
|
||||||
|
|
||||||
|
**HERITAGE-SPECIFIC EXTENSIONS**:
|
||||||
|
|
||||||
|
Beyond W3C standard motivations, heritage institutions require:
|
||||||
|
|
||||||
|
| Motivation | Purpose | Use Case |
|
||||||
|
|------------|---------|----------|
|
||||||
|
| AccessibilityMotivation | Accessibility support | Alt-text, captions, audio descriptions |
|
||||||
|
| DiscoveryMotivation | Search and discovery | SEO, facets, keywords |
|
||||||
|
| PreservationMotivation | Digital preservation | Checksums, format migration notes |
|
||||||
|
| ResearchMotivation | Research support | Citations, analysis, scholarly notes |
|
||||||
|
|
||||||
|
**CIDOC-CRM ALIGNMENT**:
|
||||||
|
|
||||||
|
Annotation motivations relate to CIDOC-CRM attribute assignments:
|
||||||
|
- `crm:E13_Attribute_Assignment` - The act of assigning information
|
||||||
|
- `crm:P17_was_motivated_by` - The motivation for an activity
|
||||||
|
|
||||||
|
**PROV-O ALIGNMENT**:
|
||||||
|
|
||||||
|
- `prov:Activity` - Annotations as activities with motivations
|
||||||
|
- `prov:wasMotivatedBy` (proposed) - Relates activity to motivation
|
||||||
|
|
||||||
|
**SUBCLASSES**:
|
||||||
|
|
||||||
|
See AnnotationMotivationTypes.yaml for 10 concrete motivation subclasses:
|
||||||
|
- ClassifyingMotivation, DescribingMotivation, IdentifyingMotivation
|
||||||
|
- TaggingMotivation, LinkingMotivation, CommentingMotivation
|
||||||
|
- AccessibilityMotivation, DiscoveryMotivation, PreservationMotivation, ResearchMotivation
|
||||||
|
exact_mappings:
|
||||||
|
- oa:Motivation
|
||||||
|
close_mappings:
|
||||||
|
- skos:Concept
|
||||||
|
related_mappings:
|
||||||
|
- crm:E55_Type
|
||||||
|
- prov:Influence
|
||||||
|
- as:Object
|
||||||
|
slots:
|
||||||
|
- motivation_type_id
|
||||||
|
- motivation_type_name
|
||||||
|
- motivation_type_description
|
||||||
|
- specificity_annotation
|
||||||
|
- template_specificity
|
||||||
|
slot_usage:
|
||||||
|
motivation_type_id:
|
||||||
|
identifier: true
|
||||||
|
required: true
|
||||||
|
description: Unique identifier for this motivation type
|
||||||
|
motivation_type_name:
|
||||||
|
required: true
|
||||||
|
description: |
|
||||||
|
Canonical name for this motivation type.
|
||||||
|
Used for display and cross-referencing.
|
||||||
|
specificity_annotation:
|
||||||
|
range: SpecificityAnnotation
|
||||||
|
inlined: true
|
||||||
|
template_specificity:
|
||||||
|
range: TemplateSpecificityScores
|
||||||
|
inlined: true
|
||||||
|
comments:
|
||||||
|
- Abstract base class - use specific subclasses (ClassifyingMotivation, etc.)
|
||||||
|
- Represents MOTIVATION TYPES, not individual motivation instances
|
||||||
|
- Aligns with W3C Web Annotation oa:Motivation class
|
||||||
|
- Heritage-specific extensions beyond W3C standard motivations
|
||||||
|
see_also:
|
||||||
|
- https://www.w3.org/TR/annotation-vocab/#motivation
|
||||||
|
- https://www.w3.org/ns/oa#Motivation
|
||||||
|
- http://www.cidoc-crm.org/cidoc-crm/E55_Type
|
||||||
|
|
@ -0,0 +1,598 @@
|
||||||
|
id: https://nde.nl/ontology/hc/class/AnnotationMotivationTypes
|
||||||
|
name: annotation_motivation_types
|
||||||
|
title: Annotation Motivation Types Collection
|
||||||
|
prefixes:
|
||||||
|
linkml: https://w3id.org/linkml/
|
||||||
|
hc: https://nde.nl/ontology/hc/
|
||||||
|
oa: http://www.w3.org/ns/oa#
|
||||||
|
skos: http://www.w3.org/2004/02/skos/core#
|
||||||
|
dcterms: http://purl.org/dc/terms/
|
||||||
|
crm: http://www.cidoc-crm.org/cidoc-crm/
|
||||||
|
prov: http://www.w3.org/ns/prov#
|
||||||
|
schema: http://schema.org/
|
||||||
|
wcag: https://www.w3.org/WAI/WCAG21/
|
||||||
|
default_prefix: hc
|
||||||
|
imports:
|
||||||
|
- linkml:types
|
||||||
|
- ../metadata
|
||||||
|
- ./AnnotationMotivationType
|
||||||
|
- ../slots/specificity_annotation
|
||||||
|
- ../slots/template_specificity
|
||||||
|
- ./SpecificityAnnotation
|
||||||
|
- ./TemplateSpecificityScores
|
||||||
|
|
||||||
|
classes:
|
||||||
|
ClassifyingMotivation:
|
||||||
|
is_a: AnnotationMotivationType
|
||||||
|
class_uri: oa:classifying
|
||||||
|
description: |
|
||||||
|
Motivation for categorizing or classifying content.
|
||||||
|
|
||||||
|
**DEFINITION**:
|
||||||
|
|
||||||
|
ClassifyingMotivation describes annotations where the intent is to
|
||||||
|
assign the target to a specific category or classification scheme.
|
||||||
|
|
||||||
|
**W3C WEB ANNOTATION**:
|
||||||
|
|
||||||
|
From oa:classifying:
|
||||||
|
> The motivation for when the user intends to classify the Target
|
||||||
|
> as something.
|
||||||
|
|
||||||
|
**USE CASES**:
|
||||||
|
|
||||||
|
| Use Case | Example |
|
||||||
|
|----------|---------|
|
||||||
|
| Subject classification | Assigning LCSH or AAT terms |
|
||||||
|
| Genre classification | Labeling artwork as "Baroque" |
|
||||||
|
| Object type | Classifying as "painting", "sculpture" |
|
||||||
|
| Content rating | Age-appropriate classifications |
|
||||||
|
|
||||||
|
**HERITAGE CONTEXT**:
|
||||||
|
|
||||||
|
Classification is fundamental to heritage cataloging:
|
||||||
|
- Museum object classification (Getty AAT)
|
||||||
|
- Archival arrangement and description
|
||||||
|
- Library subject cataloging (LCSH, DDC)
|
||||||
|
- Iconographic classification (Iconclass)
|
||||||
|
exact_mappings:
|
||||||
|
- oa:classifying
|
||||||
|
close_mappings:
|
||||||
|
- skos:Concept
|
||||||
|
- crm:E17_Type_Assignment
|
||||||
|
slot_usage:
|
||||||
|
motivation_type_name:
|
||||||
|
equals_string: classifying
|
||||||
|
specificity_annotation:
|
||||||
|
range: SpecificityAnnotation
|
||||||
|
inlined: true
|
||||||
|
template_specificity:
|
||||||
|
range: TemplateSpecificityScores
|
||||||
|
inlined: true
|
||||||
|
slots:
|
||||||
|
- specificity_annotation
|
||||||
|
- template_specificity
|
||||||
|
comments:
|
||||||
|
- W3C Web Annotation standard motivation
|
||||||
|
- Primary use in heritage cataloging and classification
|
||||||
|
|
||||||
|
DescribingMotivation:
|
||||||
|
is_a: AnnotationMotivationType
|
||||||
|
class_uri: oa:describing
|
||||||
|
description: |
|
||||||
|
Motivation for adding descriptive information to content.
|
||||||
|
|
||||||
|
**DEFINITION**:
|
||||||
|
|
||||||
|
DescribingMotivation describes annotations where the intent is to
|
||||||
|
provide a description of the target resource.
|
||||||
|
|
||||||
|
**W3C WEB ANNOTATION**:
|
||||||
|
|
||||||
|
From oa:describing:
|
||||||
|
> The motivation for when the user intends to describe the Target,
|
||||||
|
> as opposed to a comment about them.
|
||||||
|
|
||||||
|
**USE CASES**:
|
||||||
|
|
||||||
|
| Use Case | Example |
|
||||||
|
|----------|---------|
|
||||||
|
| Physical description | Dimensions, materials, condition |
|
||||||
|
| Content description | What is depicted in an artwork |
|
||||||
|
| Scene description | Video scene narrative |
|
||||||
|
| Alt-text | Image description for accessibility |
|
||||||
|
|
||||||
|
**HERITAGE CONTEXT**:
|
||||||
|
|
||||||
|
Description is core to heritage documentation:
|
||||||
|
- Museum object cataloging (physical descriptions)
|
||||||
|
- Archival finding aid scope and content notes
|
||||||
|
- Library bibliographic description
|
||||||
|
- Video/audio content summarization
|
||||||
|
exact_mappings:
|
||||||
|
- oa:describing
|
||||||
|
close_mappings:
|
||||||
|
- dcterms:description
|
||||||
|
- crm:E62_String
|
||||||
|
slot_usage:
|
||||||
|
motivation_type_name:
|
||||||
|
equals_string: describing
|
||||||
|
specificity_annotation:
|
||||||
|
range: SpecificityAnnotation
|
||||||
|
inlined: true
|
||||||
|
template_specificity:
|
||||||
|
range: TemplateSpecificityScores
|
||||||
|
inlined: true
|
||||||
|
slots:
|
||||||
|
- specificity_annotation
|
||||||
|
- template_specificity
|
||||||
|
comments:
|
||||||
|
- W3C Web Annotation standard motivation
|
||||||
|
- Fundamental to heritage cataloging and accessibility
|
||||||
|
|
||||||
|
IdentifyingMotivation:
|
||||||
|
is_a: AnnotationMotivationType
|
||||||
|
class_uri: oa:identifying
|
||||||
|
description: |
|
||||||
|
Motivation for identifying depicted entities.
|
||||||
|
|
||||||
|
**DEFINITION**:
|
||||||
|
|
||||||
|
IdentifyingMotivation describes annotations where the intent is to
|
||||||
|
assign an identity to what is being depicted or described.
|
||||||
|
|
||||||
|
**W3C WEB ANNOTATION**:
|
||||||
|
|
||||||
|
From oa:identifying:
|
||||||
|
> The motivation for when the user intends to assign an identity to
|
||||||
|
> the Target or identify what is being depicted or described.
|
||||||
|
|
||||||
|
**USE CASES**:
|
||||||
|
|
||||||
|
| Use Case | Example |
|
||||||
|
|----------|---------|
|
||||||
|
| Person identification | Identifying portrait subjects |
|
||||||
|
| Place identification | Geolocating depicted locations |
|
||||||
|
| Object identification | Linking to collection records |
|
||||||
|
| Entity recognition | Named entity extraction |
|
||||||
|
|
||||||
|
**HERITAGE CONTEXT**:
|
||||||
|
|
||||||
|
Identification links heritage content to entities:
|
||||||
|
- Portrait subject identification
|
||||||
|
| - Artwork attribution (artist identification)
|
||||||
|
- Depicted location identification
|
||||||
|
- Object-to-record linking (computer vision)
|
||||||
|
exact_mappings:
|
||||||
|
- oa:identifying
|
||||||
|
close_mappings:
|
||||||
|
- crm:E15_Identifier_Assignment
|
||||||
|
- schema:identifier
|
||||||
|
slot_usage:
|
||||||
|
motivation_type_name:
|
||||||
|
equals_string: identifying
|
||||||
|
specificity_annotation:
|
||||||
|
range: SpecificityAnnotation
|
||||||
|
inlined: true
|
||||||
|
template_specificity:
|
||||||
|
range: TemplateSpecificityScores
|
||||||
|
inlined: true
|
||||||
|
slots:
|
||||||
|
- specificity_annotation
|
||||||
|
- template_specificity
|
||||||
|
comments:
|
||||||
|
- W3C Web Annotation standard motivation
|
||||||
|
- Links content to identified entities
|
||||||
|
|
||||||
|
TaggingMotivation:
|
||||||
|
is_a: AnnotationMotivationType
|
||||||
|
class_uri: oa:tagging
|
||||||
|
description: |
|
||||||
|
Motivation for adding tags or keywords.
|
||||||
|
|
||||||
|
**DEFINITION**:
|
||||||
|
|
||||||
|
TaggingMotivation describes annotations where the intent is to
|
||||||
|
associate a tag or keyword with the target resource.
|
||||||
|
|
||||||
|
**W3C WEB ANNOTATION**:
|
||||||
|
|
||||||
|
From oa:tagging:
|
||||||
|
> The motivation for when the user intends to associate a tag with
|
||||||
|
> the Target.
|
||||||
|
|
||||||
|
**USE CASES**:
|
||||||
|
|
||||||
|
| Use Case | Example |
|
||||||
|
|----------|---------|
|
||||||
|
| Keyword tagging | User-generated tags |
|
||||||
|
| Folksonomy | Community tagging |
|
||||||
|
| Social tagging | Hashtags on social media |
|
||||||
|
| Crowdsourced tags | Volunteer tagging projects |
|
||||||
|
|
||||||
|
**HERITAGE CONTEXT**:
|
||||||
|
|
||||||
|
Tagging complements formal classification:
|
||||||
|
- Crowdsourced transcription projects
|
||||||
|
- Social tagging of collections
|
||||||
|
- User-generated content enrichment
|
||||||
|
- Folksonomies alongside controlled vocabularies
|
||||||
|
exact_mappings:
|
||||||
|
- oa:tagging
|
||||||
|
close_mappings:
|
||||||
|
- skos:Concept
|
||||||
|
- schema:keywords
|
||||||
|
slot_usage:
|
||||||
|
motivation_type_name:
|
||||||
|
equals_string: tagging
|
||||||
|
specificity_annotation:
|
||||||
|
range: SpecificityAnnotation
|
||||||
|
inlined: true
|
||||||
|
template_specificity:
|
||||||
|
range: TemplateSpecificityScores
|
||||||
|
inlined: true
|
||||||
|
slots:
|
||||||
|
- specificity_annotation
|
||||||
|
- template_specificity
|
||||||
|
comments:
|
||||||
|
- W3C Web Annotation standard motivation
|
||||||
|
- User-generated content enrichment
|
||||||
|
|
||||||
|
LinkingMotivation:
|
||||||
|
is_a: AnnotationMotivationType
|
||||||
|
class_uri: oa:linking
|
||||||
|
description: |
|
||||||
|
Motivation for linking to external resources.
|
||||||
|
|
||||||
|
**DEFINITION**:
|
||||||
|
|
||||||
|
LinkingMotivation describes annotations where the intent is to
|
||||||
|
create a link between the target and a related resource.
|
||||||
|
|
||||||
|
**W3C WEB ANNOTATION**:
|
||||||
|
|
||||||
|
From oa:linking:
|
||||||
|
> The motivation for when the user intends to link to a resource
|
||||||
|
> related to the Target.
|
||||||
|
|
||||||
|
**USE CASES**:
|
||||||
|
|
||||||
|
| Use Case | Example |
|
||||||
|
|----------|---------|
|
||||||
|
| See also links | Related collection items |
|
||||||
|
| Authority links | Links to Wikidata/VIAF |
|
||||||
|
| Reference links | Citations and sources |
|
||||||
|
| IIIF links | Manifest and canvas links |
|
||||||
|
|
||||||
|
**HERITAGE CONTEXT**:
|
||||||
|
|
||||||
|
Linking enables Linked Open Data:
|
||||||
|
- Authority file linking (VIAF, ISNI, Wikidata)
|
||||||
|
- Collection cross-references
|
||||||
|
- Digital object linking (IIIF)
|
||||||
|
- Bibliographic references
|
||||||
|
exact_mappings:
|
||||||
|
- oa:linking
|
||||||
|
close_mappings:
|
||||||
|
- dcterms:relation
|
||||||
|
- skos:related
|
||||||
|
- schema:relatedLink
|
||||||
|
slot_usage:
|
||||||
|
motivation_type_name:
|
||||||
|
equals_string: linking
|
||||||
|
specificity_annotation:
|
||||||
|
range: SpecificityAnnotation
|
||||||
|
inlined: true
|
||||||
|
template_specificity:
|
||||||
|
range: TemplateSpecificityScores
|
||||||
|
inlined: true
|
||||||
|
slots:
|
||||||
|
- specificity_annotation
|
||||||
|
- template_specificity
|
||||||
|
comments:
|
||||||
|
- W3C Web Annotation standard motivation
|
||||||
|
- Enables Linked Open Data connections
|
||||||
|
|
||||||
|
CommentingMotivation:
|
||||||
|
is_a: AnnotationMotivationType
|
||||||
|
class_uri: oa:commenting
|
||||||
|
description: |
|
||||||
|
Motivation for adding commentary.
|
||||||
|
|
||||||
|
**DEFINITION**:
|
||||||
|
|
||||||
|
CommentingMotivation describes annotations where the intent is to
|
||||||
|
add a comment or opinion about the target resource.
|
||||||
|
|
||||||
|
**W3C WEB ANNOTATION**:
|
||||||
|
|
||||||
|
From oa:commenting:
|
||||||
|
> The motivation for when the user intends to comment about the Target.
|
||||||
|
|
||||||
|
**USE CASES**:
|
||||||
|
|
||||||
|
| Use Case | Example |
|
||||||
|
|----------|---------|
|
||||||
|
| Scholarly notes | Research observations |
|
||||||
|
| Curatorial notes | Internal cataloging notes |
|
||||||
|
| User comments | Public-facing comments |
|
||||||
|
| Editorial remarks | Publication annotations |
|
||||||
|
|
||||||
|
**HERITAGE CONTEXT**:
|
||||||
|
|
||||||
|
Comments add contextual knowledge:
|
||||||
|
- Provenance research notes
|
||||||
|
- Conservation observations
|
||||||
|
- Scholarly commentary
|
||||||
|
- Community engagement features
|
||||||
|
exact_mappings:
|
||||||
|
- oa:commenting
|
||||||
|
close_mappings:
|
||||||
|
- schema:Comment
|
||||||
|
- schema:UserComments
|
||||||
|
slot_usage:
|
||||||
|
motivation_type_name:
|
||||||
|
equals_string: commenting
|
||||||
|
specificity_annotation:
|
||||||
|
range: SpecificityAnnotation
|
||||||
|
inlined: true
|
||||||
|
template_specificity:
|
||||||
|
range: TemplateSpecificityScores
|
||||||
|
inlined: true
|
||||||
|
slots:
|
||||||
|
- specificity_annotation
|
||||||
|
- template_specificity
|
||||||
|
comments:
|
||||||
|
- W3C Web Annotation standard motivation
|
||||||
|
- User and scholarly engagement
|
||||||
|
|
||||||
|
AccessibilityMotivation:
|
||||||
|
is_a: AnnotationMotivationType
|
||||||
|
class_uri: hc:accessibilityMotivation
|
||||||
|
description: |
|
||||||
|
Motivation for providing accessibility support.
|
||||||
|
|
||||||
|
**DEFINITION**:
|
||||||
|
|
||||||
|
AccessibilityMotivation describes annotations created to make
|
||||||
|
heritage content accessible to users with disabilities.
|
||||||
|
|
||||||
|
**HERITAGE-SPECIFIC MOTIVATION**:
|
||||||
|
|
||||||
|
This extends W3C Web Annotation with heritage accessibility needs.
|
||||||
|
Not part of the standard oa: vocabulary but essential for inclusive
|
||||||
|
heritage access.
|
||||||
|
|
||||||
|
**USE CASES**:
|
||||||
|
|
||||||
|
| Use Case | Example |
|
||||||
|
|----------|---------|
|
||||||
|
| Alt-text | Image descriptions for screen readers |
|
||||||
|
| Audio description | Video narration for visually impaired |
|
||||||
|
| Closed captions | Text for hearing impaired |
|
||||||
|
| Sign language | Video interpretation |
|
||||||
|
| Easy read | Simplified text versions |
|
||||||
|
|
||||||
|
**HERITAGE CONTEXT**:
|
||||||
|
|
||||||
|
Heritage institutions have accessibility obligations:
|
||||||
|
- Museum audio guides and touch tours
|
||||||
|
- Archive reading room accommodations
|
||||||
|
- Library assistive technology support
|
||||||
|
- Digital platform WCAG compliance
|
||||||
|
|
||||||
|
**WCAG ALIGNMENT**:
|
||||||
|
|
||||||
|
Supports Web Content Accessibility Guidelines:
|
||||||
|
- WCAG 2.1 Success Criterion 1.1.1 (Non-text Content)
|
||||||
|
- WCAG 2.1 Success Criterion 1.2 (Time-based Media)
|
||||||
|
exact_mappings:
|
||||||
|
- hc:accessibilityMotivation
|
||||||
|
close_mappings:
|
||||||
|
- schema:accessibilityFeature
|
||||||
|
- schema:accessibilityHazard
|
||||||
|
related_mappings:
|
||||||
|
- wcag:Guideline
|
||||||
|
slot_usage:
|
||||||
|
motivation_type_name:
|
||||||
|
equals_string: accessibility
|
||||||
|
specificity_annotation:
|
||||||
|
range: SpecificityAnnotation
|
||||||
|
inlined: true
|
||||||
|
template_specificity:
|
||||||
|
range: TemplateSpecificityScores
|
||||||
|
inlined: true
|
||||||
|
slots:
|
||||||
|
- specificity_annotation
|
||||||
|
- template_specificity
|
||||||
|
comments:
|
||||||
|
- Heritage-specific extension beyond W3C standard
|
||||||
|
- Critical for inclusive heritage access
|
||||||
|
- Supports WCAG compliance
|
||||||
|
|
||||||
|
DiscoveryMotivation:
|
||||||
|
is_a: AnnotationMotivationType
|
||||||
|
class_uri: hc:discoveryMotivation
|
||||||
|
description: |
|
||||||
|
Motivation for enabling search and discovery.
|
||||||
|
|
||||||
|
**DEFINITION**:
|
||||||
|
|
||||||
|
DiscoveryMotivation describes annotations created specifically to
|
||||||
|
improve the findability and discoverability of heritage content.
|
||||||
|
|
||||||
|
**HERITAGE-SPECIFIC MOTIVATION**:
|
||||||
|
|
||||||
|
This extends W3C Web Annotation with heritage discovery needs.
|
||||||
|
Focus is on making collections searchable and browsable.
|
||||||
|
|
||||||
|
**USE CASES**:
|
||||||
|
|
||||||
|
| Use Case | Example |
|
||||||
|
|----------|---------|
|
||||||
|
| SEO metadata | Schema.org structured data |
|
||||||
|
| Faceted search | Filter-enabling metadata |
|
||||||
|
| Full-text indexing | OCR text for search |
|
||||||
|
| Named entity extraction | People, places, dates |
|
||||||
|
| AI-generated descriptions | ML-powered metadata |
|
||||||
|
|
||||||
|
**HERITAGE CONTEXT**:
|
||||||
|
|
||||||
|
Discovery is essential for heritage access:
|
||||||
|
- Collection portal search optimization
|
||||||
|
- Aggregator metadata enhancement (Europeana)
|
||||||
|
- Cross-collection discovery
|
||||||
|
- Semantic search enablement
|
||||||
|
|
||||||
|
**SCHEMA.ORG ALIGNMENT**:
|
||||||
|
|
||||||
|
Supports structured data for search engines:
|
||||||
|
- schema:WebPage, schema:CollectionPage
|
||||||
|
- schema:Breadcrumb navigation
|
||||||
|
- schema:SearchAction configuration
|
||||||
|
exact_mappings:
|
||||||
|
- hc:discoveryMotivation
|
||||||
|
close_mappings:
|
||||||
|
- schema:SearchAction
|
||||||
|
- dcat:Catalog
|
||||||
|
slot_usage:
|
||||||
|
motivation_type_name:
|
||||||
|
equals_string: discovery
|
||||||
|
specificity_annotation:
|
||||||
|
range: SpecificityAnnotation
|
||||||
|
inlined: true
|
||||||
|
template_specificity:
|
||||||
|
range: TemplateSpecificityScores
|
||||||
|
inlined: true
|
||||||
|
slots:
|
||||||
|
- specificity_annotation
|
||||||
|
- template_specificity
|
||||||
|
comments:
|
||||||
|
- Heritage-specific extension beyond W3C standard
|
||||||
|
- Enables collection discoverability
|
||||||
|
- Supports aggregator integration
|
||||||
|
|
||||||
|
PreservationMotivation:
|
||||||
|
is_a: AnnotationMotivationType
|
||||||
|
class_uri: hc:preservationMotivation
|
||||||
|
description: |
|
||||||
|
Motivation for supporting digital preservation.
|
||||||
|
|
||||||
|
**DEFINITION**:
|
||||||
|
|
||||||
|
PreservationMotivation describes annotations created to support
|
||||||
|
the long-term preservation of digital heritage content.
|
||||||
|
|
||||||
|
**HERITAGE-SPECIFIC MOTIVATION**:
|
||||||
|
|
||||||
|
This extends W3C Web Annotation with digital preservation needs.
|
||||||
|
Focus is on ensuring content remains accessible over time.
|
||||||
|
|
||||||
|
**USE CASES**:
|
||||||
|
|
||||||
|
| Use Case | Example |
|
||||||
|
|----------|---------|
|
||||||
|
| Format documentation | Technical metadata (PREMIS) |
|
||||||
|
| Checksum recording | Fixity verification |
|
||||||
|
| Migration notes | Format conversion history |
|
||||||
|
| Rights documentation | Preservation rights |
|
||||||
|
| Significant properties | What must be preserved |
|
||||||
|
|
||||||
|
**HERITAGE CONTEXT**:
|
||||||
|
|
||||||
|
Digital preservation is a core heritage function:
|
||||||
|
- Archive preservation planning
|
||||||
|
- Museum digital asset management
|
||||||
|
- Library digital preservation programs
|
||||||
|
- OAIS compliance documentation
|
||||||
|
|
||||||
|
**PREMIS ALIGNMENT**:
|
||||||
|
|
||||||
|
Supports PREMIS Data Dictionary:
|
||||||
|
- premis:Object (digital objects)
|
||||||
|
- premis:Event (preservation actions)
|
||||||
|
- premis:Agent (preservation actors)
|
||||||
|
- premis:Rights (preservation permissions)
|
||||||
|
exact_mappings:
|
||||||
|
- hc:preservationMotivation
|
||||||
|
close_mappings:
|
||||||
|
- premis:Event
|
||||||
|
- prov:Activity
|
||||||
|
slot_usage:
|
||||||
|
motivation_type_name:
|
||||||
|
equals_string: preservation
|
||||||
|
specificity_annotation:
|
||||||
|
range: SpecificityAnnotation
|
||||||
|
inlined: true
|
||||||
|
template_specificity:
|
||||||
|
range: TemplateSpecificityScores
|
||||||
|
inlined: true
|
||||||
|
slots:
|
||||||
|
- specificity_annotation
|
||||||
|
- template_specificity
|
||||||
|
comments:
|
||||||
|
- Heritage-specific extension beyond W3C standard
|
||||||
|
- Critical for digital preservation
|
||||||
|
- Supports OAIS and PREMIS compliance
|
||||||
|
|
||||||
|
ResearchMotivation:
|
||||||
|
is_a: AnnotationMotivationType
|
||||||
|
class_uri: hc:researchMotivation
|
||||||
|
description: |
|
||||||
|
Motivation for supporting research and analysis.
|
||||||
|
|
||||||
|
**DEFINITION**:
|
||||||
|
|
||||||
|
ResearchMotivation describes annotations created specifically to
|
||||||
|
support scholarly research and analysis of heritage content.
|
||||||
|
|
||||||
|
**HERITAGE-SPECIFIC MOTIVATION**:
|
||||||
|
|
||||||
|
This extends W3C Web Annotation with research needs.
|
||||||
|
Focus is on enabling scholarly use of heritage collections.
|
||||||
|
|
||||||
|
**USE CASES**:
|
||||||
|
|
||||||
|
| Use Case | Example |
|
||||||
|
|----------|---------|
|
||||||
|
| Citation annotation | Scholarly citations |
|
||||||
|
| Research notes | Analytical observations |
|
||||||
|
| Hypothesis marking | Research questions |
|
||||||
|
| Data annotation | Dataset documentation |
|
||||||
|
| Computational analysis | ML/AI analysis results |
|
||||||
|
|
||||||
|
**HERITAGE CONTEXT**:
|
||||||
|
|
||||||
|
Heritage institutions support research:
|
||||||
|
- Archive research services
|
||||||
|
- Museum scholarly access
|
||||||
|
- Library reference services
|
||||||
|
- Digital humanities projects
|
||||||
|
|
||||||
|
**CRM ALIGNMENT**:
|
||||||
|
|
||||||
|
Supports CIDOC-CRM research patterns:
|
||||||
|
- crm:E7_Activity (research activities)
|
||||||
|
- crm:E13_Attribute_Assignment (scholarly assertions)
|
||||||
|
- crm:E65_Creation (research outputs)
|
||||||
|
exact_mappings:
|
||||||
|
- hc:researchMotivation
|
||||||
|
close_mappings:
|
||||||
|
- crm:E7_Activity
|
||||||
|
- schema:ScholarlyArticle
|
||||||
|
slot_usage:
|
||||||
|
motivation_type_name:
|
||||||
|
equals_string: research
|
||||||
|
specificity_annotation:
|
||||||
|
range: SpecificityAnnotation
|
||||||
|
inlined: true
|
||||||
|
template_specificity:
|
||||||
|
range: TemplateSpecificityScores
|
||||||
|
inlined: true
|
||||||
|
slots:
|
||||||
|
- specificity_annotation
|
||||||
|
- template_specificity
|
||||||
|
comments:
|
||||||
|
- Heritage-specific extension beyond W3C standard
|
||||||
|
- Supports digital humanities and research
|
||||||
|
- Enables computational analysis documentation
|
||||||
|
|
@ -5,6 +5,8 @@ imports:
|
||||||
- linkml:types
|
- linkml:types
|
||||||
- ./VideoTextContent
|
- ./VideoTextContent
|
||||||
- ./VideoTimeSegment
|
- ./VideoTimeSegment
|
||||||
|
- ./AnnotationMotivationType
|
||||||
|
- ./AnnotationMotivationTypes
|
||||||
- ../slots/has_annotation_motivation
|
- ../slots/has_annotation_motivation
|
||||||
- ../slots/has_annotation_segment
|
- ../slots/has_annotation_segment
|
||||||
- ../slots/has_annotation_type
|
- ../slots/has_annotation_type
|
||||||
|
|
@ -347,20 +349,22 @@ classes:
|
||||||
Web Annotation: motivatedBy describes why annotation was created.
|
Web Annotation: motivatedBy describes why annotation was created.
|
||||||
|
|
||||||
**Standard Motivations** (from W3C Web Annotation):
|
**Standard Motivations** (from W3C Web Annotation):
|
||||||
- classifying: Categorizing content
|
- ClassifyingMotivation: Categorizing content
|
||||||
- describing: Adding description
|
- DescribingMotivation: Adding description
|
||||||
- identifying: Identifying depicted things
|
- IdentifyingMotivation: Identifying depicted things
|
||||||
- tagging: Adding tags/keywords
|
- TaggingMotivation: Adding tags/keywords
|
||||||
- linking: Linking to external resources
|
- LinkingMotivation: Linking to external resources
|
||||||
|
- CommentingMotivation: Adding commentary
|
||||||
|
|
||||||
**Heritage-Specific**:
|
**Heritage-Specific Extensions**:
|
||||||
- accessibility: For accessibility services
|
- AccessibilityMotivation: For accessibility services
|
||||||
- discovery: For search/discovery
|
- DiscoveryMotivation: For search/discovery
|
||||||
- preservation: For digital preservation
|
- PreservationMotivation: For digital preservation
|
||||||
range: AnnotationMotivationEnum
|
- ResearchMotivation: For scholarly research
|
||||||
|
range: AnnotationMotivationType
|
||||||
required: false
|
required: false
|
||||||
examples:
|
examples:
|
||||||
- value: CLASSIFYING
|
- value: ClassifyingMotivation
|
||||||
description: Annotation for classification purposes
|
description: Annotation for classification purposes
|
||||||
specificity_annotation:
|
specificity_annotation:
|
||||||
range: SpecificityAnnotation
|
range: SpecificityAnnotation
|
||||||
|
|
@ -403,36 +407,6 @@ enums:
|
||||||
description: Automated video captioning/description
|
description: Automated video captioning/description
|
||||||
CUSTOM:
|
CUSTOM:
|
||||||
description: Custom annotation type
|
description: Custom annotation type
|
||||||
AnnotationMotivationEnum:
|
|
||||||
description: |
|
|
||||||
Motivation for creating annotation (W3C Web Annotation aligned).
|
|
||||||
permissible_values:
|
|
||||||
CLASSIFYING:
|
|
||||||
description: Categorizing or classifying content
|
|
||||||
meaning: oa:classifying
|
|
||||||
DESCRIBING:
|
|
||||||
description: Adding descriptive information
|
|
||||||
meaning: oa:describing
|
|
||||||
IDENTIFYING:
|
|
||||||
description: Identifying depicted entities
|
|
||||||
meaning: oa:identifying
|
|
||||||
TAGGING:
|
|
||||||
description: Adding tags or keywords
|
|
||||||
meaning: oa:tagging
|
|
||||||
LINKING:
|
|
||||||
description: Linking to external resources
|
|
||||||
meaning: oa:linking
|
|
||||||
COMMENTING:
|
|
||||||
description: Adding commentary
|
|
||||||
meaning: oa:commenting
|
|
||||||
ACCESSIBILITY:
|
|
||||||
description: Providing accessibility support
|
|
||||||
DISCOVERY:
|
|
||||||
description: Enabling search and discovery
|
|
||||||
PRESERVATION:
|
|
||||||
description: Supporting digital preservation
|
|
||||||
RESEARCH:
|
|
||||||
description: Supporting research and analysis
|
|
||||||
slots:
|
slots:
|
||||||
has_annotation_type:
|
has_annotation_type:
|
||||||
description: High-level type of video annotation
|
description: High-level type of video annotation
|
||||||
|
|
@ -470,4 +444,4 @@ slots:
|
||||||
range: boolean
|
range: boolean
|
||||||
has_annotation_motivation:
|
has_annotation_motivation:
|
||||||
description: Motivation for creating annotation (W3C Web Annotation)
|
description: Motivation for creating annotation (W3C Web Annotation)
|
||||||
range: AnnotationMotivationEnum
|
range: AnnotationMotivationType
|
||||||
|
|
|
||||||
|
|
@ -6,24 +6,43 @@ prefixes:
|
||||||
hc: https://nde.nl/ontology/hc/
|
hc: https://nde.nl/ontology/hc/
|
||||||
linkml: https://w3id.org/linkml/
|
linkml: https://w3id.org/linkml/
|
||||||
oa: http://www.w3.org/ns/oa#
|
oa: http://www.w3.org/ns/oa#
|
||||||
|
skos: http://www.w3.org/2004/02/skos/core#
|
||||||
|
crm: http://www.cidoc-crm.org/cidoc-crm/
|
||||||
imports:
|
imports:
|
||||||
- linkml:types
|
- linkml:types
|
||||||
|
- ../classes/AnnotationMotivationType
|
||||||
default_prefix: hc
|
default_prefix: hc
|
||||||
slots:
|
slots:
|
||||||
has_annotation_motivation:
|
has_annotation_motivation:
|
||||||
description: >-
|
description: >-
|
||||||
Motivation for creating an annotation (Web Annotation vocabulary).
|
Motivation for creating an annotation (W3C Web Annotation vocabulary).
|
||||||
range: string
|
|
||||||
|
The motivation describes why an annotation was created. Standard motivations
|
||||||
|
from the W3C Web Annotation vocabulary include classifying, describing,
|
||||||
|
identifying, tagging, linking, and commenting.
|
||||||
|
|
||||||
|
Heritage-specific extensions include accessibility (for alt-text, captions),
|
||||||
|
discovery (for search optimization), preservation (for digital preservation),
|
||||||
|
and research (for scholarly use).
|
||||||
|
|
||||||
|
**ONTOLOGY ALIGNMENT**:
|
||||||
|
- oa:motivatedBy - W3C Web Annotation predicate
|
||||||
|
- crm:P17_was_motivated_by - CIDOC-CRM motivation property
|
||||||
|
- skos:Concept - Motivation types are concepts in a vocabulary
|
||||||
|
range: AnnotationMotivationType
|
||||||
slot_uri: oa:motivatedBy
|
slot_uri: oa:motivatedBy
|
||||||
exact_mappings:
|
exact_mappings:
|
||||||
- oa:motivatedBy
|
- oa:motivatedBy
|
||||||
close_mappings:
|
close_mappings:
|
||||||
|
- crm:P17_was_motivated_by
|
||||||
- dcterms:type
|
- dcterms:type
|
||||||
|
related_mappings:
|
||||||
|
- skos:Concept
|
||||||
annotations:
|
annotations:
|
||||||
custodian_types: '["*"]'
|
custodian_types: '["*"]'
|
||||||
custodian_types_rationale: >-
|
custodian_types_rationale: >-
|
||||||
Applicable to all heritage custodian types.
|
Applicable to all heritage custodian types that create annotations.
|
||||||
custodian_types_primary: M
|
custodian_types_primary: M
|
||||||
specificity_score: 0.5
|
specificity_score: 0.5
|
||||||
specificity_rationale: >-
|
specificity_rationale: >-
|
||||||
Moderately specific slot.
|
Moderately specific slot for annotation systems.
|
||||||
|
|
|
||||||
|
|
@ -0,0 +1,29 @@
|
||||||
|
id: https://nde.nl/ontology/hc/slot/motivation_type_description
|
||||||
|
name: motivation_type_description_slot
|
||||||
|
title: Motivation Type Description Slot
|
||||||
|
prefixes:
|
||||||
|
linkml: https://w3id.org/linkml/
|
||||||
|
hc: https://nde.nl/ontology/hc/
|
||||||
|
skos: http://www.w3.org/2004/02/skos/core#
|
||||||
|
dcterms: http://purl.org/dc/terms/
|
||||||
|
imports:
|
||||||
|
- linkml:types
|
||||||
|
default_prefix: hc
|
||||||
|
slots:
|
||||||
|
motivation_type_description:
|
||||||
|
description: >-
|
||||||
|
Detailed description of an annotation motivation type including
|
||||||
|
purpose, characteristics, and typical use cases.
|
||||||
|
range: string
|
||||||
|
slot_uri: skos:definition
|
||||||
|
exact_mappings:
|
||||||
|
- skos:definition
|
||||||
|
close_mappings:
|
||||||
|
- dcterms:description
|
||||||
|
annotations:
|
||||||
|
custodian_types: '["*"]'
|
||||||
|
custodian_types_rationale: >-
|
||||||
|
Applicable to all heritage custodian types.
|
||||||
|
specificity_score: 0.6
|
||||||
|
specificity_rationale: >-
|
||||||
|
Moderately specific to annotation systems.
|
||||||
|
|
@ -0,0 +1,28 @@
|
||||||
|
id: https://nde.nl/ontology/hc/slot/motivation_type_id
|
||||||
|
name: motivation_type_id_slot
|
||||||
|
title: Motivation Type ID Slot
|
||||||
|
prefixes:
|
||||||
|
linkml: https://w3id.org/linkml/
|
||||||
|
hc: https://nde.nl/ontology/hc/
|
||||||
|
dcterms: http://purl.org/dc/terms/
|
||||||
|
skos: http://www.w3.org/2004/02/skos/core#
|
||||||
|
imports:
|
||||||
|
- linkml:types
|
||||||
|
default_prefix: hc
|
||||||
|
slots:
|
||||||
|
motivation_type_id:
|
||||||
|
description: >-
|
||||||
|
Unique identifier for an annotation motivation type.
|
||||||
|
range: uriorcurie
|
||||||
|
slot_uri: dcterms:identifier
|
||||||
|
exact_mappings:
|
||||||
|
- dcterms:identifier
|
||||||
|
close_mappings:
|
||||||
|
- skos:notation
|
||||||
|
annotations:
|
||||||
|
custodian_types: '["*"]'
|
||||||
|
custodian_types_rationale: >-
|
||||||
|
Applicable to all heritage custodian types that use annotations.
|
||||||
|
specificity_score: 0.6
|
||||||
|
specificity_rationale: >-
|
||||||
|
Moderately specific to annotation systems.
|
||||||
|
|
@ -0,0 +1,28 @@
|
||||||
|
id: https://nde.nl/ontology/hc/slot/motivation_type_name
|
||||||
|
name: motivation_type_name_slot
|
||||||
|
title: Motivation Type Name Slot
|
||||||
|
prefixes:
|
||||||
|
linkml: https://w3id.org/linkml/
|
||||||
|
hc: https://nde.nl/ontology/hc/
|
||||||
|
skos: http://www.w3.org/2004/02/skos/core#
|
||||||
|
rdfs: http://www.w3.org/2000/01/rdf-schema#
|
||||||
|
imports:
|
||||||
|
- linkml:types
|
||||||
|
default_prefix: hc
|
||||||
|
slots:
|
||||||
|
motivation_type_name:
|
||||||
|
description: >-
|
||||||
|
Canonical name for an annotation motivation type.
|
||||||
|
range: string
|
||||||
|
slot_uri: skos:prefLabel
|
||||||
|
exact_mappings:
|
||||||
|
- skos:prefLabel
|
||||||
|
close_mappings:
|
||||||
|
- rdfs:label
|
||||||
|
annotations:
|
||||||
|
custodian_types: '["*"]'
|
||||||
|
custodian_types_rationale: >-
|
||||||
|
Applicable to all heritage custodian types.
|
||||||
|
specificity_score: 0.6
|
||||||
|
specificity_rationale: >-
|
||||||
|
Moderately specific to annotation systems.
|
||||||
Loading…
Reference in a new issue