Skip to content

zbhit123/driving-data-collection-reference-kit

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

37 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Driving Data Collection Reference kit

Our motivation for a data collection framework is to enable a community based effort to collect driving data. Challenges in the ecosystem are high cost and steep learning curve of technical know-how. A low cost off-the-shelf solution used as-is falls short to meet reliability, quality, performance and realtime requirements. There are several systems for real time data collection systems are quite prohibitive for a developing economy. To address this challenge, we have created a recipe for a reference hardware and the associated software framework which is scalable in performance and minimizes initial capital investment. Also, the stack is designed to achieve maximum throughput possible in a commercial automotive grade system with real time constraints.

For technical details, please refer to:

Johnny Jacob, Pankaj Rabha, "Driving data collection framework using low cost hardware" , Proc. of the AutoNUE Workshop, European Conference on Computer Vision (ECCV) 2018, http://cvit.iiit.ac.in/autonue2018/

Requisites

Hardware

  • Intel Core i5 7th Generation or above
  • 16 GB RAM
  • Minimum 2 TB SSD with 500+ MB/s write
  • Wifi
  • Ethernet
  • USB 3.0
  • USB 2.0
  • Ethernet Hub (Incase of using more than one host)
  • Powersupply

Typical Setup

A typical system implemented with these guidelines and software would look like this :

Typical Hardware Setup

In our setup, we used off-the-self parts :

Hardware setup mounted on a electric car

Software

Installation

Install a standard Ubuntu 16.04 on to the system. Incase you have plans to swap harddisks to copy data, we suggest you to use a USB thumb drive for OS installation.

Compiling

  1. Follow the instructions from http://wiki.ros.org/kinetic/Installation/Ubuntu to install ROS Kinetic

  2. Create a catkin workspace by following the steps below:

source /opt/ros/kinetic/setup.bash
mkdir -p <CATKIN_DIR_NAME>/src
cd <CATKIN_DIR>
catkin_make
  • Update CMakeLists.txt
sudo vim <CATKIN_DIR_NAME>/src/CMakeLists.txt
  • Add following the flags
SET(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -O2 -D_FORTIFY_SOURCE=2 -fstack-protector-strong -fPIE -fPIC -Wformat -Wformat-security")
SET(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -z noexecstack -z relro -z now") 
SET(CMAKE_MODULE_LINKER_FLAGS "${CMAKE_MODULE_LINKER_FLAGS} -z noexecstack -z relro -z now -pie")
SET(CMAKE_SHARED_LINKER_FLAGS "${CMAKE_SHARED_LINKER_FLAGS} -z noexecstack -z relro -z now -pie")
  1. Clone the source code for driving data collection ref kit. catkin_make would have written some files to the folder. Hence instead of git clone, we do a git init + git pull
cd ~/catkin_ws/src
git init . 
git remote add origin repository_url
git pull origin master
  1. Some of the sensors are taken as submodules in our repository,
  • Download all the submodules using
git submodule update --init --recursive'

Cameras: In case PtGrey cameras are used,

  • Camera needs Fly Capture SDK to be installed, download the SDK and install it.
  • Install libpcap
sudo apt-get install libpcap0.8-dev

Calibration:

  • swatbotics APRIL TAGS requires open cv to be installed seperately, Install latest version of opencv from : https://opencv.org/releases.html.
  • Lidar camera calibration and zed_cpu_ros are fetched as a git submodule.

CAN: If a Kvaser CAN transreciever is used,

  1. For Dashboard, please install the following:
  • Install mosuitto MQTT broker
apt-get install libmosquitto-dev mosquitto libmosquittopp-dev 
  • Install libjson
sudo apt-get install libjson0 libjson0-dev
  1. Start the built
catkin_make <CATKIN_DIR>

Configuration

Storage

Format SSD to use either XFS or BTrFS which gives a better write speed.

WiFi Hotspot for Dashboard

Wifi needs to be configured for hotspot to host the dashboard.

Distributed Data Collection

To setup multiple hosts for collecting data refer http://wiki.ros.org/ROS/NetworkSetup and http://wiki.ros.org/ROS/Tutorials/MultipleMachines

Capturing Data

Launch all the ROS nodes in all the hosts.

rosrecord <list of topics>

Post Processing

consolidate.py meta.bag

Design Considerations

To learn about design considerations, read docs/design.md .

Known Issues / Limitations

  • Only USB cameras are supported as of now.
  • Data from sensors are not tightly synchronised. This needs an external trigger.
  • Second stage processing takes longer time because of sequential writes for ROS bag.

LICENSE

BSD-3-Clause

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 49.3%
  • C++ 26.7%
  • HTML 11.0%
  • Python 9.2%
  • CMake 2.2%
  • CSS 1.6%