From 178e5f536b46f1e0d3b30609cc73fdd1c05efece Mon Sep 17 00:00:00 2001 From: "Fornasier, Alessandro" Date: Mon, 20 Nov 2023 09:32:23 +0100 Subject: [PATCH] [MAINT] Updated README --- README.md | 23 ++++++++++++++++++++--- 1 file changed, 20 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 203851a..06d4a72 100644 --- a/README.md +++ b/README.md @@ -18,7 +18,7 @@ It is based on the recent advances in equivaraint inertial navigation systems [[ - Supports unit-plane projection method - Supports anchored euclidean, anchored inverse depth and anchored polar feature representation methods - Includes a static initialization routine as well as parametric initialization with custom origin -- Includes an equivariant zero-velocity update routine +- Includes an equivariant zero velocity update routine ### Vision frontend features @@ -27,6 +27,15 @@ It is based on the recent advances in equivaraint inertial navigation systems [[ - Supports different features detector including FAST and Shi-Tomasi - Supports different image enhancment tecniques, including Histogram and CLAHE +### Future roadmap + + - [x] ROS1 wrapper + - [x] ROS2 wrapper + - [x] Equivariant Zero velocity Update (EqZVU) + - [ ] Unit-sphere projection method support + - [ ] Equivariant Persistent (SLAM) features update support + + ## Dependencies MSCEqF has the following dependencies which are automatically downloaded and linked against: @@ -54,7 +63,10 @@ $ cd msceqf/build/ $ ./msceqf_tests ``` -### Run example +### Run example (Euroc) + +After downloading the [Euroc](https://projects.asl.ethz.ch/datasets/doku.php?id=kmavvisualinertialdatasets) follows + ```sh $ cd msceqf/build/ $ ./msceqf_euroc @@ -87,6 +99,12 @@ $ xhost + $ docker run --net=host -it --gpus all --env="NVIDIA_DRIVER_CAPABILITIES=all" --env="DISPLAY" --env="QT_X11_NO_MITSHM=1" --volume="/tmp/.X11-unix:/tmp/.X11-unix:rw" msceqf:ros . ``` +If Nvidia drivere are not supported, simply run docker as follows + +```sh +$ docker run --net=host -it --gpus all --env="NVIDIA_DRIVER_CAPABILITIES=all" --env="DISPLAY" --env="QT_X11_NO_MITSHM=1" --volume="/tmp/.X11-unix:/tmp/.X11-unix:rw" msceqf:ros . +``` + ## License This software is made available to the public to use (source-available), licensed under the terms of the BSD-2-Clause-License with no commercial use allowed, the full terms of which are made available in the [LICENSE](LICENSE) file. @@ -98,7 +116,6 @@ If you use this software in an academic research setting, please cite the corres @article{fornasier2023msceqf, title={MSCEqF: A Multi State Constraint Equivariant Filter for Vision-aided Inertial Navigation}, author={Fornasier, Alessandro and van Goor, Pieter and Allak, Eren and Mahony, Robert and Weiss, Stephan}, - journal={arXiv preprint arXiv:XXXX.XXXXX}, year={2023} }