PNemo commited on
Commit
797ffbf
·
verified ·
1 Parent(s): 9aaab56

Initial commit

Browse files
Files changed (4) hide show
  1. .gitattributes +1 -0
  2. README.md +115 -0
  3. README_zh.md +104 -0
  4. 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&amp;logo=arxiv&amp;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&amp;logo=github&amp;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&amp;logo=huggingface&amp;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&amp;logo=arxiv&amp;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&amp;logo=github&amp;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&amp;logo=huggingface&amp;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

  • SHA256: 692ff40ea8d7367c6572c9ce5382a583ebccec5bbfafbd90593a54791f18b2dc
  • Pointer size: 131 Bytes
  • Size of remote file: 516 kB