glam/schemas/20251121/linkml/modules/classes/ReconstructionActivity.yaml
kempersc fc405445c6 Refactor and update schema definitions
- Removed obsolete slots: `has_or_had_custodian_observation`, `provider`, and `specificity_annotation`.
- Updated `has_or_had_score` slot to use `SpecificityScore` class and modified its description and examples.
- Added new slots: `end_seconds`, `end_time`, `has_archive_path`, `has_or_had_custodian_name`, `protocol_name`, and `protocol_version`.
- Introduced a script `check_annotation_types.py` to validate the presence and structure of `custodian_types` in YAML files.
- Added a script `update_specificity.py` to automate updates related to `SpecificityAnnotation` to `SpecificityScore`.
2026-02-01 19:55:38 +01:00

102 lines
No EOL
4.3 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
- ../enums/ReconstructionActivityTypeEnum
- ../metadata
- ../slots/generates_or_generated
- ../slots/has_or_had_score # was: template_specificity
- ../slots/has_or_had_value # was: has_or_had_confidence_measure
- ../slots/justification
- ../slots/method
- ../slots/responsible_agent
- ../slots/temporal_extent
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_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
- justification
- method
- responsible_agent
- has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
- temporal_extent
slot_usage:
method:
range: string
responsible_agent:
range: ReconstructionAgent
temporal_extent:
range: TimeSpan
multivalued: true
required: true
has_or_had_value: # was: has_or_had_confidence_measure - migrated per Rule 53 (2026-01-28)
required: false
range: ConfidenceValue
generates_or_generated:
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"
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
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'
justification: Name variations 'Stedelijk Museum Amsterdam' and 'Stedelijk Museum' confirmed as same institution via
ISIL code NL-AsdSM
- value:
method: Fuzzy string matching algorithm (Levenshtein distance threshold 0.85) applied to 1,200 ISIL registry entries
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'
justification: Automated matching with high confidence scores (>0.90) for 85% of entities