Code Monkey home page Code Monkey logo

maoris's Introduction

MAORIS : MAp Of RIpples' Segmentation

Cutting most types of maps in smaller more meaningful bits.

Description

This program segment maps in semantically meaningful parts, such as rooms and corridors. It has been tested on robot build maps and sketch maps, but the principle can easily be extended to other type of maps such as city maps.

Image of a segmentation Image of another segmentation

It also provides a way to evaluate and test your own segmentation using Matthews Correlation Coefficient.

A little bit more about this here.

Paper

The paper describing the method was accepted for publication at ICRA2017 (:D!) and should be published soon after the conference. The preprint version is available on Arxiv.

How to compile

Dependencies

Compile by doing

mkdir release
cmake ..
make

If one need to use maoris for other project you can do

sudo make install

to install and

sudo make uninstall

To uninstall.

How to use maoris

After compilation, you will have those executables:

For segmentation:

  • segmentation_live : use the webcam of your laptop to segment maps. Just take a picture of the map and its ground truth and there you go.

  • evaluation_2files_fodler : compare segmented images files from two folders

  • evaluation_gt : compare a map with a segmented ground truth image

For evaluation

  • evaluation_2gt : compare two segmented images

  • evaluation_gt_all_files : segment all maps in a folder and then compare them to all segmented ground truths in another folder This file returns a gnuplot dat file named maoris_all_measures.dat with all the data from the segmentation.

  • evaluation_gt_param : evaluate maoris' parameters This file returns four gnuplot dat files named maoris_param_threshold.dat, maoris_param_margin.dat, maoris_param_ripples.dat, and maoris_param_doors.dat, with all the data from the segmentation for each parameters.

The arguments of all programs are given in the command line as in evaluation_gt_all_files folder1 folder2 should_draw.

Evaluating your own segmentations

You can evaluate your own segmentation results to ground truths by doing:

evaluation_2files_fodler folder_with_your_segmentation folder_with_your_ground_truth

We also provide segmentation by maoris, DuDe and a Voronoi based segmentation. DuDe segmentation results are in Test/RobotMap/DuDe_results for the robot maps and Test/Sketches/DuDe for the sketch maps. The Voronoi based segmentation results are in Test/RobotMap/Voronoi for the robot maps and Test/Sketches/Voronoi for the sketch maps. maoris segmentation results are in Test/RobotMap/maoris for the robot maps and Test/Sketches/maoris for the sketch maps.

maoris's People

Contributors

malcolmmielle 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.