6da794ee38
- Added `has_or_had_place_of_birth` slot to capture structured birth place information with historical context. - Introduced `has_or_had_quantity` slot for capturing quantified values with units and provenance. - Created `has_or_had_service_area` slot to define geographic service areas for heritage custodians. - Implemented `is_or_was_approximate` slot to indicate uncertainty in values (dates, quantities). - Added `is_or_was_asserted_by` slot to track the agent responsible for assertions. - Introduced `Asserter` class to model agents making assertions, including types like human, automated, and AI. - Created `Quantity` class to represent quantified values with optional units and types. - Added enums for `AsserterTypeEnum` and `QuantityTypeEnum` to standardize types of asserters and quantities. - Archived outdated slots and replaced them with new structured alternatives following RiC-O conventions.
223 lines
7.2 KiB
YAML
223 lines
7.2 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_identifier
|
|
- ../slots/has_or_had_label
|
|
- ../slots/has_or_had_description
|
|
- ../slots/specificity_annotation
|
|
- ../slots/template_specificity
|
|
- ./SpecificityAnnotation
|
|
- ./TemplateSpecificityScores
|
|
default_prefix: hc
|
|
classes:
|
|
Quantity:
|
|
class_uri: qudt:Quantity
|
|
description: >-
|
|
A quantified value with an optional unit of measurement and type.
|
|
|
|
**QUDT ALIGNMENT**:
|
|
|
|
Maps to `qudt:Quantity` - "A quantitative value expressed as a
|
|
number and a unit of measurement."
|
|
|
|
**TYPES OF QUANTITIES**:
|
|
|
|
| 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 | €15 million |
|
|
| AREA | Physical space | 10,000 m² |
|
|
| DURATION | Time period | 6 months |
|
|
|
|
**USE CASES**:
|
|
|
|
1. **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
|
|
|
|
**WHY NOT JUST USE INTEGER?**
|
|
|
|
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?
|
|
|
|
The Quantity class captures this richness while remaining simple for basic use.
|
|
|
|
**EXAMPLE**:
|
|
|
|
```yaml
|
|
Quantity:
|
|
quantity_id: https://nde.nl/ontology/hc/quantity/nha-zaanstreek-staff-2025
|
|
quantity_value: 3
|
|
quantity_type: STAFF_COUNT
|
|
quantity_unit: FTE
|
|
quantity_description: Staff assigned to Zaanstreek-Waterland branch
|
|
quantity_date: 2025-01-01
|
|
```
|
|
exact_mappings:
|
|
- qudt:Quantity
|
|
close_mappings:
|
|
- schema:QuantitativeValue
|
|
related_mappings:
|
|
- schema:numberOfEmployees
|
|
- schema:floorSize
|
|
- dcterms:extent
|
|
slots:
|
|
- has_or_had_identifier
|
|
- quantity_value
|
|
- quantity_type
|
|
- quantity_unit
|
|
- has_or_had_description
|
|
- quantity_date
|
|
- is_estimate
|
|
- specificity_annotation
|
|
- template_specificity
|
|
slot_usage:
|
|
has_or_had_identifier:
|
|
range: uriorcurie
|
|
required: false
|
|
identifier: true
|
|
description: >-
|
|
Optional identifier for this quantity measurement.
|
|
examples:
|
|
- value: https://nde.nl/ontology/hc/quantity/nha-zaanstreek-staff-2025
|
|
description: Branch staff count measurement
|
|
quantity_value:
|
|
range: float
|
|
required: true
|
|
description: >-
|
|
The numeric value of the quantity.
|
|
examples:
|
|
- value: 3
|
|
description: 3 staff members
|
|
- value: 1200000
|
|
description: 1.2 million collection items
|
|
- value: 2500000
|
|
description: 2.5 million annual visitors
|
|
quantity_type:
|
|
range: QuantityTypeEnum
|
|
required: false
|
|
description: >-
|
|
The type of quantity being measured.
|
|
examples:
|
|
- value: STAFF_COUNT
|
|
- value: COLLECTION_SIZE
|
|
- value: VISITOR_COUNT
|
|
quantity_unit:
|
|
range: string
|
|
required: false
|
|
description: >-
|
|
The unit of measurement (if applicable).
|
|
examples:
|
|
- value: FTE
|
|
description: Full-time equivalent employees
|
|
- value: headcount
|
|
description: Total number of people
|
|
- value: items
|
|
description: Collection item count
|
|
- value: linear meters
|
|
description: Archive extent
|
|
- value: EUR
|
|
description: Budget in euros
|
|
- value: m²
|
|
description: Floor area
|
|
has_or_had_description:
|
|
range: string
|
|
required: false
|
|
description: >-
|
|
Description of what this quantity represents.
|
|
examples:
|
|
- value: Staff assigned to Zaanstreek-Waterland branch
|
|
- value: Annual visitor count for 2024
|
|
quantity_date:
|
|
range: date
|
|
required: false
|
|
description: >-
|
|
Date when this quantity was measured or is valid.
|
|
examples:
|
|
- value: '2025-01-01'
|
|
is_estimate:
|
|
range: boolean
|
|
required: false
|
|
ifabsent: 'false'
|
|
description: >-
|
|
Whether this quantity is an estimate rather than an exact count.
|
|
examples:
|
|
- value: false
|
|
description: Exact count
|
|
- value: true
|
|
description: Estimated value
|
|
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
|
|
quantity_value: 3
|
|
quantity_type: STAFF_COUNT
|
|
quantity_unit: FTE
|
|
has_or_had_description: Staff assigned to Zaanstreek-Waterland branch
|
|
quantity_date: '2025-01-01'
|
|
is_estimate: false
|
|
description: Branch staff count
|
|
- value:
|
|
quantity_value: 1200000
|
|
quantity_type: COLLECTION_SIZE
|
|
quantity_unit: items
|
|
has_or_had_description: Total collection size including artworks, documents, and photographs
|
|
is_estimate: true
|
|
description: Estimated collection size
|
|
- value:
|
|
quantity_value: 2500000
|
|
quantity_type: VISITOR_COUNT
|
|
quantity_unit: visitors/year
|
|
has_or_had_description: Annual visitor count for 2024
|
|
quantity_date: '2024-12-31'
|
|
is_estimate: false
|
|
description: Annual visitor count
|
|
slots:
|
|
quantity_value:
|
|
description: >-
|
|
The numeric value of the quantity.
|
|
range: float
|
|
slot_uri: qudt:numericValue
|
|
quantity_type:
|
|
description: >-
|
|
The type of quantity being measured.
|
|
range: QuantityTypeEnum
|
|
slot_uri: hc:quantityType
|
|
quantity_unit:
|
|
description: >-
|
|
The unit of measurement (if applicable).
|
|
range: string
|
|
slot_uri: qudt:unit
|
|
quantity_date:
|
|
description: >-
|
|
Date when this quantity was measured or is valid.
|
|
range: date
|
|
slot_uri: dcterms:date
|
|
is_estimate:
|
|
description: >-
|
|
Whether this quantity is an estimate rather than an exact count.
|
|
range: boolean
|
|
slot_uri: hc:isEstimate
|