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

337 lines
12 KiB
YAML

# =============================================================================
# GLAM-NER: GROUP HYPERNYM MODULE
# =============================================================================
# Module: hypernyms/grp.yaml
# Parent: entity_annotation_rules_v1.7.0_unified.yaml
# Purpose: GROUP entity type - collectives of agents (formal and informal)
# =============================================================================
# BREAKING CHANGE v1.7.0: Renamed from ORGANISATION (ORG) to GROUP (GRP)
# Rationale: CIDOC-CRM E74_Group is the proper hypernym for ALL collectives
# =============================================================================
id: https://w3id.org/glam/ner/hypernym/group
name: glam-ner-group-hypernym
GROUP:
code: "GRP"
definition: |
Any collective of agents acting together. Groups range from formal
legal entities (corporations, governments, universities) to informal
collectives (bands, movements, families, friend groups).
The defining characteristic is COLLECTIVE AGENCY - the group can:
- Perform actions attributed to the group as a unit
- Hold collective identity distinct from individual members
- Persist through changes in membership
Groups are subclasses of AGENT (crm:E74_Group is a subclass of E39_Actor).
design_rationale: |
CIDOC-CRM E74_Group: "This class comprises any gatherings or organizations
of E21 Persons that act collectively or in a similar way due to any form
of unifying relationship."
This is broader than:
- org:Organization (W3C Org) - implies formal structure
- foaf:Organization - primarily corporate entities
- schema:Organization - web-focused commercial entities
E74_Group encompasses:
- Formal organizations (org:FormalOrganization)
- Informal groups (foaf:Group)
- Historical entities (guilds, courts, movements)
- Families and dynasties
- Artistic/cultural movements without formal structure
# ---------------------------------------------------------------------------
# ONTOLOGY MAPPINGS
# ---------------------------------------------------------------------------
ontology_mappings:
primary_class: "crm:E74_Group"
primary_class_definition: |
CIDOC-CRM E74 Group: "This class comprises any gatherings or organizations
of E21 Persons that act collectively or in a similar way due to any form
of unifying relationship."
alternative_classes:
- "rico:CorporateBody" # For formal organizations
- "foaf:Group" # For informal groups
- "org:Organization" # W3C Org for structured organizations
linkml_mapping:
class_uri: "crm:E74_Group"
exact_mappings:
- "foaf:Group"
close_mappings:
- "org:Organization"
- "schema:Organization"
related_mappings:
- "rico:CorporateBody"
nerd_class: "nerd:Organization"
nerd_deprecation_note: |
DEPRECATED: NERD's Organization class implies formal legal structure,
excluding informal groups, movements, and historical collectives. For
Digital Humanities, CIDOC-CRM E74_Group is authoritative.
Retain NERD mapping ONLY for NLP pipeline interchange.
org_ontology:
formal_organization: "org:FormalOrganization"
organizational_unit: "org:OrganizationalUnit"
note: |
W3C Org Ontology provides precise organizational modeling:
- org:Organization: Any collection of people organized together
- org:FormalOrganization: Recognized legal entity (company, charity, government)
- org:OrganizationalUnit: Division or department within an organization
Use org:FormalOrganization for GRP.HER, GRP.COR, GRP.GOV, GRP.EDU.
Use foaf:Group or crm:E74_Group for GRP.INF.
rov_ontology:
registered_organization: "rov:RegisteredOrganization"
legal_name: "rov:legalName"
org_type: "rov:orgType"
org_status: "rov:orgStatus"
registration: "rov:registration"
note: |
Registered Organization Vocabulary (RegOrg) for legal entities:
- rov:RegisteredOrganization: Legal entity in a formal register
- rov:legalName: Registered legal name (vs. trading/brand names)
- Use ONLY for formal organizations with legal registration.
# ---------------------------------------------------------------------------
# SUBCATEGORIES
# ---------------------------------------------------------------------------
subcategories:
# ----- FORMAL ORGANIZATIONS -----
HERINST:
code: "GRP.HER"
definition: "Heritage institutions: museums, archives, libraries, galleries"
examples:
- "Rijksmuseum"
- "National Archives of the Netherlands"
- "British Library"
- "Louvre Museum"
ontology_class: "glam:HeritageCustodian"
alternative_classes:
- "org:FormalOrganization"
- "rov:RegisteredOrganization"
linkml_mapping:
class_uri: "glam:HeritageCustodian"
exact_mappings: []
close_mappings:
- "schema:Museum"
- "schema:Library"
- "schema:ArchiveOrganization"
note: |
Primary entity type for GLAM project extraction.
Most heritage institutions are formal organizations with legal registration.
Use rov:RegisteredOrganization when registration details (KvK, ISIL) are known.
PARBODY:
code: "GRP.PAR"
definition: "Parent or governing bodies of heritage institutions"
examples:
- "Ministry of Education, Culture and Science"
- "Smithsonian Institution"
- "City of Amsterdam"
ontology_class: "rico:CorporateBody"
alternative_classes:
- "org:Organization"
org_predicates:
- "org:hasSubOrganization"
- "org:hasUnit"
note: "Links to HERINST via org:hasSubOrganization or org:hasUnit"
UNIT:
code: "GRP.UNT"
definition: "Departments, divisions, or units within organizations"
examples:
- "Department of Prints and Drawings"
- "Conservation Laboratory"
- "Education Services"
- "Digital Collections Unit"
ontology_class: "org:OrganizationalUnit"
org_predicates:
- "org:unitOf"
- "org:hasUnit"
note: |
Use for named internal divisions when they function as distinct entities.
Links to parent via org:unitOf. Distinct from GRP_EXC003 generic mentions.
CORPORATION:
code: "GRP.COR"
definition: "Commercial companies and businesses"
examples:
- "Dutch East India Company (VOC)"
- "Philips"
- "Royal Dutch Shell"
- "Google"
ontology_class: "schema:Corporation"
alternative_classes:
- "org:FormalOrganization"
- "rov:RegisteredOrganization"
note: |
Historical trading companies (VOC, WIC, East India Company) are
GRP.COR even though defunct. Use crm:P2_has_type for historical status.
GOVERNMENT:
code: "GRP.GOV"
definition: "Government agencies, legislatures, and public bodies"
examples:
- "Dutch Parliament (Staten-Generaal)"
- "European Commission"
- "City Council of Amsterdam"
- "US National Endowment for the Humanities"
ontology_class: "schema:GovernmentOrganization"
alternative_classes:
- "org:FormalOrganization"
EDUCATIONAL:
code: "GRP.EDU"
definition: "Universities, schools, and educational institutions"
examples:
- "University of Amsterdam"
- "Leiden University"
- "Harvard University"
- "Royal Academy of Fine Arts"
ontology_class: "schema:EducationalOrganization"
alternative_classes:
- "org:FormalOrganization"
RELIGIOUS:
code: "GRP.REL"
definition: "Religious organizations, denominations, and congregations"
examples:
- "Roman Catholic Church"
- "Westerkerk congregation"
- "Buddhist Temple Foundation"
- "Franciscan Order"
ontology_class: "schema:ReligiousOrganization"
note: |
Religious organizations may also be heritage custodians (GRP.HER) when
they maintain archives, libraries, or collections. Use multiple types.
ASSOCIATION:
code: "GRP.ASS"
definition: "Associations, societies, and membership organizations"
examples:
- "Royal Netherlands Academy of Arts and Sciences"
- "Historical Society of Amsterdam"
- "Friends of the Rijksmuseum"
- "International Council of Museums (ICOM)"
ontology_class: "org:FormalOrganization"
alternative_classes:
- "schema:Organization"
note: |
Associations are formal groups with membership structures but may
not have commercial purposes. Distinguished from GRP.INF by having
formal bylaws, officers, and registered status.
# ----- INFORMAL GROUPS -----
INFORMAL:
code: "GRP.INF"
definition: |
Informal collectives without legal structure: artistic movements,
social groups, loose collaborations, families, dynasties.
examples:
- "The Impressionists"
- "De Stijl movement"
- "Anonymous (hacker collective)"
- "the Habsburg dynasty"
- "the Medici family"
- "the Beatles"
ontology_class: "crm:E74_Group"
alternative_classes:
- "foaf:Group"
linkml_mapping:
class_uri: "crm:E74_Group"
exact_mappings:
- "foaf:Group"
note: |
Informal groups exhibit collective agency but lack:
- Legal personality or registration
- Formal membership rules
- Organizational hierarchy
Artistic movements, dynasties, bands, and collectives are GRP.INF.
The "group" is often named retrospectively by historians/critics.
# ----- HISTORICAL GROUPS -----
HISTORICAL:
code: "GRP.HIS"
definition: "Historical organizations that no longer exist or have transformed"
examples:
- "Dutch East India Company (dissolved 1799)"
- "Guild of Saint Luke"
- "East India Company"
- "Knights Templar"
ontology_class: "crm:E74_Group"
note: |
Historical groups are tagged with their period-appropriate form.
Use crm:P2_has_type to indicate historical status.
Link to successor organizations via owl:sameAs or skos:closeMatch.
# ---------------------------------------------------------------------------
# INCLUSION RULES
# ---------------------------------------------------------------------------
inclusion_rules:
- id: "GRP_INC001"
rule: "Tag formal organization names including legal suffixes"
examples:
- "Stichting Rijksmuseum"
- "British Museum Trust"
- "Google LLC"
- id: "GRP_INC002"
rule: "Tag abbreviated organization names"
examples:
- "the Rijksmuseum"
- "VOC"
- "UNESCO"
- id: "GRP_INC003"
rule: "Tag organizational units when distinctly named"
examples:
- "Department of Prints and Drawings"
- "Special Collections, University Library"
- id: "GRP_INC004"
rule: "Tag artistic/cultural movements as informal groups"
examples:
- "The Impressionists"
- "De Stijl"
- "Bauhaus movement"
- id: "GRP_INC005"
rule: "Tag family/dynasty names when acting as collective"
examples:
- "the Habsburg dynasty"
- "the Medici family"
- "House of Orange"
# ---------------------------------------------------------------------------
# EXCLUSION RULES
# ---------------------------------------------------------------------------
exclusion_rules:
- id: "GRP_EXC001"
rule: "Do NOT tag generic references to organizations"
examples:
- "the museum (without name)"
- "the company"
- "the government"
- id: "GRP_EXC002"
rule: "Do NOT tag building names alone (use TOPONYM)"
examples:
- "the Rijksmuseum building (use TOP.BLD)"
note: "Distinguish institution (GRP.HER) from building (TOP.BLD)"
- id: "GRP_EXC003"
rule: "Do NOT tag generic department references"
examples:
- "the conservation department"
- "human resources"
note: "Only tag named units: 'Department of Asian Art'"
- id: "GRP_EXC004"
rule: "Do NOT tag nationality/ethnicity groups without organization"
examples:
- "the Dutch"
- "Europeans"
note: "These are demographic descriptors, not organizations"