glam/schemas/20251121/linkml/modules/classes/ReconstructionActivity.yaml
kempersc ca4a54181e Refactor schema files to improve clarity and maintainability
- Updated WorldCatIdentifier.yaml to remove unnecessary description and ensure consistent formatting.
- Enhanced WorldHeritageSite.yaml by breaking long description into multiple lines for better readability and removed unused attributes.
- Simplified WritingSystem.yaml by removing redundant attributes and ensuring consistent formatting.
- Cleaned up XPathScore.yaml by removing unnecessary attributes and ensuring consistent formatting.
- Improved YoutubeChannel.yaml by breaking long description into multiple lines for better readability.
- Enhanced YoutubeEnrichment.yaml by breaking long description into multiple lines for better readability.
- Updated YoutubeVideo.yaml to break long description into multiple lines and removed legacy field name.
- Refined has_or_had_affiliation.yaml by removing unnecessary comments and ensuring clarity.
- Cleaned up is_or_was_retrieved_at.yaml by removing unnecessary comments and ensuring clarity.
- Added rules for generic slots and avoiding rough edits in schema files to maintain structural integrity.
- Introduced changes_or_changed_through.yaml to define a new slot for linking entities to change events.
2026-01-31 00:46:23 +01:00

113 lines
No EOL
4.6 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/specificity_annotation
- ../slots/temporal_extent
- ./ConfidenceValue
- ./CustodianObservation
- ./Output
- ./ReconstructionAgent
- ./SpecificityAnnotation
- ./TemplateSpecificityScore # was: TemplateSpecificityScores
- ./TemplateSpecificityType
- ./TemplateSpecificityTypes
- ./TimeSpan
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
- specificity_annotation
- 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