README.md

---
license: unknown
---
# LLaVA-Med model for multimodal radiology report generation

This is a model based on LLaVA-Med 1.0, finetuned to generate medical reports, based on a chest X-ray and a prompt, 
in our case, the instruction was "write the finding section of a chest x-ray radiology report".

The dataset used for finetuning was the MIMIC-CXR  share for the challenge in Radiology Report Generation 
for the Association for Computational Linguistics 2024 at BioNLP Workshop 

We used the 148,374 findings of MIMIC-CXR for finetuning during 3 epochs. 

The model metrics on the 1,063 samples of the hidden test set of the ACL challenge are the following:

| Method      | BLEU-4 | Rouge-L | Bertscore | F1-CheXbert | F1-RadGraph | Avg   |
|-------------|--------|---------|-----------|-------------|-------------|-------|
| llavamed1.0 |  5.05  |  19.13  |   47.51   |    23.06    |    15.77    | 22.10 |


The metrics were calculated directly by the challenge organizer, however you can reproduce them with the following 
example code:

```python
import json
import logging
from vilmedic.blocks.scorers.scores import compute_scores

refs = [
    "The lungs are clear. The cardiomediastinal silhouette is within normal limits. No acute osseous abnormalities.",
    "The lungs are clear.There is no pleural effusion or pneumothorax.The cardiomediastinal silhouette is normal."
]
hyps = [
    "The lungs are clear. There is no pleural effusion or pneumothorax. The cardiomediastinal silhouette is normal.",
    "The lungs are clear. The cardiomediastinal silhouette is within normal limits. No acute osseous abnormalities."
]
print("Computing metrics, this can take a while...")
print(json.dumps(compute_scores(["ROUGEL", "bertscore", "radgraph", "BLEU", "chexbert"],
                                refs=refs,
                                hyps=hyps,
                                split=None,
                                seed=None,
                                config=None,
                                epoch=None,
                                logger=logging.getLogger(__name__),
                                dump=False),
                 indent=4)
      )
```


More details of the challenge can be found on the [challenge web page](https://stanford-aimi.github.io/RRG24/)
or in [workshop site](https://aclweb.org/aclwiki/BioNLP_Workshop) 


# Citation

If you use our model for your research and applications, please cite using the following BibTex:

```
@inproceedings{campanini-etal-2024-ihealth,
    title = "i{H}ealth-{C}hile-1 at {RRG}24: In-context Learning and Finetuning of a Large Multimodal Model for Radiology Report Generation",
    author = "Campanini, Diego  and
      Loch, Oscar  and
      Messina, Pablo  and
      Elberg, Rafael  and
      Parra, Denis",
    editor = "Demner-Fushman, Dina  and
      Ananiadou, Sophia  and
      Miwa, Makoto  and
      Roberts, Kirk  and
      Tsujii, Junichi",
    booktitle = "Proceedings of the 23rd Workshop on Biomedical Natural Language Processing",
    month = aug,
    year = "2024",
    address = "Bangkok, Thailand",
    publisher = "Association for Computational Linguistics",
    url = "https://aclanthology.org/2024.bionlp-1.52",
    doi = "10.18653/v1/2024.bionlp-1.52",
    pages = "608--613"
}

@inproceedings{loch-etal-2024-ihealth,
    title = "i{H}ealth-{C}hile-3{\&}2 at {RRG}24: Template Based Report Generation",
    author = "Loch, Oscar  and
      Messina, Pablo  and
      Elberg, Rafael  and
      Campanini, Diego  and
      Soto, {\'A}lvaro  and
      Vidal, Ren{\'e}  and
      Parra, Denis",
    editor = "Demner-Fushman, Dina  and
      Ananiadou, Sophia  and
      Miwa, Makoto  and
      Roberts, Kirk  and
      Tsujii, Junichi",
    booktitle = "Proceedings of the 23rd Workshop on Biomedical Natural Language Processing",
    month = aug,
    year = "2024",
    address = "Bangkok, Thailand",
    publisher = "Association for Computational Linguistics",
    url = "https://aclanthology.org/2024.bionlp-1.53",
    doi = "10.18653/v1/2024.bionlp-1.53",
    pages = "614--623"
}
```