Home

Awesome

<div align="center"> <img src="resources/mmflow-logo.png" width="600"/> <div>&nbsp;</div> <div align="center"> <b><font size="5">OpenMMLab website</font></b> <sup> <a href="https://openmmlab.com"> <i><font size="4">HOT</font></i> </a> </sup> &nbsp;&nbsp;&nbsp;&nbsp; <b><font size="5">OpenMMLab platform</font></b> <sup> <a href="https://platform.openmmlab.com"> <i><font size="4">TRY IT OUT</font></i> </a> </sup> </div> <div>&nbsp;</div>

PyPI - Python Version PyPI docs badge codecov license open issues

📘Documentation | 🛠️Installation | 👀Model Zoo | 🤔Reporting Issues

</div> <div align="center">

English | 简体中文

</div>

Introduction

MMFlow is an open source optical flow toolbox based on PyTorch. It is a part of the OpenMMLab project.

The master branch works with PyTorch 1.5+.

https://user-images.githubusercontent.com/76149310/141947796-af4f1e67-60c9-48ed-9dd6-fcd809a7d991.mp4

Major features

What's New

v0.5.2 was released in 01/10/2023:

Please refer to changelog.md for details and release history.

Installation

Please refer to install.md for installation and guidance in dataset_prepare for dataset preparation.

Get Started

If you're new of optical flow, you can start with learn the basics. If you’re familiar with it, check out getting_started to try out MMFlow.

Refer to the below tutorials to dive deeper:

Benchmark and model zoo

Results and models are available in the model zoo.

Supported methods:

Contributing

We appreciate all contributions improving MMFlow. Please refer to CONTRIBUTING.md in MMCV for more details about the contributing guideline.

Acknowledgement

MMFlow is an open source project that is contributed by researchers and engineers from various colleges and companies. We appreciate all the contributors who implement their methods or add new features, as well as users who give valuable feedbacks. We wish that the toolbox and benchmark could serve the growing research community by providing a flexible toolkit to reimplement existing methods and develop their own new flow algorithm.

Citation

If you use this toolbox or benchmark in your research, please cite this project.

@misc{2021mmflow,
    title={{MMFlow}: OpenMMLab Optical Flow Toolbox and Benchmark},
    author={MMFlow Contributors},
    howpublished = {\url{https://github.com/open-mmlab/mmflow}},
    year={2021}
}

License

This project is released under the Apache 2.0 license.

Projects in OpenMMLab