# ============================================================================= # 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: is distinct from and # 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: - : "contains a name component which indicates that the referent has a particular role or position in society" - : "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"