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

158 lines
7.9 KiB
YAML

id: https://nde.nl/ontology/hc/class/branch-office
name: branch_office_class
title: BranchOffice Class
imports:
- linkml:types
- ../enums/QuantityTypeEnum
- ../slots/has_or_had_description
- ../slots/has_or_had_identifier
- ../slots/has_or_had_label
- ../slots/has_or_had_quantity
- ../slots/has_or_had_score
- ../slots/has_or_had_service_area
- ../slots/is_or_was_derived_from
- ../slots/is_or_was_generated_by
- ../slots/is_public_facing
- ../slots/operating_hour
- ../slots/services_offered
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#
skos: http://www.w3.org/2004/02/skos/core#
classes:
BranchOffice:
is_a: ReconstructedEntity
class_uri: org:Site
description: "Regional or satellite office of a heritage custodian organization.\n\n**DEFINITION**:\n\nA BranchOffice is a secondary physical location where a heritage custodian\nmaintains operational presence, typically providing services to a specific\ngeographic area or community. Unlike the main headquarters, branch offices\nusually have more limited scope of activities.\n\n**W3C ORG ALIGNMENT**:\n\n`org:Site` - \"An office or other premise at which the organization is located.\"\n\nBranchOffice specializes org:Site for heritage custodian branch locations:\n- Regional archives serving provincial communities\n- Satellite library branches in neighborhoods\n- Museum outposts or study centers\n\n**DISTINCTION FROM OTHER AUXILIARY PLACE TYPES**:\n\n| Type | Purpose | Example |\n|------|---------|---------|\n| **BranchOffice** | Service delivery to geographic area | Regional archive office |\n| AdministrativeOffice | Non-public administrative functions | Finance department building |\n\
| ExhibitionSpace | Display of collections | Gallery annex |\n| ResearchCenter | Research and conservation | Conservation lab |\n\n**TYPICAL CHARACTERISTICS**:\n\n- **Public-facing**: Serves visitors, researchers, patrons\n- **Geographic coverage**: Serves specific region/community\n- **Core services**: Reference, access, programming (subset of main)\n- **Staff presence**: Permanent staff assignment\n- **Collection subset**: May hold locally-relevant materials\n\n**USE CASES**:\n\n1. **Regional Archive Branches**:\n - Noord-Hollands Archief Zaanstreek-Waterland branch\n - Serves researchers in Zaandam area\n - Holds local municipal records\n\n2. **Library Satellite Locations**:\n - University library branch at satellite campus\n - Public library neighborhood branches\n\n3. **Museum Study Centers**:\n - Off-site study/research center for scholars\n - Rijksmuseum Schiphol (airport exhibition space)\n\n**Example - Regional Archive Branch**:\n```yaml\nBranchOffice:\n has_or_had_identifier:\
\ \"https://nde.nl/ontology/hc/aux/nha-zaanstreek-branch\"\n has_or_had_label: \"Noord-Hollands Archief - Zaanstreek-Waterland\"\n has_or_had_description: |\n Regional branch serving Zaanstreek-Waterland area.\n Holds municipal records from Zaandam, Wormerland, Purmerend.\n Open to researchers Tuesday-Thursday.\n branch_service_area: \"Zaanstreek-Waterland region\"\n is_public_facing: true\n services_offered:\n - \"Archival research access\"\n - \"Genealogical consultations\"\n - \"Local history reference\"\n```\n"
exact_mappings:
- org:Site
close_mappings:
- schema:Place
- schema:LocalBusiness
- crm:E27_Site
related_mappings:
- org:OrganizationalUnit
- schema:branch
slots:
- has_or_had_description
- has_or_had_identifier
- has_or_had_label
- has_or_had_service_area
- has_or_had_quantity
- is_public_facing
- operating_hour
- services_offered
- has_or_had_score
- is_or_was_derived_from
- is_or_was_generated_by
slot_usage:
has_or_had_identifier:
range: uriorcurie
required: true
identifier: true
examples:
- value: https://nde.nl/ontology/hc/aux/nha-zaanstreek-branch
has_or_had_label:
range: string
required: true
multivalued: false
examples:
- value: Noord-Hollands Archief - Zaanstreek-Waterland
- value: Rijksmuseum Schiphol
- value: Universiteitsbibliotheek Science Park
has_or_had_description:
range: string
examples:
- value: Regional branch serving Zaanstreek-Waterland area. Holds municipal records from Zaandam, Wormerland, Purmerend. Open to researchers Tuesday-Thursday.
has_or_had_service_area:
range: ServiceArea
inlined: true
examples:
- value:
service_area_id: https://nde.nl/ontology/hc/servicearea/zaanstreek-waterland
service_area_name: Zaanstreek-Waterland region
service_area_type: REGIONAL
is_public_facing:
range: boolean
required: true
ifabsent: 'true'
examples:
- value: true
services_offered:
range: string
multivalued: true
examples:
- value: Archival research access
- value: Genealogical consultations
- value: Local history reference
operating_hour:
range: string
examples:
- value: Tu-Th 09:00-17:00
has_or_had_quantity:
range: integer
inlined: true
examples:
- value:
has_or_had_description: Staff assigned to this branch
is_estimate: false
is_or_was_derived_from:
range: CustodianObservation
multivalued: true
required: false
is_or_was_generated_by:
range: ReconstructionActivity
required: false
comments:
- BranchOffice models regional/satellite locations of heritage custodians
- Distinguished from AdministrativeOffice by public-facing nature
- W3C ORG org:Site specialized for branch locations
- Typically serves specific geographic area or community
- May hold local collection subset relevant to service area
see_also:
- https://www.w3.org/TR/vocab-org/#org:Site
- https://schema.org/LocalBusiness
- https://schema.org/branch
examples:
- value:
has_or_had_identifier: https://nde.nl/ontology/hc/aux/nha-zaanstreek-branch
has_or_had_label: Noord-Hollands Archief - Zaanstreek-Waterland
has_or_had_description: Regional branch serving Zaanstreek-Waterland area. Holds municipal records from Zaandam, Wormerland, Purmerend.
has_or_had_service_area:
service_area_id: https://nde.nl/ontology/hc/servicearea/zaanstreek-waterland
service_area_name: Zaanstreek-Waterland region
service_area_type: REGIONAL
is_public_facing: true
services_offered:
- Archival research access
- Genealogical consultations
- Local history reference
operating_hours: Tu-Th 09:00-17:00
has_or_had_quantity:
has_or_had_description: Staff assigned to Zaanstreek-Waterland branch
- value:
has_or_had_identifier: https://nde.nl/ontology/hc/aux/rijksmuseum-schiphol
has_or_had_label: Rijksmuseum Schiphol
has_or_had_description: Exhibition space at Schiphol Airport featuring rotating highlights from the Rijksmuseum collection. Free admission.
has_or_had_service_area:
service_area_id: https://nde.nl/ontology/hc/servicearea/schiphol-travelers
service_area_name: Amsterdam Schiphol Airport travelers
service_area_type: COMMUNITY
is_public_facing: true
services_offered:
- Exhibition viewing
- Museum shop
operating_hours: Daily 07:00-20:00
has_or_had_quantity:
has_or_had_description: Staff assigned to Schiphol branch
annotations:
specificity_score: 0.1
specificity_rationale: Generic utility class/slot created during migration
custodian_types: "['*']"