-
Notifications
You must be signed in to change notification settings - Fork 136
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
c848d29
commit d54781b
Showing
4 changed files
with
144 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,4 @@ | ||
extra_config: model.yaml | ||
spec: spec.yaml | ||
type: model | ||
categories: ["Foundation Models"] |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,98 @@ | ||
PRISM is a multi-modal generative foundation model for slide-level analysis of H&E-stained histopathology images. Utilizing Virchow tile embeddings and clinical report texts for pre-training, PRISM combines these embeddings into a single slide embedding and generates a text-based diagnostic report. These can be used for tasks such as cancer detection, sub-typing, and biomarker identification. The model's slide encoder can be fine-tuned for specific classification tasks, leveraging both image and text data to enhance diagnostic performance and robustness. | ||
|
||
PRISM supports several modes of use: | ||
|
||
text report generation to describe tissue in H&E whole slide images | ||
zero-shot cancer detection and sub-typing using text prompts | ||
adaptation to new tasks via PRISM finetuning, or linear classifier on the slide embedding | ||
|
||
## Model Details | ||
|
||
**Developed by:** Paige, NYC, USA and Microsoft Research, Cambridge, MA USA | ||
**Model Type:** Vision-Language Encoder-Decoder | ||
**Model Stats:** | ||
Params (M): 558 | ||
**Architecture:** | ||
Encoder: Perceiver (https://doi.org/10.48550/arXiv.2103.03206) | ||
Decoder: BioGPT (https://huggingface.co/microsoft/biogpt) | ||
Model inputs: tile image embeddings and text captions | ||
Tile image encoder: Virchow V1 (https://huggingface.co/paige-ai/Virchow) | ||
**Training Details:** | ||
Objective: CoCa (https://doi.org/10.48550/arXiv.2205.01917) | ||
Precision: Mixed precision (fp16) | ||
**Paper:** | ||
PRISM: A Multi-Modal Generative Foundation Model for Slide-Level Histopathology: https://arxiv.org/abs/2405.10254 | ||
**Pretraining Dataset:** Internal dataset of 587 thousand whole slide images and 195 thousand clinical reports from Memorial Sloan Kettering Cancer Center. | ||
**License:** CC-BY-NC-ND-4.0 | ||
|
||
## Model Usage | ||
|
||
**Direct use** | ||
PRISM is a vision-language model that can analyze whole slide images using the following methods: | ||
|
||
CLIP-style zero-shot classification via zero_shot method, or | ||
generate a tissue description in the image via generate method. | ||
The model takes whole slide images in the form of tile embeddings from our Virchow model. Please see https://huggingface.co/paige-ai/Virchow for instructions on how to use it to generate embeddings for your whole slide image. | ||
|
||
**Downstream use** | ||
You can use PRISM to compute slide embedding for downstream tasks such as slide-level classification. The slide embedding can be further adapted to new tasks by finetuning the slide encoder of PRISM on slide-level labels, e.g. biomarkers. | ||
|
||
Slide embeddings are accessible via slide_representations method. | ||
|
||
**Terms of use** | ||
|
||
This model and associated code are released under the CC-BY-NC-ND 4.0 license and may only be used for non-commercial, academic research purposes with proper attribution. Any commercial use, sale, or other monetization of the PRISM Model and its derivatives, which include models trained on outputs from the PRISM Model or datasets created from the PRISM Model, is prohibited and requires prior approval. Please note that the primary email used to sign up for your Hugging Face account must match your institutional email to receive approval. By downloading the PRISM Model, you attest that all information (affiliation, research use) is correct and up-to-date. Downloading the PRISM Model requires prior registration on Hugging Face and agreeing to the terms of use. By downloading the PRISM model, you agree not to distribute, publish or reproduce a copy of the PRISM Model. If another user within your organization wishes to use the PRISM Model, they must register as an individual user and agree to comply with the terms of use. If you are a commercial entity, please contact the corresponding author. | ||
|
||
Further, by downloading the PRISM model, you agree you will only use the PRISM model for academic research purposes and will not use, or allow others to use, the PRISM model to: | ||
|
||
Diagnose, cure, mitigate, treat, or prevent disease or any other conditions, including for Investigational Use Only (“IUO”), Research Use Only (“RUO”), commercial, clinical or other similar use, and including as a substitute for professional medical advice, a healthcare opinion, a diagnosis, treatment, or the clinical judgment of a healthcare professional, as no license or right is granted for any such purposes. | ||
|
||
Re-identify the deidentified data used to develop the PRISM Model; | ||
|
||
Violate the law or others’ rights, including to: | ||
|
||
a. Engage in, promote, generate, contribute to, encourage, plan, incite, or further illegal or unlawful activity or content; | ||
|
||
b. Engage in, promote, incite, or facilitate the harassment, abuse, threatening, or bullying of individuals or groups of individuals; | ||
|
||
c. Engage in, promote, incite, or facilitate discrimination or other unlawful or harmful conduct in the provision of employment, employment benefits, credit, housing, other economic benefits, or other essential goods and services; | ||
|
||
d. Engage in the unauthorized or unlicensed practice of any profession including, but not limited to, financial, legal, medical/health, or related professional practices; | ||
|
||
e. Collect, process, disclose, generate, or infer the identity of individuals or the health, demographic, or other sensitive personal or private information about individuals without rights and consents required by applicable laws; | ||
|
||
f. Engage in or facilitate any action or generate any content that infringes, misappropriates, or otherwise violates any third-party rights, including the outputs or results of any products or services using the PRISM Model or any related materials; and | ||
|
||
g. Create, generate, or facilitate the creation of malicious code, malware, computer viruses or do anything else that could disable, overburden, interfere with or impair the proper working, integrity, operation or appearance of a website or computer system. | ||
|
||
Engage in, promote, incite, facilitate, or assist in the planning or development of activities that present a risk of death or bodily harm to individuals, including the use of the PRISM Model as a medical device, clinical support, diagnostic tool, or other technology intended to be used in the diagnosis, cure, mitigation, treatment, or prevention of disease or other conditions, including for Investigational Use Only (“IUO”), Research Use Only (“RUO”), commercial, clinical or similar use; and | ||
|
||
Intentionally deceive or mislead others, including representing that the use of the PRISM Model or its outputs is human-generated. | ||
|
||
Further, you agree that you will appropriately disclose to end users any known dangers of your AI system. | ||
|
||
**Citation** | ||
|
||
Please cite the following work if you use this model in your research. | ||
|
||
Shaikovski, George, Adam Casson, Kristen Severson, Eric Zimmermann et al. "PRISM: A Multi-Modal Generative Foundation Model for Slide-Level Histopathology." arXiv preprint arXiv:2405.10254 (2024). https://doi.org/10.48550/arXiv.2405.10254 | ||
|
||
``` | ||
@article{shaikovski2024prism, | ||
title={PRISM: A Multi-Modal Generative Foundation Model for Slide-Level Histopathology}, | ||
author={Shaikovski, George and Casson, Adam and Severson, Kristen and Zimmermann, Eric and Wang, Yi Kan and Kunz, Jeremy D and Retamero, Juan A and Oakley, Gerard and Klimstra, David and Kanan, Christopher and others}, | ||
journal={arXiv preprint arXiv:2405.10254}, | ||
year={2024} | ||
} | ||
``` | ||
**Disclaimer** | ||
|
||
PRISM has been developed for research purposes and is not intended for diagnosis of real patients or projection/prediction of future disease possibilities. | ||
|
||
Fairness evaluation cannot be completed due to limitations in the metadata. Underlying biases of the training datasets may not be well characterized and may not be representative of all demographics. | ||
|
||
**Acknowledgements** | ||
The results shown here (specifically, in the section "Sample inference code") are in whole or part based upon data generated by the TCGA Research Network: http://cancergenome.nih.gov/. | ||
|
||
## Sample Input and Output (for real-time inference) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,8 @@ | ||
path: | ||
container_name: models | ||
container_path: huggingface/Prism/mlflow_model_folder | ||
storage_name: automlcesdkdataresources | ||
type: azureblob | ||
publish: | ||
description: description.md | ||
type: mlflow_model |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,34 @@ | ||
$schema: https://azuremlschemas.azureedge.net/latest/model.schema.json | ||
|
||
name: Prism | ||
path: ./ | ||
|
||
properties: | ||
inference-min-sku-spec: 6|1|112|64 | ||
inference-recommended-sku: Standard_NC6s_v3, Standard_NC12s_v3, Standard_NC24s_v3, Standard_NC24ads_A100_v4, Standard_NC48ads_A100_v4, Standard_NC96ads_A100_v4, Standard_ND96asr_v4, Standard_ND96amsr_A100_v4, Standard_ND40rs_v2 | ||
languages: en | ||
SharedComputeCapacityEnabled: true | ||
|
||
tags: | ||
task: zero-shot-image-classification | ||
industry: health-and-life-sciences | ||
Preview: "" | ||
inference_supported_envs: | ||
- hf | ||
license: cc-by-nc-nd-4.0 | ||
author: Paige | ||
hiddenlayerscanned: "" | ||
SharedComputeCapacityEnabled: "" | ||
inference_compute_allow_list: | ||
[ | ||
Standard_NC6s_v3, | ||
Standard_NC12s_v3, | ||
Standard_NC24s_v3, | ||
Standard_NC24ads_A100_v4, | ||
Standard_NC48ads_A100_v4, | ||
Standard_NC96ads_A100_v4, | ||
Standard_ND96asr_v4, | ||
Standard_ND96amsr_A100_v4, | ||
Standard_ND40rs_v2, | ||
] | ||
version: 1 |