Skip to content

Commit

Permalink
Initial revision v0.1
Browse files Browse the repository at this point in the history
  • Loading branch information
pmoulon committed Feb 8, 2013
0 parents commit 5c5c221
Show file tree
Hide file tree
Showing 1,351 changed files with 442,122 additions and 0 deletions.
6 changes: 6 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
*.log
*.aux
*.gz
*.toc
*.bbl
*.blg
24 changes: 24 additions & 0 deletions AUTHORS
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
---------------
openMVG authors
---------------
Pierre Moulon <[email protected]>

-------------
OpenMVG authors would thanks the libmv authors
-------------
Andrew Chant <[email protected]>
Daniel Waterworth <[email protected]>
Darius Blaszyk <[email protected]>
David Roberts <[email protected]>
Jose Gonzalez <[email protected]>
Julien Michot <[email protected]>
Keir Mierle <[email protected]>
Marco Molteni <[email protected]>
Matthias Fauconneau <[email protected]>
Nathan Wiegand <[email protected]>
Pau Gargallo <[email protected]>
Pierre Moulon <[email protected]>
Rehno Lindeque <[email protected]>
Slava Vishnyakov <[email protected]>
Vess Perfanov <[email protected]>
W. James MacLean <[email protected]>
66 changes: 66 additions & 0 deletions BUILD
Original file line number Diff line number Diff line change
@@ -0,0 +1,66 @@
=====================================
OpenMVG (open Multiple View Geometry)
=====================================

-----------------
Build instruction
-----------------

Required tools:
* Cmake

On linux:
* => zlib, png, jpeg
* sudo apt-get install zlib1-dev libpng-dev libjpeg8-dev

-----------------
Linux compilation
-----------------

$ ls
AUTHORS BUILD docs logo README src ...
$ cd ..
$ mkdir openMVG_Build
$ cd openMVG_Build
$ cmake -DCMAKE_BUILD_TYPE=RELEASE . ../openmvg/src/

If you want have an IDE openable project with codeblocks:
$ cmake -G "CodeBlocks - Unix Makefiles" -DCMAKE_BUILD_TYPE=RELEASE . ../openmvg/src/

Compile the project
$ make

For a multi-core compilation (Replace NBcore with the number of threads)
$ make -j NBcore

Launch test
$ make test

Have fun with the samples
$ cd opengMVG_Samples

-------------------
Windows compilation
-------------------

Open cmake-gui
Fill the source path with the src openMVG path.
Fill the build path with a new directory
Select your Visual Studio IDE and click configure and then generate

Open the .sln solution created in your build directory.
Change the target to Release.
Compile the libraries and binaries samples.

-------------------
Mac compilation
-------------------

$ ls
AUTHORS BUILD docs logo README src ...
$ cd ..
$ mkdir openMVG_Build
$ cd openMVG_Build
$ cmake -DCMAKE_BUILD_TYPE=RELEASE -G "Xcode" . ../openmvg/src/
$ xcodebuild -configuration Release

70 changes: 70 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,70 @@
=====================================
OpenMVG (open Multiple View Geometry)
=====================================

![Logo](https://github.com/openMVG/openMVG/raw/master/logo/openMVG_Logo.png)

------------
Introduction
------------

[OpenMVG (Multiple View Geometry)](http://imagine.enpc.fr/~moulonp/openMVG/) "open Multiple View Geometry" is a library for computer-vision scientists and especially targeted to the Multiple View Geometry community. It is designed to provide an easy access to the classical problem solvers in Multiple View Geometry and solve them accurately.

The openMVG credo is: "Keep it simple, keep it maintainable". OpenMVG targets readable code that is easy to use and modify by the community.

All the features and modules are unit tested. This test driven development ensures that the code works as it should and enables more consistent repeatability. Furthermore, it makes it easier for the user to understand and learn the given features.

--------
Building
--------

See [BUILD](https://github.com/openMVG/openMVG/raw/master/BUILD) text file

-------
License
-------

See [LICENSE MPL2](https://github.com/openMVG/openMVG/raw/master/license.openMVG) text file

-------
Authors
-------

See [Authors](https://github.com/openMVG/openMVG/raw/master/AUTHORS) text file

-------
Documentation
-------

See [./docs/openmvg.pdf](https://github.com/openMVG/openMVG/raw/master/docs/openmvg.pdf)

----------------
Acknowledgements
----------------

openMVG authors would like to thanks libmv authors for providing an inspiring
base to design openMVG. Authors also would like to thanks Mikros Image [1]
and LIGM-Imagine laboratory [2] for support and authorization to make this
library an opensource project.

[1] [http://www.mikrosimage.eu/](http://www.mikrosimage.eu/)
[2] [http://imagine.enpc.fr/](http://imagine.enpc.fr/)

---------
Citations
---------

If you find the library or some part of it useful, then following
publications are relevant:

[3] Moulon Pierre, Monasse Pascal and Marlet Renaud. ACCV 2012.
[Adaptive Structure from Motion with a contrario model estimation.](http://hal.archives-ouvertes.fr/index.php?halsid=1n2qdqiv2a0l5eq7qpos9us752&view_this_doc=hal-00769266&version=1)

[4] Moulon Pierre and Monasse Pascal. CVMP 2012.
[Unordered feature tracking made fast and easy.](http://hal.archives-ouvertes.fr/index.php?halsid=ggdarhl8cv1j6ohq2073eok8q3&view_this_doc=hal-00769267&version=1)

[5] Moisan Lionel, Moulon Pierre and Monasse Pascal. IPOL 2012.
[Automatic Homographic Registration of a Pair of Images, with A Contrario Elimination of Outliers.](http://dx.doi.org/10.5201/ipol.2012.mmm-oh)

Please cite [3] if you use openMVG library in your work.

175 changes: 175 additions & 0 deletions docs/biblio.bib
Original file line number Diff line number Diff line change
@@ -0,0 +1,175 @@
%%%%%%%%%%%%%%%%%%%%%%
%% Ransac and AC-Ransac
%%%%%%%%%%%%%%%%%%%%%%
@article{DBLP:journals/cacm/FischlerB81,
author = {Fischler, Martin A. and
Bolles, Robert C.},
title = {Random Sample Consensus: A Paradigm for Model Fitting with
Applications to Image Analysis and Automated Cartography},
journal = {Communications of the ACM (CACM)},
volume = {24},
number = {6},
year = {1981},
pages = {381-395},
ee = {http://doi.acm.org/10.1145/358669.358692},
bibsource = {DBLP, http://dblp.uni-trier.de}
}

@book{Desolneux:2007:GTI:1557413,
author = {Desolneux, Agnes and Moisan, Lionel and Morel, Jean-Michel},
title = {From {Gestalt} theory to image analysis: a probabilistic approach},
year = {2007},
isbn = {0387726357, 9780387726359},
edition = {1st},
publisher = {Springer},
}
@article{DBLP:journals/ijcv/MoisanS04,
author = {Moisan, Lionel and
Stival, B{\'e}renger},
title = {A Probabilistic Criterion to Detect Rigid Point Matches
Between Two Images and Estimate the Fundamental Matrix},
journal = {Int. J. of Computer Vision (IJCV)},
volume = {57},
number = {3},
year = {2004},
pages = {201-218},
ee = {http://dx.doi.org/10.1023/B:VISI.0000013094.38752.54},
bibsource = {DBLP, http://dblp.uni-trier.de}
}

@article{ipol_ORSA,
title = {Automatic homographic registration of a pair of images, with a contrario elimination of outliers},
author = {Moisan, Lionel and Moulon, Pierre and Monasse, Pascal},
journal = {Image Processing On Line},
year = 2012,
note = {\url{http://dx.doi.org/10.5201/ipol.2012.mmm-oh}}
}


%%%%%%%%%%%%%%%%%%%%%%
%% Multiple View geometry
%%%%%%%%%%%%%%%%%%%%%%
@Book{Hartley2004,
author = "Hartley, R.~I. and Zisserman, A.",
title = "Multiple View Geometry in Computer Vision",
edition = "Second",
year = "2004",
publisher = "Cambridge University Press, ISBN: 0521540518"
}
@article{DBLP:journals/ijcv/LepetitMF09,
author = {Lepetit, Vincent and
Moreno-Noguer, Francesc and
Fua, Pascal},
title = {{{EP}{\it n}{P}: an accurate {\it {O}}({\it n}) solution to
the {P}{\it n}{P} problem}},
journal = {International Journal of Computer Vision (IJCV)},
volume = {81},
number = {2},
year = {2009},
pages = {155-166},
ee = {http://dx.doi.org/10.1007/s11263-008-0152-6},
bibsource = {DBLP, http://dblp.uni-trier.de}
}

@inproceedings{DBLP:conf/cvpr/KneipSS11,
author = {Laurent Kneip and
Davide Scaramuzza and
Roland Siegwart},
title = {A novel parametrization of the perspective-three-point problem
for a direct computation of absolute camera position and
orientation},
booktitle = {CVPR},
year = {2011},
pages = {2969-2976},
ee = {http://dx.doi.org/10.1109/CVPR.2011.5995464},
bibsource = {DBLP, http://dblp.uni-trier.de}
}

@inproceedings{DBLP:conf/cvpr/Nister03,
author = {Nist{\'e}r, David},
title = {An Efficient Solution to the Five-Point Relative Pose Problem},
booktitle = {CVPR},
year = {2003},
pages = {II.195-202},
volume = {2},
ee = {http://doi.ieeecomputersociety.org/10.1109/CVPR.2003.1211470},
bibsource = {DBLP, http://dblp.uni-trier.de}
}

@article{LonguetHiggins81,
author = {Longuet},
citeulike-article-id = {965015},
journal = {Nature},
keywords = {mosaic},
month = sep,
pages = {133--135},
posted-at = {2006-11-28 07:40:36},
priority = {0},
title = {{A computer algorithm for reconstructing a scene from two projections}},
type = {Mosaic},
volume = {293},
year = {1981}
}


%%%%%%%%%%%%%%%%%%%%%%
%% Software related
%%%%%%%%%%%%%%%%%%%%%%
@inproceedings{muja_flann_2009,
author = {Marius Muja and David G. Lowe},
title = {Fast Approximate Nearest Neighbors with Automatic Algorithm Configuration},
booktitle = {International Conference on Computer Vision Theory and Application
VISSAPP'09)},
publisher = {INSTICC Press},
year = {2009},
pages = {331-340}
}

@inproceedings{Furu:2010,
author = "Yasutaka Furukawa and Brian Curless and Steven M. Seitz and Richard Szeliski",
title = "Towards Internet-scale Multi-view Stereo",
booktitle = "CVPR",
year = "2010"
}

@article{Furu:2010:PMVS,
author = "Yasutaka Furukawa and Jean Ponce",
title = "Accurate, Dense, and Robust Multi-View Stereopsis",
journal = "IEEE Trans. on Pattern Analysis and Machine Intelligence",
year = "2010",
volume = "32",
number = "8",
pages = "1362--1376"
}

@manual{ceres-manual,
Author = {Sameer Agarwal and Keir Mierle},
Title = {Ceres Solver: Tutorial \& Reference},
Organization = {Google Inc.}
}



%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%% OpenMVG based publication
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
@inproceedings{MOULON/CVMP12,
author = {Moulon, Pierre and Monasse, Pascal},
title = {Unordered feature tracking made fast and easy},
booktitle = {CVMP},
year = {2012}
}

@inproceedings{MOULON/ACCV12,
author = {Moulon, Pierre and Monasse, Pascal and Marlet, Renaud},
title = {Adaptive Structure from Motion with a contrario model estimation},
booktitle = {ACCV},
year = {2012}
}

Binary file added docs/figures/Epipolar_geometry.pdf
Binary file not shown.
Loading

0 comments on commit 5c5c221

Please sign in to comment.