Home v0.1

Overview - listOMVG

The aim of this software is the creation of the file lists.txt needed by openMVG to run the matches computation.

Dependencies

The listomvg comes with the following dependencies :

• libelphelphg <libelphelphg repository> (provided as sub-module)
• libstlplus3 (provided as submodule)

Installation

To clone the repository, use the command :

git clone https://github.com/baritone/listOMVG.git --recursive
cd listomvg

To build the binaries using cmake, use the command :

mkdir build; cd build; cmake ../src && make all

Now update your bash with the following command. !!! WARNING !!! Please update the following command with the correct path of the listomvg folder !!!

echo 'export PATH=$PATH:/home/user/listomvg/path/listomvg/build/' >> /home/user/.bashrc 
bash

Usage

Before using the software, you have to create a file where the channel you will use are stored, one channel number per line, with no space before and after the number. For example, such a file could be named channel.txt and will look like

  10
  14
  24
  25

if you want to use channel 10, 14, 24 and 25 of eyesis4pi camera. To use the software, juste type

./listomvg  -i /path/to/image/directory  -o /path/to/directory/where/lists/should/be/ -x /path/to/xml/file  -c path/to/channel/file

Optionnal argument

 -f  value   If you want to set a focal of value for all images
 -p  1/0     Use (or not) principal point of calibration. Default is 1 
 -r  1/0     Compute lists.txt for global method with rigid rig. Default is 0.

Examples

We suppose here that we are in an openMVG folder with contains only an image folder

  openMVG/
      images/
      channel.txt

and we want to create the file lists.txt, located at openMVG/matches which is related to a subset of image that are in openMVG/images/folder. We suppose that the imagej xml file is located at home. The file channel.txt specify which channel we want to keep. Then, supposing that we are in the openMVG folder, the commands to generate files are the following : For lists.txt file with constant focal and principal point at the center of image,

 listomvg -i images/ -o matches/ -c channel.txt -f 2050 -p 0 -x ~/autoconfig_4780364_820484.corr-xml

For lists.txt file using principal point and focal of calibration,

  listomvg -i images/ -o matches/ -c channel.txt -x ~/autoconfig_4780364_820484.corr-xml

**For lists.txt file using principal point, focal of calibration and rig structure, **

  listomvg -i images/ -o matches/ -c channel.txt -r 1 -x ~/autoconfig_4780364_820484.corr-xml