wisdomik commited on
Commit
d173fa8
1 Parent(s): 4e7fc6f

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +92 -1
README.md CHANGED
@@ -2,7 +2,98 @@
2
  tags:
3
  - zero-shot-image-classification
4
  - clip
 
 
 
 
 
5
  library_tag: open_clip
6
  license: mit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
7
  ---
8
- # Model card for QuiltNet-B-16-PMB
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
2
  tags:
3
  - zero-shot-image-classification
4
  - clip
5
+ - vision
6
+ - language
7
+ - histopathology
8
+ - histology
9
+ - medical
10
  library_tag: open_clip
11
  license: mit
12
+ widget:
13
+ - src: >-
14
+ https://quilt1m.github.io/img/BREST092.jpg
15
+ candidate_labels: adipose tissue, debris tissue, lymphocytes tissue, mucus tissue, smooth muscle tissue, normal colon mucosa tissue, cancer-associated stroma tissue, colorectal adenocarcinoma epithelium tissue
16
+ example_title: Tissue phenotyping
17
+ - src: >-
18
+ https://huggingface.co/microsoft/BiomedCLIP-PubMedBERT_256-vit_base_patch16_224/resolve/main/example_data/biomed_image_classification_example_data/squamous_cell_carcinoma_histopathology.jpeg
19
+ candidate_labels: adenocarcinoma histopathology, squamous cell carcinoma histopathology
20
+ example_title: squamous cell carcinoma histopathology
21
+ - src: >-
22
+ https://huggingface.co/microsoft/BiomedCLIP-PubMedBERT_256-vit_base_patch16_224/resolve/main/example_data/biomed_image_classification_example_data/adenocarcinoma_histopathology.jpg
23
+ candidate_labels: adenocarcinoma histopathology, squamous cell carcinoma histopathology
24
+ example_title: adenocarcinoma histopathology
25
+ pipeline_tag: zero-shot-image-classification
26
  ---
27
+
28
+
29
+ ## QuiltNet-B-16-PMB Description
30
+ QuiltNet-B-32/PMB is a ViT-B/16 image tower and PubMedBERT text tower vision-language foundation model trained on the [Quilt-1M](https://quilt1m.github.io/) dataset curated from representative histopathology videos.
31
+ It can perform various vision-language processing (VLP) tasks such as cross-modal retrieval, image classification, and visual question answering.
32
+ QuiltNet establishes new state of the art in a wide range of standard datasets, and substantially outperforms prior VLP approaches:
33
+
34
+ ![](barchart_zeroshot.png)
35
+
36
+
37
+ # Citation
38
+ ```bibtex
39
+ @inproceedings{ikezogwo2023quilt,
40
+ title={Quilt-1M: One Million Image-Text Pairs for Histopathology},
41
+ author={Wisdom O. Ikezogwo, Mehmet S. Seyfioglu, Fatemeh Ghezloo, Dylan Geva , Fatwir S. Mohammed, Pavan K. Anand, Ranjay Krishna, Linda G. Shapiro.},
42
+ year={2023},
43
+ journal={arXiv***},
44
+ }
45
+ ```
46
+
47
+
48
+ # Uses
49
+
50
+ As per the original [OpenAI CLIP model card](https://github.com/openai/CLIP/blob/d50d76daa670286dd6cacf3bcd80b5e4823fc8e1/model-card.md), this model is intended as a research output for research communities. We hope that this model will enable researchers to better understand and explore zero-shot, arbitrary image classification. We also hope it can be used for interdisciplinary studies of the potential impact of such model.
51
+
52
+ The OpenAI CLIP paper includes a discussion of potential downstream impacts to provide an example for this sort of analysis.
53
+
54
+ ## Direct Use
55
+
56
+ Zero-shot image classification, image and text retrieval, among others.
57
+
58
+ ## Downstream Use
59
+
60
+ Image classification and other image task fine-tuning, linear probe image classification, image generation guiding and conditioning, among others.
61
+
62
+ ### Intended Use
63
+
64
+ The model is intended as a research output for research communities. We hope that this model will enable researchers to better understand and explore zero-shot, arbitrary image classification. We also hope it can be used for interdisciplinary studies of the potential impact of such models.
65
+
66
+ #### Primary intended uses
67
+
68
+ The primary intended users of these models are AI researchers.
69
+
70
+ We primarily imagine the model will be used by researchers to better understand robustness, generalization, and other capabilities, biases, and constraints of computer vision histopathology models.
71
+
72
+ ### Out-of-Scope Use Cases
73
+
74
+ **Any** deployed use case of the model - whether commercial or not - is currently out of scope. Non-deployed use cases such as image search in a constrained environment, are also not recommended unless there is thorough in-domain testing of the model with a specific, fixed class taxonomy.
75
+
76
+ Since the model has not been purposefully trained in or evaluated on any languages other than English, its use should be limited to English language use cases.
77
+
78
+ Further the above notice, the Quilt-1M dataset used in training of these models has additional considerations, see below.
79
+
80
+ ## Training Data
81
+
82
+ This model was trained with [QUILT-1M](https://quilt1m.github.io/) is an image-text dataset for histopathology.
83
+ Curated from educational videos on Youtube QUILT-1M contributes the largest dataset for vision language modeling in histopathology.
84
+
85
+ **IMPORTANT NOTE:** The motivation behind dataset creation is to democratize research and experimentation around large-scale multi-modal model training and handling of uncurated, large-scale histopathology datasets crawled from publically available internet. Our recommendation is therefore to use the dataset for research purposes.
86
+
87
+ # Evaluation
88
+
89
+ Evaluation done with code in the [CLIP Benchmark suite](https://github.com/LAION-AI/CLIP_benchmark) and results can be found in the paper on a list of varying histology tasks and datasets.
90
+
91
+
92
+ # Disclaimer
93
+ It is important to note that the results obtained from this function are not intended to constitute medical advice or replace consultation with a qualified medical professional. The use of this function is solely at your own risk and should be consistent with applicable laws, regulations, and ethical considerations. We do not warrant or guarantee the accuracy, completeness, suitability, or usefulness of this function for any particular purpose, and we hereby disclaim any liability arising from any reliance placed on this function or any results obtained from its use.
94
+
95
+ # Privacy
96
+ In accordance with the privacy policy of Youtube, only Video IDs data is redistributed by us.
97
+ It is strictly prohibited to redistribute any content apart from the Video IDs.
98
+ Any distribution carried out must adhere to the laws and regulations applicable in your jurisdiction, including export control laws and embargoes.'
99
+