Joel Janai a0698c7d24 Compilation errors fixed and readme extended! 1 year ago
..
Makefile 48390ac151 First version of slow_flow_release. 2 years ago
README 48390ac151 First version of slow_flow_release. 2 years ago
array_types.h 48390ac151 First version of slow_flow_release. 2 years ago
epic.cpp 48390ac151 First version of slow_flow_release. 2 years ago
epic.h 48390ac151 First version of slow_flow_release. 2 years ago
epic_aux.cpp 48390ac151 First version of slow_flow_release. 2 years ago
epic_aux.h 48390ac151 First version of slow_flow_release. 2 years ago
epicflow-static 48390ac151 First version of slow_flow_release. 2 years ago
epicflow.cpp 48390ac151 First version of slow_flow_release. 2 years ago
image.c 48390ac151 First version of slow_flow_release. 2 years ago
image.h 48390ac151 First version of slow_flow_release. 2 years ago
io.c 48390ac151 First version of slow_flow_release. 2 years ago
io.h 48390ac151 First version of slow_flow_release. 2 years ago
modelFinal.mat 48390ac151 First version of slow_flow_release. 2 years ago
solver.c 48390ac151 First version of slow_flow_release. 2 years ago
solver.h 48390ac151 First version of slow_flow_release. 2 years ago
variational.c 48390ac151 First version of slow_flow_release. 2 years ago
variational.h 48390ac151 First version of slow_flow_release. 2 years ago
variational_aux.c 48390ac151 First version of slow_flow_release. 2 years ago
variational_aux.h 48390ac151 First version of slow_flow_release. 2 years ago
variational_aux_mt.cpp 48390ac151 First version of slow_flow_release. 2 years ago
variational_aux_mt.h a0698c7d24 Compilation errors fixed and readme extended! 1 year ago
variational_mt.cpp 48390ac151 First version of slow_flow_release. 2 years ago
variational_mt.h 48390ac151 First version of slow_flow_release. 2 years ago

README

EpicFlow, v1.00

Our code is mentioned only for scientific or personal use.
Please contact us for commercial use.

### Compiling ###

Simply type 'make' and the code must compile.
Libraries libpng, libjpg, libm and liblapack are required.
You may have compilation due to lapack, eventually add -L to LDFLAGS in Makefile.
If you have compilation issue, probably due to lapack, add -L to LDFLAGS in Makefile
or use the static version: epicflow-static.
The program was only tested under a 64-bit Linux distribution.
We do not give any support for compilation issues or other OS.

### Prerequisities ###

Given two images, you need first to compute edges and matches before running EpicFlow.
You can download the code from these links.
- for edges using SED: http://research.microsoft.com/en-us/downloads/389109f6-b4e8-404c-84bf-239f7cbf4e3d/
- that will require also Piotr Dollar's toolbox: http://vision.ucsd.edu/~pdollar/toolbox/doc/index.html
- for matches using Deep Matching: http://lear.inrialpes.fr/people/revaud

Note that we initially use the first version of SED, whose results are computed using the corresponding model 'modelFinal.mat'.
More recent versions give similar performance.

### Usage ###

EpicFlow creates a .flo file in an usual .flo format
(for instance, see Middlebury dataset for code reading/displaying it).

Type "./epicflow" for list of available options.
An example usage is given here (set paths between <>).

matlab -nodesktop -nojvm -r "addpath(); addpath(genpath()); load('modelFinal.mat'); I = imread(); if size(I,3)==1, I = cat(3,I,I,I); end; edges = edgesDetect(I, model); fid=fopen(,'wb'); fwrite(fid,transpose(edges),'single'); fclose(fid); exit"

/deepmatching -png_settings -improved_settings -out

./epicflow [options]

### Citation ###

If you use our code, please cite our paper:

@inproceedings{revaud:hal-01142656,
TITLE = {{EpicFlow: Edge-Preserving Interpolation of Correspondences for Optical Flow}},
AUTHOR = {Revaud, Jerome and Weinzaepfel, Philippe and Harchaoui, Zaid and Schmid, Cordelia},
BOOKTITLE = {{Computer Vision and Pattern Recognition}},
YEAR = {2015},
}


### History ###

Dec 2014: v1.00

### LICENCE CONDITIONS ###

Copyright (C) 2014 Philippe Weinzaepfel

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see .