Files

noisedestroyers 36a576dc2c Enhanced Textual TUI with proper API usage and documentation

- Fixed DataTable row selection and event handling
- Added explicit column keys to prevent auto-generated keys
- Implemented row-to-flow mapping for reliable selection tracking
- Converted left metrics panel to horizontal top bar
- Fixed all missing FlowStats/EnhancedAnalysisData attributes
- Created comprehensive Textual API documentation in Documentation/textual/
- Added validation checklist to prevent future API mismatches
- Preserved cursor position during data refreshes
- Fixed RowKey type handling and event names

The TUI now properly handles flow selection, displays metrics in a compact top bar,
and correctly correlates selected rows with the details pane.

2025-07-27 18:37:55 -04:00

2.8 KiB

Raw Permalink Blame History

Hierarchical Flow Layout Demo

Complete Flow Analysis View Layout

Based on the actual data from 1 PTPGM.pcapng, here's how the hierarchical layout will appear:

  #   Source                   Proto    Destination              Extended     Frame Type        Pkts    Volume      Timing     Quality
  1   192.168.4.89:1024       UDP      239.1.2.10:8080         3 types      Mixed             1452      1.9MB      77.8ms     Enhanced
                                                                CH10         CH10-Data         1110     1.44MB       102ms       76.4%
                                                                CH10         TMATS              114      148KB       990ms        7.8%
                                                                             UDP                228      296KB       493ms       15.7%
  2   11.59.19.204:319        UDP      224.0.1.129:319         3 types      Mixed              297     26.8KB       378ms      Normal
                                                                PTP          PTP-Signaling     226     20.4KB       498ms       76.1%
                                                                PTP          PTP-Sync            57      6.1KB        2.0s       19.2%
                                                                PTP          PTP-Unknown         14      1.5KB        7.5s        4.7%
  3   11.59.19.202:4001       UDP      239.0.1.133:4001        1 types      Single             113     17.4KB       999ms      Normal
                                                                             UDP                113     17.4KB       999ms      100.0%

Visual Features

Main Flow Lines (Bold)

Flow 1: CH10 telemetry with mixed frame types (CH10-Data, TMATS, UDP)
Flow 2: PTP timing protocol with multiple message types
Flow 3-5: Simple flows with single frame types

Sub-Rows (Indented, Dimmed)

Perfect Column Alignment: All columns align with main flow headers
Empty Source/Proto/Destination: Sub-rows inherit from main flow
Specific Protocols: Extended column shows CH10, PTP, or empty for basic protocols
Frame Type Details: Specific frame types like CH10-Data, PTP-Sync, UDP, IGMP
Individual Metrics: Packet counts, volumes, timing, and percentages for each type

Data Insights Visible

CH10 Flow Composition: 76.4% CH10-Data (main telemetry), 7.8% TMATS (metadata), 15.7% UDP (overhead)
PTP Flow Breakdown: 76.1% signaling messages, 19.2% sync messages, 4.7% unknown
Performance Characteristics: Different timing patterns for each frame type
Protocol Hierarchy: Transport (UDP/OTHER) → Extended (CH10/PTP) → Frame Types

This layout provides complete visibility into flow composition while maintaining clear visual hierarchy and perfect column alignment.

2.8 KiB Raw Permalink Blame History