Git Product home page Git Product logo

png_to_klg's Introduction

DOI

You can cite by

@misc{jacky_liu_2018_1419222,
  author    = {Tse-An (Jacky) Liu},
  title     = {png to klg}
  version   = {1.0},
  publisher = {Zenodo},
  month     = Aug,
  year      = 2018,
  doi       = {10.5281/zenodo.1419222},
  url       = {https://github.com/HTLife/png_to_klg}
}

docker image is provided here https://github.com/HTLife/png_to_klg-docker

converted klg could be download from here

png to klg format convertor for ElasticFusion

Convert TUM RGB-D png dataset to .klg format for Kintinuous and ElasticFusion

Also work with ICL-NUIM dataset (TUM RGB-D Compatible PNGs)

What do I need to build it?

  • Ubuntu 14.04, 15.04 or 16.04 (Though many other linux distros will work fine)
  • CMake
  • Boost
  • zlib
  • libjpeg
  • OpenCV
sudo apt-get install g++ cmake cmake-gui libboost-all-dev build-essential

wget http://sourceforge.net/projects/opencvlibrary/files/opencv-unix/2.4.9/opencv-2.4.9.zip
unzip opencv-2.4.9.zip
cd opencv-2.4.9.zip
mkdir build
cd build
cmake -D BUILD_NEW_PYTHON_SUPPORT=OFF -D WITH_OPENCL=OFF -D WITH_OPENMP=ON -D INSTALL_C_EXAMPLES=OFF -D BUILD_DOCS=OFF -D BUILD_EXAMPLES=OFF -D WITH_QT=OFF -D WITH_OPENGL=OFF -D WITH_VTK=OFF -D BUILD_PERF_TESTS=OFF -D BUILD_TESTS=OFF -D WITH_CUDA=OFF -D BUILD_opencv_gpu=OFF ..
make -j8
sudo make install

Python package

  • numpy
sudo apt-get install pip
pip install numpy

Build

cd ./pngtoklg
mkdir build
cd build
cmake ..
make

Usage

Parameters

All parameters are required.

  • -w working directory
  • -o output file name (the output file will be place under working directory)
  • -r associations.txt is in reverse order (rgb)(depth)
  • -t TUM format / defualt format is ICL-NUIM
  • -s Scale factor in floating point. default=5000

For more scale factor detail, please reference: http://vision.in.tum.de/data/datasets/rgbd-dataset/file_formats#intrinsic_camera_calibration_of_the_kinect

Prerequirement##

Should place associations.txt under working directory. About how to generate associations.txt please read "Related files" section.

Download

ICL-NUIM

Download the file provided by ICL-NUIM (Living Room 'lr kt0') => (TUM RGB-D Compatible PNGs)

TUM

TUM RGB-D png dataset

Convert TUM dataset

./pngtoklg -w '/TUM/rgbd_dataset_freiburg2_desk/' -o '/TUM/rgbd_dataset_freiburg2_desk/fr2desk.klg' -t

After execute the command above, "/TUM/rgbd_dataset_freiburg2_desk" folder should contain fr2desk.klg file (about 4.4GB).

Run with ElasticFusion

./ElasticFusion -l (path to fr2desk.klg) -d 12 -c 3 -f

Convert ICL-NUIM dataset

remove -t option which is stand for tum

./pngtoklg -w '/iclnuim/living_room_traj0_frei_png/' -o '/iclnuim/living_room_traj0_frei_png/liv.klg'

http://www.doc.ic.ac.uk/~ahanda/living_room_traj0_frei_png.tar.gz

Related files

rgb.txt format

One row contain two informations. First is time sequence. Actually the time is not important. We only need increasing number sequence.

timeSequence filePath

Sample file content

0.033333 ./rgb/scene_00_0000_rs.png
0.066666 ./rgb/scene_00_0001_rs.png
0.099999 ./rgb/scene_00_0002_rs.png
0.133332 ./rgb/scene_00_0003_rs.png
0.166665 ./rgb/scene_00_0004_rs.png
0.199998 ./rgb/scene_00_0005_rs.png
...

associate.py

This code is developed by TUM, which use to associate rgb.txt and depth.txt

Type the following command

(Be aware you should remain the order of parameters, feed the depth file first and then rgb file.)

python associate.py PATH_TO_SEQUENCE/depth.txt PATH_TO_SEQUENCE/rgb.txt > associations.txt

Sample file content (TUM RGB-D dataset format) If you are using ICL-NUIM, the timestamp will be integer number

0.033333 ./depth/scene_00_0000_rs.png 0.033333 ./rgb/scene_00_0000_rs.png
0.066666 ./depth/scene_00_0001_rs.png 0.066666 ./rgb/scene_00_0001_rs.png
0.099999 ./depth/scene_00_0002_rs.png 0.099999 ./rgb/scene_00_0002_rs.png
0.133332 ./depth/scene_00_0003_rs.png 0.133332 ./rgb/scene_00_0003_rs.png
0.166665 ./depth/scene_00_0004_rs.png 0.166665 ./rgb/scene_00_0004_rs.png
0.199998 ./depth/scene_00_0005_rs.png 0.199998 ./rgb/scene_00_0005_rs.png

png_to_klg's People

Contributors

htlife avatar puzzlepaint avatar

Watchers

 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.