glam/schemas/20251121/linkml/modules/classes/Material.yaml

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_description
  - ../slots/has_or_had_identifier
  - ../slots/has_or_had_label
  - ../slots/has_or_had_score  # was: template_specificity
  - ../slots/has_or_had_type
  - ../slots/is_or_was_equivalent_to
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
      - 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
          - value: https://nde.nl/ontology/hc/material/nitrate-film
      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: uriorcurie
        examples:
          - value: https://nde.nl/ontology/hc/material-type/organic
      is_or_was_equivalent_to:
        range: WikiDataIdentifier
        multivalued: true
        inlined: true
        inlined_as_list: true
        examples:
          - value:
              - qid: "Q11472"
          - value:
              - qid: "Q1201597"
    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"
      - 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"
      - 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"