ShaneXiangH/AIGVE_Tool

a Video Quality Analysis Toolkit

14

stars

159

commits

Python

primary language

May 16, 2025

updated

www.aigve.org/

README

What is AIGVE?

AIGVE (AI Generated Video Evaluation Toolkit) provides a comprehensive and structured evaluation framework for assessing AI-generated video quality developed by the IFM Lab. It integrates multiple evaluation metrics, covering diverse aspects of video evaluation, including neural-network-based assessment, distribution comparison, vision-language alignment, and multi-faceted analysis.

AIGVE Toolkit Structure

Library Organization

ComponentsDescriptions
aigveThe library for assessing AI-generated video quality
aigve.configsa library for parameter configuration and management
aigve.corea library for video evaluation process design
aigve.datasetsa library for dataset loading design
aigve.metricsa library for video evaluation metrics design and building
aigve.utilsa library for utility function definition

Evaluation Metrics Zoo

Distribution Comparison-Based Evaluation Metrics

These metrics assess the quality of generated videos by comparing the distribution of real and generated samples.

  • FID: Frechet Inception Distance (FID) quantifies the similarity between real and generated video feature distributions by measuring the Wasserstein-2 distance.
  • FVD: Frechet Video Distance (FVD) extends the FID approach to video domain by leveraging spatio-temporal features extracted from action recognition networks.
  • IS: Inception Score (IS) evaluates both the quality and diversity of generated content by analyzing conditional label distributions.

Video-only Neural Network-Based Evaluation Metrics

These metrics leverage deep learning models to assess AI-generated video quality based on learned representations.

  • GSTVQA: Generalized Spatio-Temporal VQA (GSTVQA) employs graph-based spatio-temporal analysis to assess video quality.
  • SimpleVQA: Simple Video Quality Assessment (Simple-VQA) utilizes deep learning features for no-reference video quality assessment.
  • LightVQA+: Light Video Quality Assessment Plus (Light-VQA+) incorporates exposure quality guidance to evaluate video quality.

Vision-Language Similarity-Based Evaluation Metrics

These metrics evaluate alignment, similarity, and coherence between visual and textual representations, often using embeddings from models like CLIP and BLIP.

  • CLIPSim: CLIP Similarity (CLIPSim) leverages CLIP embeddings to measure semantic similarity between videos and text.
  • CLIPTemp: CLIP Temporal (CLIPTemp) extends CLIPSim by incorporating temporal consistency assessment.
  • BLIPSim: Bootstrapped Language-Image Pre-training Similarity (BLIPSim) uses advanced pre-training techniques to improve video-text alignment evaluation.
  • Pickscore: PickScore incorporates human preference data to provide more perceptually aligned measurement of video-text matching.

Vision-Language Understanding-Based Evaluation Metrics

These metrics assess higher-level understanding, reasoning, and factual consistency in vision-language models.

  • VIEScore: Video Information Evaluation Score (VIEScore) provides explainable assessments of conditional image synthesis.
  • TIFA: Text-Image Faithfulness Assessment (TIFA) employs question-answering techniques to evaluate text-to-image alignment.
  • DSG: Davidsonian Scene Graph (DSG) improves fine-grained evaluation reliability through advanced scene graph representations.

Multi-Faceted Evaluation Metrics

These metrics integrate structured, multi-dimensional assessments to provide a holistic benchmarking framework for AI-generated videos.

  • VideoPhy: Video Physics Evaluation (VideoPhy) specifically assesses the physical plausibility of generated videos.
  • VideoScore: Video Score (VideoScore) simulates fine-grained human feedback across multiple evaluation dimensions.
  • VBench: VBench provides a comprehensive benchmark by combining multiple aspects such as consistency, realism, and alignment into a unified scoring system.

Key Features

  • Multi-Dimensional Evaluation: Covers video coherence, physics, and benchmarking.
  • Open-Source & Customizable: Designed for easy integration.
  • Cutting-Edge AI Assessment: Supports various AI-generated video tasks.

Built-in Dataset:

  1. Toy dataset
  2. AIGVE-Bench toy
  3. AIGVE-Bench

Installation

The aigve library has been published at both PyPI and the project github repository.

Install from PyPI

To install aigve from PyPI, use the following command:

pip install aigve

Install from Source Code

You can also install aigve from the source code, which has been released at the project github repository.

You can download the public repository either from the project github webpage or via the following command:

git clone https://github.com/ShaneXiangH/AIGVE_Tool.git

Please check the installation page for dependency packages.

Environment

conda env remove --name aigve
conda env create -f environment.yml
conda activate aigve
conda install pytorch==2.1.0 torchvision==0.16.0 torchaudio==2.1.0 pytorch-cuda=11.8 -c pytorch -c nvidia

Run:

python main.py {metric_config_file}.py

Take Examples:

rm -rf ~/.cache
cd AIGVE_Tool/aigve

For GSTVQA: python main_aigve.py AIGVE_Tool/aigve/configs/gstvqa.py --work-dir ./output

For SimpleVQA: python main_aigve.py AIGVE_Tool/aigve/configs/simplevqa.py --work-dir ./output

For LightVQAPlus: python main_aigve.py AIGVE_Tool/aigve/configs/lightvqa_plus.py --work-dir ./output

For CLIPSim: python main_aigve.py AIGVE_Tool/aigve/configs/clipsim.py --work-dir ./output

For VideoPhy: python main_aigve.py AIGVE_Tool/aigve/configs/clipsim.py --work-dir ./output

Citing Us

aigve is developed based on the AIGVE-Tool paper from IFM Lab, which can be downloaded via the following links:

If you find AIGVE library and the AIGVE-Tool papers useful in your work, please cite the papers as follows:

@article{xiang2025aigvetoolaigeneratedvideoevaluation,
      title={AIGVE-Tool: AI-Generated Video Evaluation Toolkit with Multifaceted Benchmark}, 
      author={Xinhao Xiang and Xiao Liu and Zizhong Li and Zhuosheng Liu and Jiawei Zhang},
      year={2025},
      journal={arXiv preprint arXiv:2503.14064},
      eprint={2503.14064},
      archivePrefix={arXiv},
      primaryClass={cs.CV},
      url={https://arxiv.org/abs/2503.14064}, 
}

Acknowledge

The Toolkit is build top the top of MMEngine

We acknowledge original repositories of various AIGVE methods: GSTVQA, CLIPSim,

Contributors

ShaneXiangH

80 commits

lizizhong

70 commits

HaroldLiuJ

5 commits

jlk666

4 commits

ShaneXiangH/AIGVE_Tool

a Video Quality Analysis Toolkit

14

stars

159

commits

Python

primary language

May 16, 2025

updated

www.aigve.org/

README

What is AIGVE?

AIGVE (AI Generated Video Evaluation Toolkit) provides a comprehensive and structured evaluation framework for assessing AI-generated video quality developed by the IFM Lab. It integrates multiple evaluation metrics, covering diverse aspects of video evaluation, including neural-network-based assessment, distribution comparison, vision-language alignment, and multi-faceted analysis.

AIGVE Toolkit Structure

Library Organization

ComponentsDescriptions
aigveThe library for assessing AI-generated video quality
aigve.configsa library for parameter configuration and management
aigve.corea library for video evaluation process design
aigve.datasetsa library for dataset loading design
aigve.metricsa library for video evaluation metrics design and building
aigve.utilsa library for utility function definition

Evaluation Metrics Zoo

Distribution Comparison-Based Evaluation Metrics

These metrics assess the quality of generated videos by comparing the distribution of real and generated samples.

  • FID: Frechet Inception Distance (FID) quantifies the similarity between real and generated video feature distributions by measuring the Wasserstein-2 distance.
  • FVD: Frechet Video Distance (FVD) extends the FID approach to video domain by leveraging spatio-temporal features extracted from action recognition networks.
  • IS: Inception Score (IS) evaluates both the quality and diversity of generated content by analyzing conditional label distributions.

Video-only Neural Network-Based Evaluation Metrics

These metrics leverage deep learning models to assess AI-generated video quality based on learned representations.

  • GSTVQA: Generalized Spatio-Temporal VQA (GSTVQA) employs graph-based spatio-temporal analysis to assess video quality.
  • SimpleVQA: Simple Video Quality Assessment (Simple-VQA) utilizes deep learning features for no-reference video quality assessment.
  • LightVQA+: Light Video Quality Assessment Plus (Light-VQA+) incorporates exposure quality guidance to evaluate video quality.

Vision-Language Similarity-Based Evaluation Metrics

These metrics evaluate alignment, similarity, and coherence between visual and textual representations, often using embeddings from models like CLIP and BLIP.

  • CLIPSim: CLIP Similarity (CLIPSim) leverages CLIP embeddings to measure semantic similarity between videos and text.
  • CLIPTemp: CLIP Temporal (CLIPTemp) extends CLIPSim by incorporating temporal consistency assessment.
  • BLIPSim: Bootstrapped Language-Image Pre-training Similarity (BLIPSim) uses advanced pre-training techniques to improve video-text alignment evaluation.
  • Pickscore: PickScore incorporates human preference data to provide more perceptually aligned measurement of video-text matching.

Vision-Language Understanding-Based Evaluation Metrics

These metrics assess higher-level understanding, reasoning, and factual consistency in vision-language models.

  • VIEScore: Video Information Evaluation Score (VIEScore) provides explainable assessments of conditional image synthesis.
  • TIFA: Text-Image Faithfulness Assessment (TIFA) employs question-answering techniques to evaluate text-to-image alignment.
  • DSG: Davidsonian Scene Graph (DSG) improves fine-grained evaluation reliability through advanced scene graph representations.

Multi-Faceted Evaluation Metrics

These metrics integrate structured, multi-dimensional assessments to provide a holistic benchmarking framework for AI-generated videos.

  • VideoPhy: Video Physics Evaluation (VideoPhy) specifically assesses the physical plausibility of generated videos.
  • VideoScore: Video Score (VideoScore) simulates fine-grained human feedback across multiple evaluation dimensions.
  • VBench: VBench provides a comprehensive benchmark by combining multiple aspects such as consistency, realism, and alignment into a unified scoring system.

Key Features

  • Multi-Dimensional Evaluation: Covers video coherence, physics, and benchmarking.
  • Open-Source & Customizable: Designed for easy integration.
  • Cutting-Edge AI Assessment: Supports various AI-generated video tasks.

Built-in Dataset:

  1. Toy dataset
  2. AIGVE-Bench toy
  3. AIGVE-Bench

Installation

The aigve library has been published at both PyPI and the project github repository.

Install from PyPI

To install aigve from PyPI, use the following command:

pip install aigve

Install from Source Code

You can also install aigve from the source code, which has been released at the project github repository.

You can download the public repository either from the project github webpage or via the following command:

git clone https://github.com/ShaneXiangH/AIGVE_Tool.git

Please check the installation page for dependency packages.

Environment

conda env remove --name aigve
conda env create -f environment.yml
conda activate aigve
conda install pytorch==2.1.0 torchvision==0.16.0 torchaudio==2.1.0 pytorch-cuda=11.8 -c pytorch -c nvidia

Run:

python main.py {metric_config_file}.py

Take Examples:

rm -rf ~/.cache
cd AIGVE_Tool/aigve

For GSTVQA: python main_aigve.py AIGVE_Tool/aigve/configs/gstvqa.py --work-dir ./output

For SimpleVQA: python main_aigve.py AIGVE_Tool/aigve/configs/simplevqa.py --work-dir ./output

For LightVQAPlus: python main_aigve.py AIGVE_Tool/aigve/configs/lightvqa_plus.py --work-dir ./output

For CLIPSim: python main_aigve.py AIGVE_Tool/aigve/configs/clipsim.py --work-dir ./output

For VideoPhy: python main_aigve.py AIGVE_Tool/aigve/configs/clipsim.py --work-dir ./output

Citing Us

aigve is developed based on the AIGVE-Tool paper from IFM Lab, which can be downloaded via the following links:

If you find AIGVE library and the AIGVE-Tool papers useful in your work, please cite the papers as follows:

@article{xiang2025aigvetoolaigeneratedvideoevaluation,
      title={AIGVE-Tool: AI-Generated Video Evaluation Toolkit with Multifaceted Benchmark}, 
      author={Xinhao Xiang and Xiao Liu and Zizhong Li and Zhuosheng Liu and Jiawei Zhang},
      year={2025},
      journal={arXiv preprint arXiv:2503.14064},
      eprint={2503.14064},
      archivePrefix={arXiv},
      primaryClass={cs.CV},
      url={https://arxiv.org/abs/2503.14064}, 
}

Acknowledge

The Toolkit is build top the top of MMEngine

We acknowledge original repositories of various AIGVE methods: GSTVQA, CLIPSim,

Contributors

ShaneXiangH

80 commits

lizizhong

70 commits

HaroldLiuJ

5 commits

jlk666

4 commits

Languages

Python

100.0%