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 4319f38c05 Add archived slots for audience size, audience type, and capacity metrics 
- Created new YAML files for audience size and audience type slots, defining their properties and annotations.
- Added archived capacity slots including cubic meters, linear meters, item count, and descriptions, with appropriate URIs and ranges.
- Introduced a template specificity slot for context-aware RAG filtering.
- Consolidated capacity-related slots into a unified structure, including has_or_had_capacity, capacity_type, and capacity_value, with detailed descriptions and examples.
2026-01-17 18:53:23 +01:00

302 lines
14 KiB
YAML
Raw Blame History

id: https://nde.nl/ontology/hc/class/organization-branch
name: organization_branch_class
title: OrganizationBranch Class
imports:
- linkml:types
- ./Custodian
- ./CustodianObservation
- ./ReconstructionActivity
- ./OrganizationalStructure
- ./TimeSpan
- ../enums/OrganizationBranchTypeEnum
- ./ReconstructedEntity
- ./BranchType
- ../slots/located_at
- ../slots/has_or_had_description
- ../slots/has_or_had_head
# REMOVED: ../slots/branch_head - MIGRATED to has_or_had_head (2026-01-14) per Rule 53
- ../slots/has_or_had_identifier
- ../slots/has_or_had_label
- ../slots/has_or_had_type
- ../slots/contact_point
- ../slots/has_operational_unit
- ../slots/has_sub_branch
- ../slots/is_branch_of
- ../slots/refers_to_custodian
- ../slots/specificity_annotation
- ../slots/staff_count
- ../slots/has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
- ../slots/temporal_extent # was: valid_from + valid_to - migrated per Rule 53
# REMOVED 2026-01-14: valid_from + valid_to - migrated to temporal_extent (Rule 53)
- ../slots/is_or_was_derived_from # was: was_derived_from - migrated per Rule 53
- ../slots/is_or_was_generated_by # was: was_generated_by - migrated per Rule 53
- ./AuxiliaryPlace
- ./SpecificityAnnotation
- ./TemplateSpecificityScore # was: TemplateSpecificityScores - migrated per Rule 53 (2026-01-17)
- ./TemplateSpecificityType
- ./TemplateSpecificityTypes
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 │\n ├── place_designation → CustodianPlace (main headquarters)\n\
\ │ └── auxiliary_places → AuxiliaryPlace (branch sites)\n │ └── hosts_branch → OrganizationBranch (THIS CLASS)\n\
\ │ └── has_operational_unit → OrganizationalStructure\n │\n └── organizational_structure → OrganizationalStructure\
\ (main org units)\n```\n\n**USE CASES**:\n\n1. **Regional Archive Branches**:\n - National Archives → Regional Office\
\ Noord-Holland\n - Regional office has own staff, reading room, collections\n \n2. **University Library Branches**:\n\
\ - Main library → Science Library → Medical Library\n - Each branch at different campus location\n \n3. **Museum\
\ Satellite Galleries**:\n - Main museum → Contemporary Art Wing (off-site)\n - Separate building, curated exhibitions\n\
\ \n4. **Conservation/Research Centers**:\n - Main institution → 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
# REMOVED: branch_head - MIGRATED to has_or_had_head (2026-01-14) per Rule 53
- has_or_had_identifier
- has_or_had_label
- has_or_had_type
- contact_point
- has_operational_unit
- has_sub_branch
- is_branch_of
- located_at
- refers_to_custodian
- specificity_annotation
- staff_count
- has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
- temporal_extent # was: valid_from + valid_to - migrated per Rule 53
- is_or_was_derived_from # was: was_derived_from - migrated per Rule 53
- is_or_was_generated_by # was: was_generated_by - migrated per Rule 53
slot_usage:
has_or_had_identifier:
range: uriorcurie
required: true
identifier: true
description: >-
Unique identifier for this organizational branch.
MIGRATED from branch_id (2026-01-14) per Rule 53.
examples:
- value: https://nde.nl/ontology/hc/branch/rm-schiphol-exhibition
description: Rijksmuseum Schiphol exhibition branch
has_or_had_label:
range: string
required: true
multivalued: false
description: >-
Official name of this organizational branch.
MIGRATED from branch_name (2026-01-15) per Rule 53.
This is the formal name of the branch as used in official documents.
examples:
- value: Rijksmuseum Schiphol
description: Airport branch name
- value: Conservation Division - Amersfoort
description: Off-site conservation facility
has_or_had_type:
range: BranchType
required: true
description: |
Type of organizational branch unit.
MIGRATED from branch_type (2026-01-13).
Uses BranchType class hierarchy for rich type semantics.
Common types: RegionalOfficeBranch, BranchLibraryUnit,
ConservationLabUnit, ExhibitionSpaceUnit.
examples:
- value: ExhibitionSpaceUnit
description: Exhibition branch type
- value: ConservationLabUnit
description: Conservation facility type
has_or_had_description:
range: string
description: >-
Narrative description of the branch's purpose, role, and activities.
MIGRATED from branch_description (2026-01-15) per Rule 53.
Describes what this branch does, its scope of operations,
and its relationship to the parent organization.
examples:
- value: Small exhibition space at Schiphol Airport featuring rotating highlights from the Rijksmuseum collection.
description: Exhibition branch description
- value: Off-site collection storage facility managing overflow objects and art storage.
description: Storage operations branch
located_at:
range: AuxiliaryPlace
multivalued: true
inlined_as_list: true
examples:
- value: https://nde.nl/ontology/hc/aux-place/rijksmuseum-schiphol
description: Airport location
has_operational_unit:
range: OrganizationalStructure
multivalued: true
inlined_as_list: true
examples:
- value:
unit_name: Exhibition Curation Team
unit_type: TEAM
description: Team within branch
is_branch_of:
range: uriorcurie
required: true
examples:
- value: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
description: Branch of Rijksmuseum
has_sub_branch:
range: OrganizationBranch
multivalued: true
inlined_as_list: true
examples:
- value:
has_or_had_label: Schiphol Terminal 2 Kiosk
description: Sub-branch of Schiphol exhibition
has_or_had_head:
range: Person
description: >-
Person who heads or headed this organizational branch.
MIGRATED from branch_head (2026-01-14) per Rule 53.
Uses W3C ORG pattern - inverse of org:headOf.
Can reference Person entity or be inline PersonObservation.
examples:
- value: https://nde.nl/ontology/hc/person/dr-maria-van-der-berg
description: Branch director reference
- value:
full_name: Dr. Maria van der Berg
role: Branch Director
description: Inline person observation
staff_count:
range: integer
examples:
- value: 8
description: Small branch staff
contact_point:
range: string
examples:
- value: schiphol@rijksmuseum.nl
description: Branch email
temporal_extent: # was: valid_from + valid_to - migrated per Rule 53
description: |
Validity period using CIDOC-CRM TimeSpan.
MIGRATED from valid_from + valid_to per slot_fixes.yaml (Rule 53).
range: TimeSpan
inlined: true
required: false
examples:
- value:
begin_of_the_begin: '2002-10-01'
description: Branch opened October 2002
- value:
begin_of_the_begin: '2002-10-01'
end_of_the_end: '2020-03-15'
description: Branch active October 2002 to March 2020
is_or_was_derived_from: # was: was_derived_from - migrated per Rule 53
range: CustodianObservation
multivalued: true
required: false
is_or_was_generated_by: # was: was_generated_by - migrated per Rule 53
range: ReconstructionActivity
required: false
refers_to_custodian:
range: Custodian
required: true
examples:
- value: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
description: Rijksmuseum custodian hub
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_sub_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
has_operational_unit:
- unit_name: Exhibition Curation Team
unit_type: TEAM
staff_count: 3
is_branch_of: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
staff_count: 8
contact_point: schiphol@rijksmuseum.nl
valid_from: '2002-10-01'
refers_to_custodian: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
description: Rijksmuseum Schiphol exhibition branch
- 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
has_operational_unit:
- unit_name: Storage Management Team
unit_type: TEAM
- unit_name: Climate Control Monitoring
unit_type: SERVICE
is_branch_of: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
staff_count: 12
valid_from: '1995-06-01'
refers_to_custodian: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
description: Rijksmuseum off-site storage operations branch
- 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
staff_count: 25
valid_from: '2001-01-01'
refers_to_custodian: https://nde.nl/ontology/hc/nl-na
description: Regional historical center branch of National Archives
Reference in a new issue View git blame Copy permalink