Initial commit
Browse files- .gitattributes +1 -0
- README.md +115 -0
- README_zh.md +104 -0
- images/logo.png +3 -0
.gitattributes
CHANGED
|
@@ -33,3 +33,4 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
|
|
| 33 |
*.zip filter=lfs diff=lfs merge=lfs -text
|
| 34 |
*.zst filter=lfs diff=lfs merge=lfs -text
|
| 35 |
*tfevents* filter=lfs diff=lfs merge=lfs -text
|
|
|
|
|
|
| 33 |
*.zip filter=lfs diff=lfs merge=lfs -text
|
| 34 |
*.zst filter=lfs diff=lfs merge=lfs -text
|
| 35 |
*tfevents* filter=lfs diff=lfs merge=lfs -text
|
| 36 |
+
images/logo.png filter=lfs diff=lfs merge=lfs -text
|
README.md
ADDED
|
@@ -0,0 +1,115 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
language:
|
| 3 |
+
- zh
|
| 4 |
+
- en
|
| 5 |
+
datasets:
|
| 6 |
+
- MMFact/MMFact
|
| 7 |
+
tags:
|
| 8 |
+
- mmfact
|
| 9 |
+
- multimodal
|
| 10 |
+
- fake-news-detection
|
| 11 |
+
---
|
| 12 |
+
<h1 align="center" style="text-align: center; font-size: 40px;">MMFact-CKPT</h1>
|
| 13 |
+
|
| 14 |
+
<p align="center">
|
| 15 |
+
<img src="images/logo.png" alt="MMFact logo" width="280">
|
| 16 |
+
</p>
|
| 17 |
+
|
| 18 |
+
<p align="center" style="text-align: center;">
|
| 19 |
+
<strong>Model Checkpoints for Multimodal Fake News Detection</strong>
|
| 20 |
+
</p>
|
| 21 |
+
|
| 22 |
+
<p align="center">
|
| 23 |
+
<a href="https://arxiv.org/abs/2610.34162"><img src="https://img.shields.io/badge/arXiv-2610.34162-B31B1B?style=flat&logo=arxiv&logoColor=white" alt="arXiv: 2610.34162" height="20"></a>
|
| 24 |
+
<a href="https://github.com/yuchenmiao04/MMFact"><img src="https://img.shields.io/badge/GitHub-MMFact-181717?style=flat&logo=github&logoColor=white" alt="GitHub: MMFact" height="20"></a>
|
| 25 |
+
<a href="https://huggingface.co/datasets/MMFact/MMFact"><img src="https://img.shields.io/badge/Hugging%20Face-Dataset-D4A017?style=flat&logo=huggingface&logoColor=FFD21E" alt="Hugging Face: Dataset" height="20"></a>
|
| 26 |
+
</p>
|
| 27 |
+
|
| 28 |
+
**English** | [简体中文](https://huggingface.co/MMFact/MMFact-CKPT/blob/main/README_zh.md)
|
| 29 |
+
|
| 30 |
+
MMFact-CKPT is the model checkpoint repository for [MMFact](https://github.com/yuchenmiao04/MMFact), supporting reproducible experiments on Weibo-17, Weibo-21<sup>†</sup>, and GossipCop.
|
| 31 |
+
|
| 32 |
+
This repository contains checkpoints for **47 methods**, including **24 methods with separate ResNet and ViT variants**, covering three datasets and three random seeds for a total of **639 checkpoints**. Checkpoints are organized by dataset, method, variant, and seed to support evaluation and comparison using the MMFact toolbox.
|
| 33 |
+
|
| 34 |
+
## Checkpoint Coverage
|
| 35 |
+
|
| 36 |
+
| Method group | Methods | Variants | Checkpoints per method | Total |
|
| 37 |
+
|---|---:|---|---:|---:|
|
| 38 |
+
| Methods with a single variant | 23 | `default` | 9 | 207 |
|
| 39 |
+
| Methods with two visual variants | 24 | `resnet`, `vit` | 18 | 432 |
|
| 40 |
+
| **Total** | **47** | — | — | **639** |
|
| 41 |
+
|
| 42 |
+
Each variant has one checkpoint for each combination of the following datasets and random seeds:
|
| 43 |
+
|
| 44 |
+
| Setting | Values |
|
| 45 |
+
|---|---|
|
| 46 |
+
| Datasets | `weibo17`, `weibo21`, `gossipcop` |
|
| 47 |
+
| Random seeds | `0`, `42`, `2026` |
|
| 48 |
+
| Checkpoint filename | `checkpoint.pt` |
|
| 49 |
+
|
| 50 |
+
The `default` variant identifies methods without separate ResNet and ViT versions in this collection.
|
| 51 |
+
|
| 52 |
+
<sup>†</sup> Weibo-21 refers to the reconstructed version provided by MMFact, based on the [original paper](https://doi.org/10.1145/3459637.3482139), with a fixed 8:1:1 train/validation/test split. See the [dataset repository](https://huggingface.co/datasets/MMFact/MMFact) for details.
|
| 53 |
+
|
| 54 |
+
## Organization and Usage
|
| 55 |
+
|
| 56 |
+
All checkpoints follow a consistent directory structure:
|
| 57 |
+
|
| 58 |
+
```text
|
| 59 |
+
<dataset>/<method_slug>/<variant>/seed-<seed>/checkpoint.pt
|
| 60 |
+
```
|
| 61 |
+
|
| 62 |
+
For example, the EANN directory layout is as follows:
|
| 63 |
+
|
| 64 |
+
```text
|
| 65 |
+
weibo17/
|
| 66 |
+
└── eann/
|
| 67 |
+
├── resnet/
|
| 68 |
+
│ ├── seed-0/
|
| 69 |
+
│ │ └── checkpoint.pt
|
| 70 |
+
│ ├── seed-42/
|
| 71 |
+
│ │ └── checkpoint.pt
|
| 72 |
+
│ └── seed-2026/
|
| 73 |
+
│ └── checkpoint.pt
|
| 74 |
+
└── vit/
|
| 75 |
+
├── seed-0/
|
| 76 |
+
│ └── checkpoint.pt
|
| 77 |
+
├── seed-42/
|
| 78 |
+
│ └── checkpoint.pt
|
| 79 |
+
└── seed-2026/
|
| 80 |
+
└── checkpoint.pt
|
| 81 |
+
```
|
| 82 |
+
|
| 83 |
+
Download an individual checkpoint using `huggingface_hub`:
|
| 84 |
+
|
| 85 |
+
```python
|
| 86 |
+
from huggingface_hub import hf_hub_download
|
| 87 |
+
|
| 88 |
+
checkpoint_path = hf_hub_download(
|
| 89 |
+
repo_id="MMFact/MMFact-CKPT",
|
| 90 |
+
repo_type="model",
|
| 91 |
+
filename="weibo17/eann/resnet/seed-0/checkpoint.pt",
|
| 92 |
+
)
|
| 93 |
+
|
| 94 |
+
print(checkpoint_path)
|
| 95 |
+
```
|
| 96 |
+
|
| 97 |
+
Change the filename to select a checkpoint for another dataset, method, variant, or random seed.
|
| 98 |
+
|
| 99 |
+
Use the corresponding model implementation and configuration in the [MMFact toolbox](https://github.com/yuchenmiao04/MMFact) to load and evaluate the checkpoint. Dataset definitions, preprocessing resources, and precomputed features are documented in the [MMFact dataset repository](https://huggingface.co/datasets/MMFact/MMFact).
|
| 100 |
+
|
| 101 |
+
## Citation
|
| 102 |
+
|
| 103 |
+
If you use these checkpoints or other MMFact resources in your research, please cite our paper:
|
| 104 |
+
|
| 105 |
+
```bibtex
|
| 106 |
+
@misc{miao2026mmfactsimplifyingmultimodalmisinformation,
|
| 107 |
+
title={MMFact: Simplifying Multimodal Misinformation Detection with Shared Resources and Tools},
|
| 108 |
+
author={Yuchen Miao and Zijun Wang and Mingtai Zhang and Xiaoyi Chen and Sihan Deng and Xianglin Ding},
|
| 109 |
+
year={2026},
|
| 110 |
+
eprint={2610.34162},
|
| 111 |
+
archivePrefix={arXiv},
|
| 112 |
+
primaryClass={cs.MM},
|
| 113 |
+
url={https://arxiv.org/abs/2610.34162},
|
| 114 |
+
}
|
| 115 |
+
```
|
README_zh.md
ADDED
|
@@ -0,0 +1,104 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
<h1 align="center" style="text-align: center; font-size: 40px;">MMFact-CKPT</h1>
|
| 2 |
+
|
| 3 |
+
<p align="center">
|
| 4 |
+
<img src="images/logo.png" alt="MMFact logo" width="280">
|
| 5 |
+
</p>
|
| 6 |
+
|
| 7 |
+
<p align="center" style="text-align: center;">
|
| 8 |
+
<strong>面向多模态虚假新闻检测的模型检查点</strong>
|
| 9 |
+
</p>
|
| 10 |
+
|
| 11 |
+
<p align="center">
|
| 12 |
+
<a href="https://arxiv.org/abs/2610.34162"><img src="https://img.shields.io/badge/arXiv-2610.34162-B31B1B?style=flat&logo=arxiv&logoColor=white" alt="arXiv: 2610.34162" height="20"></a>
|
| 13 |
+
<a href="https://github.com/yuchenmiao04/MMFact"><img src="https://img.shields.io/badge/GitHub-MMFact-181717?style=flat&logo=github&logoColor=white" alt="GitHub: MMFact" height="20"></a>
|
| 14 |
+
<a href="https://huggingface.co/datasets/MMFact/MMFact"><img src="https://img.shields.io/badge/Hugging%20Face-Dataset-D4A017?style=flat&logo=huggingface&logoColor=FFD21E" alt="Hugging Face: Dataset" height="20"></a>
|
| 15 |
+
</p>
|
| 16 |
+
|
| 17 |
+
[English](https://huggingface.co/MMFact/MMFact-CKPT) | **简体中文**
|
| 18 |
+
|
| 19 |
+
MMFact-CKPT 是 [MMFact](https://github.com/yuchenmiao04/MMFact) 的模型检查点仓库,用于支持在 Weibo-17、Weibo-21<sup>†</sup> 和 GossipCop 上开展可复现的实验。
|
| 20 |
+
|
| 21 |
+
本仓库收录 **47 个方法**的模型检查点,其中 **24 个方法分别提供 ResNet 和 ViT 两个版本**,覆盖三个数据集和三个随机种子,共计 **639 个检查点**。检查点按照数据集、方法、版本和随机种子组织,便于结合 MMFact 工具箱进行评估与比较。
|
| 22 |
+
|
| 23 |
+
## 检查点覆盖范围
|
| 24 |
+
|
| 25 |
+
| 方法类别 | 方法数量 | 版本 | 每个方法的检查点数量 | 总数 |
|
| 26 |
+
|---|---:|---|---:|---:|
|
| 27 |
+
| 单版本方法 | 23 | `default` | 9 | 207 |
|
| 28 |
+
| 双视觉版本方法 | 24 | `resnet`、`vit` | 18 | 432 |
|
| 29 |
+
| **合计** | **47** | — | — | **639** |
|
| 30 |
+
|
| 31 |
+
每个版本在以下数据集与随机种子的每一种组合下,分别对应一个检查点:
|
| 32 |
+
|
| 33 |
+
| 设置 | 取值 |
|
| 34 |
+
|---|---|
|
| 35 |
+
| 数据集 | `weibo17`、`weibo21`、`gossipcop` |
|
| 36 |
+
| 随机种子 | `0`、`42`、`2026` |
|
| 37 |
+
| 检查点文件名 | `checkpoint.pt` |
|
| 38 |
+
|
| 39 |
+
`default` 表示该方法在本仓库中不单独区分 ResNet 和 ViT 两个版本。
|
| 40 |
+
|
| 41 |
+
<sup>†</sup> 此处的 Weibo-21 指 MMFact 根据[原始论文](https://doi.org/10.1145/3459637.3482139)重建的数据版本,采用固定的 8:1:1 训练集、验证集和测试集划分。详情请参阅[数据集仓库](https://huggingface.co/datasets/MMFact/MMFact)。
|
| 42 |
+
|
| 43 |
+
## 目录结构与使用方法
|
| 44 |
+
|
| 45 |
+
所有检查点采用统一的目录格式:
|
| 46 |
+
|
| 47 |
+
```text
|
| 48 |
+
<数据集>/<方法目录名>/<版本>/seed-<随机种子>/checkpoint.pt
|
| 49 |
+
```
|
| 50 |
+
|
| 51 |
+
例如,EANN 的目录结构如下:
|
| 52 |
+
|
| 53 |
+
```text
|
| 54 |
+
weibo17/
|
| 55 |
+
└── eann/
|
| 56 |
+
├── resnet/
|
| 57 |
+
│ ├── seed-0/
|
| 58 |
+
│ │ └── checkpoint.pt
|
| 59 |
+
│ ├── seed-42/
|
| 60 |
+
│ │ └── checkpoint.pt
|
| 61 |
+
│ └── seed-2026/
|
| 62 |
+
│ └── checkpoint.pt
|
| 63 |
+
└── vit/
|
| 64 |
+
├── seed-0/
|
| 65 |
+
│ └── checkpoint.pt
|
| 66 |
+
├── seed-42/
|
| 67 |
+
│ └── checkpoint.pt
|
| 68 |
+
└── seed-2026/
|
| 69 |
+
└── checkpoint.pt
|
| 70 |
+
```
|
| 71 |
+
|
| 72 |
+
使用 `huggingface_hub` 下载单个检查点:
|
| 73 |
+
|
| 74 |
+
```python
|
| 75 |
+
from huggingface_hub import hf_hub_download
|
| 76 |
+
|
| 77 |
+
checkpoint_path = hf_hub_download(
|
| 78 |
+
repo_id="MMFact/MMFact-CKPT",
|
| 79 |
+
repo_type="model",
|
| 80 |
+
filename="weibo17/eann/resnet/seed-0/checkpoint.pt",
|
| 81 |
+
)
|
| 82 |
+
|
| 83 |
+
print(checkpoint_path)
|
| 84 |
+
```
|
| 85 |
+
|
| 86 |
+
修改文件路径,可以选择其他数据集、方法、版本或随机种子的检查点。
|
| 87 |
+
|
| 88 |
+
请使用 [MMFact 工具箱](https://github.com/yuchenmiao04/MMFact)中对应的模型实现和配置加载、评估检查点。数据集定义、预处理资源及预计算特征的说明见 [MMFact 数据集仓库](https://huggingface.co/datasets/MMFact/MMFact)。
|
| 89 |
+
|
| 90 |
+
## 引用
|
| 91 |
+
|
| 92 |
+
如果您在研究中使用了这些检查点或其他 MMFact 资源,请引用我们的论文:
|
| 93 |
+
|
| 94 |
+
```bibtex
|
| 95 |
+
@misc{miao2026mmfactsimplifyingmultimodalmisinformation,
|
| 96 |
+
title={MMFact: Simplifying Multimodal Misinformation Detection with Shared Resources and Tools},
|
| 97 |
+
author={Yuchen Miao and Zijun Wang and Mingtai Zhang and Xiaoyi Chen and Sihan Deng and Xianglin Ding},
|
| 98 |
+
year={2026},
|
| 99 |
+
eprint={2610.34162},
|
| 100 |
+
archivePrefix={arXiv},
|
| 101 |
+
primaryClass={cs.MM},
|
| 102 |
+
url={https://arxiv.org/abs/2610.34162},
|
| 103 |
+
}
|
| 104 |
+
```
|
images/logo.png
ADDED
|
Git LFS Details
|