--- language: - en license: mit tags: - medical-imaging - chest-xray - pneumonia-detection - state-space-models - mamba - sssm - pediatric - physics-informed-neural-networks pipeline_tag: image-classification datasets: - paultimothymooney/chest-xray-pneumonia metrics: - accuracy - f1 - precision - recall - roc_auc model-index: - name: BioHCL-SSSM results: - task: type: image-classification name: Pediatric Pneumonia Classification dataset: name: Guangzhou Pediatric Chest X-Ray Cohort (Cell 2018) type: paultimothymooney/chest-xray-pneumonia metrics: - type: accuracy value: 99.37 name: 10-Fold Cross-Validation Accuracy - type: f1 value: 0.9957 name: 10-Fold Cross-Validation F1 - type: roc_auc value: 0.9929 name: 10-Fold Cross-Validation AUC --- # BioHCL-SSSM: Complete Medical Imaging Workspace & Model Hub **Author:** unknownBrain **Project:** BioHCL-SSSM: Hierarchical Convolutional State-Space Hybrid Architecture for Pediatric Pneumonia Diagnosis **Dataset:** Guangzhou Women and Children’s Medical Center Pediatric Chest X-Ray Cohort (Kermany et al., *Cell* 2018; 5,856 images, 624 official held-out test split) --- ## πŸ“Œ Complete Repository Contents This public repository contains the complete end-to-end workspace for the BioHCL-SSSM project, including all pre-trained checkpoints, raw experimental sweeps, modular source code, deliverable packages, evaluation figures, and peer-reviewed reference literature: ``` BioHCL-SSSM-Complete-Workspace/ β”‚ β”œβ”€β”€ deliverables/ # πŸ“ OFFICIAL SUPERVISOR DELIVERABLE PACKAGES β”‚ β”œβ”€β”€ 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 & Class Weighting Dynamics β”‚ β”œβ”€β”€ 5_10_fold_cross_validation_metrics.csv # Approved 10-Fold CV metrics (Folds 1 to 10 + Mean/Std) β”‚ β”œβ”€β”€ remaining_ablations_plan.md # Comprehensive scientific audit & execution plan β”‚ β”œβ”€β”€ tathagat_sir_revision_report.md # Full revision report formatted for Tathagat Sir β”‚ β”œβ”€β”€ v2/ # Clean v2 supervisor release package β”‚ β”œβ”€β”€ raw_sweeps/ # Raw 64-run ablation search & hardware profiling logs β”‚ └── figures/ # Publication-ready ROC, PR, and Confusion Matrix plots β”‚ β”œβ”€β”€ medical imaging/ # πŸ“ FULL ORIGINAL TRAINING CODE & WEIGHTS β”‚ β”œβ”€β”€ best_student_cv.pt # Best Model Checkpoint (Fold 2: 99.81% Val Acc, 0.9987 F1) β”‚ β”œβ”€β”€ model_fold_1.pt … model_fold_10.pt # All 10 trained cross-validation model weights (54 MB each) β”‚ β”œβ”€β”€ ablation.csv # Raw 64 empirical ablation sweep runs β”‚ β”œβ”€β”€ extracted_code.py # Original full pipeline code extracted from Colab β”‚ β”œβ”€β”€ build_benchmark.py # Benchmark runner β”‚ β”œβ”€β”€ build_ablations.py # Ablation engine runner β”‚ β”œβ”€β”€ build_eval.py # Test evaluation engine β”‚ β”œβ”€β”€ build_xai.py # Explainability generator (Attention, GradCAM, LIME, SHAP) β”‚ └── *.ipynb / *.ipynb.txt # Full Colab training notebooks β”‚ β”œβ”€β”€ hf_repo_staging/ # πŸ“ CLEAN MODULARIZED SOURCE & ARTIFACTS β”‚ β”œβ”€β”€ src/ # Clean modular Python package (models, dataset, loss, eval) β”‚ β”œβ”€β”€ checkpoints/ # Reorganized weights (cross_validation/ and ablations/) β”‚ β”œβ”€β”€ results/ # CSV deliverables β”‚ └── figures/ # Complete high-res figures & XAI heatmaps β”‚ β”œβ”€β”€ papers to refer/ # πŸ“ 12 PEER-REVIEWED REFERENCE PAPERS β”‚ β”œβ”€β”€ IBMED-S-26-01139.pdf # Bio-HCLSSSM Reference Paper (Computers in Biology and Medicine) β”‚ β”œβ”€β”€ CMPB-D-26-01992_R1_reviewer.pdf # Computer Methods and Programs in Biomedicine β”‚ β”œβ”€β”€ EAAI-26-17234_reviewer.pdf # Engineering Applications of Artificial Intelligence β”‚ β”œβ”€β”€ TCIV-2026-0179.pdf # Computer Methods in Biomechanics and Biomedical Engineering β”‚ β”œβ”€β”€ IJIG-D-26-00102_R1_reviewer.pdf # International Journal of Image and Graphics β”‚ β”œβ”€β”€ JBHI-04026-2026_Proof_hi.pdf # IEEE Journal of Biomedical and Health Informatics β”‚ └── ... (6 additional reviewer proofs) β”‚ β”œβ”€β”€ run_colab_remaining_ablations.py # πŸš€ STANDALONE RUNNER FOR REMAINING EXPERIMENTS β”‚ # Executes the 4 remaining core runs (lambda_bio in [0.2, 0.5, 1.0] and MHSA Attention baseline) β”‚ # Takes ~10 mins on GPU and logs directly to CSV β”‚ β”œβ”€β”€ 10_fold_metrics.csv # Exact 10-fold cross-validation metrics β”œβ”€β”€ benchmark_master.csv # Consolidated SOTA benchmarks β”œβ”€β”€ remaining_ablations_plan.md # Scientific audit & plan └── tathagat_sir_revision_report.md # Comprehensive revision report ``` --- ## πŸ† Key Performance Highlights 1. **Approved 10-Fold Cross-Validation:** * **Mean Accuracy:** **99.37% Β± 0.33%** * **Mean F1-Score:** **0.9957 Β± 0.0022** * **Mean ROC-AUC:** **0.9929 Β± 0.0039** * **Pooled Errors:** Only 33 errors across 5,232 images (3,862 TP, 1,337 TN, 12 FP, 21 FN). * **Peak Fold:** **Fold 2** achieved **99.81% accuracy, 0.9987 F1, 100% recall, 99.26% specificity** (`best_student_cv.pt`). 2. **Official Held-Out Test Set (624 Images) Benchmark:** * **BioHCL-SSSM:** **96.47% Accuracy, 97.22% F1, 99.37% ROC-AUC** with only **14.01M parameters and 8.56 GFLOPs**. * Outperforms standard Vision Transformers (**ViT-Base:** 86.57M params, 92.47% Acc) with **83.8% fewer parameters**. * Matches/exceeds Hierarchical Shifted-Window Transformers (**Swin-T:** 27.52M params, 95.99% Acc) with **49.1% fewer parameters**. --- ## πŸš€ Quick Execution on New GPU (i9 + RTX 3080 Ti or Colab) To execute the remaining 4 core ablation runs: ```bash # 1. Clone this repository git clone https://huggingface.co/unknownBrain/BioHCL-SSSM-Complete-Workspace cd BioHCL-SSSM-Complete-Workspace # 2. Install dependencies pip install torch torchvision timm albumentations huggingface_hub scikit-learn pandas pillow # 3. Run the automated ablation suite python run_colab_remaining_ablations.py ``` --- ## πŸ“œ License & Citation Licensed under the **MIT License**. Guangzhou Women and Children’s Medical Center Chest X-Ray Cohort (Kermany et al., *Cell* 2018).