glam/schemas/20251121/linkml/modules/classes/CustodianPlace.yaml
kempersc fc405445c6 Refactor and update schema definitions
- Removed obsolete slots: `has_or_had_custodian_observation`, `provider`, and `specificity_annotation`.
- Updated `has_or_had_score` slot to use `SpecificityScore` class and modified its description and examples.
- Added new slots: `end_seconds`, `end_time`, `has_archive_path`, `has_or_had_custodian_name`, `protocol_name`, and `protocol_version`.
- Introduced a script `check_annotation_types.py` to validate the presence and structure of `custodian_types` in YAML files.
- Added a script `update_specificity.py` to automate updates related to `SpecificityAnnotation` to `SpecificityScore`.
2026-02-01 19:55:38 +01:00

212 lines
9.3 KiB
YAML

id: https://nde.nl/ontology/hc/class/custodian-place
name: custodian_place_class
title: CustodianPlace Class
imports:
- linkml:types
- ../enums/PlaceSpecificityEnum
- ../slots/country
- ../slots/has_or_had_auxiliary_entities
- ../slots/has_or_had_geographic_subdivision
- ../slots/has_or_had_location
- ../slots/has_or_had_score
- ../slots/is_or_was_based_on
- ../slots/is_or_was_derived_from
- ../slots/is_or_was_generated_by
- ../slots/place_custodian_ref
- ../slots/place_language
- ../slots/place_name
- ../slots/place_note
- ../slots/place_specificity
- ../slots/refers_to_custodian
- ../slots/settlement
- ../slots/temporal_extent
classes:
CustodianPlace:
is_a: ReconstructedEntity
class_uri: crm:E53_Place
description: "Nominal place designation used to identify a heritage custodian.\n\nCRITICAL: This is NOT geographic coordinates! This is a NOMINAL REFERENCE\nto a place as a way of identifying the custodian.\n\nCustodianPlace represents how people refer to a custodian through place:\n- \"het herenhuis in de Schilderswijk\" (neighborhood reference)\n- \"the mansion\" (generic building reference)\n- \"Rijksmuseum\" (building name as place, not institution name)\n- \"het museum op het Museumplein\" (landmark reference)\n\n**Relationship to FeaturePlace**:\n\nCustodianPlace provides the NOMINAL REFERENCE (WHERE):\n- \"Rijksmuseum\" (building name used as place identifier)\n\nFeaturePlace classifies the FEATURE TYPE (WHAT TYPE):\n- MUSEUM building type\n\nExample:\n```yaml\nCustodianPlace:\n place_name: \"Rijksmuseum\"\n has_feature_type:\n feature_type: MUSEUM\n feature_description: \"Neo-Gothic museum building (1885)\"\n```\n\n**Distinction from GeoSpatialPlace class**:\n\n| CustodianPlace\
\ | GeoSpatialPlace |\n|----------------|-----------------|\n| Nominal reference | Geographic coordinates |\n| \"the mansion in the Schilderswijk\" | lat: 52.0705, lon: 4.2894 |\n| Emic/contextual | Precise/measured |\n| May be ambiguous | Unambiguous |\n| Identifies custodian | Locates custodian |\n| Source: archives, oral history | Source: GPS, cadastral surveys |\n\n**Relationship to GeoSpatialPlace**:\n\nCustodianPlace.has_geospatial_location \u2192 GeoSpatialPlace\n\nA nominal place reference can link to precise geospatial coordinates:\n- CustodianPlace: \"the mansion in the Schilderswijk, Den Haag\"\n- GeoSpatialPlace: lat 52.0705, lon 4.2894, WKT: POINT(4.2894 52.0705)\n\n**Generated by ReconstructionActivity**:\nCustodianPlace is ONE OF THREE possible outputs from ReconstructionActivity:\n1. CustodianLegalStatus - Formal legal entity\n2. CustodianName - Emic label\n3. CustodianPlace - Nominal place designation (THIS CLASS)\n\nAll three aspects independently identify the SAME\
\ Custodian hub via refers_to_custodian.\n"
exact_mappings:
- crm:E53_Place
- schema:Place
close_mappings:
- dcterms:Location
- geo:Feature
related_mappings:
- prov:Entity
- crm:E27_Site
slots:
- has_or_had_auxiliary_entities
- country
- has_or_had_location
- place_language
- place_name
- place_note
- place_specificity
- refers_to_custodian
- settlement
- has_or_had_geographic_subdivision
- has_or_had_score
- temporal_extent
- is_or_was_derived_from
- is_or_was_generated_by
slot_usage:
place_name:
range: string
required: true
examples:
- value: het herenhuis in de Schilderswijk
- value: the mansion
- value: Rijksmuseum
place_language:
range: string
required: false
examples:
- value: nl
- value: en
place_specificity:
range: PlaceSpecificityEnum
required: false
examples:
- value: NEIGHBORHOOD
- value: BUILDING
- value: VAGUE
place_note:
range: string
required: false
examples:
- value: Used as place reference in archival documents, not as institution name
country:
range: Country
inlined: true
required: false
examples:
- value: https://nde.nl/ontology/hc/country/NL
- value: https://nde.nl/ontology/hc/country/PE
has_or_had_geographic_subdivision:
range: string
inlined: true
required: false
examples:
- value: https://nde.nl/ontology/hc/subregion/US-PA
- value: https://nde.nl/ontology/hc/subregion/ID-BA
settlement:
range: Settlement
inlined: true
required: false
examples:
- value: https://nde.nl/ontology/hc/settlement/2759794
- value: https://nde.nl/ontology/hc/settlement/5206379
- value: https://nde.nl/ontology/hc/feature/herenhuis-mansion
has_or_had_location:
range: uriorcurie
# range: GeoSpatialPlace
multivalued: true
inlined_as_list: true
required: false
examples:
- value:
has_or_had_location:
geospatial_id: https://nde.nl/ontology/hc/geo/rijksmuseum-building
latitude: 52.36
longitude: 4.8852
- value:
has_or_had_location:
geospatial_id: https://nde.nl/ontology/hc/geo/schilderswijk-herenhuis
latitude: 52.0705
longitude: 4.2894
has_accuracy_in_meters: 50.0
spatial_resolution: NEIGHBORHOOD
has_or_had_auxiliary_entities:
range: AuxiliaryPlace
multivalued: true
inlined_as_list: true
required: false
examples:
- value:
- place_name: Depot Amersfoort
auxiliary_place_type: STORAGE_FACILITY
- place_name: Rijksmuseum Schiphol
auxiliary_place_type: BRANCH_OFFICE
is_or_was_based_on:
range: uriorcurie
multivalued: true
required: true
examples:
- value: https://w3id.org/heritage/observation/notarial-deed-1850
is_or_was_generated_by:
range: uriorcurie
# range: ReconstructionActivity
required: false
place_custodian_ref:
range: uriorcurie
required: true
examples:
- value: https://nde.nl/ontology/hc/nl-zh-hag-m-xyz
temporal_extent:
range: TimeSpan
inlined: true
required: false
examples:
- value:
begin_of_the_begin: '1850-01-01'
end_of_the_end: '1900-12-31'
comments:
- 'Represents the PLACE ASPECT of a custodian: ''how is this custodian identified by place reference?'''
- One of three possible outputs from ReconstructionActivity (legal status, name, PLACE)
- 'CRITICAL: NOT geographic coordinates - this is a NOMINAL reference (name-based)'
- 'Example: ''het herenhuis in de Schilderswijk'' identifies a custodian through place naming'
- Distinct from GeoSpatialPlace which has lat/lon coordinates and WKT geometry
- Link to GeoSpatialPlace via has_or_had_location slot (migrated from has_geospatial_location)
- Can be vague ('the mansion') or specific ('het museum op het Museumplein 1')
- Historical place names capture how custodians were referenced in archival documents
- "MIGRATED: auxiliary_places \u2192 has_or_had_auxiliary_entities for AuxiliaryPlace sites (depots, branches, labs)"
- "Hierarchical pattern mirrors CustodianName \u2192 CustodianAppellation relationship"
see_also:
- http://www.cidoc-crm.org/html/cidoc_crm_v7.1.3.html#E53
- https://schema.org/Place
- http://www.opengis.net/ont/geosparql
- https://identifier.overheid.nl/tooi/def/ont/
examples:
- value:
place_name: het herenhuis in de Schilderswijk
place_language: nl
place_specificity: NEIGHBORHOOD
place_note: Referenced in notarial deed from 1850
has_or_had_location:
- has_or_had_location:
geospatial_id: https://nde.nl/ontology/hc/geo/schilderswijk-herenhuis
latitude: 52.0705
longitude: 4.2894
has_accuracy_in_meters: 100.0
spatial_resolution: NEIGHBORHOOD
is_or_was_derived_from:
- https://w3id.org/heritage/observation/notarial-deed-1850
is_or_was_generated_by: null
refers_to_custodian: https://nde.nl/ontology/hc/nl-zh-hag-m-xyz
- value:
place_name: Rijksmuseum
place_language: nl
place_specificity: BUILDING
place_note: Used as place reference in guidebooks, not as institution name
has_or_had_location:
- has_or_had_location:
geospatial_id: https://nde.nl/ontology/hc/geo/rijksmuseum-building
latitude: 52.36
longitude: 4.8852
has_or_had_geometry:
- has_or_had_format:
has_or_had_value: POLYGON((4.8830 52.3590, 4.8870 52.3590, 4.8870 52.3610, 4.8830 52.3610, 4.8830 52.3590))
has_or_had_type:
has_or_had_label: POLYGON
osm_id: way/27083908
has_accuracy_in_meters: 1.0
spatial_resolution: BUILDING
is_or_was_derived_from:
- https://w3id.org/heritage/observation/guidebook-1920
refers_to_custodian: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
annotations:
specificity_score: 0.1
specificity_rationale: Generic utility class/slot created during migration
custodian_types: "['*']"