id: https://nde.nl/ontology/hc/class/NetworkAnalysis
name: network_analysis_class
title: Network Analysis Class
version: 1.0.0
prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  schema: http://schema.org/
imports:
  - linkml:types
  - ./SpecificityAnnotation
  - ./TemplateSpecificityScores
  - ./HeritageTypeCount
  - ../slots/connections_by_heritage_type
  - ../slots/heritage_relevant_count
  - ../slots/heritage_relevant_percentage
  - ../slots/specificity_annotation
  - ../slots/template_specificity
  - ../slots/total_connections_extracted
default_prefix: hc

classes:
  NetworkAnalysis:
    class_uri: schema:DataFeedItem
    description: |
      Aggregated statistics about the connection network.

      Provides summary metrics for quick analysis:
      - Total connections extracted
      - Heritage-relevant count and percentage
      - Breakdown by heritage type (GLAMORCUBESFIXPHDNT)

      **Example**:
      ```json
      {
        "total_connections_extracted": 776,
        "heritage_relevant_count": 456,
        "heritage_relevant_percentage": 58.8,
        "connections_by_heritage_type": {
          "A": 45,
          "M": 89,
          "D": 112,
          "R": 78
        }
      }
      ```
    slots:
      - connections_by_heritage_type
      - heritage_relevant_count
      - heritage_relevant_percentage
      - specificity_annotation
      - template_specificity
      - total_connections_extracted
    slot_usage:
      total_connections_extracted:
        description: Total number of connections in the network
        slot_uri: schema:numberOfItems
        range: integer
        required: true
        minimum_value: 0
      heritage_relevant_count:
        description: Number of connections marked as heritage-relevant
        slot_uri: hc:heritageRelevantCount
        range: integer
        required: true
        minimum_value: 0
      heritage_relevant_percentage:
        description: Percentage of connections that are heritage-relevant (0-100)
        slot_uri: hc:heritageRelevantPercentage
        range: float
        minimum_value: 0.0
        maximum_value: 100.0
        examples:
          - value: 58.8
      connections_by_heritage_type:
        description: |
          Breakdown of heritage-relevant connections by type code.
          Keys are single-letter GLAMORCUBESFIXPHDNT codes.
        slot_uri: hc:connectionsByHeritageType
        range: HeritageTypeCount
        multivalued: true
        inlined: true
        inlined_as_list: true
      specificity_annotation:
        range: SpecificityAnnotation
        inlined: true
      template_specificity:
        range: TemplateSpecificityScores
        inlined: true
    comments:
      - Optional aggregation - can be computed from connections array
      - Useful for quick heritage sector analysis