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
|
||||
- ./VideoTextContent
|
||||
- ./VideoTimeSegment
|
||||
- ./AnnotationMotivationType
|
||||
- ./AnnotationMotivationTypes
|
||||
- ../slots/has_annotation_motivation
|
||||
- ../slots/has_annotation_segment
|
||||
- ../slots/has_annotation_type
|
||||
|
|
@ -347,20 +349,22 @@ classes:
|
|||
Web Annotation: motivatedBy describes why annotation was created.
|
||||
|
||||
**Standard Motivations** (from W3C Web Annotation):
|
||||
- classifying: Categorizing content
|
||||
- describing: Adding description
|
||||
- identifying: Identifying depicted things
|
||||
- tagging: Adding tags/keywords
|
||||
- linking: Linking to external resources
|
||||
- ClassifyingMotivation: Categorizing content
|
||||
- DescribingMotivation: Adding description
|
||||
- IdentifyingMotivation: Identifying depicted things
|
||||
- TaggingMotivation: Adding tags/keywords
|
||||
- LinkingMotivation: Linking to external resources
|
||||
- CommentingMotivation: Adding commentary
|
||||
|
||||
**Heritage-Specific**:
|
||||
- accessibility: For accessibility services
|
||||
- discovery: For search/discovery
|
||||
- preservation: For digital preservation
|
||||
range: AnnotationMotivationEnum
|
||||
**Heritage-Specific Extensions**:
|
||||
- AccessibilityMotivation: For accessibility services
|
||||
- DiscoveryMotivation: For search/discovery
|
||||
- PreservationMotivation: For digital preservation
|
||||
- ResearchMotivation: For scholarly research
|
||||
range: AnnotationMotivationType
|
||||
required: false
|
||||
examples:
|
||||
- value: CLASSIFYING
|
||||
- value: ClassifyingMotivation
|
||||
description: Annotation for classification purposes
|
||||
specificity_annotation:
|
||||
range: SpecificityAnnotation
|
||||
|
|
@ -403,36 +407,6 @@ enums:
|
|||
description: Automated video captioning/description
|
||||
CUSTOM:
|
||||
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:
|
||||
has_annotation_type:
|
||||
description: High-level type of video annotation
|
||||
|
|
@ -470,4 +444,4 @@ slots:
|
|||
range: boolean
|
||||
has_annotation_motivation:
|
||||
description: Motivation for creating annotation (W3C Web Annotation)
|
||||
range: AnnotationMotivationEnum
|
||||
range: AnnotationMotivationType
|
||||
|
|
|
|||
|
|
@ -6,24 +6,43 @@ prefixes:
|
|||
hc: https://nde.nl/ontology/hc/
|
||||
linkml: https://w3id.org/linkml/
|
||||
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:
|
||||
- linkml:types
|
||||
- linkml:types
|
||||
- ../classes/AnnotationMotivationType
|
||||
default_prefix: hc
|
||||
slots:
|
||||
has_annotation_motivation:
|
||||
description: >-
|
||||
Motivation for creating an annotation (Web Annotation vocabulary).
|
||||
range: string
|
||||
Motivation for creating an annotation (W3C Web Annotation vocabulary).
|
||||
|
||||
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
|
||||
exact_mappings:
|
||||
- oa:motivatedBy
|
||||
close_mappings:
|
||||
- crm:P17_was_motivated_by
|
||||
- dcterms:type
|
||||
related_mappings:
|
||||
- skos:Concept
|
||||
annotations:
|
||||
custodian_types: '["*"]'
|
||||
custodian_types_rationale: >-
|
||||
Applicable to all heritage custodian types.
|
||||
Applicable to all heritage custodian types that create annotations.
|
||||
custodian_types_primary: M
|
||||
specificity_score: 0.5
|
||||
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