Complete medical imaging workspace dump (weights, deliverables, papers, notebooks, code, figures)
eded815 verified |
Download deliverables/README.md from unknownBrain/BioHCL-SSSM-Complete-Workspace: direct link, hf CLI and curl.
- Browser
- Download file 7.92 kB
-
https://huggingface.co/unknownBrain/BioHCL-SSSM-Complete-Workspace/resolve/main/deliverables/README.md
- Command line
-
hf download hf://unknownBrain/BioHCL-SSSM-Complete-Workspace/deliverables/README.md
-
curl -L -o README.md https://huggingface.co/unknownBrain/BioHCL-SSSM-Complete-Workspace/resolve/main/deliverables/README.md
7.92 kB
| # BioHCL-SSSM Project Deliverables Package (Revised per Supervisor Feedback) | |
| This repository package contains the finalized, publication-grade benchmarks, segregated ablation studies, and 10-fold cross-validation results for the **BioHCL-SSSM** model on the Guangzhou Pediatric Chest X-Ray dataset (Kermany et al., *Cell* 2018; 5,856 images, 624 official held-out test split). | |
| --- | |
| ## Deliverables Architecture & Supervisor Alignment | |
| ``` | |
| deliverables/ | |
| βββ README.md # Deliverables index & executive summary | |
| βββ tathagat_sir_revision_report.md # Full report mapped directly to Tathagat Sir's feedback | |
| βββ 1_sota_benchmarks_master.csv # 15-Model SOTA Benchmark (Literature baselines + Ours) | |
| βββ 2_table1_component_ablation.csv # Table 1: Macro Component Ablation (SSSM vs Attention vs CNN) | |
| βββ 3_table2_layer_hyperparameter_deduction.csv # Table 2: Proposed SSSM Layer Hyperparameter Deduction | |
| βββ 4_table3_loss_function_weighting.csv # Table 3: Loss Function Formulations & Class Weighting Dynamics | |
| βββ 5_10_fold_cross_validation_metrics.csv # Approved 10-Fold CV metrics (Folds 1 to 10 + Mean/Std) | |
| βββ raw_sweeps/ # Unaggregated raw grid sweep files | |
| β βββ ablation_grid_sweep_64_runs.csv # 64-run ablation search | |
| β βββ benchmark_profiling_raw.csv # Latency & FLOPs profiling log | |
| βββ figures/ # Publication-grade evaluation figures | |
| βββ 10_fold_overlay_roc_curve.png # 10-Fold ROC with variance envelopes | |
| βββ 10_fold_overlay_pr_curve.png # 10-Fold PR with variance envelopes | |
| βββ 10_fold_confusion_matrix.png # Pooled 10-Fold Confusion Matrix (5,232 images) | |
| βββ 10_fold_global_roc_curve.png # Pooled global ROC | |
| βββ 10_fold_global_pr_curve.png # Pooled global PR | |
| βββ 10_fold_trajectory_plot.png # Training/validation curves across folds | |
| βββ layerwise_tradeoff_plot.png # Latency / FLOPs vs F1 Pareto frontier | |
| βββ test_student_biohcl_sssm_cm.png # Official Test Set Confusion Matrix (BioHCL-SSSM) | |
| βββ test_student_biohcl_sssm_roc.png # Official Test Set ROC Curve (BioHCL-SSSM) | |
| βββ test_baseline_resnet50_cm.png # Official Test Set Confusion Matrix (ResNet-50) | |
| βββ test_baseline_resnet50_roc.png # Official Test Set ROC Curve (ResNet-50) | |
| βββ test_bioprior_ablation_cm.png # Official Test Set Confusion Matrix (BioPrior Ablated) | |
| βββ test_roc_pr_comparison.png # Official Test Set ROC/PR Comparison | |
| ``` | |
| --- | |
| ## 1. State-of-the-Art Comparative Benchmarks (`1_sota_benchmarks_master.csv`) | |
| *Directly addresses feedback: "Benchmark - wrong. I need benchmark as in state of the art techniques accuracy as a vanilla model Like Resnet, vit, deit etc around 10 to 15 latest models and ofc ours best model in the sheet"* | |
| * **15 Distinct Models** benchmarked on the official 624-image Kermany test split (234 Normal, 390 Pneumonia). | |
| * **Covered Families:** Classic CNNs (Inception-V3, ResNet-18, DenseNet-121, ResNet-50, Xception, GoogLeNet, AlexNet, VGG-16), Modern Lightweight CNNs (MobileNetV3, MobileNet-v1), Vision Transformers (ViT-Base, DeiT-Small, Swin-T), and Proposed State-Space Hybrids (BioHCL-SSSM). | |
| * **Key Finding:** BioHCL-SSSM achieves **96.47% accuracy, 97.22% F1, and 99.37% ROC-AUC** with only **14.01M parameters and 8.56 GFLOPs**, outperforming large transformers like ViT-Base (86.57M params, 92.47% acc) and matching/exceeding Swin-T (27.52M params, 95.99% acc) at half the parameter footprint. | |
| --- | |
| ## 2. Table 1: Component-Wise Architectural Ablation (`2_table1_component_ablation.csv`) | |
| *Directly addresses feedback: "Table 1 - for component so ur layers comes there and other alternative like if u don't use SSSM and use attention how much computation is gained how much accuracy is gained or lost etc"* | |
| * **SSSM vs. Multi-Head Self-Attention (MHSA):** Replacing SSSM with MHSA increases compute by **+50.0% FLOPs (12.84 vs 8.56 GFLOPs)** and latency by **+59.8% (78.4ms vs 49.06ms)**, while dropping validation F1 by **-0.0269** due to quadratic $O(N^2)$ memory bottlenecks and lack of directional scanline continuity. | |
| * **SSSM vs. Depthwise Separable Conv:** Replacing SSSM with local convolutions saves compute (-16.8% FLOPs, -16.96ms faster), but suffers an acute **-0.0703 F1 drop** due to inability to model bilateral consolidations across hemithoraces. | |
| * **Dual-Chain vs. Single-Chain Backbone:** Dropping DenseNet-121 drops F1 by **-0.2055** (severe underfitting); dropping Hierarchical CNN drops F1 by **-0.0483**. | |
| * **Clinical Prior Ablation:** Disabling anatomical prior drops F1 by **-0.0775** due to false-positive over-indexing on peripheral rib/diaphragmatic edges. | |
| * **Fusion Mechanism:** Bilinear gated cross-attention outperforms naive additive fusion by **+0.0467 F1**. | |
| --- | |
| ## 3. Table 2: Proposed SSSM Layer Hyperparameter Deduction (`3_table2_layer_hyperparameter_deduction.csv`) | |
| *Directly addresses feedback: "Table 2 - of ur proposed layer how u can deduce hyperparameters on this. I take only one example which u have used is SSSM blocks or the parameter for ssssm similarly u can have other parameters for other layers. If not atleast table 2"* | |
| * **Block Depth ($L$):** Swept across $L \in \{1, 2, 3, 4, 6\}$. Peak Pareto efficiency occurs at **$L = 3$** (14.01M params, 49.06ms latency, 0.9987 Val F1). Depths $L=4$ and $L=6$ induce parameter redundancy (+13% to +40%) without accuracy gains. | |
| * **State Dimension ($d_{state}$):** Evaluated at $d_{state} \in \{16, 32, 64, 128\}$. $d_{state} = 16$ creates an information bottleneck (0.9580 F1); **$d_{state} = 64$** hits optimal capacity (0.9987 F1); $d_{state} = 128$ increases latency to 61.2ms without performance gains. | |
| * **Channel Expansion Factor ($E$):** Evaluated at $E \in \{1, 2, 4\}$. **$E = 2$** offers the optimal continuous ODE transformation; $E=4$ triggers severe over-parameterization (+30% params) prone to overfitting. | |
| * **Residual Connection Strategy:** Direct sequential cascading without skips drops F1 to 0.9120 (-8.67%); **Additive Identity Highways** guarantee stable continuous-to-discrete gradient propagation. | |
| --- | |
| ## 4. Table 3: Loss Function & Class Weighting Dynamics (`4_table3_loss_function_weighting.csv`) | |
| *Directly addresses feedback: "Then table 3 is loss function which u are using what weighted metrics are taken for granted etc"* | |
| * **Unweighted CE:** Suffers from severe false positive bias (18.38% false alarm rate in healthy children, specificity 81.62%) because it over-indexes on the 72% pneumonia majority class. | |
| * **Class-Weighted CE ($w = [1.95, 0.67]$):** Heavily penalizes normal-class misclassifications, elevating specificity to **93.16% (+11.54%)**. | |
| * **Focal Loss ($\gamma=2.0, \alpha=0.25$):** Down-weights easily classified clear lungs, concentrating gradient updates on borderline consolidations (94.07% acc, 0.9529 F1). | |
| * **Bio-PINN Inductive Penalty Loss (Proposed):** Integrates anatomical regularization masks, achieving the optimal clinical Pareto frontier: **98.21% Sensitivity, 93.59% Specificity, and 99.37% ROC-AUC**. | |
| --- | |
| ## 5. 10-Fold Cross-Validation (`5_10_fold_cross_validation_metrics.csv`) | |
| *Directly addresses feedback: "CV is correct" (Approved by Tathagat Sir)* | |
| * **Exact Integer Confusion Matrix:** Pooled across 5,232 images: **3,862 TP, 1,337 TN, 12 FP, 21 FN** (99.37% global accuracy, only 33 errors). | |
| * **Mean Performance:** **Accuracy: 99.37% Β± 0.33%**, **Precision: 0.9969 Β± 0.0036**, **Recall: 0.9946 Β± 0.0059**, **Specificity: 0.9911 Β± 0.0103**, **F1-Score: 0.9957 Β± 0.0022**, **AUC: 0.9929 Β± 0.0039**. | |