glam/schemas/20251121/linkml/modules/classes/StorageCondition.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

416 lines
No EOL
18 KiB
YAML

id: https://nde.nl/ontology/hc/class/StorageCondition
name: storage_condition_class
title: Storage Condition Observation Class
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
crm: http://www.cidoc-crm.org/cidoc-crm/
premis: http://www.loc.gov/premis/rdf/v3/
prov: http://www.w3.org/ns/prov#
schema: http://schema.org/
dcterms: http://purl.org/dc/terms/
pico: https://personsincontext.org/model#
default_prefix: hc
imports:
- linkml:types
- ../enums/StorageConditionStatusEnum
- ../enums/StorageObserverTypeEnum
- ../slots/has_or_had_category
- ../slots/has_or_had_identifier # was: condition_id
- ../slots/has_or_had_measurement
- ../slots/has_or_had_measurement_type
- ../slots/has_or_had_note # was: category_note
- ../slots/has_or_had_provenance
- ../slots/has_or_had_score # was: template_specificity
- ../slots/has_or_had_status
- ../slots/includes_or_included
- ../slots/indicates_or_indicated # was: follow_up_date
- ../slots/is_official_assessment
- ../slots/is_or_was_based_on
- ../slots/is_or_was_generated_by
- ../slots/measurement_data
- ../slots/observation_date
- ../slots/observation_note
- ../slots/observation_period
- ../slots/observer_affiliation
- ../slots/observer_name
- ../slots/observer_type
- ../slots/overall_status
- ../slots/refers_to_storage
- ../slots/remediation_note
- ../slots/remediation_required
- ../slots/specificity_annotation
- ../slots/supersedes_or_superseded
- ../slots/supersedes_or_superseded # was: supersede
- ./AssessmentCategory
- ./AssessmentCategoryType
- ./AssessmentCategoryTypes
- ./CategoryStatus
- ./ComplianceStatus
- ./ConfidenceMethod
- ./ConfidenceScore
- ./ConservationReview # for indicates_or_indicated range
- ./Documentation
- ./GenerationEvent
- ./Identifier
- ./Measurement
- ./MeasurementType
- ./MeasurementTypes
- ./Note # for has_or_had_note range
- ./Provenance
- ./SpecificityAnnotation
- ./Storage
- ./TemplateSpecificityScore # was: TemplateSpecificityScores
- ./TemplateSpecificityType
- ./TemplateSpecificityTypes
- ./TimeSpan
classes:
StorageCondition:
class_uri: hc:StorageConditionAssessment
description: "An observation-based report of actual storage conditions.\n\n**DEFINITION**:\n\nStorageCondition represents\
\ a specific assessment or observation of\na storage facility's actual state at a point in time. Multiple\nobservations\
\ can exist for the same storage facility, from different\nobservers with potentially different findings.\n\n**CRITICAL\
\ DISTINCTION**:\n\n- **StorageCondition** (THIS CLASS): What IS - actual observed state\n- **StorageConditionPolicy**:\
\ What SHOULD BE - designed/intended conditions\n\nThe gap between policy and observed condition is often significant\n\
and represents a critical transparency concern.\n\n**PiCo OBSERVATION PATTERN**:\n\nFollowing the Person in Context\
\ (PiCo) ontology pattern, observations\nare NOT assertions of truth but reports from specific observers with\ntheir\
\ own perspectives and potential biases.\n\nA journalist discovering white ants in a storage facility creates an\nobservation\
\ with:\n- observer_type: JOURNALIST\n- condition_status: CRITICAL\n- category: PEST_CONTROL\n- observation_notes: \"\
White ants discovered in main document depot\"\n\nThis observation exists ALONGSIDE any official self-assessment, without\n\
requiring reconciliation of conflicting reports.\n\n**PROV-O ALIGNMENT**:\n\n`prov:Activity` - \"An activity is something\
\ that occurs over a period\nof time and acts upon or with entities; it may include consuming,\nprocessing, transforming,\
\ modifying, relocating, using, or generating\nentities.\"\n\nThe observation activity:\n- `prov:wasAssociatedWith`\
\ → observer (prov:Agent)\n- `prov:used` → storage facility being observed\n- `prov:atTime` → observation timestamp\n\
- `prov:generated` → this condition report\n\n**RELATIONSHIP TO STORAGE CLASS**:\n\n```\nStorage\n │\n ├── storage_conditions[]\
\ → StorageCondition (THIS CLASS)\n │ ├── Observation 1: Internal staff, 2024-06 → GOOD\n │ ├── Observation\
\ 2: Journalist, 2024-09 → CRITICAL (pest issue)\n │ └── Observation 3: Government inspector, 2024-10 → POOR\n\
\ │\n └── condition_policy → StorageConditionPolicy (what SHOULD be)\n```\n\n**USE CASES**:\n\n1. **Regular Internal\
\ Assessment**:\n - observer_type: INTERNAL_STAFF\n - is_official_assessment: true\n - category_assessments: Temperature=GOOD,\
\ Humidity=GOOD\n \n2. **Investigative Journalism**:\n - observer_type: JOURNALIST\n - is_official_assessment:\
\ false\n - observation_notes: \"Photographs show water damage in basement storage\"\n - evidence_documentation:\
\ [URLs to published article]\n \n3. **Government Inspection**:\n - observer_type: GOVERNMENT_INSPECTOR\n - is_official_assessment:\
\ true (regulatory authority)\n - compliance_status: \"NON_COMPLIANT\"\n - remediation_required: true\n \n4. **Automated\
\ Monitoring**:\n - observer_type: AUTOMATED_SYSTEM\n - category: TEMPERATURE\n - measurement_value: \"23.5°C\"\
\n - threshold_exceeded: true\n"
exact_mappings:
- hc:StorageConditionAssessment
- crm:E14_Condition_Assessment
- prov:Activity
close_mappings:
- crm:E7_Activity
- premis:Event
- pico:Observation
- hc:StorageEnvironmentObservation
slots:
- includes_or_included
# REMOVED 2026-01-22: compliance_status - migrated to has_or_had_status + ComplianceStatus (Rule 53)
- has_or_had_status
- has_or_had_identifier # was: condition_id - migrated per Rule 53 (2026-01-18)
# REMOVED 2026-01-19: confidence_score - migrated to is_or_was_generated_by (Rule 53)
- is_or_was_generated_by
- has_or_had_provenance
- indicates_or_indicated # was: follow_up_date - migrated per Rule 53 (2026-01-26)
- is_official_assessment
- measurement_data
- observation_date
- observation_note
- observation_period
- observer_affiliation
- observer_name
- observer_type
- overall_status
- refers_to_storage
- remediation_note
- remediation_required
- specificity_annotation
- supersedes_or_superseded
- has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
# has_assessment_category REMOVED - migrated to has_or_had_category (Rule 53)
- has_or_had_category
slot_usage:
has_or_had_identifier: # was: condition_id - migrated per Rule 53 (2026-01-18)
range: uriorcurie
inlined: true
required: true
identifier: true
examples:
- value:
identifier_value: "https://nde.nl/ontology/hc/condition/rijksmuseum-depot-2024-q2"
refers_to_storage:
range: Storage
required: true
examples:
- value: https://nde.nl/ontology/hc/storage/rijksmuseum-depot-amersfoort
observation_date:
range: date
required: true
examples:
- value: '2024-09-15'
observation_period:
range: TimeSpan
examples:
- value: Q2 2024 (April-June)
observer_type:
range: StorageObserverTypeEnum
required: true
examples:
- value: JOURNALIST
- value: INTERNAL_STAFF
- value: GOVERNMENT_INSPECTOR
observer_name:
range: string
examples:
- value: Maria van der Berg
- value: Collections Management Team
- value: Anonymous (confidential source)
observer_affiliation:
range: string
examples:
- value: De Volkskrant
- value: Rijksdienst voor het Cultureel Erfgoed
- value: ABC Conservation Consultants
is_official_assessment:
range: boolean
required: true
examples:
- value: true
- value: false
overall_status:
range: StorageConditionStatusEnum
required: true
examples:
- value: CRITICAL
- value: GOOD
includes_or_included:
range: StorageConditionCategoryAssessment
multivalued: true
inlined_as_list: true
examples:
- value:
- has_or_had_category:
has_or_had_type: TEMPERATURE
has_or_had_status:
has_or_had_type: GOOD
has_or_had_measurement:
- has_or_had_unit:
has_or_had_label: Celsius
measurement_value: 19.5
- has_or_had_category:
has_or_had_type: PEST_CONTROL
has_or_had_status:
has_or_had_type: CRITICAL
has_or_had_note: # was: note - migrated per Rule 53/56 (2026-01-18)
- note_type: category
note_content: White ants discovered in main depot area
has_or_had_category:
range: AssessmentCategory
multivalued: true
inlined: true
examples:
- value:
has_or_had_category: PEST_CONTROL
observation_note:
range: string
examples:
- value: During routine inspection, white ant damage discovered in south wall of main document storage. Approximately
50 linear meters of shelving affected. Evidence of active infestation - live insects observed. Immediate treatment
recommended.
has_or_had_provenance:
range: string
multivalued: true
inlined: true
examples:
- value:
is_or_was_based_on:
has_or_had_url:
url_value: "https://www.volkskrant.nl/archive-pest-investigation-2024"
- value:
is_or_was_based_on:
has_or_had_url:
url_value: "https://archive.org/evidence/photos/depot-damage-20240915.zip"
measurement_data:
range: string
examples:
- value: '{"temperature_celsius": 23.5, "humidity_percent": 58, "threshold_exceeded": true}'
# MIGRATED 2026-01-22: compliance_status → has_or_had_status + ComplianceStatus (Rule 53)
has_or_had_status:
range: ComplianceStatus
inlined: true
required: false
examples:
- value:
has_or_had_type: "NON_COMPLIANT"
has_or_had_label: "EN 16893 Non-Compliant"
standard_reference: "EN 16893:2018"
remediation_required: true
description: Does not meet EN 16893:2018 requirements
- value:
has_or_had_type: "COMPLIANT"
has_or_had_label: "ISO 11799 Compliant"
standard_reference: "ISO 11799:2015"
remediation_required:
range: boolean
examples:
- value: true
remediation_note:
range: string
examples:
- value: 1. Engage licensed pest control immediately 2. Quarantine affected materials 3. Survey adjacent storage areas
4. Install additional monitoring traps 5. Report to Heritage Inspectorate within 48 hours
indicates_or_indicated: # was: follow_up_date - migrated per Rule 53 (2026-01-26)
range: ConservationReview
inlined: true
required: false
examples:
- value:
temporal_extent:
begin_of_the_begin: "2024-12-01"
has_or_had_label: "Post-treatment verification inspection"
# REMOVED 2026-01-19: confidence_score - migrated to is_or_was_generated_by (Rule 53)
is_or_was_generated_by:
range: GenerationEvent
required: false
inlined: true
examples:
- value:
has_or_had_score:
has_or_had_score: 0.95
has_or_had_method: "government_inspection"
- value:
has_or_had_score:
has_or_had_score: 0.75
has_or_had_method: "journalist_investigation"
# supersede migrated to supersedes_or_superseded
# This domain-specific slot has explicit StorageCondition range
# to avoid OWL type ambiguity (DatatypeProperty vs ObjectProperty conflict)
comments:
- 'MIGRATED 2026-01-19: confidence_score → is_or_was_generated_by + GenerationEvent + ConfidenceScore (Rule 53)'
- Observations are NOT assertions of truth - they are reports from specific observers
- Multiple observations may exist for same storage with conflicting findings
- Gap between observed conditions and policy conditions is critical transparency metric
- External observations (journalists, researchers) may reveal unreported issues
- Official assessments vs external investigations treated equally as data
- Automated system observations provide objective measurements but require calibration
see_also:
- http://www.w3.org/ns/prov#Activity
- https://www.loc.gov/premis/rdf/v3/Event
examples:
- value:
has_or_had_identifier: # was: condition_id - migrated per Rule 53 (2026-01-18)
identifier_value: "https://nde.nl/ontology/hc/condition/depot-pest-investigation-2024"
refers_to_storage: https://nde.nl/ontology/hc/storage/national-archive-depot-b
observation_date: '2024-09-15'
observer_type: JOURNALIST
observer_name: Jan de Vries
observer_affiliation: De Volkskrant
is_official_assessment: false
overall_status: CRITICAL
includes_or_included:
- has_or_had_category:
has_or_had_type: PEST_CONTROL
has_or_had_status:
has_or_had_type: CRITICAL
has_or_had_note: # was: note - migrated per Rule 53/56 (2026-01-18)
- note_type: category
note_content: White ants discovered in main document depot
observation_notes: >-
Investigative visit revealed active termite infestation in south section of Document Depot B. Approximately
50 linear meters of historical documents at risk. Institution was unaware of extent of damage until contacted for
comment.
has_or_had_provenance:
- is_or_was_based_on:
has_or_had_url:
url_value: "https://www.volkskrant.nl/archive-pest-crisis-2024"
remediation_required: true
is_or_was_generated_by: # was: confidence_score - migrated per Rule 53 (2026-01-19)
has_or_had_score:
has_or_had_score: 0.85
has_or_had_method: "journalist_investigation"
- value:
has_or_had_identifier: # was: condition_id - migrated per Rule 53 (2026-01-18)
identifier_value: "https://nde.nl/ontology/hc/condition/rijksmuseum-q2-2024"
refers_to_storage: https://nde.nl/ontology/hc/storage/rijksmuseum-depot-amersfoort
observation_date: '2024-06-30'
observation_period:
observer_type: INTERNAL_STAFF
observer_name: Collections Management Team
observer_affiliation: Rijksmuseum
is_official_assessment: true
overall_status: GOOD
includes_or_included:
- has_or_had_category:
has_or_had_type: TEMPERATURE
has_or_had_status:
has_or_had_type: EXCELLENT
has_or_had_measurement:
- measurement_value: 18.5
has_or_had_unit:
has_or_had_label: Celsius
- has_or_had_category:
has_or_had_type: HUMIDITY
has_or_had_status:
has_or_had_type: GOOD
has_or_had_measurement:
- measurement_value: 48
has_or_had_unit:
has_or_had_label: Percent
- has_or_had_category:
has_or_had_type: PEST_CONTROL
has_or_had_status:
has_or_had_type: GOOD
has_or_had_note: # was: note - migrated per Rule 53/56 (2026-01-18)
- note_type: category
note_content: No pest activity detected in monitoring traps
- has_or_had_category:
has_or_had_type: SECURITY
has_or_had_status:
has_or_had_type: EXCELLENT
observation_notes: Quarterly facilities review. All parameters within policy ranges.
# MIGRATED 2026-01-22: compliance_status → has_or_had_status + ComplianceStatus (Rule 53)
has_or_had_status:
has_or_had_type: "COMPLIANT"
standard_reference: "ISO 11799:2015"
remediation_required: false
is_or_was_generated_by: # was: confidence_score - migrated per Rule 53 (2026-01-19)
has_or_had_score:
has_or_had_score: 0.9
has_or_had_method: "internal_assessment"
StorageConditionCategoryAssessment:
class_uri: hc:StorageConditionCategoryAssessment
description: 'Individual category assessment within a StorageCondition observation.
Allows granular reporting of different condition categories with
independent status levels.
'
slots:
- has_or_had_category
- has_or_had_measurement # was: category_measurement - migrated per Rule 53/56 (2026-01-24)
- has_or_had_note # was: category_note - migrated per Rule 53/56 (2026-01-18)
- has_or_had_status # was: category_status - migrated per Rule 53/56 (2026-01-24)
- specificity_annotation
- has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
slot_usage:
has_or_had_category:
range: AssessmentCategory
required: true
inlined: true
has_or_had_status: # was: category_status - migrated per Rule 53/56 (2026-01-24)
range: CategoryStatus
required: true
inlined: true
has_or_had_measurement: # was: category_measurement - migrated per Rule 53/56 (2026-01-24)
range: Measurement
inlined: true
multivalued: true
has_or_had_note: # was: category_note - migrated per Rule 53/56 (2026-01-18)
range: string
multivalued: true
inlined: true
inlined_as_list: true
examples:
- value:
- note_type: category
note_content: "White ants discovered in main depot area"