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

id: https://nde.nl/ontology/hc/class/Quantity
name: Quantity
title: Quantity 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/QuantityTypeEnum
  - ../slots/has_description
  - ../slots/identified_by
  - ../slots/has_label
  - ../slots/has_measurement_unit
  - ../slots/has_methodology
  - ../slots/has_provenance
  - ../slots/has_score
  - ../slots/approximate
  - ../slots/based_on
  - ../slots/temporal_extent
default_prefix: hc
classes:
  Quantity:
    class_uri: qudt:Quantity
    description: "A quantified value with an optional unit of measurement and type.\n**QUDT ALIGNMENT**:\nMaps to `qudt:Quantity` - \"A quantitative value expressed as a number and a unit of measurement.\"\n**TYPES OF QUANTITIES**:\n| Type | Description | Example | |------|-------------|---------| | STAFF_COUNT | Number of employees | 42 employees | | COLLECTION_SIZE | Number of items | 1.2 million objects | | VISITOR_COUNT | Annual visitors | 2.5 million/year | | BUDGET_AMOUNT | Financial value | \u20AC15 million | | AREA | Physical space | 10,000 m\xB2 | | DURATION | Time period | 6 months |\n**USE CASES**:\n1. **Staff Metrics**: Branch staff count, department size, FTE equivalents 2. **Collection Metrics**: Object counts, archive linear meters, digital items 3. **Visitor Metrics**: Annual attendance, daily capacity, peak visitors 4. **Financial Metrics**: Budget, revenue, acquisition costs 5. **Physical Metrics**: Floor area, gallery space, storage capacity\n**WHY NOT JUST USE INTEGER?**\n\
      Simple integer fields like `branch_staff_count: 3` lose important context: - What's the unit? (FTE? headcount? contractors included?) - When was this measured? (provenance) - Is this exact or estimated? - What type of quantity is this?\nThe Quantity class captures this richness while remaining simple for basic use.\n**EXAMPLE**:\n```yaml Quantity:\n  quantity_id: https://nde.nl/ontology/hc/quantity/nha-zaanstreek-staff-2025\n  quantity_value: 3\n  quantity_type: STAFF_COUNT\n  has_measurement_unit:\n    has_type: VISITOR\n    has_symbol: \"visitors\"\n  temporal_extent:\n    begin_of_the_begin: \"2024-01-01T00:00:00Z\"\n    end_of_the_end: \"2024-12-31T23:59:59Z\"\n  has_description: Staff assigned to Zaanstreek-Waterland branch\n```\n**RULE 53 COMPLIANT**: Updated with link_branch slots (has_measurement_unit, temporal_extent, has_methodology) per slot_fixes.yaml revision for  visitor_count, view_count, unique_object_count, and unique_face_count\
      \ migrations."
    exact_mappings:
    - qudt:Quantity
    close_mappings:
    - schema:QuantitativeValue
    related_mappings:
    - schema:numberOfEmployees
    - schema:floorSize
    - dcterms:extent
    slots:
    - identified_by
    - has_measurement_unit
    - has_methodology
    - based_on
    - has_provenance
    - temporal_extent
    - has_description
    - approximate
    - has_score
    slot_usage:
      identified_by:
#         range: string # uriorcurie
        required: false
        examples:
        - value: https://nde.nl/ontology/hc/quantity/nha-zaanstreek-staff-2025
        - value: 3
        - value: 1200000
        - value: 2500000
        - value: STAFF_COUNT
        - value: COLLECTION_SIZE
        - value: VISITOR_COUNT
        - value: headcount
        - value: items
        - value: linear meters
        - value: EUR
        - value: "m\xB2"
      has_measurement_unit:
        range: MeasureUnit
        required: false
        inlined: true
        description: 'The structured unit of measurement for this quantity. Provides richer semantics than the deprecated quantity_unit string. RULE 53: Branch 1 slot from visitor_count migration.'
        examples:
        - value:
            has_type: VISITOR
            has_symbol: visitors
        - value:
            has_type: SQUARE_METER
            has_symbol: "m\xB2"
      temporal_extent:
        range: TimeSpan
        required: false
        inlined: true
        description: 'The time period over which this quantity was measured. CIDOC-CRM temporal modeling with fuzzy boundaries. RULE 53: Branch 2 slot from visitor_count migration.'
        examples:
        - value:
            begin_of_the_begin: '2024-01-01T00:00:00Z'
            end_of_the_end: '2024-12-31T23:59:59Z'
      has_methodology:
        range: Methodology
        required: false
        inlined: true
        description: 'The methodology used to derive this quantity. Essential for unique counts derived via entity resolution. RULE 53: Branch 2 slot from unique_object_count/unique_face_count migration.'
        examples:
        - value:
            methodology_type: ENTITY_RESOLUTION
            has_label: ArcFace clustering
            confidence_threshold: 0.6
        - value:
            methodology_type: OBJECT_TRACKING
            has_label: DeepSORT
      has_description:
#         range: string
        required: false
        examples:
        - value: Staff assigned to Zaanstreek-Waterland branch
        - value: Annual visitor count for 2024
        - value: '2025-01-01'
      approximate:
        range: boolean
        required: false
        ifabsent: 'false'
        examples:
        - value: false
        - value: true
    comments:
    - Quantity models quantified values with units and provenance
    - Replaces simple integer fields with richer structured data
    - Uses QUDT Quantity as primary ontology mapping
    - Supports various quantity types (staff, collection, visitor, budget)
    see_also:
    - http://qudt.org/schema/qudt/Quantity
    - https://schema.org/QuantitativeValue
    examples:
    - value:
        identified_by: https://nde.nl/ontology/hc/quantity/nha-zaanstreek-staff-2025
        has_measurement_unit:
          has_type: FTE
          has_symbol: FTE
          has_label: full-time equivalent
        has_description: Staff assigned to Zaanstreek-Waterland branch
        is_estimate: false
    - value:
        has_measurement_unit:
          has_type: VISITOR
          has_symbol: visitors
        temporal_extent:
          begin_of_the_begin: '2023-02-10T00:00:00Z'
          end_of_the_end: '2023-06-04T23:59:59Z'
        has_description: Vermeer exhibition attendance
        is_estimate: false
    - value:
        has_measurement_unit:
          has_type: FACE
          has_symbol: faces
        has_methodology:
          methodology_type: ENTITY_RESOLUTION
          has_label: ArcFace clustering
          confidence_threshold: 0.6
        has_description: Unique faces detected via entity resolution
        is_estimate: false
    - value:
        has_measurement_unit:
          has_type: OBJECT
          has_symbol: objects
        has_methodology:
          methodology_type: OBJECT_TRACKING
          has_label: DeepSORT
        has_description: Unique objects tracked across video frames
        is_estimate: false
    - value:
        has_description: Total collection size including artworks, documents, and photographs
        is_estimate: true
    - value:
        has_description: Annual visitor count for 2024
        is_estimate: false
    annotations:
      specificity_score: 0.1
      specificity_rationale: Generic utility class/slot created during migration
      custodian_types: "['*']"