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

177 lines
7.8 KiB
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_or_had_description
- ../slots/has_or_had_identifier
- ../slots/has_or_had_label
- ../slots/has_or_had_measurement_unit
- ../slots/has_or_had_methodology
- ../slots/has_or_had_provenance
- ../slots/has_or_had_score
- ../slots/is_estimate
- ../slots/is_or_was_based_on
- ../slots/specificity_annotation
- ../slots/temporal_extent
- ./EstimationMethod
- ./MeasureUnit
- ./Methodology
- ./SpecificityAnnotation
- ./TemplateSpecificityScore
- ./TemplateSpecificityType
- ./TemplateSpecificityTypes
- ./TimeSpan
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_or_had_measurement_unit:\n has_or_had_type: VISITOR\n has_or_had_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_or_had_description: Staff assigned to Zaanstreek-Waterland branch\n```\n**RULE 53 COMPLIANT**: Updated with link_branch slots (has_or_had_measurement_unit, temporal_extent, has_or_had_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:
- has_or_had_identifier
- has_or_had_measurement_unit
- has_or_had_methodology
- is_or_was_based_on
- has_or_had_provenance
- temporal_extent
- has_or_had_description
- is_estimate
- specificity_annotation
- has_or_had_score
slot_usage:
has_or_had_identifier:
range: 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_or_had_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_or_had_type: VISITOR
has_or_had_symbol: visitors
- value:
has_or_had_type: SQUARE_METER
has_or_had_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_or_had_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_or_had_label: ArcFace clustering
confidence_threshold: 0.6
- value:
methodology_type: OBJECT_TRACKING
has_or_had_label: DeepSORT
has_or_had_description:
range: string
required: false
examples:
- value: Staff assigned to Zaanstreek-Waterland branch
- value: Annual visitor count for 2024
- value: '2025-01-01'
is_estimate:
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:
has_or_had_identifier: https://nde.nl/ontology/hc/quantity/nha-zaanstreek-staff-2025
has_or_had_measurement_unit:
has_or_had_type: FTE
has_or_had_symbol: FTE
has_or_had_label: full-time equivalent
has_or_had_description: Staff assigned to Zaanstreek-Waterland branch
is_estimate: false
- value:
has_or_had_measurement_unit:
has_or_had_type: VISITOR
has_or_had_symbol: visitors
temporal_extent:
begin_of_the_begin: '2023-02-10T00:00:00Z'
end_of_the_end: '2023-06-04T23:59:59Z'
has_or_had_description: Vermeer exhibition attendance
is_estimate: false
- value:
has_or_had_measurement_unit:
has_or_had_type: FACE
has_or_had_symbol: faces
has_or_had_methodology:
methodology_type: ENTITY_RESOLUTION
has_or_had_label: ArcFace clustering
confidence_threshold: 0.6
has_or_had_description: Unique faces detected via entity resolution
is_estimate: false
- value:
has_or_had_measurement_unit:
has_or_had_type: OBJECT
has_or_had_symbol: objects
has_or_had_methodology:
methodology_type: OBJECT_TRACKING
has_or_had_label: DeepSORT
has_or_had_description: Unique objects tracked across video frames
is_estimate: false
- value:
has_or_had_description: Total collection size including artworks, documents, and photographs
is_estimate: true
- value:
has_or_had_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: "['*']"