The MARS VINS software is copyrighted by the Regents of the University of Minnesota. Use of the software may be covered by at least US patents and applications 9,243,916, 9,658,07, 14/733,468 and 15/601,261 assigned to Regents of the University of Minnesota. The software can be freely used for educational and research purposes by non-profit institutions and US government agencies only. Other organizations are allowed to use the MARS VINS software only for evaluation purposes, and any further uses will require prior approval from http://z.umn.edu/marsvins. The software may not be sold or redistributed without prior approval. One may make copies of the software for their use provided that the copies, are not sold or distributed, are used under the same terms and conditions.
As unestablished research software, this code is provided on an "as is" basis without warranty of any kind, either expressed or implied. The downloading, or executing any part of this software constitutes an implicit agreement to these terms. These terms and conditions are subject to change at any time without prior notice.
============================================================================
If you want to use this library in your research, please cite:
============================================================================
Notes:
timestamp (s), gyro measurement (gx, gy, gz), accel measurement (ax, ay, az)
image_name, timestamp (s)
============================================================================
Follow these steps to build an example program on linux (built for Ubuntu 14.04) This program will run stereo vins on a given dataset (see http://mars.cs.umn.edu/research/stereo_vins.php for some example datasets).
cd MARS-VINS
mkdir build
cd build
cmake .. -DPLATFORM=x86 -DCAMERA_MODEL=equidistant
make example_app
make install
./example_app <config file> <output file> <imu data file> <left image directory> <right image directory>
If you get this error error while loading shared libraries: libmars_core.so: cannot open shared object file: No such file or directory
, please add the "build" directory to your LD_LIBRARY_PATH.
export LD_LIBRARY_PATH="path-to-build-directory":$LD_LIBRARY_PATH
The following options for MARS-VINS are currently available:
Platforms:
Linux : Intel-64bit (x86)
Linux : ARM-64bit (arm64)
Android : ARM-64-bit (arm64)
Camera models:
equidistant
fov
radial_tangential
example_app can be compiled for any of the above combinations in the following fashion.
For linux builds:
cd MARS-VINS
cd build
cmake -DPLATFORM=<x86 or arm64> -DCAMERA_MODEL=<equidistant or fov or or radial_tangential> ..
make example_app
make install
./example_app <config file> <output file> <imu data file> <left image directory> <right image directory>
For android builds (adb required to interface with android, android device should be rooted):
cd MARS-VINS
cd build_android
## edit cmake_android.sh to select your camera model
sh cmake_android.sh
make example_app
make install
adb push ./example_app <directory on android device>
adb shell
cd <directory on android device>
./example_app <config file> <output file> <imu data file> <left image directory> <right image directory>