glam/schemas/20251121/linkml/modules/classes/ReconstructionActivity.yaml
kempersc c1946e93f9 Refactor VideoPost and WebObservation schemas; remove deprecated slots and migrate to new structures
- Updated VideoPost.yaml to include new slots and remove deprecated ones, enhancing video-specific properties.
- Removed extraction_confidence from WebObservation.yaml, streamlining the schema.
- Deleted obsolete slot files: characteristics.yaml, class_definition.yaml, confidence.yaml, confidence_method.yaml, confidence_score.yaml, confidence_value.yaml, count.yaml, and hosts_branch.yaml.
- Introduced ghost_slots.txt to track unused slots.
- Archived previous versions of characteristics, class_definition, confidence, confidence_method, confidence_score, confidence_value, count, and hosts_branch slots for historical reference.
- Added new slots: has_or_had_citation, has_or_had_city_code, and is_or_was_location_of with appropriate descriptions and mappings.
2026-01-28 15:04:11 +01:00

155 lines
6.5 KiB
YAML

id: https://nde.nl/ontology/hc/class/ReconstructionActivity
name: reconstruction_activity_class
title: ReconstructionActivity Class
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
prov: http://www.w3.org/ns/prov#
rico: https://www.ica.org/standards/RiC/ontology#
crm: http://www.cidoc-crm.org/cidoc-crm/
schema: http://schema.org/
dcterms: http://purl.org/dc/terms/
imports:
- linkml:types
- ../metadata
- ../enums/ReconstructionActivityTypeEnum
- ./ReconstructionAgent
- ./TimeSpan
- ./CustodianObservation
- ./ConfidenceValue
- ../slots/id
- ../slots/has_or_had_activity_type
- ../slots/method
- ../slots/responsible_agent
- ../slots/temporal_extent
# REMOVED 2026-01-15: ../slots/used - migrated to has_or_had_used_source with CustodianObservation range (Rule 53)
- ../slots/has_or_had_used_source
- ../slots/has_or_had_value # was: has_or_had_confidence_measure - migrated per Rule 53 (2026-01-28)
- ../slots/justification
- ../slots/specificity_annotation
- ../slots/has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
- ./SpecificityAnnotation
- ./TemplateSpecificityScore # was: TemplateSpecificityScores - migrated per Rule 53 (2026-01-17)
- ./TemplateSpecificityType
- ./TemplateSpecificityTypes
# has_or_had_generate REMOVED - migrated to generates_or_generated + Output (Rule 53)
- ../slots/generates_or_generated
- ./Output
default_prefix: hc
classes:
ReconstructionActivity:
class_uri: prov:Activity
description: "An activity that creates a CustodianLegalStatus by reconciling and \nresolving multiple CustodianObservations\
\ into a single entity.\n\nThis documents:\n- Entity resolution method (manual curation, algorithmic matching, etc.)\n\
- Responsible agent (person, custodian, software)\n- Temporal extent (start/end dates)\n- Provenance and justification\n"
exact_mappings:
- prov:Activity
close_mappings:
- rico:Activity
- crm:E7_Activity
- schema:Action
related_mappings:
- crm:E13_Attribute_Assignment
slots:
- has_or_had_activity_type
- has_or_had_value # was: has_or_had_confidence_measure - migrated per Rule 53 (2026-01-28)
# has_or_had_generate REMOVED - migrated to generates_or_generated (Rule 53)
- generates_or_generated
- id
- justification
- method
- responsible_agent
- specificity_annotation
- has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
- temporal_extent
- has_or_had_used_source
slot_usage:
has_or_had_activity_type:
range: ReconstructionActivityTypeEnum
method:
range: string
responsible_agent:
range: ReconstructionAgent
temporal_extent:
range: TimeSpan
has_or_had_used_source:
description: |
CustodianObservation(s) used as input for reconstruction activity.
MIGRATED 2026-01-15: Replaces 'used' slot per Rule 53 - uses prov:used slot_uri.
range: CustodianObservation
multivalued: true
required: true
has_or_had_value: # was: has_or_had_confidence_measure - migrated per Rule 53 (2026-01-28)
required: false
description: |
Confidence in the reconstruction activity's PROCESS and methodology.
MIGRATED 2026-01-28: Uses ConfidenceValue class via has_or_had_value slot.
range: ConfidenceValue
generates_or_generated:
description: |
Output(s) generated by the reconstruction activity.
MIGRATED from has_or_had_generate per Rule 53.
Uses Output class.
range: Output
multivalued: true
inlined: true
examples:
- value:
has_or_had_label: "Reconstructed Custodian Record"
has_or_had_description: "Merged record from ISIL and Wikidata sources"
description: Generated output
justification:
range: string
comments:
- Documents the 'how' (method) and 'who' (responsible_agent) of entity resolution and reconstruction
- Enables provenance tracking for data quality assessment and citation purposes
- 'Example methods: manual expert curation, algorithmic fuzzy matching, hybrid semi-automated with human review'
- Uses TimeSpan for temporal_extent to support fuzzy temporal boundaries and CIDOC-CRM alignment
- For precise timestamps (common in automated activities), set TimeSpan boundaries to identical values
see_also:
- https://www.w3.org/TR/prov-o/#Activity
- https://github.com/FICLIT/PiCo
- https://cidoc-crm.org/html/cidoc_crm_v7.1.3.html#P4
examples:
- value:
id: https://w3id.org/heritage/custodian/activity/reconstruction-001
activity_type: MANUAL_CURATION
method: Expert historian reviewed 15 archival sources to reconcile conflicting references to 'Stedelijk Museum' in
Amsterdam
responsible_agent:
id: https://w3id.org/heritage/custodian/agent/curator-jdoe
agent_type: PERSON
name: Jane Doe
temporal_extent:
begin_of_the_begin: '2025-01-15T09:00:00Z'
end_of_the_begin: '2025-01-15T09:00:00Z'
begin_of_the_end: '2025-01-15T17:30:00Z'
end_of_the_end: '2025-01-15T17:30:00Z'
has_or_had_used_source:
- https://archief.amsterdam/nl/inventaris/433.php
- https://www.wikidata.org/wiki/Q621531
justification: Name variations 'Stedelijk Museum Amsterdam' and 'Stedelijk Museum' confirmed as same institution via
ISIL code NL-AsdSM
description: Manual curation activity with precise timestamps
- value:
id: https://w3id.org/heritage/custodian/activity/reconstruction-002
activity_type: ALGORITHMIC_MATCHING
method: Fuzzy string matching algorithm (Levenshtein distance threshold 0.85) applied to 1,200 ISIL registry entries
responsible_agent:
id: https://w3id.org/heritage/custodian/agent/dedupe-v2.1
agent_type: SOFTWARE
name: Heritage Deduplication Tool v2.1
temporal_extent:
begin_of_the_begin: '2025-01-20T02:00:00Z'
end_of_the_begin: '2025-01-20T02:00:00Z'
begin_of_the_end: '2025-01-20T02:15:00Z'
end_of_the_end: '2025-01-20T02:15:00Z'
has_or_had_used_source:
- https://isil.org/NL
justification: Automated matching with high confidence scores (>0.90) for 85% of entities
description: Algorithmic reconstruction with precise automated timestamps