https://github.com/csukuangfj/ppm
PatchMatch algorithms for motion estimation and stereo reconstruction
https://github.com/csukuangfj/ppm
Last synced: about 1 month ago
JSON representation
PatchMatch algorithms for motion estimation and stereo reconstruction
- Host: GitHub
- URL: https://github.com/csukuangfj/ppm
- Owner: csukuangfj
- License: gpl-3.0
- Created: 2018-01-04T11:51:58.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2021-12-20T09:36:41.000Z (over 3 years ago)
- Last Synced: 2025-03-31T02:12:09.236Z (3 months ago)
- Language: C++
- Homepage:
- Size: 32.3 MB
- Stars: 16
- Watchers: 2
- Forks: 11
- Open Issues: 1
-
Metadata Files:
- Readme: readme.md
- License: COPYING
Awesome Lists containing this project
README
[](https://travis-ci.org/csukuangfj/ppm)
## Introduction
This repository contains the source code for my thesis,
which implements and extends [CPM][1] for motion estimation
and [PatchMatch Stereo][2] for stereo matching.
You can obtain a copy of the thesis at the address: https://elib.uni-stuttgart.de/handle/11682/9592
The estimation results
for the standard benchmarks are available
at: [KITTI-2012][8], [KITTI-2015][9],
[MPI Sintel][10] and [Middlebury][11].
## Usage
It has been tested on macOS and Ubuntu.
To compile the code, you need to install [OpenCV][3]
and its contribution module [opencv_contrib][4].
In addition, your compiler has to support C++11.
1. Download the repository.
2. Build the code
```.sh
cd ppm
mkdir build
cd build
cmake ..
make -j4
```
3. It will generate three demo executables
- `ppm_cmd` for CPM without post processing (motion estimation)
- `ppm_cmd_with_epic` for CPM with post processing (motion estimation)
- `ppm_st_cmd` for stereo matching.
Refer to [ppm_commandline.cpp][5],
[ppm_commandline_with_epic_flow.cpp][6]
and [ppm_st_cmd.cpp][7] for how to use it.
[11]: http://vision.middlebury.edu/flow/eval/results-fangjun-kuang/
[10]: http://sintel.is.tue.mpg.de/results
[9]: http://www.cvlibs.net/datasets/kitti/eval_scene_flow_detail.php?benchmark=flow&result=55531e93f1a96d0f7f49f53bd250c9979c592356
[8]: http://www.cvlibs.net/datasets/kitti/eval_stereo_flow_detail.php?benchmark=flow&error=3&eval=all&result=361e835c95c296c7bd9eddbbf270fa132eddc5ec
[7]: /src/ppm_stereo/cmd/ppm_st_cmd.cpp
[6]: /src/ppm_flow/cmd/ppm_commandline_with_epic_flow.cpp
[5]: /src/ppm_flow/cmd/ppm_commandline.cpp
[4]: https://github.com/opencv/opencv_contrib
[3]: https://github.com/opencv/opencv
[2]: https://www.microsoft.com/en-us/research/publication/patchmatch-stereo-stereo-matching-with-slanted-support-windows/
[1]: https://github.com/YinlinHu/CPM