Awesome

Out of the Box: Embodied Navigation in the Real World

This is the PyTorch implementation for our paper:

Out of the Box: Embodied Navigation in the Real World Roberto Bigazzi, Federico Landi, Marcella Cornia, Silvia Cascianelli, Lorenzo Baraldi, Rita Cucchiara 19th International Conference on Computer Analysis of Images and Patterns (CAIP), 2021

LoCoNav
Desktop Installation
LoCoBot Installation
Pretrained Weights
Experiments
Citing LoCoNav
License
Acknowledgments

LoCoNav

Approach Overview

Samples of Navigation Episodes in the Real World

Desktop Installation

Create an environment with conda:

conda create -n loconav python=3.6 cmake=3.14.0
source activate loconav

Install Habitat-Lab:

mkdir environments
cd environments
git clone --branch stable https://github.com/facebookresearch/habitat-lab.git
cd habitat-lab
pip install -r requirements.txt
python setup.py develop --all

Install Habitat-Sim via source:

cd ..
git clone --branch stable https://github.com/facebookresearch/habitat-sim.git
cd habitat-sim
pip install -r requirements.txt
sudo apt-get update || true
sudo apt-get install -y --no-install-recommends \
      libjpeg-dev libglm-dev libgl1-mesa-glx libegl1-mesa-dev mesa-utils xorg-dev freeglut3-dev

Optional arguments --headless for headless systems and --with-cuda for systems with CUDA:

python setup.py install --headless --with-cuda

If installation via source fails you can try conda installation:

Clone this repository:

cd ../..
git clone --recursive https://github.com/aimagelab/LoCoNav
cd LoCoNav

Download the scene datasets:
- [Matterport3D dataset] Download and extract the habitat zip archive using the official Matterport3D download script in habitat-lab/data/scene_datasets/mp3d/ as follows:
```
python download_mp.py --task habitat -o data/scene_datasets/mp3d/
```
- [Gibson dataset] Download the habitat related dataset following the instructions from Gibson repository. After downloading extract the dataset to folder habitat-lab/data/scene_datasets/gibson/ (inside this folder you should have .glb files).

Install A* algorithm:

cd occant_utils/astar_pycpp
make
cd ../..

At this point you will be able to start the training script, so from now on instruction are focused on the deployment of the models to the LoCoBot Platform.

Install Enroot following the instructions on the official repository.

Import PyRobot+Habitat container from DockerHub:

enroot import docker://soumith/pyrobot-and-habitat

Create enroot container on your machine:

enroot create --name loconav soumith+pyrobot-and-habitat.sqsh

Start enroot container (mounting every path you need to access the cloned repository and your data):

enroot start --rw --mount /path_to_loconav --mount /path_to_data --root loconav
cd /path_to_loconav

Set up PyRobot communication on your machine substituting <IP_LOCOBOT> and <IP_DESKTOP> with the IP of the LoCoBot and the IP of your machine respectively. The LoCoBot and your machine should be connected to the same local network:
```
echo export ROS_MASTER_URI=http://<IP_LOCOBOT>:11311 >> ~/.bashrc
echo export ROS_HOSTNAME=<IP_DESKTOP> >> ~/.bashrc
source ~/.bashrc
```
Load PyRobot Environment included in the container:
```
load_pyrobot_env
```

If the LoCoBot is also set up, you will be able to run your evaluation scripts.

LoCoBot Installation

Install Ubuntu 16.04 on the NUC (if not done already).

Install both PyRobot and LoCoBot specifying Python 3:

sudo apt update
sudo apt-get install curl
curl 'https://raw.githubusercontent.com/facebookresearch/pyrobot/master/robots/LoCoBot/install/locobot_install_all.sh' > locobot_install_all.sh
chmod +x locobot_install_all.sh
./locobot_install_all.sh -t full -p 3 -l interbotix

Set up PyRobot communication on the LoCoBot substituting <IP_LOCOBOT> with the IP of the LoCoBot in the local network:

echo export ROS_MASTER_URI=http://localhost:11311 >> ~/.bashrc
echo export ROS_HOSTNAME=<IP_LOCOBOT> >> ~/.bashrc
source ~/.bashrc

Start the ROS server to handle commands sent from your machine:

roslaunch locobot_control main.launch use_arm:=false use_base:=true use_camera:=true use_rviz:=false

At this point, the LoCoBot will receive and execute the evaluation scripts sent from your machine.

Pretrained Weights

To download our pretrained weights for LoCoBot:

source activate loconav
pip install gdown
mkdir pretrained_ckpts
cd pretrained_ckpts
wget https://ailb-web.ing.unimore.it/publicfiles/drive/Pesi%20LoCoNav/ckpt.104.pth
cd ..

Experiments

Training:

python -u run.py --exp-config configs/model_configs/lococcant/locobot_train.yaml --run-type train

Evaluation on the LoCoBot:

python -u locobot_exp.py --exp-config configs/model_configs/lococcant/locobot_eval.yaml

Citing LoCoNav

If you find our code useful for your research, please cite our paper:

Bibtex:

@inproceedings{bigazzi2021out,
  title={Out of the Box: Embodied Navigation in the Real World},
  author={Bigazzi, Roberto and Landi, Federico and Cornia, Marcella and Cascianelli, Silvia and Baraldi, Lorenzo and Cucchiara, Rita},
  booktitle={2021 19th International Conference on Computer Analysis of Images and Patterns (CAIP)},
  year={2021}
}

License

LoCoNav is MIT licensed. See the LICENSE file for details.

The trained models and the exploration dataset are considered data derived from the correspondent scene datasets.

Matterport3D based task datasets and trained models are distributed with Matterport3D Terms of Use and under CC BY-NC-SA 3.0 US license.
Gibson based task datasets, the code for generating such datasets, and trained models are distributed with Gibson Terms of Use and under CC BY-NC-SA 3.0 US license.

Acknowledgments

This work has been supported by "Fondazione di Modena" under the project "AI for Digital Humanities" and by the national project "IDEHA: Innovation for Data Elaboration in Heritage Areas" (PON ARS01_00421), cofunded by the Italian Ministry of University and Research.