id: https://nde.nl/ontology/hc/class/Capacity
name: Capacity
title: Capacity Class
prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  qudt: http://qudt.org/schema/qudt/
  schema: http://schema.org/
  dcterms: http://purl.org/dc/terms/
imports:
  - linkml:types
  - ../enums/CapacityTypeEnum
  - ../slots/has_description
  - ../slots/identified_by
  - ../slots/has_label
  - ../slots/has_measurement_unit
  - ../slots/has_quantity
  - ../slots/has_score
  - ../slots/has_type
  - ../slots/approximate
  - ../slots/temporal_extent
default_prefix: hc
classes:
  Capacity:
    class_uri: hc:Capacity
    description: "Storage or holding capacity measurement for heritage facilities.\n**RULE 53 MIGRATION**:\nThis class consolidates the following bespoke capacity slots: - capacity_cubic_meters \u2192 capacity_value + VOLUME type + m\xB3 unit - capacity_linear_meters \u2192 capacity_value + SHELF_LENGTH type + m unit - capacity_item \u2192 capacity_value + ITEM_COUNT type + items unit - capacity_description \u2192 has_description\n**ONTOLOGY ALIGNMENT**:\n- Extends `qudt:Quantity` pattern for measured values - Uses MeasureUnit for structured unit representation - Supports temporal validity via TimeSpan\n**CAPACITY TYPES**:\n| Type | Description | Unit Examples | |------|-------------|---------------| | VOLUME | Cubic capacity | m\xB3, ft\xB3 | | SHELF_LENGTH | Linear shelf meters | m, ft | | FLOOR_AREA | Floor space | m\xB2, ft\xB2 | | ITEM_COUNT | Number of items | boxes, folders, objects | | WEIGHT | Weight capacity | kg, tons | | SEATING | Seating capacity | seats, persons |\n\
      **EXAMPLES** (MIGRATED 2026-01-22: capacity_value \u2192 has_quantity):\nArchive depot (linear meters): ```yaml has_capacity:\n  - has_quantity:\n      quantity_value: 8000.0\n      has_unit:\n        unit_value: \"linear_meter\"\n    has_type: ShelfLengthCapacity\n    has_description: Total linear meters of shelving capacity\n```\nCold storage (volume): ```yaml has_capacity:\n  - has_quantity:\n      quantity_value: 2500.0\n      has_unit:\n        unit_value: \"cubic_meter\"\n    has_type: VolumeCapacity\n```\nArchive box storage (items): ```yaml has_capacity:\n  - has_quantity:\n      quantity_value: 50000\n      has_unit:\n        unit_value: \"item\"\n    has_type: ItemCountCapacity\n```"
    exact_mappings:
    - hc:Capacity
    close_mappings:
    - qudt:Quantity
    - schema:QuantitativeValue
    related_mappings:
    - schema:floorSize
    - dcterms:extent
    - premis:StorageLocation
    slots:
    - identified_by
    - has_quantity
    - has_type
    - has_measurement_unit
    - has_measurement_unit
    - has_description
    - temporal_extent
    - approximate
    - has_score
    slot_usage:
      identified_by:
#         range: string # uriorcurie
        required: false
        examples:
        - value: https://nde.nl/ontology/hc/capacity/na-depot-b-shelving
      has_type:
#         range: string # uriorcurie
        required: false
        examples:
        - value: ShelfLengthCapacity
        - value: VolumeCapacity
        - value: ItemCountCapacity
        - value: FloorAreaCapacity
      has_measurement_unit:
        range: MeasureUnit
        required: false
        inlined: true
        examples:
        - value:
            has_type: LINEAR_METER
            has_symbol: m
        - value:
            has_type: CUBIC_METER
            has_symbol: "m\xB3"
        - value:
            has_type: ITEM
            has_symbol: archive boxes
      has_quantity:
        range: integer
        required: true
        inlined: false # Fixed invalid inline for primitive type
        examples:
        - value:
            has_measurement_unit:
        - value:
            has_measurement_unit:
        - value:
            has_measurement_unit:
      has_description:
#         range: string
        required: false
        examples:
        - value: Approximately 5,000 linear meters of shelving across 3 floors
        - value: Large-scale art storage for paintings up to 4m x 6m
        - value: 1,200 linear meters of cold storage shelving
      temporal_extent:
        range: TimeSpan
        required: false
        inlined: true
        examples:
        - value:
            begin_of_the_begin: '2020-01-01T00:00:00Z'
            end_of_the_end: '2030-12-31T23:59:59Z'
      approximate:
        range: boolean
        required: false
        ifabsent: 'false'
    comments:
    - Created 2026-01-17 per Rule 53 to consolidate capacity_* slots
    - Based on QUDT Quantity pattern with capacity-specific typing
    - Supports multiple capacity types (volume, length, count, area)
    see_also:
    - http://qudt.org/schema/qudt/Quantity
    - https://schema.org/QuantitativeValue
    examples:
    - value:
        identified_by: https://nde.nl/ontology/hc/capacity/rijksmuseum-depot-shelving
        has_quantity:
          has_unit:
        has_type: ShelfLengthCapacity
        has_description: Total linear shelf capacity in Depot Amersfoort
        is_estimate: false
    - value:
        has_quantity:
          has_unit:
        has_type: VolumeCapacity
    - value:
        has_quantity:
          has_unit:
        has_type: ItemCountCapacity
        has_description: Capacity for 50,000 standard archive boxes
    - value:
        has_description: Approximately 5,000 linear meters of shelving across 3 floors. Large-scale art storage for paintings up to 4m x 6m.
        is_estimate: true
    annotations:
      specificity_score: 0.1
      specificity_rationale: Generic utility class/slot created during migration
      custodian_types: "['*']"