Skip to content

usnistgov/PS-002-WALDO

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PS-002 WALDO (Wireless Artificial intelligence Location DetectiOn)), we finally know where you are: sensing using mmWave communications and ML.

Software and dataset resource for ITU AI/ML 5G Challenge. To register to the challenge, please visit https://challenge.aiforgood.itu.int/match/matchitem/38.

Table of Contents

Installation

The software does not require any installation procedure: simply download or clone the repository to your local folders.

Requirements

The codebase to generate the dataset is written in MATLAB. It is currently being tested on MATLAB R2020b. No toolboxes are needed to run the code.

The dataset has been alredy generated and it can be downloaded directly (see Download Dataset)

Download dataset

The dataset is available to download at https://data.nist.gov/od/id/mds2-2417. There are two options to generate the received signals, which need to be used as the input of ITU AI/ML 5G Challenge.

  • Option 1: download the received signals dataset, which has been already generated.

    • Execute the matlab script dataset/downloadDataset.m or the phyton script dataset/downloadDataset.py
    • A menu will display multiple download options: enter S to download the received signals.
      There are 46738 files in the dataset with a total size of 850 GB. The download might take long time depending on the network and local storage speed. A progress percentage reports the download status.
    • The received signals are downloaded in dataset\rxSignal.
  • Option 2: download channel data and generate received signals.

    • Execute the matlab script dataset/downloadDataset.m or the phyton script dataset/downloadDataset.py
    • A menu will display multiple download options: enter C to download the received signals.
      There are 15582 files in the dataset with a total size of 395 GB. The download might take long time depending on the network and local storage speed. A progress percentage reports the download status.
    • When the download is completed, execute the script receivedSignalGeneration/scriptGenerateRxSig.m. The script is generating a transmit signal, pass it trough the downloaded channels and add AWGN noise. The received signals are stored in dataset\rxSignal.

To download the validation dataset:

  • Execute the matlab script dataset/downloadDataset.m or the phyton script dataset/downloadDataset.py
    • A menu will display multiple download options: enter V to download the received signals. In case of problems in downloading the validation dataset, please send an email to the authors.

Contributing

Feedbacks and additions are more than welcomed! You can directly contact the authors for any information.

Authors

NIST picture

The WALDO challenge has been designed at NIST by Steve Blandino (steve.blandino@nist.gov), Raied Caromi (raied.caromi@nist.gov) and Tanguy Ropitault (tanguy.ropitault@nist.gov).

License

Please refer to the LICENSE file for more information.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published