README.md

---
license: mit
language:
- en
base_model:
- donydchen/matchnerf
pipeline_tag: image-to-3d
tags:
- tanks-and-temples
- nerf-synthetic
- real-forward-facing
---

# MatchNeRF

This repository serves as a storage space for the pre-trained weights and selected preprocessed datasets used in [MatchNeRF](https://github.com/donydchen/matchnerf).

**[Explicit Correspondence Matching for Generalizable Neural Radiance Fields](http://arxiv.org/abs/2304.12294)**  
[Yuedong Chen](https://donydchen.github.io/)<sup>1</sup>,
[Haofei Xu](https://haofeixu.github.io/)<sup>2</sup>,
[Qianyi Wu](https://qianyiwu.github.io/)<sup>1</sup>,
[Chuanxia Zheng](https://www.chuanxiaz.com/)<sup>3</sup>,
[Tat-Jen Cham](https://personal.ntu.edu.sg/astjcham/)<sup>4</sup>,
[Jianfei Cai](https://jianfei-cai.github.io/)<sup>1</sup>  
<sup>1</sup>Monash University, <sup>2</sup>ETH Zurich, <sup>3</sup>University of Oxford, <sup>4</sup>Nanyang Technological University  
TPAMI 2025

[Paper](http://arxiv.org/abs/2304.12294) | [Project Page](https://donydchen.github.io/matchnerf) | [Code](https://github.com/donydchen/matchnerf) | [Model](https://huggingface.co/donydchen/matchnerf)

![architecture of matchnerf](https://github.com/donydchen/matchnerf/raw/main/docs/matchnerf.png)


## Contents

### Pre-trained weights

* **[gmflow_sintel-0c07dcb3.pth](https://huggingface.co/donydchen/matchnerf/resolve/main/gmflow_sintel-0c07dcb3.pth)**: Pre-trained weights for [GMFlow](https://github.com/haofeixu/gmflow), used to initialize our backbone when training, provided as a backup of the original available on [Google Drive](https://drive.google.com/file/d/1d5C5cgHIxWGsFR1vYs5XrQbbUiZl9TX2/view).
* **[matchnerf_3v.pth](https://huggingface.co/donydchen/matchnerf/resolve/main/matchnerf_3v.pth)**: Pre-trained weights for [MatchNeRF](https://github.com/donydchen/matchnerf) using DTU dataset, trained using 3 input views. Used for benchmarks testing.
* **[matchnerf_3v_ibr.pth](https://huggingface.co/donydchen/matchnerf/resolve/main/matchnerf_3v_ibr.pth)**: Pre-trained weights for [MatchNeRF](https://github.com/donydchen/matchnerf) using IBRNet datasets, trained using 3 input views. More suitable for in-the-wild scenes.

### Datasets

* **[nerf_synthetic.zip](https://huggingface.co/donydchen/matchnerf/resolve/main/nerf_synthetic.zip)**: Blender dataset, provided as a backup of the original available on [Google Drive](https://drive.google.com/drive/folders/128yBriW1IG_3NJ5Rp7APSTZsJqdJdfc1).
* **[nerf_llff_data.zip](https://huggingface.co/donydchen/matchnerf/resolve/main/nerf_llff_data.zip)**: Real Forward Facing dataset, provided as a backup of the original available on [Google Drive](https://drive.google.com/drive/folders/128yBriW1IG_3NJ5Rp7APSTZsJqdJdfc1).
* **[tnt_data.zip](https://huggingface.co/donydchen/matchnerf/resolve/main/tnt_data.zip)**: Tanks and Temples dataset, provided as a backup of the original available on [Google Drive](https://drive.google.com/drive/folders/15Q-N5SrD96i3YmQv0EgmzwJj80IBeYhQ).


## Acknowledgement

This repository contains data that has been derived from publicly available open-source resources. 
All rights and credit for the original data go to the respective creators and contributors of those projects.

If you are the owner of any content included in this repository and believe that its inclusion violates your rights or licensing terms, 
please contact me ("donny") via donny[DOT]chen[AT]outlook[DOT]sg. Upon receipt of a valid request, we will promptly take appropriate action, 
which may include the removal of the content in question.

## BibTex


If you use this project for your research, please cite our paper.

```bibtex
@article{chen2025explicit,
  title={Explicit correspondence matching for generalizable neural radiance fields},
  author={Chen, Yuedong and Xu, Haofei and Wu, Qianyi and Zheng, Chuanxia and Cham, Tat-Jen and Cai, Jianfei},
  journal={IEEE Transactions on Pattern Analysis and Machine Intelligence},
  year={2025},
  publisher={IEEE}
}
```