Giter VIP home page Giter VIP logo

calicam's Introduction

CaliCam: Calibrated Fisheye Stereo & Mono Camera

For more information see https://astar.ai.

Youtube Demo Video.

The following steps have been tested and passed on Ubuntu 16.04.5.

1. Theoretical Background

Fisheye Camera Model: C. Mei and P. Rives, Single View Point Omnidirectional Camera Calibration From Planar Grids, ICRA 2007.

2. OpenCV Installation

2.1 Required Dependencies

sudo apt-get install git cmake build-essential pkg-config libgtk2.0-dev libssl-dev libv4l-dev v4l-utils libjpeg-dev libtiff5-dev libjasper-dev libpng-dev libavcodec-dev libavformat-dev libswscale-dev libxvidcore-dev libx264-dev libxine2-dev libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev libqt4-dev libgtk-3-dev mesa-utils libgl1-mesa-dri libqt4-opengl-dev libatlas-base-dev gfortran libeigen3-dev python2.7-dev python3-dev python-numpy python3-numpy 

2.2 Install OpenCV 3.0 (or Above)

cd
mkdir library
cd library

git clone https://github.com/opencv/opencv_contrib.git
cd opencv_contrib
git checkout tags/3.0.0
cd ..

git clone https://github.com/opencv/opencv.git
cd opencv
git checkout tags/3.0.0
mkdir build
cd build
cmake -DOPENCV_EXTRA_MODULES_PATH=../../opencv_contrib/modules ..
make -j
sudo make install

echo 'export LD_LIBRARY_PATH=LD_LIBRARY_PATH:/lib:/usr/lib:/usr/local/lib' >> ~/.bashrc
source ~/.bashrc

3. Compile

git clone https://github.com/astar-ai/calicam.git
cd calicam
chmod 777 ./compile.sh
./compile.sh

4. Run

./calicam

5. Calibration Parameter File

To run CaliCam in the LIVE mode, you need to download the calibration parameter file from online. Each CaliCam stereo/mono camera has a UNIQUE parameter file. Please download the corresponding parameter file by following the instructions at https://astar.ai/collections/astar-products.

6. Operation

6.1 'Raw Image' window

There are 3 trackbars to adjust the vertical FoV, width, and height for the output image.

6.2 'Disparity Image' window

There are 2 trackbars to adjust the numDisparities and blockSize for OpenCV stereo matching functions.

6.3 Exit

Press 'q' or 'Esc' key to exit.

7. Live Mode

To run CaliCam in a live mode, please change the variable live to true:

bool      live = true;

and run

./calicam YOUR_CALIBRATION_FILE.yml

Note: A*SLAM can run with ANY CaliCam stereo camera under the TRIAL mode.

In TRIAL mode, the map cannot be saved to or loaded from the hard drive.

calicam's People

Contributors

astar-ai avatar akcite avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.