How tonyxtyan/helab works
HeLab is a PyQt desktop lab-data browser and analysis board. A user opens a folder in the main window; folder tabs browse the filesystem, asynchronously compute status, and load selected data into RAM. The window also exposes selectable analysis scripts and plotting tools. The graph captures the documented multi-analysis direction and sampled runtime wiring; script implementations and several worker details are unsampled, so uncertain internal links are omitted.
Main entry points: FolderExplorer.py Folder explorer · HelabMainWindow.py Main window · HelabFileSystemModel.py Filesystem model · StatusWorker.py Status worker
Components 25
Desktop interface
- Application entry
helab/main.py - Main window
helab/views/HelabMainWindow.py - Folder tabs
helab/views/FolderTabWidget.py - Icon resources
helab/resources/icons.py - Settings dialog
helab/views/SettingsDialog.py - Memory window
helab/views/MemoryUsageWindow.py
Folder and status
- Folder explorer
helab/views/FolderExplorer.py - Filesystem model
helab/models/HelabFileSystemModel.py - Status tree
helab/views/StatusTreeView.py - Status icons
helab/views/StatusIconDelegate.py - Status report
helab/models/StatusReport.py
Workers and state
- Directory check
helab/workers/DirectoryCheckWorker.py - Status worker
helab/workers/StatusWorker.py - Deep status scan
helab/workers/StatusDeepWorker.py - Status rescan
helab/workers/StatusRescanWorker.py - RAM data loader
helab/workers/LoadFolderToRamWorker.py - Thread coordination
helab/utils/threading_setup.py - Persistent caches
helab/utils/caching_setup.py - Filesystem cache
helab/utils/os_cached.py
Analysis scripts
- Script selector
helab/models/ScriptTreeSelector.py - Script manager
helab/scripts/scripts_manager.py - Script interface
helab/scripts/base.py - 3D scatter plot
helab/scripts/plotly_3d_sactter.py - Dash server helper
helab/utils/dash_server.py
Other components
- Lab user
Connections 30
- Lab user → Application entry: starts app
README.md - Application entry → Main window: launches
helab/main.py - Main window → Folder tabs: creates tabs
helab/views/HelabMainWindow.py - Main window → Script selector: uses selector
helab/views/HelabMainWindow.py - Main window → Settings dialog: opens settings
helab/views/HelabMainWindow.py - Main window → Memory window: opens window
helab/views/HelabMainWindow.py - Folder tabs → Folder explorer: creates explorer
helab/views/FolderTabWidget.py - Folder explorer → Filesystem model: uses model
helab/views/FolderExplorer.py - Folder explorer → Status tree: uses view
helab/views/FolderExplorer.py - Status tree → Status icons: uses delegate
helab/views/StatusTreeView.py - Filesystem model → Status report: reads status
helab/models/HelabFileSystemModel.py - Filesystem model → Status worker: starts worker
helab/models/HelabFileSystemModel.py - Folder explorer → Directory check: requests checks
helab/views/FolderExplorer.py - Folder explorer → Deep status scan: requests scans
helab/views/FolderExplorer.py - Folder explorer → Status rescan: requests rescans
helab/views/FolderExplorer.py - Folder explorer → RAM data loader: loads selection
helab/views/FolderExplorer.py - Status worker → Status report: updates report
helab/workers/StatusWorker.py - RAM data loader → Status report: reads report
helab/workers/LoadFolderToRamWorker.py - Thread coordination → Directory check: coordinates
helab/utils/threading_setup.py - Thread coordination → RAM data loader: coordinates
helab/utils/threading_setup.py - Thread coordination → Status worker: coordinates
helab/utils/threading_setup.py - Status worker → Persistent caches: uses caches
helab/workers/StatusWorker.py - Directory check → Filesystem cache: checks cached paths
helab/workers/DirectoryCheckWorker.py - Folder explorer → Persistent caches: manages cache
helab/views/FolderExplorer.py - Script selector → Script manager: uses manager
helab/models/ScriptTreeSelector.py - Script manager → Script interface: uses interface
helab/scripts/scripts_manager.py - Script selector → 3D scatter plot: selects analysis
helab/models/ScriptTreeSelector.py - 3D scatter plot → Dash server helper: uses server
helab/scripts/plotly_3d_sactter.py - Application entry → Icon resources: initializes icons
helab/main.py - Filesystem model → Icon resources: uses status icons
helab/models/HelabFileSystemModel.py