glam/schemas/20251121/linkml/modules/classes/TimeSpan.yaml
kempersc 0cf93587fb fix(schema): Normalize custodian_types annotation YAML quoting
YAML arrays in LinkML annotations must be quoted strings to ensure
proper parsing. This change quotes all custodian_types annotations
from the raw array format to quoted string format.

Before: custodian_types: ["A", "G"]
After:  custodian_types: '["A", "G"]'

Affected: 50+ class files in modules/classes/
Also updates: manifest.json, 01_custodian_name_modular.yaml
2025-12-16 20:19:45 +01:00

107 lines
3.5 KiB
YAML

# Heritage Custodian TimeSpan Class
# Represents temporal extent with fuzzy boundaries following CIDOC-CRM pattern
id: https://nde.nl/ontology/hc/class/TimeSpan
name: timespan_class
title: TimeSpan Class
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
schema: http://schema.org/
crm: http://www.cidoc-crm.org/cidoc-crm/
time: http://www.w3.org/2006/time#
xsd: http://www.w3.org/2001/XMLSchema#
imports:
- linkml:types
default_range: string
slots:
begin_of_the_begin:
slot_uri: crm:P82a_begin_of_the_begin
description: |
Earliest possible start time of the time-span.
CIDOC-CRM: Outer bound of the time-span's beginning.
range: datetime
examples:
- value: "1800-01-01T00:00:00Z"
description: "Earliest possible founding date"
end_of_the_begin:
slot_uri: crm:P81a_end_of_the_begin
description: |
Latest possible start time of the time-span.
CIDOC-CRM: Inner bound of the time-span's beginning.
range: datetime
examples:
- value: "1805-12-31T23:59:59Z"
description: "Latest possible founding date"
begin_of_the_end:
slot_uri: crm:P81b_begin_of_the_end
description: |
Earliest possible end time of the time-span.
CIDOC-CRM: Inner bound of the time-span's ending.
range: datetime
examples:
- value: "1950-01-01T00:00:00Z"
description: "Earliest possible closure date"
end_of_the_end:
slot_uri: crm:P82b_end_of_the_end
description: |
Latest possible end time of the time-span.
CIDOC-CRM: Outer bound of the time-span's ending.
range: datetime
examples:
- value: "1955-12-31T23:59:59Z"
description: "Latest possible closure date"
classes:
TimeSpan:
class_uri: crm:E52_Time-Span
description: |
Represents temporal extent with fuzzy boundaries following CIDOC-CRM pattern.
E52_Time-Span models uncertainty in temporal bounds through four properties:
- P82a (begin_of_the_begin): Earliest possible start time
- P81a (end_of_the_begin): Latest possible start time
- P81b (begin_of_the_end): Earliest possible end time
- P82b (end_of_the_end): Latest possible end time
**Example**: "Founded sometime between 1800-1805, closed between 1950-1955"
- begin_of_the_begin: 1800-01-01 (earliest founding)
- end_of_the_begin: 1805-12-31 (latest founding)
- begin_of_the_end: 1950-01-01 (earliest closure)
- end_of_the_end: 1955-12-31 (latest closure)
**Use Cases**:
- Custodian founding/dissolution dates with uncertainty
- Historical event temporal bounds
- Archival record date ranges
**DO NOT USE FOR**: Database record metadata (use schema:dateCreated/dateModified)
exact_mappings:
- crm:E52_Time-Span
close_mappings:
- schema:DateTime
- time:Interval
related_mappings:
- prov:InstantaneousEvent
slots:
- begin_of_the_begin
- end_of_the_begin
- begin_of_the_end
- end_of_the_end
comments:
- "Handles temporal uncertainty common in heritage contexts"
- "Precise dates: Set begin_of_the_begin == end_of_the_begin (and same for end)"
- "Unknown start: Set begin_of_the_begin to earliest plausible date"
- "Unknown end: Leave end_of_the_end as null (ongoing/present)"
see_also:
- "https://cidoc-crm.org/html/cidoc_crm_v7.1.3.html#E52"
- "https://www.w3.org/TR/owl-time/"