glam/schemas/20251121/linkml/examples/auxiliary_classes_examples.yaml

596 lines
25 KiB
YAML

# Example Instances: Auxiliary Classes Integration
# Demonstrates AuxiliaryPlace, OrganizationBranch, and AuxiliaryDigitalPlatform patterns
# Version: 2025-11-26
#
# These examples show how heritage custodians with complex organizational structures
# can be modeled using auxiliary classes for secondary locations and digital platforms.
---
# USE CASE 1: Large Museum with Branch Locations and Multiple Digital Platforms
# Rijksmuseum with storage depot, research center, and project-specific platforms
- hc_id: https://nde.nl/ontology/hc/rijksmuseum-amsterdam
preferred_label:
- appellation_value: Rijksmuseum
appellation_language: nl
appellation_type: PREFERRED_NAME
- appellation_value: National Museum of the Netherlands
appellation_language: en
appellation_type: TRANSLATED_NAME
custodian_type: MUSEUM
# Main physical place
place_designation:
- place_id: https://nde.nl/ontology/place/rijksmuseum-main
settlement: Amsterdam
street_address: Museumstraat 1
postal_code: "1071 XX"
country_code: NL
place_specificity: PRECISE
latitude: 52.3600
longitude: 4.8852
# AUXILIARY PLACES - secondary physical locations
auxiliary_places:
# Storage facility
- auxiliary_place_id: https://nde.nl/ontology/place/rijksmuseum-depot-amstelveen
auxiliary_place_type: STORAGE_FACILITY
auxiliary_place_name: Rijksmuseum Collection Depot
settlement: Amstelveen
street_address: Burgemeester Rijnderslaan 60
postal_code: "1185 MC"
country_code: NL
latitude: 52.3064
longitude: 4.8522
is_auxiliary_of: https://nde.nl/ontology/place/rijksmuseum-main
auxiliary_place_status: ACTIVE
auxiliary_place_description: >
Climate-controlled storage facility housing approximately 1 million
objects not currently on display at the main museum building.
temporal_extent:
begin_of_the_begin: "1999-01-01"
end_of_the_end: null
# Branch organization at this location
hosts_branch:
branch_id: https://nde.nl/ontology/branch/rijksmuseum-conservation-dept
branch_type: CONSERVATION_LAB
branch_name: Rijksmuseum Conservation and Restoration Department
branch_description: >
Department responsible for conservation, restoration, and
scientific analysis of museum objects. Located at the Amstelveen depot.
reports_to: https://nde.nl/ontology/hc/rijksmuseum-amsterdam
branch_status: ACTIVE
temporal_extent:
begin_of_the_begin: "1999-01-01"
end_of_the_end: null
# Research center
- auxiliary_place_id: https://nde.nl/ontology/place/rijksmuseum-research-library
auxiliary_place_type: RESEARCH_CENTER
auxiliary_place_name: Rijksmuseum Research Library
settlement: Amsterdam
street_address: Museumstraat 1
postal_code: "1071 XX"
country_code: NL
is_auxiliary_of: https://nde.nl/ontology/place/rijksmuseum-main
auxiliary_place_status: ACTIVE
auxiliary_place_description: >
Art history research library with over 450,000 volumes, located
within the main Rijksmuseum building but operating as distinct unit.
temporal_extent:
begin_of_the_begin: "1885-01-01"
end_of_the_end: null
hosts_branch:
branch_id: https://nde.nl/ontology/branch/rijksmuseum-library
branch_type: RESEARCH_UNIT
branch_name: Rijksmuseum Research Library
branch_description: >
Specialized art history library supporting museum research
and external scholars.
reports_to: https://nde.nl/ontology/hc/rijksmuseum-amsterdam
branch_status: ACTIVE
# Main digital platform
digital_platform:
- platform_id: https://nde.nl/ontology/platform/rijksstudio
platform_name: Rijksstudio
homepage_web_address: https://www.rijksmuseum.nl
collection_web_addresses:
- https://www.rijksmuseum.nl/nl/rijksstudio
api_endpoint: https://www.rijksmuseum.nl/api
iiif_support: true
linked_data: true
metadata_standards:
- Dublin Core
- EDM
- IIIF
refers_to_custodian: https://nde.nl/ontology/hc/rijksmuseum-amsterdam
temporal_extent:
begin_of_the_begin: "2012-01-01"
end_of_the_end: null
# AUXILIARY DIGITAL PLATFORMS - project-specific and secondary platforms
auxiliary_platforms:
# Exhibition microsite
- auxiliary_platform_id: https://nde.nl/ontology/platform/rijksmuseum-vermeer-2023
auxiliary_platform_type: EXHIBITION_MICROSITE
auxiliary_platform_name: Vermeer 2023 Exhibition Website
platform_description: >
Dedicated microsite for the landmark 2023 Vermeer exhibition,
featuring virtual tours, scholarly essays, and high-resolution images.
homepage_url: https://www.rijksmuseum.nl/vermeer
is_auxiliary_of: https://nde.nl/ontology/platform/rijksstudio
auxiliary_platform_status: ARCHIVED
archival_status: PRESERVED
archived_at: https://web.archive.org/web/2023/https://www.rijksmuseum.nl/vermeer
temporal_extent:
begin_of_the_begin: "2023-02-10"
end_of_the_end: "2023-07-01"
# Mobile app
- auxiliary_platform_id: https://nde.nl/ontology/platform/rijksmuseum-app
auxiliary_platform_type: MOBILE_APP
auxiliary_platform_name: Rijksmuseum App
platform_description: >
Official mobile application providing audio tours, collection
exploration, and visitor information. Available for iOS and Android.
is_auxiliary_of: https://nde.nl/ontology/platform/rijksstudio
auxiliary_platform_status: ACTIVE
temporal_extent:
begin_of_the_begin: "2018-01-01"
end_of_the_end: null
# API endpoint as separate auxiliary platform
- auxiliary_platform_id: https://nde.nl/ontology/platform/rijksmuseum-api
auxiliary_platform_type: API_ENDPOINT
auxiliary_platform_name: Rijksmuseum Data API
platform_description: >
RESTful API providing programmatic access to collection metadata,
images, and research data. Requires API key registration.
api_url: https://data.rijksmuseum.nl/object-metadata/api/
is_auxiliary_of: https://nde.nl/ontology/platform/rijksstudio
auxiliary_platform_status: ACTIVE
temporal_extent:
begin_of_the_begin: "2012-01-01"
end_of_the_end: null
---
# USE CASE 2: Multi-Branch Public Library System
# Openbare Bibliotheek Amsterdam (OBA) with multiple branch locations
- hc_id: https://nde.nl/ontology/hc/oba-amsterdam
preferred_label:
- appellation_value: Openbare Bibliotheek Amsterdam
appellation_language: nl
appellation_type: PREFERRED_NAME
- appellation_value: OBA
appellation_language: nl
appellation_type: ABBREVIATION
- appellation_value: Amsterdam Public Library
appellation_language: en
appellation_type: TRANSLATED_NAME
custodian_type: LIBRARY
# Main library (Centrale OBA)
place_designation:
- place_id: https://nde.nl/ontology/place/oba-central
settlement: Amsterdam
street_address: Oosterdokskade 143
postal_code: "1011 DL"
country_code: NL
place_specificity: PRECISE
latitude: 52.3763
longitude: 4.9068
# Branch libraries as auxiliary places
auxiliary_places:
# Branch: OBA Javaplein
- auxiliary_place_id: https://nde.nl/ontology/place/oba-javaplein
auxiliary_place_type: BRANCH_OFFICE
auxiliary_place_name: OBA Javaplein
settlement: Amsterdam
street_address: Javaplein 2
postal_code: "1095 CJ"
country_code: NL
latitude: 52.3615
longitude: 4.9420
is_auxiliary_of: https://nde.nl/ontology/place/oba-central
auxiliary_place_status: ACTIVE
auxiliary_place_description: >
Neighborhood branch library in Amsterdam-Oost serving the
Indische Buurt community.
temporal_extent:
begin_of_the_begin: "2005-01-01"
end_of_the_end: null
hosts_branch:
branch_id: https://nde.nl/ontology/branch/oba-javaplein-branch
branch_type: BRANCH_LIBRARY
branch_name: OBA Javaplein Branch Library
reports_to: https://nde.nl/ontology/hc/oba-amsterdam
branch_status: ACTIVE
# Branch: OBA Banne
- auxiliary_place_id: https://nde.nl/ontology/place/oba-banne
auxiliary_place_type: BRANCH_OFFICE
auxiliary_place_name: OBA Banne
settlement: Amsterdam
street_address: Banne Centrum 50
postal_code: "1034 KH"
country_code: NL
is_auxiliary_of: https://nde.nl/ontology/place/oba-central
auxiliary_place_status: ACTIVE
auxiliary_place_description: >
Branch library in Amsterdam-Noord integrated with community center.
temporal_extent:
begin_of_the_begin: "1998-01-01"
end_of_the_end: null
hosts_branch:
branch_id: https://nde.nl/ontology/branch/oba-banne-branch
branch_type: BRANCH_LIBRARY
branch_name: OBA Banne Branch Library
reports_to: https://nde.nl/ontology/hc/oba-amsterdam
branch_status: ACTIVE
# Closed branch (historical)
- auxiliary_place_id: https://nde.nl/ontology/place/oba-linnaeus
auxiliary_place_type: BRANCH_OFFICE
auxiliary_place_name: OBA Linnaeusstraat (Closed)
settlement: Amsterdam
street_address: Linnaeusstraat 89
postal_code: "1093 EK"
country_code: NL
is_auxiliary_of: https://nde.nl/ontology/place/oba-central
auxiliary_place_status: HISTORICAL
auxiliary_place_description: >
Former branch library closed in 2015 due to budget cuts.
Services transferred to OBA Javaplein.
temporal_extent:
begin_of_the_begin: "1978-01-01"
end_of_the_end: "2015-06-30"
hosts_branch:
branch_id: https://nde.nl/ontology/branch/oba-linnaeus-branch
branch_type: BRANCH_LIBRARY
branch_name: OBA Linnaeusstraat Branch Library
reports_to: https://nde.nl/ontology/hc/oba-amsterdam
branch_status: CLOSED
temporal_extent:
begin_of_the_begin: "1978-01-01"
end_of_the_end: "2015-06-30"
# Main digital platform
digital_platform:
- platform_id: https://nde.nl/ontology/platform/oba-online
platform_name: OBA Online Catalog
homepage_web_address: https://www.oba.nl
collection_web_addresses:
- https://www.oba.nl/catalogus.html
refers_to_custodian: https://nde.nl/ontology/hc/oba-amsterdam
temporal_extent:
begin_of_the_begin: "2000-01-01"
end_of_the_end: null
auxiliary_platforms:
# E-book platform
- auxiliary_platform_id: https://nde.nl/ontology/platform/oba-ebooks
auxiliary_platform_type: SPECIALIZED_COLLECTION_PORTAL
auxiliary_platform_name: OBA E-books & E-audiobooks
platform_description: >
Digital lending platform for e-books and e-audiobooks available
to OBA members via the Online Bibliotheek service.
homepage_url: https://www.onlinebibliotheek.nl
is_auxiliary_of: https://nde.nl/ontology/platform/oba-online
auxiliary_platform_status: ACTIVE
temporal_extent:
begin_of_the_begin: "2014-01-01"
end_of_the_end: null
# Youth portal
- auxiliary_platform_id: https://nde.nl/ontology/platform/oba-youth
auxiliary_platform_type: SPECIALIZED_COLLECTION_PORTAL
auxiliary_platform_name: OBA Jeugd (Youth Portal)
platform_description: >
Dedicated portal for children and young adults with age-appropriate
content, reading lists, and educational resources.
homepage_url: https://www.oba.nl/jeugd
is_auxiliary_of: https://nde.nl/ontology/platform/oba-online
auxiliary_platform_status: ACTIVE
temporal_extent:
begin_of_the_begin: "2010-01-01"
end_of_the_end: null
---
# USE CASE 3: Regional Archive with Reading Rooms and Digitization Partnerships
# Noord-Hollands Archief with study center and partner reading rooms
- hc_id: https://nde.nl/ontology/hc/noord-hollands-archief
preferred_label:
- appellation_value: Noord-Hollands Archief
appellation_language: nl
appellation_type: PREFERRED_NAME
- appellation_value: NHA
appellation_language: nl
appellation_type: ABBREVIATION
- appellation_value: North Holland Archives
appellation_language: en
appellation_type: TRANSLATED_NAME
custodian_type: ARCHIVE
# Main archive building
place_designation:
- place_id: https://nde.nl/ontology/place/nha-haarlem
settlement: Haarlem
street_address: Jansstraat 40
postal_code: "2011 RX"
country_code: NL
place_specificity: PRECISE
latitude: 52.3827
longitude: 4.6332
auxiliary_places:
# Study center
- auxiliary_place_id: https://nde.nl/ontology/place/nha-study-center
auxiliary_place_type: RESEARCH_CENTER
auxiliary_place_name: NHA Studiezaal
settlement: Haarlem
street_address: Jansstraat 40
postal_code: "2011 RX"
country_code: NL
is_auxiliary_of: https://nde.nl/ontology/place/nha-haarlem
auxiliary_place_status: ACTIVE
auxiliary_place_description: >
Public reading room for researchers accessing archival materials.
Separate entrance and registration required.
temporal_extent:
begin_of_the_begin: "2001-01-01"
end_of_the_end: null
hosts_branch:
branch_id: https://nde.nl/ontology/branch/nha-public-services
branch_type: PUBLIC_ACCESS_POINT
branch_name: NHA Public Services Unit
branch_description: >
Department handling public access, reproductions, and
reference services for archive users.
reports_to: https://nde.nl/ontology/hc/noord-hollands-archief
branch_status: ACTIVE
# Off-site storage
- auxiliary_place_id: https://nde.nl/ontology/place/nha-depot
auxiliary_place_type: STORAGE_FACILITY
auxiliary_place_name: NHA Depot Santpoort
settlement: Santpoort-Noord
country_code: NL
is_auxiliary_of: https://nde.nl/ontology/place/nha-haarlem
auxiliary_place_status: ACTIVE
auxiliary_place_description: >
Climate-controlled depot for archival materials not frequently accessed.
Materials can be requested for delivery to main reading room.
temporal_extent:
begin_of_the_begin: "2010-01-01"
end_of_the_end: null
# Partner reading room (at another institution)
- auxiliary_place_id: https://nde.nl/ontology/place/nha-alkmaar-partner
auxiliary_place_type: PARTNER_LOCATION
auxiliary_place_name: NHA Partner Reading Room Alkmaar
settlement: Alkmaar
street_address: Regionaal Archief Alkmaar, Bergerweg 1
postal_code: "1815 AC"
country_code: NL
is_auxiliary_of: https://nde.nl/ontology/place/nha-haarlem
auxiliary_place_status: ACTIVE
auxiliary_place_description: >
Shared reading room at Regionaal Archief Alkmaar where NHA
digitized materials can be accessed. Part of provincial
archive collaboration agreement.
temporal_extent:
begin_of_the_begin: "2015-01-01"
end_of_the_end: null
# Main digital platform
digital_platform:
- platform_id: https://nde.nl/ontology/platform/nha-website
platform_name: Noord-Hollands Archief Website
homepage_web_address: https://www.noord-hollandsarchief.nl
inventory_web_addresses:
- https://www.noord-hollandsarchief.nl/onderzoek
metadata_standards:
- EAD
- Dublin Core
refers_to_custodian: https://nde.nl/ontology/hc/noord-hollands-archief
temporal_extent:
begin_of_the_begin: "2001-01-01"
end_of_the_end: null
auxiliary_platforms:
# OAI-PMH service
- auxiliary_platform_id: https://nde.nl/ontology/platform/nha-oai
auxiliary_platform_type: API_ENDPOINT
auxiliary_platform_name: NHA OAI-PMH Harvest Service
platform_description: >
OAI-PMH endpoint for metadata harvesting by aggregators
like Archieven.nl and the Dutch Digital Heritage Network.
api_url: https://www.noord-hollandsarchief.nl/oai
is_auxiliary_of: https://nde.nl/ontology/platform/nha-website
auxiliary_platform_status: ACTIVE
temporal_extent:
begin_of_the_begin: "2010-01-01"
end_of_the_end: null
# Image viewer for digitized materials
- auxiliary_platform_id: https://nde.nl/ontology/platform/nha-viewer
auxiliary_platform_type: DIGITAL_ASSET_MANAGEMENT
auxiliary_platform_name: NHA Digital Image Viewer
platform_description: >
High-resolution image viewer for digitized archival documents,
photographs, and maps. Supports zoom, rotation, and download.
is_auxiliary_of: https://nde.nl/ontology/platform/nha-website
auxiliary_platform_status: ACTIVE
temporal_extent:
begin_of_the_begin: "2012-01-01"
end_of_the_end: null
# Legacy system (deprecated)
- auxiliary_platform_id: https://nde.nl/ontology/platform/nha-legacy-catalog
auxiliary_platform_type: LEGACY_SYSTEM
auxiliary_platform_name: NHA Legacy Catalog System
platform_description: >
Former inventory system based on DOS application.
Data migrated to current web system in 2010.
Archived for historical reference.
is_auxiliary_of: https://nde.nl/ontology/platform/nha-website
auxiliary_platform_status: DEPRECATED
archival_status: MIGRATED
temporal_extent:
begin_of_the_begin: "1995-01-01"
end_of_the_end: "2010-12-31"
---
# USE CASE 4: University with Embedded Special Collections
# University of Amsterdam with separate library and special collections units
- hc_id: https://nde.nl/ontology/hc/uva-library
preferred_label:
- appellation_value: Universiteitsbibliotheek Amsterdam
appellation_language: nl
appellation_type: PREFERRED_NAME
- appellation_value: UBA
appellation_language: nl
appellation_type: ABBREVIATION
- appellation_value: University of Amsterdam Library
appellation_language: en
appellation_type: TRANSLATED_NAME
custodian_type: LIBRARY
# Main library (University Library)
place_designation:
- place_id: https://nde.nl/ontology/place/uba-singel
settlement: Amsterdam
street_address: Singel 425
postal_code: "1012 WP"
country_code: NL
place_specificity: PRECISE
latitude: 52.3682
longitude: 4.8892
auxiliary_places:
# Special Collections reading room
- auxiliary_place_id: https://nde.nl/ontology/place/uba-special-collections
auxiliary_place_type: RESEARCH_CENTER
auxiliary_place_name: Bijzondere Collecties (Special Collections)
settlement: Amsterdam
street_address: Oude Turfmarkt 129
postal_code: "1012 GC"
country_code: NL
latitude: 52.3685
longitude: 4.8930
is_auxiliary_of: https://nde.nl/ontology/place/uba-singel
auxiliary_place_status: ACTIVE
auxiliary_place_description: >
Special Collections department housing rare books, manuscripts,
maps, and prints. Separate reading room with supervised access.
temporal_extent:
begin_of_the_begin: "1999-01-01"
end_of_the_end: null
hosts_branch:
branch_id: https://nde.nl/ontology/branch/uba-special-collections
branch_type: SPECIAL_COLLECTIONS_UNIT
branch_name: UBA Special Collections Department
branch_description: >
Curates and provides access to rare and unique materials including
the Rosenthaliana (Jewish studies), Artis Library (natural history),
and map collections.
reports_to: https://nde.nl/ontology/hc/uva-library
branch_status: ACTIVE
# Science Park library
- auxiliary_place_id: https://nde.nl/ontology/place/uba-science-park
auxiliary_place_type: BRANCH_OFFICE
auxiliary_place_name: UBA Science Park
settlement: Amsterdam
street_address: Science Park 904
postal_code: "1098 XH"
country_code: NL
is_auxiliary_of: https://nde.nl/ontology/place/uba-singel
auxiliary_place_status: ACTIVE
auxiliary_place_description: >
Branch library serving the Faculty of Science at Science Park campus.
temporal_extent:
begin_of_the_begin: "2010-01-01"
end_of_the_end: null
hosts_branch:
branch_id: https://nde.nl/ontology/branch/uba-science-park
branch_type: BRANCH_LIBRARY
branch_name: UBA Science Park Branch
reports_to: https://nde.nl/ontology/hc/uva-library
branch_status: ACTIVE
# Main digital platform
digital_platform:
- platform_id: https://nde.nl/ontology/platform/uba-catalog
platform_name: UBA Library Catalog
homepage_web_address: https://lib.uva.nl
collection_web_addresses:
- https://lib.uva.nl/primo-explore/search
metadata_standards:
- MARC21
- Dublin Core
repository_software: Alma/Primo
refers_to_custodian: https://nde.nl/ontology/hc/uva-library
temporal_extent:
begin_of_the_begin: "2000-01-01"
end_of_the_end: null
auxiliary_platforms:
# Digital Special Collections
- auxiliary_platform_id: https://nde.nl/ontology/platform/uba-digital-collections
auxiliary_platform_type: SPECIALIZED_COLLECTION_PORTAL
auxiliary_platform_name: UBA Digital Special Collections
platform_description: >
Online access to digitized rare books, manuscripts, maps,
and photographs from the Special Collections department.
homepage_url: https://bc.uva.nl
is_auxiliary_of: https://nde.nl/ontology/platform/uba-catalog
auxiliary_platform_status: ACTIVE
temporal_extent:
begin_of_the_begin: "2008-01-01"
end_of_the_end: null
# Research data repository
- auxiliary_platform_id: https://nde.nl/ontology/platform/uva-dare
auxiliary_platform_type: DATA_REPOSITORY
auxiliary_platform_name: UvA-DARE (Digital Academic Repository)
platform_description: >
Institutional repository for academic publications, theses,
and research data from the University of Amsterdam.
homepage_url: https://dare.uva.nl
is_auxiliary_of: https://nde.nl/ontology/platform/uba-catalog
auxiliary_platform_status: ACTIVE
temporal_extent:
begin_of_the_begin: "2003-01-01"
end_of_the_end: null
# IIIF image service
- auxiliary_platform_id: https://nde.nl/ontology/platform/uba-iiif
auxiliary_platform_type: IIIF_SERVICE
auxiliary_platform_name: UBA IIIF Image Service
platform_description: >
IIIF-compliant image server providing interoperable access
to high-resolution digitized materials from Special Collections.
api_url: https://iiif.uva.nl
is_auxiliary_of: https://nde.nl/ontology/platform/uba-catalog
auxiliary_platform_status: ACTIVE
temporal_extent:
begin_of_the_begin: "2018-01-01"
end_of_the_end: null