ai4mobile-industrial

Support code and documentation for the AI4Mobile industrial datasets: iV2V and iV2I+

https://github.com/fraunhoferhhi/ai4mobile-industrial

Science Score: 75.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 1 DOI reference(s) in README
  • Academic publication links
    Links to: ieee.org
  • Academic email domains
  • Institutional organization owner
    Organization fraunhoferhhi has institutional domain (www.hhi.fraunhofer.de)
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (14.5%) to scientific vocabulary
Last synced: 7 months ago · JSON representation ·

Repository

Support code and documentation for the AI4Mobile industrial datasets: iV2V and iV2I+

Basic Info
Statistics
  • Stars: 6
  • Watchers: 2
  • Forks: 0
  • Open Issues: 1
  • Releases: 0
Created about 3 years ago · Last pushed almost 2 years ago
Metadata Files
Readme License Citation

README.md

AI4Mobile Industrial Datasets

Pandas NumPy Jupyter

Download the datasets on IEEE Dataport

We provide 2 datasets: iV2V (industrial Vehicle-to-Vehicle) and iV2I+ (industrial Vehicular-to-Infrastructure + sensor). Both datasets provide information from several sources in different granularity. For ease of use, parquet files containing direct translations of the raw data are provided in respective sources folders.

In the following, an overview of the data is provided. For a detailed description of the measurement campaigns, please refer to the paper.

Requirements

We strongly recommend to work on Python with the following libraries:

Furthermore, we suggest some additional libraries to process and analyze the data, such as:

File overview

filetree

The following data is provided both for iV2V and iV2I+:

  1. A combined dataframe with selected features for direct usage, in parquet format.
  2. A compressed file *-sources.zip, with the different data sources transformed to individual parquet files.
  3. Several compressed files with the unedited raw data sources in their original file formats, as *-sources/raw/*.zip.
    • The bag files iV2Ip-sources/raw/sensors/*.bag constitute an exception, since they are already compressed and a single zip file with all of them would have a size of >250 GB.
  4. Metadata from all features in the combined dataframes, as *_info.csv

iV2V

iv2v

Quickstart

Head to the iV2V.parquet file, and load it in pandas to inspect the columns. Some general information on each column can be found in iV2V_info.csv

The dataframe contains information from the sidelink as extracted from RUDE and Crude, including:

  • time of arrival and signal strength measurements
  • the location of AGV1 within the test track
  • labels to identify source and destination AGVs.

Sidelink and location data have been matched on the epoch timestamps with a small error tolerance. The wall scenarios "A" and "B" are also provided as labels as noted down during the measurements.

Data Overview

Sources:

  1. RUDE & CRUDE for sidelink communication
  2. Localization data provided from the AGV's sensors.

Sidelink

The packets were transmitted roughly every 20 ms. This reference value, together with the provided timestamps, can serve as a basis to estimate packet error rate.

The sidelink data extracted from the incoming messages for any given AGV are provided as separate parquet files among the iV2V sources (e.g., sidelinkX_df.parquet with X the id of the AGV). For a detailed insight of the sidelink signal parameters, check the dataset publication or RUDE's documentation.

Localization

The AGV1 localization data is provided in .txt format as tab-separated-values containing the following fields:

  • Sidelink Epoch Time [sec] - As unix epoch timestamps
  • X-coordinate [m]
  • Y-coordinate [m]

The update period for the localization data is approximately 50 ms.

iV2I+

iv2ip

Quickstart

Head to the iV2Ip.parquet file, and load it in pandas to inspect the columns. Some general information on each column can be found in iV2Ip_info.csv

The dataframe contains:

  • radio data (RSRP, RSRQ, SINR, RSSI)
  • basic sensor data (x and y location, speed)
  • throughput and delay measurements
  • additional calculated features like the Line of Sight (LoS) or the cell load

Each source has a particular update period, so they all have been resampled to 1 second while merging. As a result, information loss can be expected.

For detailed information about the columns and information in higher resolution, read below.

Data Overview

Sources:

  1. MobileInsight
  2. TCP Dump
  3. Iperf
  4. Ping
  5. ROS sensor data

Except for the Sensor Data, all measurement software is Open Source and free of use.

MobileInsight

All information captured by MobileInsight from available LTE channels. The available information also depends on the modem of the measurement device.

The "rsintraall" file contains RSRP and RSRQ information in a resolution of 40 ms for the measurement campaign.

Alternatively, RSRP and RSRQ values were logged together with SNR and RSSI directly into the AGV-mounted mini PC every 200 ms as cellinfoyyyymmdd-HHMMSS.log. These logs are merged and available in the sources as "cell_df.parquet"

TCP Dump

TCP Dump is a packet analyzer that allows tracking transmitted packets and their properties (e.g. payload, size of the packet).

During the measurement campaign, TCP Dump was run on both server and the mini-PC which was attached to the AGV. This allows reconstructing e.g. the packet delay ( $P{server}-P{agv}$ or $P{agv}-P{server}$ for Uplink and Downlink, respectively). Since the time synchronization was not running consistently (max. break of 30 min), errors in the area of single-digit ms can be expected using this information.

The parquet files contain already information from both server and client side and each packet is listed with respective fields if it is either an ICMP, TCP or UDP packet. For the UDP packets also the delay between sending and receiving entity is included, as well as if a packet has arrived. The parquet files are split between Uplink and Downlink and also between the different days.

Iperf

Iperf is a speed test application that enables measuring the bandwidth and jitter of a UDP or TCP connection.

In the measurement campaign, Iperf was run on both a mini PC and server to receive throughput measurements with a granularity of 1s. For experiments that require high accuracy, it is recommended to use the TCP dump based information since the information was collected one time per second, but not at the beginning of each second.

Ping

Collected from the console command ping.

ROS sensor data

Sensor data was stored using ROS as .bag files, which can be read e.g. with the bagpy library in Python. An excerpt of the available information can be seen below.

| Topic | ROS message type | Update period | Description | |---------------------------|-------------------------------------|---------------|---------------------------------------------------------| | Map static elevation | nav_msgs/OccupancyGrid | - | Single precomputed map of the whole area | | Far map obstacles | nav_msgs/OccupancyGrid | 50 ms | 400 $\mathrm{m}^2$ obstacle map around the AGV | | Near map obstacles | nav_msgs/OccupancyGrid | 20 ms | 36 $\mathrm{m}^2$ obstacle map around the AGV | | Odometry | nav_msgs/Odometry | 10 ms | Sensor-fused position, orientation and speed of the AGV | | Inertial Measurement Unit | sensor_msgs/Imu | 10 ms | Conventional IMU data | | LIDAR | sensor_msgs/PointCloud2 | 100 ms | 3D point cloud with obstacles |

The static map and the odometry data are provided in the sources as "staticmap" and "rosdf", respectively, while the remaining information can be extracted from the original bag messages.

It is important to note that "Odometry" does not refer to pure wheel odometry but sensor-fused dead reckoning using other sensor sources, e.g., IMU. Within "ros_df", the odometry data has been downsampled to 40 ms (considering the AGV's low speed and update rate of the communication data) and extended with:

  • distancetobs: The distance to the base station, whose position was fixed to (9,9).
  • obstacles_sum: A summation of the obstacles for Line-of-Sight (LoS) estimation. For this, the elevation values above a small threshold lying within a Fresnel ellipse between AGV and base station were added together. The threshold here serves to neglect the grid values that account for ground.
  • lineofsight: A boolean estimate of LoS, obtained as the condition obstacles_sum < 1000 (The threshold value "1000" has been selected a posteriori).

These added fields are computed within odom_parser.py

Reference

Examples

For a complete code example to explore the datasets, check the Jupyter notebooks iV2Ip-visualize.ipynb and iV2V-visualize.ipynb.

jupyter-visuals

AI4Mobile

AI4Mobile is a research project funded by the Federal Ministry for Education and Research (BMBF), from the announcement Artificial Intelligence in Communication Networks within the scope of the High-Tech Strategy of the German Federal Government.

The scope of the project is the study of AI-aided wireless systems for mobility in industry and traffic. More information at ai4mobile.org.

Citation

If you use the dataset, please cite it as:

bibtex @article{hernangomez2024aienabled, title = {Toward an {{AI-Enabled Connected Industry}}: {{AGV Communication}} and {{Sensor Measurement Datasets}}}, shorttitle = {Toward an {{AI-Enabled Connected Industry}}}, author = {Hernang{\'o}mez, Rodrigo and Palaios, Alexandros and Watermann, Cara and Sch{\"a}ufele, Daniel and Geuer, Philipp and Ismayilov, Rafail and Parvini, Mohammad and Krause, Anton and Kasparick, Martin and Neugebauer, Thomas and {Ramos-Cantor}, Oscar D. and Tchouankem, Hugues and Calvo, Jose Leon and Chen, Bo and Fettweis, Gerhard and Sta{\'n}czak, S{\l}awomir}, year = {2024}, month = apr, journal = {IEEE Communications Magazine}, volume = {62}, number = {4}, eprint = {2301.03364}, primaryclass = {cs}, pages = {90--95}, issn = {1558-1896}, doi = {10.1109/MCOM.001.2300494}, copyright = {All rights reserved}, keywords = {Artificial intelligence,Computer Science - Artificial Intelligence,Computer Science - Machine Learning,Computer Science - Networking and Internet Architecture,Fingerprint recognition,Line-of-sight propagation,Quality of service,Robot sensing systems,Service robots,Vehicular ad hoc networks,Wireless communication,Wireless sensor networks} }

Project logos

Owner

  • Name: Fraunhofer HHI
  • Login: fraunhoferhhi
  • Kind: organization
  • Email: github@hhi.fraunhofer.de
  • Location: Berlin, Germany

Citation (CITATION.cff)

cff-version: 1.2.0
message: If you use this dataset, please cite it using the preferred-citation information.
type: dataset
license: CC0-1.0
title: "Support code and documentation for the AI4Mobile industrial datasets: iV2V and iV2I+."
doi: 10.21227/04ta-v128
abstract: "We provide 2 datasets: iV2V (industrial Vehicle-to-Vehicle) 
and iV2I+ (industrial Vehicular-to-Infrastructure + sensor).
Both datasets provide information from several sources in different granularity.
For ease of use, parquet files containing direct translations of the raw data
are provided in respective sources folders."
authors:
- family-names: Hernangómez
  given-names: Rodrigo
  orcid: https://orcid.org/0000-0002-1284-4951
  affiliation: Fraunhofer Heinrich Hertz Institute
- family-names: Palaios
  given-names: Alexandros
  affiliation: Ericsson Research
- family-names: Watermann
  given-names: Cara
  affiliation: Ericsson Research
- family-names: Schäufele
  given-names: Daniel
  affiliation: Fraunhofer Heinrich Hertz Institute
- family-names: Geuer
  given-names: Philipp
  affiliation: Ericsson Research
- family-names: Ismayilov
  given-names: Rafail
  affiliation: Fraunhofer Heinrich Hertz Institute
- family-names: Parvini
  given-names: Mohammad
  affiliation: Vodafone Chair, Technische Universität Dresden
- family-names: Krause
  given-names: Anton
  affiliation: Vodafone Chair, Technische Universität Dresden
- family-names: Kasparick
  given-names: Martin
  affiliation: Fraunhofer Heinrich Hertz Institute
- family-names: Neugebauer
  given-names: Thomas
  affiliation: Götting KG
- family-names: Ramos-Cantor
  given-names: Oscar D.
  affiliation: Robert Bosch GmbH
- family-names: Tchouankem
  given-names: Hugues
  affiliation: Robert Bosch GmbH
- family-names: Leon Calvo
  given-names: Jose
  affiliation: Ericsson Research
- family-names: Chen
  given-names: Bo
  affiliation: Enway GmbH
- family-names: Fettweis
  given-names: Gerhard
  affiliation: Vodafone Chair, Technische Universität Dresden
- family-names: Stanczak
  given-names: Slawomir
  affiliation: Fraunhofer Heinrich Hertz Institute
preferred-citation:
  type: article
  title: 'Toward an AI-enabled Connected Industry:
  AGV Communication and Sensor Measurement Datasets'
  abstract: 'This paper presents two wireless measurement
  campaigns in industrial testbeds: industrial Vehicle-to-vehicle (iV2V)
  and industrial Vehicle-to-infrastructure plus Sensor (iV2I+).
  Detailed information about the two captured datasets is provided as well.
  iV2V covers sidelink communication scenarios between Automated Guided Vehicles (AGVs),
  while iV2I+ is conducted at an industrial setting where an autonomous cleaning
  robot is connected to a private cellular network. The combination of
  different communication technologies, together with a common measurement methodology,
  provides insights that can be exploited by Machine Learning (ML) for tasks
  such as fingerprinting, line-of-sight detection, prediction of quality of service
  or link selection. Moreover, the datasets are labelled and pre-filtered for fast
  on-boarding and applicability. The corresponding testbeds and measurements
  are also presented in detail for both datasets.'
  authors:
    - family-names: Hernangómez
      given-names: Rodrigo
      orcid: https://orcid.org/0000-0002-1284-4951
      affiliation: Fraunhofer Heinrich Hertz Institute
    - family-names: Palaios
      given-names: Alexandros
      affiliation: Ericsson Research
    - family-names: Watermann
      given-names: Cara
      affiliation: Ericsson Research
    - family-names: Schäufele
      given-names: Daniel
      affiliation: Fraunhofer Heinrich Hertz Institute
    - family-names: Geuer
      given-names: Philipp
      affiliation: Ericsson Research
    - family-names: Ismayilov
      given-names: Rafail
      affiliation: Fraunhofer Heinrich Hertz Institute
    - family-names: Parvini
      given-names: Mohammad
      affiliation: Vodafone Chair, Technische Universität Dresden
    - family-names: Krause
      given-names: Anton
      affiliation: Vodafone Chair, Technische Universität Dresden
    - family-names: Kasparick
      given-names: Martin
      affiliation: Fraunhofer Heinrich Hertz Institute
    - family-names: Neugebauer
      given-names: Thomas
      affiliation: Götting KG
    - family-names: Ramos-Cantor
      given-names: Oscar D.
      affiliation: Robert Bosch GmbH
    - family-names: Tchouankem
      given-names: Hugues
      affiliation: Robert Bosch GmbH
    - family-names: Leon Calvo
      given-names: Jose
      affiliation: Ericsson Research
    - family-names: Chen
      given-names: Bo
      affiliation: Enway GmbH
    - family-names: Fettweis
      given-names: Gerhard
      affiliation: Vodafone Chair, Technische Universität Dresden
    - family-names: Stanczak
      given-names: Slawomir
      affiliation: Fraunhofer Heinrich Hertz Institute
  year: '2024'
  month: '4'
  journal: IEEE Communications Magazine
  volume: 62
  issue: 4
  pages: '90-95'
  issn: '1558-1896'
  doi: 10.1109/MCOM.001.2300494
  keywords:
  - Artificial intelligence
  - Computer Science - Artificial Intelligence
  - Computer Science - Machine Learning
  - Computer Science - Networking and Internet Architecture
  - Fingerprint recognition
  - Line-of-sight propagation
  - Quality of service
  - Robot sensing systems
  - Service robots
  - Vehicular ad hoc networks
  - Wireless communication
  - Wireless sensor networks
repository: https://ieee-dataport.org/open-access/ai4mobile-industrial-wireless-datasets-iv2v-and-iv2i
repository-code: https://github.com/fraunhoferhhi/ai4mobile-industrial
url: https://www.ai4mobile.org/en/
identifiers:
- description: Paper DOI
  type: doi
  value: 10.1109/MCOM.001.2300494

GitHub Events

Total
  • Issues event: 1
  • Watch event: 2
Last Year
  • Issues event: 1
  • Watch event: 2