Update README.md
Browse files
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 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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 |
+
|