279 lines
9.8 KiB
YAML
279 lines
9.8 KiB
YAML
# =============================================================================
|
|
# ROLE Hypernym Module
|
|
# =============================================================================
|
|
# Version: 1.7.0
|
|
# Module: hypernyms/rol.yaml
|
|
#
|
|
# NEW in v1.7.0: Separated from DENOMINATION to properly model:
|
|
# - Occupational roles (curator, archivist, director)
|
|
# - Honorific titles (Your Majesty, Professor, Dr.)
|
|
# - Social positions (president, secretary, member)
|
|
# - Relational roles (father of, student of)
|
|
#
|
|
# TEI P5: <roleName> is distinct from <persName> and <occupation>
|
|
# W3C Org: org:Role and org:Post model organizational positions
|
|
# =============================================================================
|
|
|
|
id: hypernym_role
|
|
name: "ROLE Hypernym"
|
|
description: |
|
|
Social, occupational, and ceremonial positions that agents hold or have held.
|
|
Roles are POSITIONS, not the persons who fill them.
|
|
|
|
hypernym:
|
|
ROLE:
|
|
code: "ROL"
|
|
definition: |
|
|
Social, occupational, and ceremonial positions that agents hold or
|
|
have held. Roles are POSITIONS, not the persons who fill them.
|
|
|
|
Key distinction:
|
|
- AGENT: The person ("Jan de Wit")
|
|
- ROLE: The position ("Director", "Curator")
|
|
- APPELLATION: The name as linguistic construct ("Dr. Jan de Wit")
|
|
|
|
Roles include:
|
|
- Occupations: Professional positions (curator, archivist, librarian)
|
|
- Titles: Honorific designations (Professor, Dr., Sir)
|
|
- Offices: Formal positions in organizations (Director, President)
|
|
- Relational: Family/social relationships (father of, mentor to)
|
|
|
|
design_rationale: |
|
|
TEI P5 distinguishes:
|
|
- <roleName>: "contains a name component which indicates that the
|
|
referent has a particular role or position in society"
|
|
- <occupation>: "contains an informal description of a person's trade,
|
|
profession, or occupation"
|
|
|
|
W3C Org Ontology provides:
|
|
- org:Role: A role within an organization
|
|
- org:Post: A specific position that exists independently of holders
|
|
- org:Membership: The n-ary relation of agent+organization+role
|
|
|
|
CIDOC-CRM uses:
|
|
- E55_Type for role classification
|
|
- P14.1_in_the_role_of for role-in-activity
|
|
|
|
Roles are NOT the same as:
|
|
- AGENT (the person, not the position)
|
|
- APPELLATION (the name, not the social function)
|
|
- GROUP (the organization, not the position within it)
|
|
|
|
ontology_mappings:
|
|
primary_class: "org:Role"
|
|
primary_class_definition: |
|
|
W3C Org Ontology org:Role: "Denotes a role that a Person or other Agent
|
|
can take in an organization. Instances of this class describe the
|
|
abstract role; to denote a specific instance of a person playing that
|
|
role in a specific organization use a Membership."
|
|
alternative_classes:
|
|
- "org:Post" # Specific position (e.g., "Director of the Rijksmuseum")
|
|
- "crm:E55_Type" # CIDOC-CRM classification
|
|
- "schema:Role" # Schema.org
|
|
linkml_mapping:
|
|
class_uri: "org:Role"
|
|
exact_mappings:
|
|
- "schema:Role"
|
|
close_mappings:
|
|
- "crm:E55_Type"
|
|
tei_mapping:
|
|
element: "roleName"
|
|
attributes:
|
|
type: "honorific|official|occupation|civil|military|religious"
|
|
nymRef: "URI reference to controlled vocabulary"
|
|
related_elements:
|
|
- "occupation"
|
|
- "affiliation"
|
|
nerd_class: null
|
|
nerd_note: |
|
|
NERD has no dedicated class for roles/occupations. Most NER systems
|
|
conflate roles with persons. This convention separates them for
|
|
precision in heritage contexts (staff roles, historical titles).
|
|
|
|
subcategories:
|
|
# ----- OCCUPATIONAL ROLES -----
|
|
OCCUPATION:
|
|
code: "ROL.OCC"
|
|
definition: "Professional occupations and job titles"
|
|
examples:
|
|
- "curator"
|
|
- "archivist"
|
|
- "librarian"
|
|
- "conservator"
|
|
- "director"
|
|
- "registrar"
|
|
ontology_class: "schema:Occupation"
|
|
alternative_classes:
|
|
- "tei:occupation"
|
|
linkml_mapping:
|
|
class_uri: "schema:Occupation"
|
|
related_mappings:
|
|
- "sdo:occupationalCategory"
|
|
isco_note: |
|
|
Link to ISCO-08 (International Standard Classification of Occupations)
|
|
for standardized occupation codes when possible.
|
|
note: |
|
|
Occupations are general categories of work.
|
|
For specific positions in organizations, use ROL.POS.
|
|
For the person holding the occupation, use AGENT.STF.
|
|
|
|
POSITION:
|
|
code: "ROL.POS"
|
|
definition: |
|
|
Specific positions within organizations, typically unique roles
|
|
that persist beyond the current holder.
|
|
examples:
|
|
- "Director of the Rijksmuseum"
|
|
- "Chief Curator of Prints"
|
|
- "Head of Conservation"
|
|
- "President of ICOM"
|
|
ontology_class: "org:Post"
|
|
org_properties:
|
|
postIn: "org:postIn (links to organization)"
|
|
heldBy: "org:heldBy (links to agent)"
|
|
note: |
|
|
Positions (Posts) are distinct from the people who hold them.
|
|
org:Post models positions that exist independently of holders.
|
|
Use when the position itself is referenced, not just the occupation.
|
|
|
|
# ----- HONORIFIC TITLES -----
|
|
HONORIFIC:
|
|
code: "ROL.HON"
|
|
definition: |
|
|
Honorific titles, forms of address, and ceremonial designations.
|
|
examples:
|
|
- "Your Majesty"
|
|
- "Professor"
|
|
- "Dr."
|
|
- "Sir"
|
|
- "Dame"
|
|
- "His Excellency"
|
|
- "Reverend"
|
|
ontology_class: "crm:E55_Type"
|
|
tei_mapping:
|
|
element: "roleName"
|
|
attribute_type: "honorific"
|
|
pnv_mapping: "pnv:honorificPrefix | pnv:honorificSuffix"
|
|
note: |
|
|
Honorifics often appear with names but are roles, not name parts:
|
|
- "Professor Einstein" → AGENT.PER with ROL.HON
|
|
- When analyzing name structure: APP.PNM with honorific component
|
|
|
|
Academic degrees (PhD, MA) after names are honorificSuffix.
|
|
|
|
# ----- NOBILITY AND RANK -----
|
|
NOBILITY:
|
|
code: "ROL.NOB"
|
|
definition: "Noble titles, aristocratic ranks, and royal designations"
|
|
examples:
|
|
- "Duke of Wellington"
|
|
- "Countess of Blessington"
|
|
- "Prince of Orange"
|
|
- "Baron van Pallandt"
|
|
- "King"
|
|
- "Queen"
|
|
ontology_class: "crm:E55_Type"
|
|
tei_mapping:
|
|
element: "roleName"
|
|
attribute_type: "nobility"
|
|
note: |
|
|
Nobility titles may be:
|
|
- Hereditary: Pass through family lineage
|
|
- Created: Bestowed as honor
|
|
- Extinct: Historical titles no longer in use
|
|
|
|
Link to authority files for genealogical precision.
|
|
|
|
# ----- RELIGIOUS TITLES -----
|
|
RELIGIOUS:
|
|
code: "ROL.REL"
|
|
definition: "Religious titles, orders, and ecclesiastical ranks"
|
|
examples:
|
|
- "Pope"
|
|
- "Cardinal"
|
|
- "Rabbi"
|
|
- "Imam"
|
|
- "Reverend"
|
|
- "Brother"
|
|
- "Sister"
|
|
- "Abbot"
|
|
ontology_class: "crm:E55_Type"
|
|
tei_mapping:
|
|
element: "roleName"
|
|
attribute_type: "religious"
|
|
note: |
|
|
Religious roles span traditions:
|
|
- Christian: Pope, Bishop, Deacon, Abbot, Prior
|
|
- Jewish: Rabbi, Cantor
|
|
- Islamic: Imam, Mufti, Ayatollah
|
|
- Buddhist: Monk, Lama, Rinpoche
|
|
|
|
# ----- RELATIONAL ROLES -----
|
|
RELATIONAL:
|
|
code: "ROL.RLT"
|
|
definition: |
|
|
Relational roles defined by relationship to another agent:
|
|
family relationships, apprenticeship, mentorship.
|
|
examples:
|
|
- "father of Rembrandt"
|
|
- "student of Frans Hals"
|
|
- "wife of"
|
|
- "heir to"
|
|
- "successor of"
|
|
ontology_class: "crm:E55_Type"
|
|
bio_relations:
|
|
family: "bio:parent, bio:child, bio:spouse, bio:sibling"
|
|
professional: "bio:student, bio:mentor"
|
|
note: |
|
|
Relational roles require a reference agent:
|
|
- "X's father" → X has role "father" relative to someone
|
|
|
|
For family relationships, use BIO ontology properties.
|
|
For professional relationships, use org:memberOf context.
|
|
|
|
inclusion_rules:
|
|
- id: "ROL_INC001"
|
|
rule: "Tag occupation terms when they identify professional function"
|
|
examples:
|
|
- "the curator stated..."
|
|
- "as archivist, she organized..."
|
|
|
|
- id: "ROL_INC002"
|
|
rule: "Tag honorifics that precede or follow names"
|
|
examples:
|
|
- "Professor Einstein"
|
|
- "Dr. Marie Curie"
|
|
- "Jan de Wit, Director"
|
|
|
|
- id: "ROL_INC003"
|
|
rule: "Tag specific organizational positions"
|
|
examples:
|
|
- "Director of the Rijksmuseum"
|
|
- "Chief Curator of Medieval Art"
|
|
|
|
- id: "ROL_INC004"
|
|
rule: "Tag nobility and religious titles"
|
|
examples:
|
|
- "Duke of Wellington"
|
|
- "Cardinal Richelieu"
|
|
- "Rabbi Akiva"
|
|
|
|
exclusion_rules:
|
|
- id: "ROL_EXC001"
|
|
rule: "Do NOT tag generic person references as roles"
|
|
examples:
|
|
- "the man (not a role)"
|
|
- "a woman (not a role)"
|
|
- "someone (not a role)"
|
|
|
|
- id: "ROL_EXC002"
|
|
rule: "Do NOT tag organizations as roles"
|
|
examples:
|
|
- "the museum (use GROUP)"
|
|
- "the university (use GROUP)"
|
|
|
|
- id: "ROL_EXC003"
|
|
rule: "Do NOT double-tag: person with role context → AGENT + ROLE"
|
|
examples:
|
|
- "'Director Jan de Wit' → AGENT.PER + ROL.POS"
|
|
note: "Create separate annotations with linking"
|