whatisgithub

What is bievr-lio?

ethz-asl/bievr-lio — explained in plain English

Analysis updated 2026-05-18

196C++Audience · researcherComplexity · 5/5LicenseSetup · hard

In one sentence

A research system that helps robots track their position using LiDAR and motion sensors, built to stay accurate even in featureless spaces like tunnels.

Mindmap

mindmap
  root((bievr lio))
    What it does
      Tracks robot position
      Uses lidar plus inertial
      Handles featureless spaces
    Tech stack
      C plus plus
      ROS1 and ROS2
      Eigen and Ceres
    Use cases
      Tunnel navigation
      Robust odometry
      Elevation mapping
    Audience
      Robotics researchers
      Autonomous navigation engineers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Give a mobile robot reliable position tracking in narrow, featureless environments like tunnels or corridors.

USE CASE 2

Combine LiDAR and inertial sensor data into a single robust odometry estimate for navigation.

USE CASE 3

Use the tracked geometry for follow on tasks like building elevation maps for a walking robot.

What is it built with?

C++ROSEigenCeres

How does it compare?

ethz-asl/bievr-liocloudcompare/cccorelibpeng-zhihui/imgui-template
Stars196197189
LanguageC++C++C++
Last pushed2026-06-202023-01-14
MaintenanceMaintainedDormant
Setup difficultyhardmoderatemoderate
Complexity5/53/52/5
Audienceresearcherdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1day+

Needs ROS1 or ROS2, the Ceres and Eigen math libraries, and optionally Livox hardware drivers, Docker images are provided to ease setup.

BSD 3-Clause license: use, modify, and share freely, including commercially, as long as you keep the copyright notice and do not use the authors' names to promote your own product without permission.

So what is it?

BIEVR-LIO is a research system that helps mobile robots figure out where they are and how they are moving using a spinning laser sensor called a LiDAR combined with an inertial sensor that measures motion, like the one in a phone. This general task is called odometry, and it is one of the core building blocks robots need to move around safely. The project's contribution is aimed at a specific hard case: environments with very little distinctive shape to them, such as long straight tunnels or featureless corridors, where many existing systems lose track of the robot's position because there is not enough geometric detail to match one scan against the next. BIEVR-LIO addresses this by storing the environment as a map of small height images arranged in a grid of cubes called voxels, which captures subtle bumps and surface variation that flatter representations miss. It also focuses its comparison work on the parts of the environment that actually carry useful shape information, which both improves accuracy in these hard cases and reduces computing cost compared to comparing everything everywhere. The core system does not depend on any robotics framework and can be used on its own, with separate add on packages provided for both major versions of ROS, the common robotics software framework, labeled ROS1 and ROS2. Setup instructions and Docker images are provided for both versions so you can try the system without manually installing every dependency. The project also depends on two established math and optimization libraries, Eigen and Ceres, and can optionally support additional LiDAR hardware from a manufacturer called Livox. This is research code accompanying a published paper, aimed at robotics engineers and academics working on autonomous navigation, not a general purpose consumer tool. It is released under the BSD 3-Clause license.

Copy-paste prompts

Prompt 1
Explain in simple terms how BIEVR-LIO keeps a robot from losing track of its position in a tunnel.
Prompt 2
Help me set up the Docker image for the ROS2 version of BIEVR-LIO.
Prompt 3
Walk me through building BIEVR-LIO from source with the Ceres and Eigen dependencies.
Prompt 4
How does this project's voxel height image map differ from typical LiDAR mapping approaches?

Frequently asked questions

What is bievr-lio?

A research system that helps robots track their position using LiDAR and motion sensors, built to stay accurate even in featureless spaces like tunnels.

What language is bievr-lio written in?

Mainly C++. The stack also includes C++, ROS, Eigen.

What license does bievr-lio use?

BSD 3-Clause license: use, modify, and share freely, including commercially, as long as you keep the copyright notice and do not use the authors' names to promote your own product without permission.

How hard is bievr-lio to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is bievr-lio for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.