Official repo for Foundation Models for Quantitative Biomarker Discovery in Cancer Imaging [INSERT DOI]
Project description
This is the the official repository for the paper:
"Foundation Models for Quantitative Biomarker Discovery in Cancer Imaging "
Suraj Pai, Dennis Bontempi, Vasco Prudente, Ibrahim Hadzic, Mateo Sokač, Tafadzwa L. Chaunzwa, Simon Bernatz, Ahmed Hosny, Raymond H Mak, Nicolai J Birkbak, Hugo JWL Aerts
NOTE For detailed documentation check our website
Overview
Quick Start (in under 15 mins!)
We provide two notebooks that can be run in google colab to promote the use of our model by the community,
-
A reproducibility notebook that allows users to recreate our analysis for NSCLC prognostication, from downloading the data to obtaining results matching our manuscript.
-
A bring your own use case notebook that shows you how you can use the foundation model for your data.
You are not limited to using Colab and you can run our model on your data locally in only 3 steps!
Step 1: Install all our dependencies:
pip install foundation-cancer-image-biomarker --pre
Step 2: Generate a CSV file with the path to your images and seed points (in physical coordinates),
| image_path | coordX | coordY | coordZ |
|---|---|---|---|
| /content/data/dummy_0.nii.gz | 55.0 | 119.0 | 27.0 |
Step 3: Run this in your code environment,
from fmcib.run import get_features
feature_df = get_features("csv_path_here")
This will preprocess your data, download our pre-trained model and execute inference on whatever device you have (CPU/GPU) and return a dataframe with the features.
License
This project is licensed under the terms of the MIT license.
See LICENSE for more details.
Acknowledgements
Code development, testing, and documentation: Suraj Pai, Ibrahim Hadzic
Framework used for building the code: project-lighter
project-lighter was developed internally within our lab by Ibrahim Hadzic and Suraj Pai.
Disclaimer
The code and data of this repository are provided to promote reproducible research. They are not intended for clinical care or commercial use. The software is provided "as is", without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. In no event shall the authors or copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the software or the use or other dealings in the software.
Code Citation
Will be updated to reflect a Zenodo DOI upon publication
@misc{foundation-cancer-image-biomarker,
author = {AIM-Harvard},
title = {Official repo for "Foundation Models for Quantitative Biomarker Discovery in Cancer Imaging"},
year = {2023},
publisher = {GitHub},
journal = {GitHub repository},
howpublished = {\url{https://github.com/AIM-Harvard/foundation-cancer-image-biomarker}}
}
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for foundation_cancer_image_biomarker-0.0.1a22.tar.gz
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 51ac2d9b0638be81964b53c439f171be3df6f0acf22cadd93f913c30b5cd12ef |
|
| MD5 | 6e5fdb65c313585fe61b4e29a09b0a22 |
|
| BLAKE2b-256 | 95ff9dfa223635db5d24d3cedc76f6be09d2f3513ef0d6b96926549b63022096 |
Hashes for foundation_cancer_image_biomarker-0.0.1a22-py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 2993e3af892c05d9bdb10c3d3b56fa45b84f030d1723dc560ab82b0181b268a5 |
|
| MD5 | b89c297f08125ebfdf587a08cd7d98bd |
|
| BLAKE2b-256 | 6f89092af5186420e60a61dd57b5298322cd3c326534c8fffe2be0bb74df7996 |
