Git Product home page Git Product logo

lio_sam_6axis's Introduction

hkust

LIO_SAM_6AXIS

LIO_SAM_6AXIS is an open-source SLAM project based on the project LIO_SAM that has been modified to support a wider range of sensors. It includes support for a 6-axis IMU and low-cost GNSS, making it easier to adapt for your own sensor setup.

image-20220609035032131

Features

LIO_SAM_6AXIS includes the following features:

  • Support for a 6-axis IMU: This allows you to use orientation information in state estimation, improving the accuracy of your results.
  • Support for low-cost GNSS: By eliminating the need to adapt for the robot_localization node, this feature makes it easier to integrate GNSS into your SLAM system.
  • GPS constraint visualization: This feature helps with debugging by allowing you to visualize the GPS constraints that are being used in the optimization.
  • Compatible with a range of lidars: LIO_SAM_6AXIS can be adapted to work with a range of lidars, including popular models like the VLP-16 ,Pandar32 and Ouster OS-1.
  • Easy to adapt: With minor changes to the original code, LIO_SAM_6AXIS can be adapted to work with your own sensors and lidars.

Getting Started

To get started with LIO_SAM_6AXIS, follow these steps:

  1. Clone the repository:
git clone https://github.com/JokerJohn/LIO_SAM_6AXIS.git
  1. Install the dependencies:
cd LIO_SAM_6AXIS
catkin build
  1. Launch the roslaunch file for your sensor setup:
roslaunch lio_sam_6axis run.launch

For more information on how to use LIO_SAM_6AXIS, see the video tutorial and documentation.

  1. finally, save your point cloud map.
rosservice call /lio_sam_6axis/save_map

image-20220609044824460

  1. for docker support.

Dockerfile is for people who don't want to break their own environment.

# please cd the folder which have Dockerfile first, approximately 10mins based on your internet and CPU
docker build -t zhangkin/lio_sam_6axis .

docker run -it --net=host --gpus all --name lio_sam_6axis zhangkin/lio_sam_6axis /bin/zsh

# OR -v to link the folder from your computer into container (your_computer_loc:container_loc)
docker run -it --net=host --gpus all --name lio_sam_6axis -v /home/kin/bag_data:/home/xchu/data/ramlab_dataset zhangkin/lio_sam_6axis /bin/zsh

# in the container
catkin build
source devel/setup.zsh

# with dataset download and linked ==> please see more usage in previous section
roslaunch lio_sam_6axis ouster128_indoors.launch

# 对于在内地的同学,可以换源`dockerhub`后,直接拉取:
docker pull zhangkin/lio_sam_6axis

Documentation

The documentation for LIO_SAM_6AXIS can be found in the doc directory of the repository. It includes instructions on how to adapt the code for your own sensors and lidars.

Latest News(2022-11-10)

Here are the latest updates to LIO_SAM_6AXIS:

  • Fix some bugs in GNSS odometry: If the GNSS has enough translation (larger than 0.1m) in a short time, we publish an absolute yaw angle as a reference.
  • Improve LIO-GPS initialization: If the GNSS trajectory has been aligned well with the LIO trajectory, we refine the LLA coordinate of the origin point of the map.
  • Add tf messages in result.bag so that you can use the result.bag to generate the demo shown above.
  • Add rviz_satellate plugins, which can show your point cloud on Google Maps.
  • Update map origin point automatically during optimization.

Dataset and Adaptation

LIO_SAM_6AXIS is compatible with a range of datasets and sensor setups. To help you get started, we have included a table that lists some of the datasets and sensors that have been tested with LIO_SAM_6AXIS.

Dataset Description Sensors Download Links Ground Truth Comments
hkust_20201105full image-20221030035547512 VLP-16, STIM300 IMU, left camera, normal GPS Dropbox, BaiduNetdisk (password: m8g4) GT (password:123) About 10 km outdoor, see this doc
HILTI DATASET img Hesai32 lidar, low-cost IMU, 5 Fisher Eye cameras Download The config/params_pandar.yaml is prepared for the HILTI sensors kit
garden_day Garden Ouster OS1-128, STIM300 IMU, stereo camera Download GT Indoors. When you download this compressed data, remember to execute the following command: rosbag decompress 20220216_garden_day_ref_compressed.bag

Related Package

  • LIO_SAM 6轴IMU适配香港城市数据集UrbanNav,并给出添加GPS约束和不加GPS约束的结果

Contributing

If you would like to contribute to LIO_SAM_6AXIS, please read the CONTRIBUTING.md file for guidelines.

License

LIO_SAM_6AXIS is released under the MIT license.

Credits

We would like to thank TixiaoShan for creating the LIO_SAM project that served as the foundation for this work.

Acknowledgments

We would like to express our gratitude to the following individuals for their contributions to this project:

We also extend our appreciation to the developers of the LIO_SAM algorithm for providing a solid foundation for our work.

Finally, we would like to thank the open-source community for their contributions to the development and improvement of SLAM technologies, which have made this project possible.

Star History Chart

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.