# =============================================================================
# THING Hypernym Module
# =============================================================================
# Version: 1.7.0
# Module: hypernyms/thg.yaml
# 
# Objects, concepts, and phenomena that don't fit other hypernyms.
# =============================================================================

id: hypernym_thing
name: "THING Hypernym"
description: |
  Named objects, artifacts, concepts, events, and other entities that
  do not fit the other hypernym categories. Broad category for tangible
  items and abstract concepts.

hypernym:
  THING:
    code: "THG"
    definition: |
      Named objects, artifacts, concepts, events, and other entities that
      do not fit the above categories. Broad category for tangible items
      and abstract concepts.
    
    ontology_mappings:
      primary_class: "crm:E70_Thing"
      alternative_classes:
        - "schema:Thing"
        - "edm:NonInformation_Resource"
      nerd_class: "nerd:Thing"
      nerd_subclasses:
        - "nerd:Product"
        - "nerd:Event"
      nerd_note: |
        NERD Thing is the base class. Use nerd:Product for objects/artifacts,
        nerd:Event for THG.EVT subcategory.
      edm_note: |
        Europeana Data Model (EDM) provides cultural heritage-specific classes:
        - edm:ProvidedCHO: Cultural Heritage Object (the real-world thing)
        - edm:PhysicalThing: Physical/material objects
        - edm:Event: Historical or cultural events
        - edm:TimeSpan: Temporal extent of events/objects
    
    subcategories:
      ARTWORK:
        code: "THG.ART"
        definition: "Physical artworks and art objects"
        examples:
          - "The Night Watch painting"
          - "Rodin's The Thinker"
          - "the Rosetta Stone"
        ontology_class: "crm:E22_Man-Made_Object"
        alternative_classes:
          - "edm:PhysicalThing"
          - "edm:ProvidedCHO"
        edm_note: |
          For artworks in cultural heritage contexts:
          - edm:ProvidedCHO for the conceptual cultural object
          - edm:PhysicalThing for the material manifestation
      
      ARTIFACT:
        code: "THG.AFT"
        definition: "Historical objects and artifacts"
        examples:
          - "the crown jewels"
          - "Viking helmet"
          - "Roman coin"
        ontology_class: "crm:E22_Man-Made_Object"
        alternative_classes:
          - "edm:PhysicalThing"
      
      SPECIES:
        code: "THG.SPC"
        definition: "Biological species and taxa"
        examples:
          - "Tyrannosaurus rex"
          - "Quercus robur"
          - "dodo"
        ontology_class: "schema:Taxon"
      
      EVENT:
        code: "THG.EVT"
        definition: "Named historical events"
        examples:
          - "World War II"
          - "the French Revolution"
          - "the Great Fire of London"
        ontology_class: "crm:E5_Event"
        alternative_classes:
          - "edm:Event"
          - "schema:Event"
        edm_properties:
          has_time_span: "edm:happenedAt"
          occurred_at_place: "edm:occurredAt"
        note: |
          EDM Event extends CIDOC-CRM E5_Event for cultural heritage contexts.
          Use edm:happenedAt for temporal scope, edm:occurredAt for location.
      
      CONCEPT:
        code: "THG.CON"
        definition: "Abstract concepts, movements, styles"
        examples:
          - "Impressionism"
          - "the Baroque style"
          - "human rights"
        ontology_class: "crm:E55_Type"
        alternative_classes:
          - "skos:Concept"
      
      LANGUAGE:
        code: "THG.LNG"
        definition: "Named languages"
        examples:
          - "Dutch"
          - "Latin"
          - "Old French"
        ontology_class: "crm:E56_Language"
      
      MATERIAL:
        code: "THG.MAT"
        definition: "Materials and substances"
        examples:
          - "oil on canvas"
          - "bronze"
          - "parchment"
        ontology_class: "crm:E57_Material"
    
    inclusion_rules:
      - id: "THG_INC001"
        rule: "Tag named artworks as physical objects (distinct from their titles)"
        examples:
          - "the painting known as The Night Watch"
          - "Michelangelo's David"
      
      - id: "THG_INC002"
        rule: "Tag named historical events"
        examples:
          - "the Eighty Years War"
          - "the Golden Age"
      
      - id: "THG_INC003"
        rule: "Tag art movements and styles when named"
        examples:
          - "Dutch Golden Age painting"
          - "Art Nouveau"
    
    exclusion_rules:
      - id: "THG_EXC001"
        rule: "Do NOT tag generic object references"
        examples:
          - "the object (not named)"
          - "an artifact (not specific)"
      
      - id: "THG_EXC002"
        rule: "Do NOT tag common nouns unless part of a proper name"
        examples:
          - "painting (generic)"
          - "sculpture (generic)"