AnonRes commited on
Commit
d14eed8
·
verified ·
1 Parent(s): dfbb889

Include README.md and add citation infos for architectures, methods, dataset and framework into the checkpoint

Browse files
Files changed (3) hide show
  1. README.md +52 -3
  2. adaptation_plan.json +30 -0
  3. checkpoint_final.pth +2 -2
README.md CHANGED
@@ -1,3 +1,52 @@
1
- ---
2
- license: cc-by-4.0
3
- ---
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ license: cc-by-4.0
3
+ datasets:
4
+ - AnonRes/OpenMind
5
+ pipeline_tag: image-feature-extraction
6
+ tags:
7
+ - medical
8
+ ---
9
+
10
+ # OpenMind Benchmark 3D SSL Models
11
+
12
+ > **Model from the paper**: [An OpenMind for 3D medical vision self-supervised learning](https://arxiv.org/abs/2412.17041)
13
+ > **Pre-training codebase used to create checkpoint**: [MIC-DKFZ/nnssl](https://github.com/MIC-DKFZ/nnssl)
14
+ > **Dataset**: [AnonRes/OpenMind](https://huggingface.co/datasets/AnonRes/OpenMind)
15
+ > **Downstream (segmentation) fine-tuning**: [TaWald/nnUNet](https://github.com/TaWald/nnUNet)
16
+
17
+ ---
18
+
19
+ ![OpenMind](https://huggingface.co/datasets/AnonRes/OpenMind/resolve/main/assets/OpenMindDataset.png)
20
+
21
+ ## 🔍 Overview
22
+
23
+ This repository hosts pre-trained checkpoints from the **OpenMind** benchmark:
24
+ 📄 **"An OpenMind for 3D medical vision self-supervised learning"**
25
+ ([arXiv:2412.17041](https://arxiv.org/abs/2412.17041)) — the first extensive benchmark study for **self-supervised learning (SSL)** on **3D medical imaging** data.
26
+
27
+ The models were pre-trained using various SSL methods on the [OpenMind Dataset](https://huggingface.co/datasets/AnonRes/OpenMind), a large-scale, standardized collection of public brain MRI datasets.
28
+
29
+ **These models are not recommended to be used as-is.** Instead we recommend using the downstream fine-tuning pipelines for **segmentation** and **classification**, available in the [adaptation repository](https://github.com/TaWald/nnUNet).
30
+ *While direct download is possible, we recommend using the auto-download of the respective fine-tuning repositories.*
31
+
32
+ ---
33
+
34
+ ## 🧠 Model Variants
35
+
36
+ We release SSL checkpoints for two backbone architectures:
37
+
38
+ - **ResEnc-L**: A CNN-based encoder [[link1](https://arxiv.org/abs/2410.23132), [link2](https://arxiv.org/abs/2404.09556)]
39
+ - **Primus-M**: A transformer-based encoder [[Primus paper](https://arxiv.org/abs/2503.01835)]
40
+
41
+ Each encoder has been pre-trained using the following SSL techniques:
42
+
43
+ | Method | Description |
44
+ |---------------|-------------|
45
+ | [Volume Contrastive (VoCo)](https://arxiv.org/abs/2402.17300) | Global contrastive learning in 3D volumes |
46
+ | [VolumeFusion (VF)](https://arxiv.org/abs/2306.16925) | Spatial fusion-based SSL |
47
+ | [Models Genesis (MG)](https://www.sciencedirect.com/science/article/pii/S1361841520302048) | Classic 3D self-reconstruction |
48
+ | [Masked Autoencoders (MAE)](https://openaccess.thecvf.com/content/CVPR2022/html/He_Masked_Autoencoders_Are_Scalable_Vision_Learners_CVPR_2022_paper) | Patch masking and reconstruction |
49
+ | [Spark 3D (S3D)](https://arxiv.org/abs/2410.23132) | 3D adaptation of Spark framework |
50
+ | [SimMIM](https://openaccess.thecvf.com/content/CVPR2022/html/Xie_SimMIM_A_Simple_Framework_for_Masked_Image_Modeling_CVPR_2022_paper.html) | Simple masked reconstruction |
51
+ | [SwinUNETR SSL](https://arxiv.org/abs/2111.14791) | Transformer-based pre-training |
52
+ | [SimCLR](https://arxiv.org/abs/2002.05709) | Contrastive learning baseline |
adaptation_plan.json CHANGED
@@ -74,5 +74,35 @@
74
  "down_projection.proj"
75
  ],
76
  "key_to_lpe": "eva.pos_embed",
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
77
  "trainer_name": "SimMIMEvaTrainer_BS8"
78
  }
 
74
  "down_projection.proj"
75
  ],
76
  "key_to_lpe": "eva.pos_embed",
77
+ "citations": [
78
+ {
79
+ "type": "Architecture",
80
+ "name": "PrimusM",
81
+ "bibtex_citations": [
82
+ "@article{wald2025primus,\n title={Primus: Enforcing attention usage for 3d medical image segmentation},\n author={Wald, Tassilo and Roy, Saikat and Isensee, Fabian and Ulrich, Constantin and Ziegler, Sebastian and Trofimova, Dasha and Stock, Raphael and Baumgartner, Michael and K{\"o}hler, Gregor and Maier-Hein, Klaus},\n journal={arXiv preprint arXiv:2503.01835},\n year={2025}\n }"
83
+ ]
84
+ },
85
+ {
86
+ "type": "Pretraining Method",
87
+ "name": "Masked Image Modeling",
88
+ "bibtex_citations": [
89
+ "@inproceedings{xie2022simmim,\n title={Simmim: A simple framework for masked image modeling},\n author={Xie, Zhenda and Zhang, Zheng and Cao, Yue and Lin, Yutong and Bao, Jianmin and Yao, Zhuliang and Dai, Qi and Hu, Han},\n booktitle={Proceedings of the IEEE/CVF conference on computer vision and pattern recognition},\n pages={9653--9663},\n year={2022}\n}"
90
+ ]
91
+ },
92
+ {
93
+ "type": "Pre-Training Dataset",
94
+ "name": "OpenMind",
95
+ "bibtex_citations": [
96
+ "@article{wald2024openmind,\n title={An OpenMind for 3D medical vision self-supervised learning},\n author={Wald, Tassilo and Ulrich, Constantin and Suprijadi, Jonathan and Ziegler, Sebastian and Nohel, Michal and Peretzke, Robin and K{\"o}hler, Gregor and Maier-Hein, Klaus H},\n journal={arXiv preprint arXiv:2412.17041},\n year={2024}\n }\n "
97
+ ]
98
+ },
99
+ {
100
+ "type": "Framework",
101
+ "name": "nnssl",
102
+ "bibtex_citations": [
103
+ "@article{wald2024revisiting,\n title={Revisiting MAE pre-training for 3D medical image segmentation},\n author={Wald, Tassilo and Ulrich, Constantin and Lukyanenko, Stanislav and Goncharov, Andrei and Paderno, Alberto and Maerkisch, Leander and J{\"a}ger, Paul F and Maier-Hein, Klaus},\n journal={arXiv preprint arXiv:2410.23132},\n year={2024}\n}"
104
+ ]
105
+ }
106
+ ],
107
  "trainer_name": "SimMIMEvaTrainer_BS8"
108
  }
checkpoint_final.pth CHANGED
@@ -1,3 +1,3 @@
1
  version https://git-lfs.github.com/spec/v1
2
- oid sha256:818e4c17be8b2566f12d6234a6442bbf7365c154d92a66fd396c443fe60c9a5c
3
- size 688956438
 
1
  version https://git-lfs.github.com/spec/v1
2
+ oid sha256:81e173ce07b02eef3ebfa3db7f9571eede89552a63678766c21e4c0624cd09b0
3
+ size 688958486