Published February 2, 2024 | Version 0.0.1
Software documentation Open

A Middle Way to Traffic Enlightenment: Repeatability Evaluation Package

Description

Our repeatability evaluation package includes data, python notebooks for recreating our quantitative figures, and a docker
image to playback the recorded ROS bag file simulating the ROS message passing network. If you have never used these
before, install the proper resources on your machine here:
Docker Install: https://docs.docker.com/engine/install/
Jupyter Install: https://jupyter.org/install
A. File Resources
You can find the relevant files here at Zenodo.
B. Docker Image
The Docker image provides a ROS integration to automatically perform a realtime replay the rosbag file from the experiment.
To replay the data, navigate to the docker/ directory, then build and run with the following commands:
$ docker build -t middleway .
$ docker run -it middleway
The Docker container invokes its own roscore, so external ROS systems may connect to the container as a ROS host to
view and analyze ROS topics. Alternatively, The container can connect to an external ROS host by connecting to the container
with bash, then manually configure the host and manually perform the rosbag play:
$ docker build -t middleway .
$ docker run -it middleway bash
$ export ROS_MASTER_URI="http://<external hostname or IP>:11311"
$ rosbag play 2023_10_23_11_13_42_2T3MWRFVXLW056972cbf_codegen_test.bag
C. Reproducing Figures
Inside the Zenodo resource, there are seveal `.ipynb’ jupyter notebook files. Download the main .zip for all the data and code. Directories are segmented based on figures created. Inside the directory, you will find a notebook titled "FigureXXX" with the code to run to recreate figures. Once you open the notebook in Jupyter, you will be able to run a series of small cells with python scripts which will recreate the figures in the paper with the data files inside the folders.

Files

ICCPS_MiddleWay_code.zip

Files (782.5 MB)

Name Size Download all
md5:c416cb20e54cb382dd58788a6469091c
859 Bytes Download
md5:e690dba72eb98a98147b0de73690e488
782.5 MB Preview Download
md5:38091dbb8e8b8beb4748257c3f1b6c1a
134 Bytes Download

Additional details

Funding

Collaborative Research: CPS: Frontier: Computation-Aware Algorithmic Design for Cyber-Physical Systems 2111688
U.S. National Science Foundation
CPS: TTP Option: Medium: Coordinating Actors via Learning for Lagrangian Systems (CALLS) 2135579
U.S. National Science Foundation
Dwight D. Eisenhower Fellowship 693JJ32345023
United States Department of Transportation