glam/schemas/initial/enums.yaml
kempersc fa5680f0dd Add initial versions of custodian hub UML diagrams in Mermaid and PlantUML formats
- Introduced custodian_hub_v3.mmd, custodian_hub_v4_final.mmd, and custodian_hub_v5_FINAL.mmd for Mermaid representation.
- Created custodian_hub_FINAL.puml and custodian_hub_v3.puml for PlantUML representation.
- Defined entities such as CustodianReconstruction, Identifier, TimeSpan, Agent, CustodianName, CustodianObservation, ReconstructionActivity, Appellation, ConfidenceMeasure, Custodian, LanguageCode, and SourceDocument.
- Established relationships and associations between entities, including temporal extents, observations, and reconstruction activities.
- Incorporated enumerations for various types, statuses, and classifications relevant to custodians and their activities.
2025-11-22 14:33:51 +01:00

361 lines
14 KiB
YAML

id: https://w3id.org/heritage/custodian/enums
name: heritage-custodian-enums
title: Heritage Custodian Enumerations
description: >-
Enumeration types for the Heritage Custodian schema. Provides controlled vocabularies
for institution types, organizational status, data provenance, metadata standards,
and change events.
license: https://creativecommons.org/publicdomain/zero/1.0/
version: 0.2.2
prefixes:
linkml: https://w3id.org/linkml/
heritage: https://w3id.org/heritage/custodian/
schema: http://schema.org/
tooi: https://identifier.overheid.nl/tooi/def/ont/
cpov: http://data.europa.eu/m8g/
rico: https://www.ica.org/standards/RiC/ontology#
bf: http://id.loc.gov/ontologies/bibframe/
crm: http://www.cidoc-crm.org/cidoc-crm/
dcterms: http://purl.org/dc/terms/
default_prefix: heritage
imports:
- linkml:types
# =============================================================================
# ENUMERATIONS
# =============================================================================
enums:
InstitutionTypeEnum:
description: >-
Types of heritage institutions (GLAMORCUBESFIXPHDNT taxonomy). Uses single-letter codes for GHCID generation:
G(allery), L(ibrary), A(rchive), M(useum), O(fficial), R(esearch), C(orporation),
U(nknown), B(otanical/Zoo), E(ducation), S(ociety), F(eatures), I(ntangible heritage),
X(miXed), P(ersonal), H(oly sites), D(igital platform), N(GO), T(aste/smell).
permissible_values:
GALLERY:
description: Art gallery or exhibition space
meaning: schema:ArtGallery
annotations:
ghcid_code: G
LIBRARY:
description: Library (public, academic, specialized)
meaning: schema:Library
annotations:
ghcid_code: L
also_maps_to: bf:Library
ARCHIVE:
description: Archive (government, corporate, personal, community)
meaning: schema:ArchiveOrganization
annotations:
ghcid_code: A
also_maps_to: rico:RecordResource
MUSEUM:
description: Museum (art, history, science, natural history, etc.)
meaning: schema:Museum
annotations:
ghcid_code: M
also_maps_to: crm:E74_Group
OFFICIAL_INSTITUTION:
description: Official government institutions managing cultural heritage
meaning: cpov:PublicOrganisation
annotations:
ghcid_code: O
also_maps_to: tooi:Overheidsorganisatie
RESEARCH_CENTER:
description: Research centers and institutes focused on cultural/heritage research
meaning: schema:ResearchOrganization
annotations:
ghcid_code: R
CORPORATION:
description: Corporate collections and heritage institutions
meaning: schema:Corporation
annotations:
ghcid_code: C
UNKNOWN:
description: >-
Institution type cannot be determined during data extraction. This is a fallback
classification used when source data lacks sufficient information to assign a specific
type (G, L, A, M, O, R, C, B, E, S, F, I, X, P, H, D, N, or T). Institutions with UNKNOWN type
should be flagged for manual review and reclassification. NOTE: Universities belong
to E (EDUCATION_PROVIDER), not U-class.
annotations:
ghcid_code: U
BOTANICAL_ZOO:
description: Botanical gardens, zoos, aquariums, and natural heritage sites
meaning: schema:Zoo
annotations:
ghcid_code: B
EDUCATION_PROVIDER:
description: Educational institutions with heritage collections (universities, schools)
meaning: schema:EducationalOrganization
annotations:
ghcid_code: E
COLLECTING_SOCIETY:
description: >-
Collecting societies (numismatics, philately, ephemera, local history/heemkundige kring,
memorabilia, vintage, philographic)
meaning: schema:Organization
annotations:
ghcid_code: S
FEATURES:
description: >-
Physical landscape features with heritage significance (monuments, sculptures, statues,
memorials, landmarks, cemeteries as physical features). Distinct from institutions that
maintain collections.
meaning: schema:Monument
annotations:
ghcid_code: F
also_maps_to: schema:LandmarksOrHistoricalBuildings
INTANGIBLE_HERITAGE_GROUP:
description: >-
Organizations preserving intangible cultural heritage (traditional performance groups,
oral history societies, folklore organizations, cultural practice preservation).
Includes UNESCO-recognized intangible heritage bearers.
meaning: schema:PerformingGroup
annotations:
ghcid_code: I
also_maps_to: schema:Organization
MIXED:
description: >-
Multi-type institution (e.g., library + archive + museum).
Use primary type for GHCID; document mixed nature in description.
annotations:
ghcid_code: X
PERSONAL_COLLECTION:
description: Personal or private collections
meaning: schema:Collection
annotations:
ghcid_code: P
HOLY_SITES:
description: >-
Religious and sacred heritage sites (churches, temples, mosques, synagogues, shrines,
monasteries, cathedrals) with historical, architectural, or cultural significance.
meaning: schema:PlaceOfWorship
annotations:
ghcid_code: H
DIGITAL_PLATFORM:
description: >-
Digital heritage platforms and repositories (online archives, digital libraries,
virtual museums, aggregation portals). Born-digital heritage institutions.
meaning: schema:WebSite
annotations:
ghcid_code: D
also_maps_to: schema:DataCatalog
NGO:
description: >-
Non-governmental heritage organizations (heritage advocacy groups, preservation societies,
cultural heritage NGOs). Non-profit organizations not classified under other types.
meaning: schema:NGO
annotations:
ghcid_code: N
also_maps_to: schema:Organization
TASTE_SMELL:
description: >-
Culinary and olfactory heritage institutions (restaurants, eateries, parfumeries, distilleries,
breweries) actively preserving traditional recipes, cooking techniques, perfume formulations,
and sensory cultural practices. Includes establishments maintaining historical food preparation
methods and scent heritage.
meaning: schema:Restaurant
annotations:
ghcid_code: T
also_maps_to: schema:FoodEstablishment
OrganizationStatusEnum:
description: Operational status of the organization
permissible_values:
ACTIVE:
description: Currently operational
INACTIVE:
description: No longer operational
MERGED:
description: Merged with another organization
SUSPENDED:
description: Temporarily suspended operations
PLANNED:
description: Planned but not yet operational
UNKNOWN:
description: Status unknown
DataSourceEnum:
description: Source of the data (for provenance tracking)
permissible_values:
ISIL_REGISTRY:
description: Official ISIL code registry
DUTCH_ORG_CSV:
description: Dutch heritage organizations CSV (totaallijst_nederland)
CONVERSATION_NLP:
description: Extracted from Claude conversation via NLP
WEB_CRAWL:
description: Extracted from institutional website via crawl4ai
WIKIDATA:
description: Sourced from Wikidata SPARQL query
MANUAL_ENTRY:
description: Manually entered or curated
INFERRED:
description: Inferred from other data points
CSV_REGISTRY:
description: General CSV registry or dataset
DataTierEnum:
description: Data quality/authority tier (from 04-data-standardization.md)
permissible_values:
TIER_1_AUTHORITATIVE:
description: Official registries (ISIL, national registers)
TIER_2_VERIFIED:
description: Verified institutional data (website, official publications)
TIER_3_CROWD_SOURCED:
description: Community-sourced data (Wikidata, OpenStreetMap)
TIER_4_INFERRED:
description: NLP-extracted or inferred data
MetadataStandardEnum:
description: Metadata standards used by the institution
permissible_values:
DUBLIN_CORE:
description: Dublin Core Metadata Initiative
meaning: dcterms:title
MARC21:
description: MARC 21 bibliographic format
EAD:
description: Encoded Archival Description
BIBFRAME:
description: BIBFRAME bibliographic framework
LIDO:
description: Lightweight Information Describing Objects (museum objects)
CIDOC_CRM:
description: CIDOC Conceptual Reference Model
meaning: crm:E1_CRM_Entity
SCHEMA_ORG:
description: Schema.org vocabulary
meaning: schema:Thing
RIC_O:
description: Records in Contexts Ontology
meaning: rico:Record
MODS:
description: Metadata Object Description Schema
PREMIS:
description: PREservation Metadata Implementation Strategies
SPECTRUM:
description: UK museum collections management standard
DACS:
description: Describing Archives - A Content Standard
DigitalPlatformTypeEnum:
description: Types of digital platforms used
permissible_values:
COLLECTION_MANAGEMENT:
description: >-
Collection management system (CMS) or integrated library system (ILS).
Examples: Koha, Alma, Symphony (libraries); Atlantis, MAIS, CollectiveAccess, TMS (museums/archives)
DIGITAL_REPOSITORY:
description: Digital repository (DSpace, EPrints)
DISCOVERY_PORTAL:
description: Discovery/search portal
LINKED_DATA_ENDPOINT:
description: Linked Data/SPARQL endpoint
API:
description: Public API for data access
AGGREGATOR:
description: Aggregation platform (Europeana, DPLA)
WEBSITE:
description: Institutional website
LEARNING_MANAGEMENT:
description: Learning management systems for heritage education (Moodle, Google Classroom, Blackboard, Canvas)
meaning: schema:LearningResource
IDENTIFIER_SERVICE:
description: Persistent identifier assignment service (URN, DOI, Handle, ARK)
meaning: schema:Service
GENERIC:
description: >-
General-purpose software not specific to heritage sector.
Examples: FileMaker, Microsoft Access, custom databases.
ChangeTypeEnum:
description: >-
Types of organizational changes, based on TOOI Wijzigingsgebeurtenis patterns.
Tracks major events in an organization's lifecycle.
permissible_values:
FOUNDING:
description: Organization was founded or established
meaning: tooi:Oprichting
CLOSURE:
description: Organization ceased operations or was dissolved
meaning: tooi:Opheffing
MERGER:
description: Organization merged with one or more other organizations
meaning: tooi:Fusie
SPLIT:
description: Organization split into multiple separate entities
meaning: tooi:Afsplitsing
ACQUISITION:
description: Organization acquired another organization
RELOCATION:
description: Organization moved to a new geographic location
NAME_CHANGE:
description: Organization changed its official name
TYPE_CHANGE:
description: Institution type changed (e.g., archive became museum)
STATUS_CHANGE:
description: Operational status changed
RESTRUCTURING:
description: Internal reorganization or structural change
LEGAL_CHANGE:
description: Change in legal status or governance
OTHER:
description: Other type of organizational change
EnrichmentTypeEnum:
description: >-
Types of data enrichment activities performed on heritage custodian records.
Tracks what kind of data was added or modified during enrichment processes.
permissible_values:
WIKIDATA_IDENTIFIER:
description: Wikidata Q-number identifier added via SPARQL query or API lookup
meaning: prov:Entity
GEOCODING:
description: Latitude/longitude coordinates added via geocoding service (Nominatim, GeoNames)
meaning: prov:Location
VIAF_IDENTIFIER:
description: Virtual International Authority File (VIAF) identifier added
meaning: prov:Entity
ISIL_CODE:
description: International Standard Identifier for Libraries (ISIL) code assigned
meaning: prov:Entity
GHCID_GENERATION:
description: Global Heritage Custodian Identifier (GHCID) generated from institution metadata
meaning: prov:Entity
FALSE_POSITIVE_REMOVAL:
description: Incorrect or false positive enrichment data removed after verification
meaning: prov:Invalidation
NAME_NORMALIZATION:
description: Institution name normalized or standardized for consistency
meaning: prov:Revision
IDENTIFIER_VERIFICATION:
description: Existing identifier verified against authoritative source
meaning: prov:Validation
INSTITUTION_TYPE_CLASSIFICATION:
description: Institution type classified or corrected (GLAMORCUBEPSXHF taxonomy)
meaning: prov:Revision
ADDRESS_STANDARDIZATION:
description: Physical address standardized or corrected using postal service data
meaning: prov:Revision
WEBSITE_URL_VALIDATION:
description: Institution website URL validated and updated
meaning: prov:Validation
COLLECTION_METADATA:
description: Collection-level metadata added (extent, temporal coverage, subject areas)
meaning: prov:Entity
ORGANIZATIONAL_RELATIONSHIP:
description: Relationship to parent/child organizations or networks identified
meaning: prov:Association
DIGITAL_PLATFORM_DETECTION:
description: Digital platforms or systems used by institution identified
meaning: prov:Entity
OTHER:
description: Other type of enrichment activity not covered by standard types
meaning: prov:Activity