kempersc/glam
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
glam/schemas/20251121/linkml/modules/classes/OrganizationBranch.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

201 lines
10 KiB
YAML
Raw Blame History

id: https://nde.nl/ontology/hc/class/organization-branch
name: organization_branch_class
title: OrganizationBranch Class
imports:
- linkml:types
- ../enums/OrganizationBranchTypeEnum
- ../slots/contact_point
- ../slots/has_or_had_branch
- ../slots/has_or_had_description
- ../slots/has_or_had_head
- ../slots/has_or_had_identifier
- ../slots/has_or_had_label
- ../slots/has_or_had_quantity
- ../slots/has_or_had_score
- ../slots/has_or_had_type
- ../slots/is_branch_of
- ../slots/is_or_was_derived_from
- ../slots/is_or_was_generated_by
- ../slots/located_at
- ../slots/refers_to_custodian
- ../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/
prov: http://www.w3.org/ns/prov#
skos: http://www.w3.org/2004/02/skos/core#
foaf: http://xmlns.com/foaf/0.1/
vcard: http://www.w3.org/2006/vcard/ns#
classes:
OrganizationBranch:
is_a: ReconstructedEntity
class_uri: org:OrganizationalUnit
description: "Formal organizational branch or sub-organization of a heritage custodian\nthat operates at a specific physical location (AuxiliaryPlace).\n\n**CRITICAL DISTINCTION FROM OrganizationalStructure**:\n\n| OrganizationBranch | OrganizationalStructure |\n|-------------------|------------------------|\n| **Formal** branches with administrative status | **Informal** operational units |\n| Tied to PHYSICAL LOCATION (AuxiliaryPlace) | May or may not have fixed location |\n| Semi-autonomous (may have own budget, staff) | Part of main organizational hierarchy |\n| Examples: Regional archive, branch library | Examples: Department, team, division |\n\n**W3C ORG ALIGNMENT**:\n\n`org:OrganizationalUnit` - \"An Organization such as a University Support Unit \nwhich is part of some larger FormalOrganization and only has full recognition \nwithin the context of that FormalOrganization.\"\n\nKey properties:\n- `org:unitOf` - links unit to parent organization\n- `org:hasSite` - links organization\
\ to physical site\n- `org:hasSubOrganization` - links to sub-branches\n\n**THREE-TIER ORGANIZATIONAL MODEL**:\n\n1. **Custodian** (hub): The main heritage institution\n2. **OrganizationBranch** (formal sub-organization): \n - Located at AuxiliaryPlace\n - Semi-autonomous branch\n3. **OrganizationalStructure** (informal units):\n - Departments, teams within branch or main org\n - Can be assigned to branch via has_operational_unit\n\n**RELATIONSHIP PATTERN**:\n\n```\nCustodian (hub)\n \u2502\n \u251C\u2500\u2500 place_designation \u2192 CustodianPlace (main headquarters)\n \u2502 \u2514\u2500\u2500 auxiliary_places \u2192 AuxiliaryPlace (branch sites)\n \u2502 \u2514\u2500\u2500 hosts_branch \u2192 OrganizationBranch (THIS CLASS)\n \u2502 \u2514\u2500\u2500 has_operational_unit \u2192 OrganizationalStructure\n \u2502\n \u2514\u2500\u2500 organizational_structure \u2192 OrganizationalStructure (main org units)\n```\n\n**USE CASES**:\n\n1. **Regional Archive\
\ Branches**:\n - National Archives \u2192 Regional Office Noord-Holland\n - Regional office has own staff, reading room, collections\n \n2. **University Library Branches**:\n - Main library \u2192 Science Library \u2192 Medical Library\n - Each branch at different campus location\n \n3. **Museum Satellite Galleries**:\n - Main museum \u2192 Contemporary Art Wing (off-site)\n - Separate building, curated exhibitions\n \n4. **Conservation/Research Centers**:\n - Main institution \u2192 Conservation Lab (different building)\n - Specialized facility with own staff\n\n**Example - National Archives Branch**:\n```yaml\nAuxiliaryPlace:\n place_name: \"Regionaal Historisch Centrum Noord-Holland\"\n auxiliary_place_type: BRANCH_OFFICE\n hosts_branch:\n - has_or_had_identifier: \"https://nde.nl/ontology/hc/branch/na-rhc-noord-holland\"\n has_or_had_label: \"RHC Noord-Holland\"\n branch_type: REGIONAL_OFFICE\n has_operational_unit:\n - unit_name:\
\ \"Reading Room Services\"\n - unit_name: \"Digitization Team\"\n is_branch_of: \"https://nde.nl/ontology/hc/nl-na\"\n```\n\n**DISTINCTION FROM schema:branchOf**:\n\nSchema.org `branchOf` links commercial branches (e.g., bank branches).\n`org:unitOf` is more appropriate for heritage institutions as it:\n- Models public sector organizational hierarchies\n- Allows for semi-autonomous units\n- Integrates with formal organizational structures\n"
exact_mappings:
- org:OrganizationalUnit
close_mappings:
- schema:Organization
- foaf:Organization
related_mappings:
- org:subOrganizationOf
- schema:branchOf
- schema:department
slots:
- has_or_had_description
- has_or_had_head
- has_or_had_identifier
- has_or_had_label
- has_or_had_type
- contact_point
- has_or_had_branch
- is_branch_of
- located_at
- refers_to_custodian
- has_or_had_quantity
- has_or_had_score
- temporal_extent
- 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/branch/rm-schiphol-exhibition
has_or_had_label:
range: string
required: true
multivalued: false
examples:
- value: Rijksmuseum Schiphol
- value: Conservation Division - Amersfoort
has_or_had_type:
range: uriorcurie
required: true
examples:
- value: ExhibitionSpaceUnit
- value: ConservationLabUnit
has_or_had_description:
range: string
examples:
- value: Small exhibition space at Schiphol Airport featuring rotating highlights from the Rijksmuseum collection.
- value: Off-site collection storage facility managing overflow objects and art storage.
located_at:
range: AuxiliaryPlace
multivalued: true
inlined_as_list: true
examples:
- value: https://nde.nl/ontology/hc/aux-place/rijksmuseum-schiphol
is_branch_of:
range: uriorcurie
required: true
examples:
- value: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
has_or_had_branch:
range: OrganizationBranch
multivalued: true
inlined_as_list: true
examples:
- value:
has_or_had_label: Schiphol Terminal 2 Kiosk
has_or_had_head:
range: Person
examples:
- value: https://nde.nl/ontology/hc/person/dr-maria-van-der-berg
- value:
full_name: Dr. Maria van der Berg
has_or_had_quantity:
range: integer
inlined: true
contact_point:
range: string
examples:
- value: schiphol@rijksmuseum.nl
temporal_extent:
range: TimeSpan
inlined: true
required: false
examples:
- value:
begin_of_the_begin: '2002-10-01'
- value:
begin_of_the_begin: '2002-10-01'
end_of_the_end: '2020-03-15'
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:
- OrganizationBranch models FORMAL branches with administrative status
- OrganizationalStructure models INFORMAL operational units
- Branches are LOCATED AT AuxiliaryPlace (physical sites)
- Branches CONTAIN OrganizationalStructure (internal departments/teams)
- W3C ORG org:OrganizationalUnit for semi-autonomous sub-organizations
- Temporal validity tracks branch lifecycle (opened/closed/merged)
- 'Hierarchical: branches can have sub-branches via has_or_had_branch'
see_also:
- https://www.w3.org/TR/vocab-org/#org:OrganizationalUnit
- https://www.w3.org/TR/vocab-org/#org:hasSite
- https://www.w3.org/TR/vocab-org/#org:unitOf
- https://www.w3.org/TR/vcard-rdf/
examples:
- value:
has_or_had_identifier: https://nde.nl/ontology/hc/branch/rm-schiphol
has_or_had_label: Rijksmuseum Schiphol
branch_type: EXHIBITION_SPACE
has_or_had_description: Small exhibition space at Schiphol Airport featuring rotating highlights from the collection.
located_at:
- https://nde.nl/ontology/hc/aux-place/rijksmuseum-schiphol
- unit_name: Exhibition Curation Team
has_or_had_quantity:
range: integer
inlined: true
is_branch_of: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
has_or_had_quantity:
range: integer
inlined: true
contact_point: schiphol@rijksmuseum.nl
refers_to_custodian: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
- value:
has_or_had_identifier: https://nde.nl/ontology/hc/branch/rm-depot-operations
has_or_had_label: Collection Storage Operations - Amersfoort
branch_type: STORAGE_MANAGEMENT
has_or_had_description: Off-site collection storage facility managing overflow objects and art storage.
located_at:
- https://nde.nl/ontology/hc/aux-place/rijksmuseum-depot-amersfoort
- unit_name: Storage Management Team
- unit_name: Climate Control Monitoring
is_branch_of: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
has_or_had_quantity:
range: integer
inlined: true
refers_to_custodian: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
- value:
has_or_had_identifier: https://nde.nl/ontology/hc/branch/na-rhc-nh
has_or_had_label: Regionaal Historisch Centrum Noord-Holland
branch_type: REGIONAL_OFFICE
has_or_had_description: Regional archives center serving Noord-Holland province, providing reading room services and archival research support.
is_branch_of: https://nde.nl/ontology/hc/nl-na
has_or_had_quantity:
range: integer
inlined: true
refers_to_custodian: https://nde.nl/ontology/hc/nl-na
annotations:
specificity_score: 0.1
specificity_rationale: Generic utility class/slot created during migration
custodian_types: "['*']"
Reference in a new issue View git blame Copy permalink