Skip to content

Repository files navigation

BCRBench: A Breast Cancer Risk Benchmark

DOIDocumentationLicense: MIT

BCRBench is an open-source benchmark for breast cancer risk prediction from mammography. It provides a unified and reproducible framework for evaluating state-of-the-art models under standardized preprocessing, training, inference, and evaluation protocols.

The benchmark supports both single-timepoint and longitudinal breast cancer risk prediction, enabling fair and reproducible comparison across different approaches.

📖 Documentation:https://sot176.github.io/BCRBench/


We aim to encourage further research by providing a single, unified repository where all image-based breast cancer risk prediction models can be collected, compared, and extended. By centralizing these implementations, we hope to accelerate progress in the field and make it easier for researchers to benchmark and build upon existing methods.


Table of Contents

  1. 📘 Overview
  2. ⚙️ Models Implemented
  3. 🗂️ Datasets
  4. ▶️Usage
  5. 📄 Citation
  6. 📝 License

Overview

This repository provides implementations of several recent breast cancer risk prediction models, allowing users to:

  • Train models end-to-end on mammogram datasets.

  • Evaluate models with unified metrics.

  • Experiment with single-view, multi-view, and longitudinal mammogram data.


Models Implemented

ModelConference/JournalInput Views & TimepointsKey Idea
LMV-NetMICCAI 2026Both views of 1 breast, 2 timepointsMulti-view longitudinal model with dual-stream attention leveraging both views of one breast.
ImgFeatAlignMICCAI 20251 view of 1 breastUses image-based deformation (MammoRegNet) applied in feature space for improved longitudinal comparison.
VMRA-MaRMICCAI 20254 screening mammograms (multiple timepoints)Extends Mirai to longitudinal mammograms using Spatial Asymmetry Detector and Longitudinal Asymmetry Tracker.
OA-BReaCRMICCAI 20241 view of 1 breast, 2 timepointsLearns longitudinal changes using feature-based deformation fields for better temporal alignment.
MiraiSci. Transl. Med. 20214 screening mammograms (single timepoint)Learns breast cancer risk from all four views in a single visit

Each model is implemented with a consistent API and unified training/evaluation pipeline.


Datasets

This repository integrates two large, publicly available mammography datasets:


Usage

For using this framework follow the instructions below:

1) Clone & Setup Environment

Clone the repository, create a conda environment, and install the requirements:

git clone https://github.com/sot176/BCRBench.git
cd BCRBench
conda create -n bc_risk python=3.12
conda activate bc_risk
pip install -r requirements.txt

Important: For each script in the scripts folder, make sure to update the paths to point to your datasets and choose the output directories for results.

2) Requirements

All Python dependencies are listed in requirements.txt. Install them using the commands above.

3) Training

Each model has its own training script under scripts/.
Run the model of your choice:

 scripts/train_mirai.sh
scripts/train_vmra_mar.sh
scripts/train_oa_breacr.sh
scripts/train_imgfeatalign.sh
scripts/train_lmv_net.sh

4) Evaluation

Similarly, each model has its own evaluation script:

 scripts/test_mirai.sh
scripts/test_vmra_mar.sh
scripts/test_oa_breacr.sh
scripts/test_imgfeatalign.sh
scripts/test_lmv_net.sh

Citation

If you use these implementations in your research, please cite the original papers for the models and this repository.

Repository

@software{Thrun_BCRBench_2026,
author = {Thrun, Solveig and Wetzer, Elisabeth and Wickstrøm, Kristoffer and Jenssen, Robert and Kampffmeyer, Michael},
license = {MIT},
month = may,
title = {{BCRBench}},
url = {https://github.com/sot176/BCRBench},
version = {v1.0.0},
year = {2026}
doi={10.5281/zenodo.20691090}
}

Model Papers

  • LMV-Net:
@inproceedings{lmv_net_2026,
author = {Thrun, Solveig and Sun, Zijun and Salahuddin, Suaiba A. and Wickstrøm, Kristoffer and Wetzer, Elisabeth and Hansen, Stine, and Jenssen, Robert and Kampffmeyer, Michael},
title={Longitudinal Multi-View Modeling for Breast Cancer Risk Prediction},
booktitle = {Medical Image Computing and Computer Assisted Intervention -- MICCAI 2026},
year={2026}
url={https://arxiv.org/abs/2607.11343}
}
  • ImgFeatAlign:
@inproceedings{imgfeatalign_2025,
author = {Thrun, Solveig and Hansen, Stine and Sun, Zijun and Blum, Nele and Salahuddin, Suaiba A. and Wickstrøm, Kristoffer and Wetzer, Elisabeth and Jenssen, Robert and Stille, Maik and Kampffmeyer, Michael},
title = {Reconsidering Explicit Longitudinal Mammography Alignment for Enhanced Breast Cancer Risk Prediction},
booktitle = {Medical Image Computing and Computer Assisted Intervention -- MICCAI 2025},
year = {2025},
doi = {10.1007/978-3-032-04937-7_47}
}
  • VMRA-MaR:
@inproceedings{vmra_mar_2025,
author = {Sun, Zijun and Thrun, Solveig and Kampffmeyer, Michael},
title = {VMRA-MaR: An Asymmetry-Aware Temporal Framework for Longitudinal Breast Cancer Risk Prediction},
booktitle = {proceedings of Medical Image Computing and Computer Assisted Intervention -- MICCAI 2025},
year = {2025},
doi = {https://doi.org/10.1007/978-3-032-05182-0_64}
  • OA-BReaCR:
@inproceedings{oa_breacr_2024,
author = {Wang, Xin and Tan, Tao and Gao, Yuan and Marcus, Eric and Han, Luyi and Portaluri, Antonio and Zhang, Tianyu and Lu, Chunyao and Liang, Xinglong and Beets-Tan, Regina and Teuwen, Jonas and Mann, Ritse},
title = {Ordinal Learning: Longitudinal Attention Alignment Model for Predicting Time to Future Breast Cancer Events from Mammograms},
booktitle={Medical Image Computing and Computer Assisted Intervention -- MICCAI 2024}, year = {2024},
doi = {https://doi.org/10.1007/978-3-031-72378-0_15}
}
  • Mirai
@article{mirai_2021,
author = {Adam Yala and Peter G. Mikhael and Fredrik Strand and Gigin Lin and Kevin Smith and Yung-Liang Wan and Leslie Lamb and Kevin Hughes and Constance Lehman and Regina Barzilay },
title = {Toward robust mammography-based models for breast cancer risk},
journal = {Science Translational Medicine},
year={2021},
volume={9},
doi={doi.org/10.1126/scitranslmed.aba4373}
}

License

This repository is released under the MIT License.

About

A unified framework for benchmarking deep learning models for breast cancer risk prediction across multi-view and longitudinal data.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages