Update public repository

Generated from 2c4e451f1a103455430047c9577698a9b8a0ceea

Author: elvout

.devcontainer/devcontainer.json

@@ -0,0 +1,33 @@
+// From https://github.com/fluentrobotics/ros-devcontainer
+{
+    "name": "ros-humble",
+    // The following image needs to be built from the ros-devcontainer
+    // repository.
+    "image": "fluentrobotics/ros:humble",
+    // The following runtime arguments are adapted from the `enter-container.sh`
+    // script in the ros-devcontainer repository.
+    "runArgs": [
+        "--rm",
+        "--interactive",
+        "--tty",
+        "--env=TERM=xterm-256color",
+        "--network=host",
+        "--hostname=ros-humble",
+        "--ipc=host",
+        "--volume=/tmp/.X11-unix:/tmp/.X11-unix:ro",
+        "--volume=/dev/dri:/dev/dri:ro",
+        "--env=DISPLAY=${localEnv:DISPLAY}",
+        "--group-add=sudo",
+        "--user=${localEnv:ROS_DEVCONTAINER_UID}",
+        "--volume=/etc/group:/etc/group:ro",
+        "--volume=/etc/passwd:/etc/passwd:ro",
+        "--volume=/etc/shadow:/etc/shadow:ro",
+        "--volume=${localEnv:HOME}:${localEnv:HOME}",
+        // "--runtime=nvidia",
+        // "--gpus=all",
+        // "--env=NVIDIA_DRIVER_CAPABILITIES=all",
+    ],
+    // Since we're mounting the whole user directory, we can work directly in
+    // the local user workspace path.
+    "workspaceFolder": "${localWorkspaceFolder}"
+}

.gitignore

@@ -0,0 +1,20 @@
+*.pkl
+*.pyc
+__pycache__/
+.mypy_cache/
+.venv/
+
+*.jpg
+*.jpeg
+*.png
+*.svg
+*.pdf
+*.mp4
+
+data/eleyng/demonstrations
+
+data/fluentrobotics/**/*.csv
+data/fluentrobotics/**/*.mp4
+data/fluentrobotics/**/*.tar*
+data/fluentrobotics/**/*SUMS*
+data/fluentrobotics/**/rosbag2*

.vscode/settings.json

@@ -0,0 +1,13 @@
+{
+    "mypy-type-checker.importStrategy": "fromEnvironment",
+    "mypy-type-checker.preferDaemon": false,
+    "cSpell.languageSettings": [
+        {
+            "languageId": "python",
+            "includeRegExpList": [
+                "/#.*/",
+                "/('''|\"\"\")[^\\1]+?\\1/g"
+            ]
+        },
+    ]
+}

README.md

@@ -0,0 +1,91 @@
+# Implicit Communication in Human-Robot Collaborative Transport
+
+[![arxiv](https://img.shields.io/badge/Preprint-gray?logo=arxiv&labelColor=B31B1B)
+](https://arxiv.org/abs/2502.03346)
+[![dataset](<https://img.shields.io/badge/Dataset-gray?logo=dropbox&labelColor=0061FF>)](https://www.dropbox.com/scl/fo/ruzihfyim9n5wx3kcluc6/APV1wxgUifVPQnd12RSqjbo?rlkey=u1d4pdei9jruil1bl4j0fxkmf&st=1e7mman0&dl=0)
+[![video](https://img.shields.io/badge/Supplemental_Video-gray?logo=youtube&labelColor=ff0033)](https://youtu.be/0NTDrobSifg)
+
+## Requirements
+
+### Core
+
+* Python 3.10
+* Poetry package manager
+* ~10 GB disk space for Python packages
+
+### Extra Dependencies for Deployment and Data Analysis
+
+* ROS 2 Humble (Ubuntu 22.04)
+* GNU tar, zstd, and ~20 GB disk space for dataset
+
+## Setup
+
+### Core
+
+Install Python package dependencies to a virtual environment:
+
+```shell
+poetry install
+```
+
+Activate the virtual environment:
+
+```shell
+source .venv/bin/activate
+```
+
+### Dataset
+
+Download `rosbags.tar.zst` from the Dropbox Dataset link in this file's header into [`data/fluentrobotics`](data/fluentrobotics).
+
+Decompress the tar file:
+
+```shell
+cd data/fluentrobotics
+tar xf rosbags.tar.zst
+```
+
+## Repository Layout
+
+```text
+.
+├── data/
+│   └── fluentrobotics
+│       (Data files from our user study)
+│
+├── deployment_scripts/
+│   (Convenience scripts used during our user study)
+│
+├── src/
+│   ├── eleyng/
+│   │   └── table-carrying-ai/
+│   │       (3rd party code required for the VRNN baseline, see README.md in this folder)
+│   │
+│   └── fluentrobotics/
+│       └── icmpc_collab_transport/
+│           ├── core/
+│           │   (Implementation of the core inference algorithm)
+│           │
+│           ├── deployment/
+│           │   (ROS 2 nodes to run algorithms on a Hello Robot Stretch 2)
+│           │
+│           └── evaluation/
+│               (Modules to analyze and visualize data from our user study)
+│
+├── pyproject.toml
+│   (Specification file for Python package dependencies)
+│
+└── README.md
+    (📍 You are here)
+```
+
+## Citation
+
+```bibtex
+@article{yang2025implicit,
+  title={Implicit Communication in Human-Robot Collaborative Transport},
+  author={Yang, Elvin and Mavrogiannis, Christoforos},
+  journal={arXiv preprint arXiv:2502.03346},
+  year={2025}
+}
+```