glam/schemas/20251121/linkml/modules/classes/Activity.yaml

201 lines
9 KiB
YAML

id: https://nde.nl/ontology/hc/class/Activity
name: Activity
title: Activity Class
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
crm: http://www.cidoc-crm.org/cidoc-crm/
rico: https://www.ica.org/standards/RiC/ontology#
prov: http://www.w3.org/ns/prov#
schema: http://schema.org/
dcterms: http://purl.org/dc/terms/
aat: http://vocab.getty.edu/aat/
skos: http://www.w3.org/2004/02/skos/core#
default_prefix: hc
imports:
- linkml:types
- ../metadata
- ./TimeSpan
- ./ActivityType
- ./ActivityTypes
- ../slots/has_activity_identifier
- ../slots/has_or_had_identifier
- ./Identifier
- ../slots/has_or_had_label
- ./Label
- ../slots/has_or_had_description
- ./Description
- ../slots/has_activity_status
- ../slots/note
- ../slots/specificity_annotation
- ../slots/has_or_had_score
- ./SpecificityAnnotation
- ./TemplateSpecificityScore
- ./TemplateSpecificityType
- ./TemplateSpecificityTypes
classes:
Activity:
class_uri: prov:Activity
description: "Base class for activities performed by heritage custodians.\n\n**DEFINITION**:\n\nAn Activity represents a discrete or ongoing action undertaken by a heritage\ncustodian. This is the base class for all activity instances in the ontology.\n\n**ONTOLOGICAL ALIGNMENT**:\n\n| Ontology | Class | Use Case |\n|----------|-------|----------|\n| PROV-O | prov:Activity | Primary - provenance tracking |\n| CIDOC-CRM | crm:E7_Activity | Cultural heritage domain |\n| RiC-O | rico:Activity | Archival activities |\n| Schema.org | schema:Action | Web semantics |\n\n**KEY RELATIONSHIPS**:\n\n```\nActivity\n \u2502\n \u251C\u2500\u2500 has_or_had_activity_type \u2192 ActivityType (classification)\n \u2502 \u2514\u2500\u2500 CurationActivityType, ConservationActivityType, etc.\n \u2502\n \u251C\u2500\u2500 has_timespan \u2192 TimeSpan (temporal extent)\n \u2502 \u2514\u2500\u2500 start_date, end_date, fuzzy bounds\n \u2502\n \u251C\u2500\u2500 is_or_was_succeeded_by\
\ \u2192 Activity (succession)\n \u2502\n \u2514\u2500\u2500 preceding_activity \u2192 Activity (inverse succession)\n```\n\n**SPECIALIZATION**:\n\nThis base class is extended by domain-specific activity classes:\n- CurationActivity - Collection management (existing, to be refactored)\n- ConservationActivity - Preservation work\n- ExhibitionActivity - Exhibition planning and execution\n- DigitizationActivity - Digital transformation projects\n\n**PROVENANCE (PROV-O)**:\n\nActivities generate provenance information:\n- `prov:Activity` - The activity itself\n- `prov:wasAssociatedWith` - Responsible agents\n- `prov:used` - Entities processed\n- `prov:generated` - Entities created\n- `prov:atTime` - Temporal extent\n"
exact_mappings:
- prov:Activity
close_mappings:
- crm:E7_Activity
- rico:Activity
- schema:Action
related_mappings:
- aat:300054277
slots:
- has_or_had_identifier
- has_or_had_label
- has_or_had_description
- has_or_had_activity_type
- temporal_extent
- is_or_was_succeeded_by
- preceding_activity
- has_or_had_status
- note
- specificity_annotation
- has_or_had_score
slot_usage:
has_or_had_identifier:
description: 'Unique identifier for this activity instance.
MIGRATED from has_activity_identifier per Rule 53.
Format: URI following NDE Heritage Custodian ontology conventions.
Pattern: `https://nde.nl/ontology/hc/activity/{custodian-slug}-{type}-{year}-{sequence}`
'
range: Identifier
required: true
identifier: true
inlined: true
examples:
- value:
identifier_value: https://nde.nl/ontology/hc/activity/rijksmuseum-inventory-2025-001
description: 2025 inventory at Rijksmuseum
- value:
identifier_value: https://nde.nl/ontology/hc/activity/nationaal-archief-digitization-voc-2024
description: VOC digitization project at Nationaal Archief
has_or_had_label:
range: string
required: true
description: Human-readable name for this activity.
examples:
- value: 2025 Annual Collection Inventory
description: Recurring annual inventory
- value: VOC Archives Digitization Project Phase 2
description: Multi-year digitization project
has_or_had_description:
range: string
required: false
description: Detailed description of the activity scope and objectives.
examples:
- value: "Annual physical inventory of the Dutch Masters collection, \ncovering approximately 450 paintings. Spot-check methodology \nwith 20% sample verified against catalog records.\n"
description: Inventory activity description
has_or_had_activity_type:
range: ActivityType
required: true
multivalued: true
description: 'The type classification(s) for this activity.
Values are ActivityType subclasses from ActivityTypes.yaml.
'
examples:
- value: CurationActivityType
description: Curation activity
- value: '[DigitizationActivityType, ResearchActivityType]'
description: Combined digitization and research project
temporal_extent:
range: TimeSpan
required: false
inlined: true
description: 'Temporal extent of this activity.
Replaces has_timespan, start_date, end_date.
Uses CIDOC-CRM four-point temporal model for fuzzy bounds.
'
examples:
- value:
begin_of_the_begin: '2025-01-15'
end_of_the_end: '2025-03-31'
description: Q1 2025 activity period
is_or_was_succeeded_by:
range: Activity
multivalued: true
inlined: false
description: Activity/activities that follow this one.
examples:
- value: https://nde.nl/ontology/hc/activity/conservation-treatment-2025
description: Conservation follows condition survey
preceding_activity:
range: Activity
inlined: false
description: Activity that preceded this one.
examples:
- value: https://nde.nl/ontology/hc/activity/condition-survey-2024
description: Condition survey informed this conservation treatment
has_or_had_status:
range: string
required: false
description: Current status of the activity.
examples:
- value: IN_PROGRESS
description: Activity currently underway
- value: COMPLETED
description: Activity finished
- value: PLANNED
description: Activity scheduled for future
note:
range: string
multivalued: true
description: Additional notes about the activity.
annotations:
specificity_score: '0.50'
specificity_rationale: Moderately specific - Activity is a core domain concept but broadly applicable across all heritage custodian types.
has_or_had_score: null
custodian_types: "['*']"
custodian_types_rationale: Universal utility concept
comments:
- Base class for all heritage domain activities
- Extended by CurationActivity, ConservationActivity, etc.
- 'Uses generic slots: has_activity_identifier, has_or_had_activity_type, has_timespan'
- PROV-O primary alignment for provenance tracking
- Supports activity chaining via is_or_was_succeeded_by/preceding_activity
see_also:
- https://www.w3.org/TR/prov-o/
- http://www.cidoc-crm.org/html/cidoc_crm_v7.1.3.html#E7
- https://www.ica.org/standards/RiC/ontology
examples:
- value:
has_or_had_identifier:
identifier_value: https://nde.nl/ontology/hc/activity/rijksmuseum-inventory-2025-001
has_or_had_label: 2025 Annual Collection Inventory - Dutch Masters
has_or_had_activity_type:
- CurationActivityType
has_or_had_description: "Annual physical inventory of the Dutch Masters collection \n(Gallery of Honour and adjacent galleries). Spot-check methodology \nwith 20% sample verification against CMS records.\n"
temporal_extent:
begin_of_the_begin: '2025-01-15'
end_of_the_end: '2025-03-31'
has_or_had_status: IN_PROGRESS
description: Inventory activity at Rijksmuseum
- value:
has_or_had_identifier:
identifier_value: https://nde.nl/ontology/hc/activity/kb-digitization-medieval-2024
has_or_had_label: Medieval Manuscripts Digitization Project
has_or_had_activity_type:
- DigitizationActivityType
- ResearchActivityType
has_or_had_description: "High-resolution digitization of 342 medieval manuscripts with \nHTR processing and metadata enhancement. IIIF-compliant output.\n"
temporal_extent:
begin_of_the_begin: '2024-03-01'
end_of_the_end: '2025-12-31'
has_or_had_status: IN_PROGRESS
preceding_activity: https://nde.nl/ontology/hc/activity/kb-condition-survey-2023
description: Digitization and research project at KB