# =============================================================================
# QUANTITY Hypernym Module
# =============================================================================
# Version: 1.7.0
# Module: hypernyms/qty.yaml
# 
# Numerical quantities, measurements, counts, and ranges.
# =============================================================================

id: hypernym_quantity
name: "QUANTITY Hypernym"
description: |
  Numerical quantities, measurements, counts, and ranges. Includes
  dimensions, populations, statistics, and any quantifiable values
  with or without units.

hypernym:
  QUANTITY:
    code: "QTY"
    definition: |
      Numerical quantities, measurements, counts, and ranges. Includes
      dimensions, populations, statistics, and any quantifiable values
      with or without units.
    
    ontology_mappings:
      primary_class: "crm:E54_Dimension"
      alternative_classes:
        - "schema:QuantitativeValue"
        - "ivoa:Measure"
      nerd_class: "nerd:Amount"
      nerd_note: "NERD Amount class for all quantities and measurements."
    
    subcategories:
      COUNT:
        code: "QTY.CNT"
        definition: "Cardinal numbers and item counts"
        examples:
          - "8,000 artworks"
          - "over 1 million visitors"
          - "15 staff members"
        ontology_class: "xsd:integer"
      
      MEASUREMENT:
        code: "QTY.MSR"
        definition: "Physical measurements with units"
        examples:
          - "363 cm by 437 cm"
          - "2.5 meters tall"
          - "500 square meters"
        ontology_class: "crm:E54_Dimension"
      
      CURRENCY:
        code: "QTY.CUR"
        definition: "Monetary amounts"
        examples:
          - "15 euro admission"
          - "5 million euros"
          - "1.2 billion dollars"
        ontology_class: "schema:MonetaryAmount"
      
      PERCENTAGE:
        code: "QTY.PCT"
        definition: "Percentages and ratios"
        examples:
          - "75 percent of the collection"
          - "one-third of visitors"
        ontology_class: "xsd:decimal"
      
      RANGE:
        code: "QTY.RNG"
        definition: "Numeric ranges"
        examples:
          - "between 50,000 and 100,000"
          - "10-15 meters"
          - "ages 6-12"
        ontology_class: "schema:QuantitativeValue"
      
      ORDINAL:
        code: "QTY.ORD"
        definition: "Ordinal numbers and rankings"
        examples:
          - "the 5th largest museum"
          - "first place"
          - "17th century"
        ontology_class: "xsd:integer"
    
    inclusion_rules:
      - id: "QTY_INC001"
        rule: "Tag quantities with their units as single entities"
        examples:
          - "8,000 paintings (single entity)"
          - "2.5 million visitors annually"
      
      - id: "QTY_INC002"
        rule: "Tag approximate quantities"
        examples:
          - "approximately 500"
          - "over 1 million"
          - "nearly 10,000"
      
      - id: "QTY_INC003"
        rule: "Tag ranges as single entities"
        examples:
          - "10,000 to 15,000 items"
    
    exclusion_rules:
      - id: "QTY_EXC001"
        rule: "Do NOT tag numbers that are part of proper names"
        examples:
          - "World War 2 (part of name, tag as THING.EVT)"
          - "Henry VIII (part of name, tag as AGENT)"
      
      - id: "QTY_EXC002"
        rule: "Do NOT tag page numbers, reference numbers, or identifiers"
        examples:
          - "page 42"
          - "inventory number 12345"