declare-lab/MM-InstructEval

This repository contains code to evaluate various multimodal large language models using different instructions across multiple multimodal content comprehension tasks.

32

stars

55

commits

Python

primary language

Mar 9, 2025

updated

multimodal-content-comprehension-tasks
multimodal-large-language-models

README

MM-InstructEval: Zero-Shot Evaluation of (Multimodal) Large Language Models on Multimodal Reasoning Tasks

Paper | Data | Leaderboard

Why?

The popularity of multimodal large language models (MLLMs) has triggered a recent surge in research efforts dedicated to evaluating these models. Nevertheless, existing evaluation studies of MLLMs, such as MME, SEED-Bench, LVLM-eHub, and MM-Vet, primarily focus on the comprehension and reasoning of unimodal (vision) content, neglecting performance evaluations in the domain of multimodal (vision-language) content understanding. Beyond multimodal reasoning, tasks related to multimodal content comprehension necessitate a profound understanding of multimodal contexts, achieved through the multimodal interaction to obtain a final answer.

In this project, we introduce a comprehensive assessment framework called MM-BigBench, which incorporates a diverse range of metrics to offer an extensive evaluation of the performance of various models and instructions across a wide spectrum of diverse multimodal content comprehension tasks, including Multimodal Sentiment Analysis (MSA), Multimodal Aspect-Based Sentiment Analysis (MABSA), Multimodal Hateful Memes Recognition (MHMR), Multimodal Sarcasm Recognition (MSR), Multimodal Relation Extraction (MRE), and the Visual Question Answering (VQA) with text context. Consequently, our work complements research on the performance of MLLMs in multimodal comprehension tasks, achieving a more comprehensive and holistic evaluation of MLLMs.

MM-BigBench, with a range of diverse metrics to provide a thorough evaluation of different models and instructions, including the Best Performance metric, the Mean Relative Gain metric, the Stability metric, and the Adaptability metric.

Evaluated Models (14 MLLMs)

Model NameModalityModel/CodePaperPLMPVMToTal-ParasTraining-Paras
ChatGPTTextChatGPTPapergpt-3.5-turb---
LLaMA1-7BTextLLaMA-1PaperLLaMA-V1-7B-6.74B6.74B
LLaMA1-13BTextLLaMA-1PaperLLaMA-V1-13B_13.02B13.02B
LLaMA2-7BTextLLaMA-2 and llama-recipesPaperLLaMA-V2-7B-6.74B6.74B
LLaMA2-13BTextLLaMA-2 and llama-recipesPaperLLaMA-V2-13B_13.02B13.02B
Flan-T5-XXLTextFlan-T5-XXLPaperFlan-T5-XXL-11.14B11.14B
OpenFlamingoMultimodalOpenFlamingoPaperLLaMA-7BViT-L/148.34B1.31B
FromageMultimodalFromagePaperOPT-6.7BViT-L/146.97B0.21B
LLaVA-7BMultimodalLLaVA-7BPaperLLaMA-7BViT-L/146.74B6.74B
LLaVA-13BMultimodalLLaVA-7BPaperLLaMA-13BViT-L/1413.02B13.02B
MiniGPT4MultimodalMiniGPT4PaperVicuna-13BViT-g/1414.11B0.04B
mPLUG-OwlMultimodalmPLUG-OwlPaperLLaMA-7BViT-L/147.12B7.12B
LLaMA-Adapter V2MultimodalLLaMA-Adapter V2PaperLLaMA-7BViT-L/147.23B7.23B
VPGTransMultimodalVPGTransPaperVicuna-7B-7.83B0.11B
Multimodal-GPTMultimodalMultimodal-GPTPaperLLaMA-7BViT-L-148.37B0.02B
LaVIN-7BMultimodalLaVIN-7BPaperLLaMA-7BViT-L/147.17B7.17B
LaVIN-13BMultimodalLaVIN-13BPaperLLaMA-13BViT-L/1413.36B13.36B
LynxMultimodalLynxPaperVicuna-7BEva-ViT-1b8.41B0.69B
BLIP-2MultimodalBLIP-2PaperFlanT5-XXLViT-g/1412.23B0.11B
InstructBLIPMultimodalInstructBLIPPaperFlanT5-XXLViT-g/1412.31B0.45B

Note: Refer to Setting Models for more information.

Results

For detailed results, please go to our MM-BigBench leaderboard

Setup

Install dependencies and download data.

conda create -n mm-bigbench python=3.8 -y
conda activate mm-bigbench
pip install -r requirements.txt

Fast Start

Select evaluated dataset, model, prompt_type

  1. Select the evaluated task and dataset in the "*.sh" file;
  2. Select the model to be evaluated in the "*.sh" file;
  3. Select the prompt type, from "1" to "10" in the "*.sh" file;
  4. Run the corresponding "*.sh" file.

Running the inference of difffernt models

For ChatGPT, LLaMA-V1-7B, LLaMA-V1-13B, LLaMA-V2-7B, LLaMA-V2-13B, Text-FlanT5-XXL, BLIP-2, InstructBLIP, Fromage, OpenFlamingo, Multimodal-GPT, mPLUG-Owl, MiniGPT4, LLaMA-Adapterv2, VPGTrans, LLaVA-7B, LLaVA-13 models:

sh test_scripts/run_scripts.sh

## Change the "model_name" in the ".sh" file to corresponding to the 'chatgpt', 'decapoda-llama-7b-hf', 'decapoda-llamab-hf', 'meta-llama2-7b-hf', 'meta-llama2-13b-hf', 'text_flan-t5-xxl', 'blip2_t5', 'blip2_instruct_flant5xxl', 'fromage', 'openflamingo', 'mmgpt', 'mplug_owl', 'minigpt4', 'llama_adapterv2', 'vpgtrans', 'llava_7b', 'llava_13b'.


For LaVIN model:

sh test_scripts/run_LaVIN_zero_shot.sh

For Lynx model:

sh test_scripts/run_lynx_llm_zero_shot.sh

Eval the results to get the accuracy metric

sh test_scripts/eval_scripts.sh

Diverse Metrics

Metrics used in our paper can be found in Evaluation Metrics.

Citation

@inproceedings{Yang2023MMBigBenchEM,
  title={MM-BigBench: Evaluating Multimodal Models on Multimodal Content Comprehension Tasks},
  author={Xiaocui Yang and Wenfang Wu and Shi Feng and Ming Wang and Daling Wang and Yang Li and Qi Sun and Yifei Zhang and Xiaoming Fu and Soujanya Poria},
  year={2023},
  url={https://api.semanticscholar.org/CorpusID:264127863}
}

Contributors

YangXiaocui1215

52 commits

soujanyaporia

2 commits

Emrys-Hong

1 commits

declare-lab/MM-InstructEval

This repository contains code to evaluate various multimodal large language models using different instructions across multiple multimodal content comprehension tasks.

32

stars

55

commits

Python

primary language

Mar 9, 2025

updated

multimodal-content-comprehension-tasks
multimodal-large-language-models

README

MM-InstructEval: Zero-Shot Evaluation of (Multimodal) Large Language Models on Multimodal Reasoning Tasks

Paper | Data | Leaderboard

Why?

The popularity of multimodal large language models (MLLMs) has triggered a recent surge in research efforts dedicated to evaluating these models. Nevertheless, existing evaluation studies of MLLMs, such as MME, SEED-Bench, LVLM-eHub, and MM-Vet, primarily focus on the comprehension and reasoning of unimodal (vision) content, neglecting performance evaluations in the domain of multimodal (vision-language) content understanding. Beyond multimodal reasoning, tasks related to multimodal content comprehension necessitate a profound understanding of multimodal contexts, achieved through the multimodal interaction to obtain a final answer.

In this project, we introduce a comprehensive assessment framework called MM-BigBench, which incorporates a diverse range of metrics to offer an extensive evaluation of the performance of various models and instructions across a wide spectrum of diverse multimodal content comprehension tasks, including Multimodal Sentiment Analysis (MSA), Multimodal Aspect-Based Sentiment Analysis (MABSA), Multimodal Hateful Memes Recognition (MHMR), Multimodal Sarcasm Recognition (MSR), Multimodal Relation Extraction (MRE), and the Visual Question Answering (VQA) with text context. Consequently, our work complements research on the performance of MLLMs in multimodal comprehension tasks, achieving a more comprehensive and holistic evaluation of MLLMs.

MM-BigBench, with a range of diverse metrics to provide a thorough evaluation of different models and instructions, including the Best Performance metric, the Mean Relative Gain metric, the Stability metric, and the Adaptability metric.

Evaluated Models (14 MLLMs)

Model NameModalityModel/CodePaperPLMPVMToTal-ParasTraining-Paras
ChatGPTTextChatGPTPapergpt-3.5-turb---
LLaMA1-7BTextLLaMA-1PaperLLaMA-V1-7B-6.74B6.74B
LLaMA1-13BTextLLaMA-1PaperLLaMA-V1-13B_13.02B13.02B
LLaMA2-7BTextLLaMA-2 and llama-recipesPaperLLaMA-V2-7B-6.74B6.74B
LLaMA2-13BTextLLaMA-2 and llama-recipesPaperLLaMA-V2-13B_13.02B13.02B
Flan-T5-XXLTextFlan-T5-XXLPaperFlan-T5-XXL-11.14B11.14B
OpenFlamingoMultimodalOpenFlamingoPaperLLaMA-7BViT-L/148.34B1.31B
FromageMultimodalFromagePaperOPT-6.7BViT-L/146.97B0.21B
LLaVA-7BMultimodalLLaVA-7BPaperLLaMA-7BViT-L/146.74B6.74B
LLaVA-13BMultimodalLLaVA-7BPaperLLaMA-13BViT-L/1413.02B13.02B
MiniGPT4MultimodalMiniGPT4PaperVicuna-13BViT-g/1414.11B0.04B
mPLUG-OwlMultimodalmPLUG-OwlPaperLLaMA-7BViT-L/147.12B7.12B
LLaMA-Adapter V2MultimodalLLaMA-Adapter V2PaperLLaMA-7BViT-L/147.23B7.23B
VPGTransMultimodalVPGTransPaperVicuna-7B-7.83B0.11B
Multimodal-GPTMultimodalMultimodal-GPTPaperLLaMA-7BViT-L-148.37B0.02B
LaVIN-7BMultimodalLaVIN-7BPaperLLaMA-7BViT-L/147.17B7.17B
LaVIN-13BMultimodalLaVIN-13BPaperLLaMA-13BViT-L/1413.36B13.36B
LynxMultimodalLynxPaperVicuna-7BEva-ViT-1b8.41B0.69B
BLIP-2MultimodalBLIP-2PaperFlanT5-XXLViT-g/1412.23B0.11B
InstructBLIPMultimodalInstructBLIPPaperFlanT5-XXLViT-g/1412.31B0.45B

Note: Refer to Setting Models for more information.

Results

For detailed results, please go to our MM-BigBench leaderboard

Setup

Install dependencies and download data.

conda create -n mm-bigbench python=3.8 -y
conda activate mm-bigbench
pip install -r requirements.txt

Fast Start

Select evaluated dataset, model, prompt_type

  1. Select the evaluated task and dataset in the "*.sh" file;
  2. Select the model to be evaluated in the "*.sh" file;
  3. Select the prompt type, from "1" to "10" in the "*.sh" file;
  4. Run the corresponding "*.sh" file.

Running the inference of difffernt models

For ChatGPT, LLaMA-V1-7B, LLaMA-V1-13B, LLaMA-V2-7B, LLaMA-V2-13B, Text-FlanT5-XXL, BLIP-2, InstructBLIP, Fromage, OpenFlamingo, Multimodal-GPT, mPLUG-Owl, MiniGPT4, LLaMA-Adapterv2, VPGTrans, LLaVA-7B, LLaVA-13 models:

sh test_scripts/run_scripts.sh

## Change the "model_name" in the ".sh" file to corresponding to the 'chatgpt', 'decapoda-llama-7b-hf', 'decapoda-llamab-hf', 'meta-llama2-7b-hf', 'meta-llama2-13b-hf', 'text_flan-t5-xxl', 'blip2_t5', 'blip2_instruct_flant5xxl', 'fromage', 'openflamingo', 'mmgpt', 'mplug_owl', 'minigpt4', 'llama_adapterv2', 'vpgtrans', 'llava_7b', 'llava_13b'.


For LaVIN model:

sh test_scripts/run_LaVIN_zero_shot.sh

For Lynx model:

sh test_scripts/run_lynx_llm_zero_shot.sh

Eval the results to get the accuracy metric

sh test_scripts/eval_scripts.sh

Diverse Metrics

Metrics used in our paper can be found in Evaluation Metrics.

Citation

@inproceedings{Yang2023MMBigBenchEM,
  title={MM-BigBench: Evaluating Multimodal Models on Multimodal Content Comprehension Tasks},
  author={Xiaocui Yang and Wenfang Wu and Shi Feng and Ming Wang and Daling Wang and Yang Li and Qi Sun and Yifei Zhang and Xiaoming Fu and Soujanya Poria},
  year={2023},
  url={https://api.semanticscholar.org/CorpusID:264127863}
}

Contributors

YangXiaocui1215

52 commits

soujanyaporia

2 commits

Emrys-Hong

1 commits

Languages

Python

54.9%

Jupyter Notebook

44.5%