PrazNeuro commited on
Commit
446e14c
Β·
verified Β·
1 Parent(s): b3ec385

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +43 -14
README.md CHANGED
@@ -1,12 +1,35 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
  <p align="center"> <b> Predictive Radiomics for Evaluation of Cancer Immune SignaturE in Glioblastoma | PRECISE-GBM </b> </p>
2
 
3
  <p align="center">
4
  <img src="PRECISE-GBM_GUI_logo%20(1).png" alt="PRECISE-GBM Logo">
5
  </p>
6
 
 
 
 
 
7
  <b> Project: PRECISE-GBM - Model training & retraining helpers </b>
8
 
9
- Overview
10
 
11
  This repository contains code to train models (Gaussian Mixture labelling + SVM and ensemble classifiers) and to persist all artifacts required to reproduce or retrain models on new data. It includes:
12
 
@@ -20,7 +43,7 @@ This repo also includes helper files to make it ready for GitHub:
20
  - `LICENSE` β€” MIT license
21
  - GitHub Actions workflow for CI (pytest smoke test)
22
 
23
- Getting started (Windows PowerShell)
24
 
25
  1) Create and activate a virtual environment
26
 
@@ -44,7 +67,7 @@ python Scenario_heldout_final_PRECISE.py
44
 
45
  The training script will create model files under `models_LM22/` and `models_GBM/` and write metadata JSONs next to each joblib model (selected features, params, cv results) as well as group-level JSON summaries.
46
 
47
- Retraining
48
 
49
  See `README_RETRAIN.md` for detailed CLI and notebook examples. Short example:
50
 
@@ -55,40 +78,46 @@ python retrain_helper.py \
55
  --label-col "label"
56
  ```
57
 
58
- Notes
59
 
60
  - The training script contains hard-coded absolute paths to data files. Before running on another machine, update the `scenarios_*` file paths or place the datasets in the same paths.
61
  - Retrain helper auto-detects model type when `--model-type` is omitted by looking for `{prefix}_svm_params.json` or `{prefix}_ens_params.json`.
62
  - YAML config support for retrain requires PyYAML (`pip install pyyaml`).
63
 
64
- CI
65
 
66
  A basic GitHub Actions workflow runs a smoke pytest to ensure the retrain helper imports and basic pipeline construction works. It does not run heavy training.
67
 
68
- Contributing
69
 
70
  See `CONTRIBUTING.md` for guidance on opening issues and PRs.
71
 
72
- License
73
 
74
- This project is released under the MIT License β€” see `LICENSE`.
75
 
76
- Citation:
77
- Please use the following citation when using the repository.
78
 
79
  2025
80
 
81
- β€’ Ghimire P, Modat M, Booth T. Predictive radiogenomic AI Model for patient stratification in brain tumor immunotherapy trials. Neuro-oncology. Oct 2025; 26(Suppl_3): iii58–iii59. https://doi.org/10.1093/neuonc/noaf193.188
82
 
83
- β€’ Ghimire P, Modat M, Booth T. Radiogenomic AI model predicts immune status in IDH wildtype glioblastoma: PRECISE-GBM study. RCR open. Jan 2025; 3(1): 100234
84
 
85
  2024
86
 
87
- β€’ Ghimire P, Modat M, Booth T. A machine Learning bases predictive radiomics for evaluation of cancer immune signature in glioblastoma: the PRECISE-GBM study. Neuro-Oncology. Oct 2024; 26(suppl_5): v25.
 
 
88
 
89
- β€’ Ghimire P, Modat M, Booth T. A radiogenomic machine learning based study to identify Predictive Radiomics for Evaluation of Cancer Immune SignaturE in IDHw Glioblastoma. Neuro-Oncology. Oct 2024; 26(suppl_7): vii3
90
 
 
91
 
 
92
 
 
93
 
 
94
 
 
 
1
+ ---
2
+ license: mit
3
+ language:
4
+ - en
5
+ metrics:
6
+ - accuracy
7
+ - precision
8
+ pipeline_tag: image-classification
9
+ tags:
10
+ - biology
11
+ - cancer
12
+ - glioblastoma
13
+ - brain
14
+ - multimodal
15
+ - radiogenomics
16
+ - radiomics
17
+ - immune
18
+ - classifier
19
+ ---
20
  <p align="center"> <b> Predictive Radiomics for Evaluation of Cancer Immune SignaturE in Glioblastoma | PRECISE-GBM </b> </p>
21
 
22
  <p align="center">
23
  <img src="PRECISE-GBM_GUI_logo%20(1).png" alt="PRECISE-GBM Logo">
24
  </p>
25
 
26
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
27
+
28
+ This repository contains an AI-based training and retraining pipeline for Predictive Radiomics for Evaluation of Cancer Immune SignaturE in Glioblastoma (PRECISE-GBM). It is the multimodal radiogenomic framework that integrates MRI radiomics, genomics, and immune signatures for patient stratification.
29
+
30
  <b> Project: PRECISE-GBM - Model training & retraining helpers </b>
31
 
32
+ ## πŸ“ Overview
33
 
34
  This repository contains code to train models (Gaussian Mixture labelling + SVM and ensemble classifiers) and to persist all artifacts required to reproduce or retrain models on new data. It includes:
35
 
 
43
  - `LICENSE` β€” MIT license
44
  - GitHub Actions workflow for CI (pytest smoke test)
45
 
46
+ ## πŸ“ Getting started (Windows PowerShell)
47
 
48
  1) Create and activate a virtual environment
49
 
 
67
 
68
  The training script will create model files under `models_LM22/` and `models_GBM/` and write metadata JSONs next to each joblib model (selected features, params, cv results) as well as group-level JSON summaries.
69
 
70
+ ## πŸ“ Retraining
71
 
72
  See `README_RETRAIN.md` for detailed CLI and notebook examples. Short example:
73
 
 
78
  --label-col "label"
79
  ```
80
 
81
+ ## πŸ“Notes
82
 
83
  - The training script contains hard-coded absolute paths to data files. Before running on another machine, update the `scenarios_*` file paths or place the datasets in the same paths.
84
  - Retrain helper auto-detects model type when `--model-type` is omitted by looking for `{prefix}_svm_params.json` or `{prefix}_ens_params.json`.
85
  - YAML config support for retrain requires PyYAML (`pip install pyyaml`).
86
 
87
+ ## πŸ“ CI
88
 
89
  A basic GitHub Actions workflow runs a smoke pytest to ensure the retrain helper imports and basic pipeline construction works. It does not run heavy training.
90
 
91
+ ## πŸ“ Contributing
92
 
93
  See `CONTRIBUTING.md` for guidance on opening issues and PRs.
94
 
95
+ ## πŸ“ License
96
 
97
+ This project is released under the MIT License β€” see `LICENSE`. [MIT License](https://opensource.org/licenses/MIT).
98
 
99
+ ## πŸ“ Citation
100
+ Please use the following citations when using the repository.
101
 
102
  2025
103
 
104
+ > **Ghimire P, Modat M, Booth T**. *Predictive radiogenomic AI Model for patient stratification in brain tumor immunotherapy trials. Neuro-oncology. Oct 2025; 26(Suppl_3): iii58–iii59. doi: https://doi.org/10.1093/neuonc/noaf193.188*
105
 
106
+ > **Ghimire P, Modat M, Booth T**. *Radiogenomic AI model predicts immune status in IDH wildtype glioblastoma: PRECISE-GBM study. RCR open. Jan 2025; 3(1): 100234*
107
 
108
  2024
109
 
110
+ > **Ghimire P, Modat M, Booth T**. *A machine Learning bases predictive radiomics for evaluation of cancer immune signature in glioblastoma: the PRECISE-GBM study. Neuro-Oncology. Oct 2024; 26(suppl_5): v25.*
111
+
112
+ > **Ghimire P, Modat M, Booth T**. *A radiogenomic machine learning based study to identify Predictive Radiomics for Evaluation of Cancer Immune SignaturE in IDHw Glioblastoma. Neuro-Oncology. Oct 2024; 26(suppl_7): vii3*
113
 
 
114
 
115
+ **Contact**:
116
 
117
+ **Dr Prajwal Ghimire**
118
 
119
+ **MBBS MRCSEd MSc PhD'26**
120
 
121
+ School of Biomedical Engineering & Imaging Sciences, King's College London
122
 
123
+ Email: [prajwal.1.ghimire@kcl.ac.uk](mailto:prajwal.1.ghimire@kcl.ac.uk)