b34992b1d3
Extends migration to all class types (museums, libraries, galleries, etc.) New slots added to class_metadata_slots.yaml: - RiC-O: rico_record_set_type, rico_organizational_principle, rico_has_or_had_holder, rico_note - Multilingual: label_de, label_es, label_fr, label_nl, label_it, label_pt - Scope: scope_includes, scope_excludes, custodian_only, organizational_level, geographic_restriction - Notes: privacy_note, preservation_note, legal_note Migration script now handles 30+ annotation types. All migrated schemas pass linkml-validate. Total: 387 class files now use proper slots instead of annotations.
190 lines
7.5 KiB
YAML
190 lines
7.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
|
|
- ./ConfidenceMeasure
|
|
- ../slots/id
|
|
- ../slots/activity_type
|
|
- ../slots/method
|
|
- ../slots/responsible_agent
|
|
- ../slots/temporal_extent
|
|
- ../slots/used
|
|
- ../slots/confidence_score
|
|
- ../slots/justification
|
|
- ../slots/class_metadata_slots
|
|
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:
|
|
- activity_type
|
|
- confidence_score
|
|
- id
|
|
- justification
|
|
- method
|
|
- responsible_agent
|
|
- specificity_annotation
|
|
- template_specificity
|
|
- temporal_extent
|
|
- used
|
|
slot_usage:
|
|
activity_type:
|
|
slot_uri: prov:Activity
|
|
description: |
|
|
Type of reconstruction activity (manual, algorithmic, hybrid, expert review).
|
|
PROV-O: Activity type classification.
|
|
range: ReconstructionActivityTypeEnum
|
|
method:
|
|
slot_uri: dcterms:description
|
|
description: |
|
|
Detailed method description for entity resolution.
|
|
Dublin Core: description for methodology documentation.
|
|
range: string
|
|
responsible_agent:
|
|
slot_uri: prov:wasAssociatedWith
|
|
description: |
|
|
ReconstructionAgent responsible for reconstruction (REQUIRED).
|
|
PROV-O: wasAssociatedWith links Activity to responsible ReconstructionAgent.
|
|
range: ReconstructionAgent
|
|
temporal_extent:
|
|
slot_uri: crm:P4_has_time-span
|
|
description: |
|
|
Temporal extent of reconstruction activity (start/end times with fuzzy boundaries).
|
|
CIDOC-CRM: P4_has_time-span links Activity to TimeSpan.
|
|
PROV-O: Maps to combination of prov:startedAtTime and prov:endedAtTime.
|
|
|
|
For precise timestamps:
|
|
- Set begin_of_the_begin == end_of_the_begin (activity start)
|
|
- Set begin_of_the_end == end_of_the_end (activity end)
|
|
|
|
For activities with uncertain duration, use fuzzy boundaries:
|
|
- begin_of_the_begin: Earliest possible start
|
|
- end_of_the_begin: Latest possible start
|
|
- begin_of_the_end: Earliest possible end
|
|
- end_of_the_end: Latest possible end
|
|
range: TimeSpan
|
|
exact_mappings:
|
|
- crm:P4_has_time-span
|
|
related_mappings:
|
|
- prov:startedAtTime
|
|
- prov:endedAtTime
|
|
used:
|
|
slot_uri: prov:used
|
|
description: |
|
|
CustodianObservation(s) used as input for this reconstruction activity (REQUIRED).
|
|
|
|
PROV-O Pattern: Activity prov:used Entity
|
|
- Multiple observations can contribute to a single reconstruction
|
|
- Observations are INPUT entities consumed by the activity
|
|
- Activity may generate CustodianLegalStatus (success) OR CustodianName (partial) OR nothing (failure)
|
|
|
|
This is the PRIMARY input link in the observation→reconstruction flow.
|
|
range: CustodianObservation
|
|
multivalued: true
|
|
required: true
|
|
confidence_score:
|
|
slot_uri: prov:confidence
|
|
description: |
|
|
Confidence in the reconstruction activity's PROCESS and methodology.
|
|
|
|
CRITICAL: Measures quality of the PROCESS, not the result!
|
|
- High confidence = Strong methodology, reliable sources, clear evidence
|
|
- Low confidence = Weak matching, ambiguous sources, uncertain reconciliation
|
|
|
|
Range: 0.0 (low confidence) to 1.0 (high confidence)
|
|
|
|
PROV-O Extension: prov:confidence for activity quality assessment.
|
|
range: ConfidenceMeasure
|
|
required: false
|
|
justification:
|
|
slot_uri: prov:qualifiedAttribution
|
|
description: |
|
|
Justification for entity resolution decisions.
|
|
PROV-O: qualifiedAttribution for detailed provenance rationale.
|
|
range: string
|
|
specificity_annotation:
|
|
range: SpecificityAnnotation
|
|
inlined: true
|
|
template_specificity:
|
|
range: TemplateSpecificityScores
|
|
inlined: true
|
|
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'
|
|
used_sources:
|
|
- 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'
|
|
used_sources:
|
|
- https://isil.org/NL
|
|
justification: Automated matching with high confidence scores (>0.90) for
|
|
85% of entities
|
|
description: Algorithmic reconstruction with precise automated timestamps
|