wisdomik commited on
Commit
fffebfd
1 Parent(s): 42d3269

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +84 -1
README.md CHANGED
@@ -2,7 +2,90 @@
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
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
2
  tags:
3
  - zero-shot-image-classification
4
  - clip
5
+ - histopathology
6
+ - pathology
7
+ - histology
8
+ - vision
9
+ - language
10
  library_tag: open_clip
11
  license: mit
12
+ widget:
13
+ - src: https://webpath.med.utah.edu/jpeg3/BREST092.jpg
14
+ 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
15
+ example_title: Tissue phenotyping
16
  ---
17
+
18
+
19
+ # Model card for QuiltNet-B-32
20
+
21
+ ## Model Description
22
+
23
+ A CLIP ViT-B/16 model trained with the Quilt-1M dataset (https://quilt1m.github.io/) using OpenCLIP (https://github.com/mlfoundations/open_clip).
24
+
25
+ # Uses
26
+
27
+ 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.
28
+
29
+ The OpenAI CLIP paper includes a discussion of potential downstream impacts to provide an example for this sort of analysis.
30
+
31
+ ## Direct Use
32
+
33
+ Zero-shot image classification, image and text retrieval, among others.
34
+
35
+ ## Downstream Use
36
+
37
+ Image classification and other image task fine-tuning, linear probe image classification, image generation guiding and conditioning, among others.
38
+
39
+ ### Intended Use
40
+
41
+ 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.
42
+
43
+ #### Primary intended uses
44
+
45
+ The primary intended users of these models are AI researchers.
46
+
47
+ 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.
48
+
49
+ ### Out-of-Scope Use Cases
50
+
51
+ **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.
52
+
53
+ 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.
54
+
55
+ Further the above notice, the Quilt-1M dataset used in training of these models has additional considerations, see below.
56
+
57
+ ## Training Data
58
+
59
+ This model was trained with [QUILT-1M](https://quilt1m.github.io/) is an image-text dataset for histopathology.
60
+ Curated from educational videos on Youtube QUILT-1M contributes the largest dataset for vision language modeling in histopathology.
61
+
62
+ **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.
63
+
64
+ # Evaluation
65
+
66
+ 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.
67
+
68
+
69
+ # Disclaimer
70
+ 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.
71
+
72
+ # Privacy
73
+ In accordance with the privacy policy of Youtube, only Video IDs data is redistributed by us.
74
+ It is strictly prohibited to redistribute any content apart from the Video IDs.
75
+ Any distribution carried out must adhere to the laws and regulations applicable in your jurisdiction, including export control laws and embargoes.'
76
+
77
+
78
+
79
+ # Citation
80
+
81
+ **BibTeX:**
82
+
83
+ Quilt-1M
84
+ ```bibtex
85
+ @inproceedings{ikezogwo2023quilt,
86
+ title={Quilt-1M: One Million Image-Text Pairs for Histopathology},
87
+ author={Wisdom O. Ikezogwo, Mehmet S. Seyfioglu, Fatemeh Ghezloo, Dylan Geva , Fatwir S. Mohammed, Pavan K. Anand, Ranjay Krishna, Linda G. Shapiro.},
88
+ year={2023},
89
+ journal={arXiv***},
90
+ }
91
+ ```