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

276 lines
13 KiB
YAML

id: https://nde.nl/ontology/hc/class/auxiliary-place
name: auxiliary_place_class
title: AuxiliaryPlace Class
imports:
- linkml:types
- ../enums/AuxiliaryPlaceTypeEnum
- ../slots/country
- ../slots/has_or_had_geographic_subdivision
- ../slots/has_or_had_geometry
- ../slots/has_or_had_identifier
- ../slots/has_or_had_location
- ../slots/has_or_had_score
- ../slots/has_or_had_type
- ../slots/is_or_was_branch_of
- ../slots/is_or_was_derived_from
- ../slots/is_or_was_generated_by
- ../slots/is_or_was_located_in
- ../slots/is_or_was_location_of
- ../slots/has_or_had_description
- ../slots/has_or_had_label
- ../slots/postal_code
- ../slots/refers_to_custodian
- ../slots/settlement
- ../slots/specialized_place
- ../slots/temporal_extent
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
schema: http://schema.org/
org: http://www.w3.org/ns/org#
dcterms: http://purl.org/dc/terms/
crm: http://www.cidoc-crm.org/cidoc-crm/
prov: http://www.w3.org/ns/prov#
locn: http://www.w3.org/ns/locn#
skos: http://www.w3.org/2004/02/skos/core#
vcard: http://www.w3.org/2006/vcard/ns#
geosparql: http://www.opengis.net/ont/geosparql#
classes:
AuxiliaryPlace:
is_a: ReconstructedEntity
class_uri: org:Site
description: "Secondary or subordinate physical location associated with a heritage custodian.\n\n**CRITICAL DISTINCTION - THREE-TIER PLACE MODEL**:\n\n1. **CustodianPlace** (preferred place reference):\n - Main/primary place designation for the custodian\n - Like CustodianName is the preferred emic label\n - Examples: \"Rijksmuseum\" (main building), \"National Archives\" (headquarters)\n \n2. **AuxiliaryPlace** (subordinate places) - THIS CLASS:\n - Secondary locations: branch offices, storage facilities, regional sites\n - Like CustodianAppellation is to CustodianName\n - Examples: Depot Amersfoort (off-site storage), Regional office Noord-Holland\n \n3. **FeaturePlace** (feature type classification):\n - Classifies the TYPE of physical feature (museum building, warehouse, etc.)\n - Applies to both CustodianPlace and AuxiliaryPlace\n\n**W3C ORG ALIGNMENT**:\n\n`org:Site` - \"An office or other premise at which the organization is located. \nMany organizations are\
\ spread across multiple sites and many sites will host \nmultiple locations. In most cases a Site will be a physical location.\"\n\nKey properties:\n- `org:siteOf` - links site to organization (inverse of org:hasSite)\n- `org:siteAddress` - locn:Address for physical address\n- `locn:geometry` - geometric representation (lat/lon)\n\n**RELATIONSHIP TO ORGANIZATIONBRANCH**:\n\nAuxiliaryPlace represents PHYSICAL LOCATION (where)\nOrganizationBranch represents ORGANIZATIONAL UNIT (what operates there)\n\n```\nCustodian (hub)\n \u251C\u2500\u2500 place_designation \u2192 CustodianPlace (main place)\n \u2502 \u2514\u2500\u2500 auxiliary_places \u2192 AuxiliaryPlace (subordinate sites)\n \u2502 \u2514\u2500\u2500 hosts_branch \u2192 OrganizationBranch (org unit at site)\n \u2502 \u2514\u2500\u2500 has_operational_unit \u2192 OrganizationalStructure (teams)\n \u2502\n \u2514\u2500\u2500 organizational_structure \u2192 OrganizationalStructure (informal units)\n \
\ \u2514\u2500\u2500 located_at \u2192 AuxiliaryPlace (optional physical location)\n```\n\n**USE CASES**:\n\n1. **Off-site Storage Facilities**:\n - Museum depot in Amersfoort (Rijksmuseum)\n - Archive annexes and document centers\n\n2. **Branch Libraries/Offices**:\n - University library branches at satellite campuses\n - Regional archive offices (Noord-Holland, Zuid-Holland)\n\n3. **Research Centers**:\n - Conservation lab in separate building\n - Digitization center at different address\n\n4. **Historic Buildings Under Same Custodian**:\n - Mauritshuis manages multiple historic houses\n - Abbey with multiple monastic buildings\n\n5. **Temporary Locations**:\n - Exhibition pavilions\n - Pop-up museums/archives\n - Storage during renovation\n\n**Example - Rijksmuseum with Multiple Sites**:\n```yaml\nCustodian:\n has_or_had_identifier: \"https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804\"\n preferred_label: \"Rijksmuseum\"\n place_designation:\n place_name: \"Rijksmuseum\"\
\ # Main building on Museumplein\n auxiliary_places:\n - place_name: \"Depot Amersfoort\"\n auxiliary_place_type: STORAGE_FACILITY\n street_address: \"Euterpelaan 25, Amersfoort\"\n - place_name: \"Rijksmuseum Schiphol\"\n auxiliary_place_type: BRANCH_OFFICE\n street_address: \"Schiphol Airport, Lounge 2\"\n hosts_branch:\n has_or_had_label: \"Schiphol Exhibition Space\"\n```\n\n**TEMPORAL VALIDITY**:\n\nAuxiliary places can open/close independently:\n- Storage facility opened 1995, closed 2010 (moved to new location)\n- Branch office valid_from 2000, valid_to null (still active)\n\nTrack with valid_from/valid_to or temporal_extent (for fuzzy dates).\n"
exact_mappings:
- org:Site
close_mappings:
- schema:Place
- crm:E27_Site
- locn:Address
- vcard:Location
related_mappings:
- crm:E53_Place
- schema:branch
- org:siteAddress
- vcard:Address
slots:
- has_or_had_identifier
- has_or_had_type
- is_or_was_located_in
- country
- has_or_had_location
- is_or_was_location_of
- is_or_was_branch_of
- has_or_had_description
- has_or_had_label
- postal_code
- refers_to_custodian
- settlement
- specialized_place
- has_or_had_geographic_subdivision
- has_or_had_score
- temporal_extent
- is_or_was_derived_from
- is_or_was_generated_by
- has_or_had_geometry
slot_usage:
has_or_had_identifier:
range: uriorcurie
required: true
identifier: true
examples:
- value: https://nde.nl/ontology/hc/aux-place/rijksmuseum-depot-amersfoort
has_or_had_label:
range: string
required: true
examples:
- value: Depot Amersfoort
- value: Rijksmuseum Schiphol
- value: Reading Room Annex
has_or_had_type:
range: uriorcurie
# range: PlaceType
required: true
inlined: true
examples:
- value:
has_or_had_label: STORAGE_FACILITY
- value:
has_or_had_label: BRANCH_OFFICE
- value:
has_or_had_label: RESEARCH_CENTER
specialized_place:
range: uriorcurie
# range: ReconstructedEntity
required: false
inlined: true
examples:
- value:
research_center_id: https://nde.nl/hc/research/kb-digitization
center_name: KB Digitization Center
research_center_type: DIGITIZATION_CENTER
- value:
conservation_lab_id: https://nde.nl/hc/lab/rkd-paper
lab_name: RKD Paper Conservation Lab
conservation_specialties:
- Works on paper
- Drawings
has_or_had_description:
range: string
examples:
- value: Off-site storage facility housing overflow collections. Staff access only.
postal_code:
range: string
examples:
- value: 3824 BK
is_or_was_located_in:
range: string
required: false
inlined: true
examples:
- value:
settlement_name: Amersfoort
country: NL
country:
range: Country
examples:
- value: https://nde.nl/ontology/hc/country/NL
has_or_had_geographic_subdivision:
range: string
examples:
- value: https://nde.nl/ontology/hc/subregion/NL-UT
settlement:
range: Settlement
examples:
- value: https://nde.nl/ontology/hc/settlement/2759633
- 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/depot-amersfoort-building
latitude: 52.1561
longitude: 5.3878
has_or_had_geometry:
- has_or_had_format:
has_or_had_value: POLYGON((5.385 52.154, 5.390 52.154, 5.390 52.158, 5.385 52.158, 5.385 52.154))
has_or_had_type:
has_or_had_label: POLYGON
osm_id: way/234567890
has_accuracy_in_meters: 1.0
spatial_resolution: BUILDING
- value:
has_or_had_location:
geospatial_id: https://nde.nl/ontology/hc/geo/schiphol-branch
latitude: 52.3086
longitude: 4.7639
has_or_had_geometry:
- has_or_had_format:
has_or_had_value: POINT(4.7639 52.3086)
has_or_had_type:
has_or_had_label: POINT
has_accuracy_in_meters: 50.0
spatial_resolution: BUILDING
is_or_was_location_of:
range: uriorcurie
# range: OrganizationBranch
multivalued: true
inlined_as_list: true
examples:
- value:
has_or_had_label: Conservation Division - Amersfoort
branch_type: CONSERVATION_LAB
is_or_was_branch_of:
range: uriorcurie
# range: CustodianPlace
required: true
examples:
- value: https://nde.nl/ontology/hc/place/rijksmuseum-main
temporal_extent:
range: TimeSpan
examples:
- value:
begin_of_the_begin: '1995-06-01'
end_of_the_end: '2010-12-31'
- value:
begin_of_the_begin: '1970-01-01'
end_of_the_begin: '1979-12-31'
is_or_was_derived_from:
range: CustodianObservation
multivalued: true
required: false
is_or_was_generated_by:
range: ReconstructionActivity
required: false
refers_to_custodian:
range: Custodian
required: true
examples:
- value: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
comments:
- AuxiliaryPlace models SUBORDINATE physical locations (not main headquarters)
- Analogous to CustodianAppellation (alternative names) for CustodianName
- W3C ORG org:Site for organizational site/premises
- Links to OrganizationBranch via hosts_branch (what operates at this site)
- Links back to CustodianPlace via is_auxiliary_of_place (main vs subordinate)
- Temporal validity tracks site lifecycle (opened/closed)
- Can have precise coordinates (latitude/longitude) unlike nominal CustodianPlace
see_also:
- https://www.w3.org/TR/vocab-org/#org:Site
- https://www.w3.org/ns/locn
- http://www.cidoc-crm.org/html/cidoc_crm_v7.1.3.html#E27
- https://www.w3.org/TR/vcard-rdf/
examples:
- value:
has_or_had_identifier: https://nde.nl/ontology/hc/aux-place/rijksmuseum-depot-amersfoort
has_or_had_label: Depot Amersfoort
has_or_had_type:
has_or_had_label: STORAGE_FACILITY
has_or_had_description: Off-site storage facility for overflow collections. Climate-controlled. Staff access only.
country: https://nde.nl/ontology/hc/country/NL
has_or_had_geographic_subdivision: https://nde.nl/ontology/hc/subregion/NL-UT
is_or_was_branch_of: https://nde.nl/ontology/hc/place/rijksmuseum-main
refers_to_custodian: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
- value:
has_or_had_identifier: https://nde.nl/ontology/hc/aux-place/rijksmuseum-schiphol
has_or_had_label: Rijksmuseum Schiphol
has_or_had_type:
has_or_had_label: BRANCH_OFFICE
has_or_had_description: Small exhibition space at Schiphol Airport featuring rotating highlights from the collection.
is_or_was_located_in:
settlement_name: Hoofddorp
country: NL
country: https://nde.nl/ontology/hc/country/NL
is_or_was_location_of:
- has_or_had_label: Schiphol Exhibition Team
branch_type: EXHIBITION_SPACE
is_or_was_branch_of: https://nde.nl/ontology/hc/place/rijksmuseum-main
refers_to_custodian: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
- value:
has_or_had_identifier: https://nde.nl/ontology/hc/aux-place/nha-reading-room-annex
has_or_had_label: Noord-Hollands Archief Reading Room Annex
has_or_had_type:
has_or_had_label: READING_ROOM_ANNEX
specialized_place:
reading_room_annex_id: https://nde.nl/hc/reading-room-annex/nha-overflow
annex_name: NHA Overflow Reading Room
annex_reason: PEAK_DEMAND
capacity_seats: 12
has_or_had_description: Overflow reading room for peak research periods.
is_or_was_located_in:
settlement_name: Haarlem
country: NL
is_or_was_branch_of: https://nde.nl/ontology/hc/place/noord-hollands-archief-main
refers_to_custodian: https://nde.nl/ontology/hc/nl-nh-haa-a-nha
annotations:
specificity_score: 0.1
specificity_rationale: Generic utility class/slot created during migration
custodian_types: "['*']"