glam/schemas/20251121/linkml/modules/classes/Material.yaml
kempersc 4319f38c05 Add archived slots for audience size, audience type, and capacity metrics
- Created new YAML files for audience size and audience type slots, defining their properties and annotations.
- Added archived capacity slots including cubic meters, linear meters, item count, and descriptions, with appropriate URIs and ranges.
- Introduced a template specificity slot for context-aware RAG filtering.
- Consolidated capacity-related slots into a unified structure, including has_or_had_capacity, capacity_type, and capacity_value, with detailed descriptions and examples.
2026-01-17 18:53:23 +01:00

223 lines
8.3 KiB
YAML

# Material - Class representing physical materials/substances for storage categorization
#
# Generation date: 2026-01-16
# Rule compliance: 37 (specificity scores), 38 (slot centralization)
# Created for: target_material migration per slot_fixes.yaml (Rule 53/56)
#
# MIGRATION: Replaces simple string-based target_material with structured class
# Used by: EnvironmentalZoneType, StorageType
id: https://nde.nl/ontology/hc/class/Material
name: material_class
title: Material Class
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
crm: http://www.cidoc-crm.org/cidoc-crm/
schema: http://schema.org/
skos: http://www.w3.org/2004/02/skos/core#
dcterms: http://purl.org/dc/terms/
wd: http://www.wikidata.org/entity/
aat: http://vocab.getty.edu/aat/
default_prefix: hc
imports:
- linkml:types
- ../slots/has_or_had_identifier
- ../slots/has_or_had_label
- ../slots/has_or_had_description
- ../slots/has_or_had_type
- ./MaterialType
- ../slots/is_or_was_equivalent_to
- ./WikiDataIdentifier
- ../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
classes:
Material:
class_uri: crm:E57_Material
description: |
Represents a physical material or substance, typically used to categorize
what types of heritage objects a storage environment is designed to preserve.
**DEFINITION**:
Material represents the physical substance from which heritage objects are made.
This class enables structured representation of target materials for storage
environments, replacing simple string lists with semantically rich entities.
**CIDOC-CRM ALIGNMENT**:
Maps to `crm:E57_Material` - "A type of material of which things can be made."
E57_Material provides vocabulary for describing the physical composition of
heritage objects and the environmental requirements for their preservation.
**USE CASES**:
1. **Storage Environment Classification**:
- EnvironmentalZoneType specifies which materials it's designed for
- StorageType indicates suitable material types
2. **Preservation Requirements**:
- Different materials have different climate requirements
- Paper vs. film vs. textiles have distinct needs
3. **Collection Categorization**:
- Materials provide another facet for classifying collections
- Enables material-specific search and discovery
**EXAMPLES**:
- Paper, parchment, vellum (archival materials)
- Nitrate film, acetate film, polyester film (photographic)
- Wool, silk, cotton, linen (textiles)
- Bronze, iron, silver (metals)
- Oil paint, acrylic, tempera (art materials)
**MIGRATION NOTE (2026-01-16)**:
This class replaces simple string-based `target_material` slot per Rule 53/56.
Provides structured representation with type classification, Wikidata alignment,
and extensibility for future material-specific properties.
exact_mappings:
- crm:E57_Material
close_mappings:
- schema:material
- aat:300010358
related_mappings:
- crm:E55_Type
- skos:Concept
slots:
- has_or_had_identifier
- has_or_had_label
- has_or_had_description
- has_or_had_type
- is_or_was_equivalent_to
- specificity_annotation
- has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
slot_usage:
has_or_had_identifier:
range: uriorcurie
identifier: true
required: true
pattern: "^https://nde\\.nl/ontology/hc/material/[a-z0-9-]+$"
examples:
- value: https://nde.nl/ontology/hc/material/paper
description: Paper material identifier
- value: https://nde.nl/ontology/hc/material/nitrate-film
description: Nitrate film material identifier
has_or_had_label:
range: string
required: true
multivalued: true
examples:
- value: ["paper@en", "papier@nl"]
- value: ["nitrate film@en", "nitraatfilm@nl"]
- value: ["parchment@en", "perkament@nl"]
has_or_had_description:
range: string
examples:
- value: "Cellulose-based material made from wood pulp or cotton fibers, used for documents, books, and prints."
has_or_had_type:
range: MaterialType
description: |
Classification of this material into a type category.
Enables hierarchical organization of materials.
examples:
- value: https://nde.nl/ontology/hc/material-type/organic
description: Organic material category
is_or_was_equivalent_to:
range: WikiDataIdentifier
multivalued: true
inlined: true
inlined_as_list: true
description: |
Wikidata equivalence for this material.
examples:
- value:
- qid: "Q11472"
label: "paper"
description: Wikidata equivalence for paper
- value:
- qid: "Q1201597"
label: "nitrate film"
description: Wikidata equivalence for nitrate film
annotations:
custodian_types: '["*"]'
custodian_types_rationale: "Materials apply to all custodian types with collections"
specificity_score: "0.50"
specificity_rationale: "Moderately specific - materials relevant for preservation across heritage domains."
has_or_had_score: # was: template_specificity - migrated per Rule 53 (2026-01-17)
# NOTE: slot_usage may need manual review for range/description updates '{"collection_discovery": 0.65, "organizational_change": 0.25, "general_heritage": 0.45}'
migration_source: "target_material slot"
migration_date: "2026-01-16"
migration_rule: "Rule 53/56 - semantic consistency over simplicity"
comments:
- "Material represents physical substances for heritage preservation"
- "CIDOC-CRM E57_Material as primary ontology alignment"
- "Replaces string-based target_material per Rule 53/56"
- "Enables structured material classification with Wikidata alignment"
- "Used by EnvironmentalZoneType and StorageType for storage categorization"
see_also:
- http://www.cidoc-crm.org/cidoc-crm/E57_Material
- http://vocab.getty.edu/aat/300010358
- https://www.wikidata.org/wiki/Q214609
examples:
- value:
has_or_had_identifier: https://nde.nl/ontology/hc/material/paper
has_or_had_label:
- paper@en
- papier@nl
has_or_had_description: "Cellulose-based material made from wood pulp or cotton fibers."
has_or_had_type: https://nde.nl/ontology/hc/material-type/organic
is_or_was_equivalent_to:
- qid: "Q11472"
label: "paper"
description: Paper material
- value:
has_or_had_identifier: https://nde.nl/ontology/hc/material/nitrate-film
has_or_had_label:
- nitrate film@en
- nitraatfilm@nl
- cellulose nitrate film@en
has_or_had_description: "Early photographic and motion picture film base, highly flammable and chemically unstable."
has_or_had_type: https://nde.nl/ontology/hc/material-type/synthetic
is_or_was_equivalent_to:
- qid: "Q1201597"
label: "nitrate film"
description: Nitrate film material requiring cold storage
- value:
has_or_had_identifier: https://nde.nl/ontology/hc/material/parchment
has_or_had_label:
- parchment@en
- perkament@nl
has_or_had_description: "Animal skin prepared for writing, historically used for manuscripts and legal documents."
has_or_had_type: https://nde.nl/ontology/hc/material-type/organic
is_or_was_equivalent_to:
- qid: "Q226697"
label: "parchment"
description: Parchment material for archival storage