glam/data/entity_annotation/modules/hypernyms/app.yaml
2025-12-05 15:30:23 +01:00

194 lines
7.4 KiB
YAML

# =============================================================================
# APPELLATION Hypernym Module
# =============================================================================
# Version: 1.7.0
# Module: hypernyms/app.yaml
#
# BREAKING CHANGE v1.7.0: Renamed from DENOMINATION (DEN) to APPELLATION (APP)
# and restructured to separate:
# - APPELLATION: Names as linguistic constructs (titles, collection names)
# - ROLE: Social/occupational positions (see rol.yaml)
#
# TEI P5 provides the authority: <name>, <title>, <roleName>, <occupation>
# are distinct element types, not conflated.
# =============================================================================
id: hypernym_appellation
name: "APPELLATION Hypernym"
description: |
Naming constructs as linguistic entities, distinct from the things they name.
Appellations are linguistic labels that identify entities.
hypernym:
APPELLATION:
code: "APP"
definition: |
Naming constructs as linguistic entities, distinct from the things they
name. Appellations are linguistic labels that identify entities:
- Titles (artwork titles, document titles)
- Collection names (archival fonds, named collections)
- Exhibition names (named temporary displays)
- Awards (named honors and prizes)
- Structured person names (when analyzing name components)
For ROLES (positions, occupations, honorifics), see the ROLE hypernym.
design_rationale: |
CIDOC-CRM E41 Appellation: "This class comprises signs, either meaningful
or not, or arrangements of signs following a specific syntax, that are
used or can be used to refer to and identify a specific instance."
Appellations are DISTINCT from what they name:
- "The Night Watch" (appellation) vs. the painting (E22_Human-Made_Object)
- "Rembrandt van Rijn" (appellation) vs. the person (E21_Person)
TEI P5 uses:
- <name> for any naming string
- <persName> for person names (with sub-elements)
- <placeName> for place names
- <title> for work titles
- <roleName> for role designations (see ROLE hypernym)
ontology_mappings:
primary_class: "crm:E41_Appellation"
primary_class_definition: |
CIDOC-CRM E41 Appellation: "This class comprises signs, either meaningful
or not, or arrangements of signs following a specific syntax, that are
used or can be used to refer to and identify a specific instance."
alternative_classes:
- "skos:prefLabel"
- "rdfs:label"
- "rico:Name"
linkml_mapping:
class_uri: "crm:E41_Appellation"
exact_mappings: []
close_mappings:
- "skos:prefLabel"
- "rdfs:label"
nerd_class: null
nerd_note: |
NERD has no dedicated class for names/appellations. Appellation entities
are linguistic constructs that name other entities. In NIF export, these
become nif:Phrase instances without a specific NERD type.
pnv_class: "pnv:PersonName"
pnv_note: |
For person names, use PNV (Person Name Vocabulary) structured representation
with components: pnv:givenName, pnv:surnamePrefix, pnv:baseSurname, pnv:patronym
subcategories:
TITLE:
code: "APP.TIT"
definition: "Titles of artworks, books, documents, musical works"
examples:
- "The Night Watch"
- "Girl with a Pearl Earring"
- "On the Origin of Species"
- "Symphony No. 9"
ontology_class: "crm:E35_Title"
linkml_mapping:
class_uri: "crm:E35_Title"
note: |
Titles are appellations for Works (see WORK hypernym).
The same work may have multiple titles (original, translated, popular).
COLLECTION:
code: "APP.COL"
definition: "Named collections and archival fonds"
examples:
- "the Golden Age Collection"
- "Archief van de Familie Bicker"
- "Dutch Masters Collection"
- "Fonds Bicker"
ontology_class: "rico:RecordSet"
alternative_classes:
- "crm:E78_Curated_Holding"
note: |
Collection names identify aggregations of objects.
Use rico:RecordSet for archival fonds/series.
Use crm:E78_Curated_Holding for museum collections.
EXHIBITION:
code: "APP.EXH"
definition: "Named exhibitions and displays"
examples:
- "Rembrandt and the Golden Age"
- "Vermeer: Master of Light"
- "The Art of Living (2023)"
ontology_class: "crm:E7_Activity"
alternative_classes:
- "schema:ExhibitionEvent"
note: |
Exhibition names are appellations for events (E7_Activity).
Include dates when analyzing exhibition history.
AWARD:
code: "APP.AWD"
definition: "Named prizes, honors, and awards"
examples:
- "Nobel Prize in Physics"
- "Rijksmuseum Award"
- "Order of Orange-Nassau"
- "Pulitzer Prize"
ontology_class: "crm:E55_Type"
note: |
Awards are types that can be bestowed. The bestowal event
is an E7_Activity; the award type is the appellation.
PERSONNAME:
code: "APP.PNM"
definition: |
Structured person name components, for detailed name analysis.
Use when parsing name parts, not for simple person mentions.
examples:
- "van Rijn (surname prefix + surname)"
- "Rembrandt Harmenszoon (given name + patronym)"
- "Dr. Maria van den Berg, PhD"
ontology_class: "pnv:PersonName"
pnv_components:
givenName: "pnv:givenName"
patronym: "pnv:patronym"
surnamePrefix: "pnv:surnamePrefix"
baseSurname: "pnv:baseSurname"
honorificPrefix: "pnv:honorificPrefix (Dr., Prof.)"
honorificSuffix: "pnv:honorificSuffix (PhD, Jr.)"
note: |
Use APP.PNM when analyzing name structure (genealogy, prosopography).
For simple person mentions, use AGENT.PER.
Honorifics in names are part of the appellation, not separate roles.
inclusion_rules:
- id: "APP_INC001"
rule: "Tag work titles in their original language when possible"
examples:
- "De Nachtwacht (Dutch)"
- "The Night Watch (English translation)"
- id: "APP_INC002"
rule: "Tag collection names including archival fonds designations"
examples:
- "Fonds Bicker"
- "Collection Fodor"
- id: "APP_INC003"
rule: "Tag exhibition titles with dates when given"
examples:
- "Vermeer (2023)"
- "Rembrandt: The Late Works (2015)"
exclusion_rules:
- id: "APP_EXC001"
rule: "Do NOT tag generic descriptive phrases"
examples:
- "the painting (not a title)"
- "the exhibition (not named)"
- id: "APP_EXC002"
rule: "Do NOT double-tag: if tagged as AGENT/GROUP, do not also tag as APPELLATION"
note: "Exception: when specifically analyzing name structure (APP.PNM)"
- id: "APP_EXC003"
rule: "Do NOT tag roles/occupations as appellations (use ROLE hypernym)"
examples:
- "Director (use ROLE.OCC)"
- "Curator (use ROLE.OCC)"
- "His Majesty (use ROLE.HON)"