Mitigating RF Jamming Attacks at the Physical Layer with Machine Learning Dataset

Data files were used in support of the research paper titled “Mitigating RF Jamming Attacks at the Physical Layer with Machine Learning" which has been submitted to the IET Communications journal.

---------------------------------------------------------------------------------------------

All data was collected using the SDR implementation shown here: https://github.com/mainland/dragonradio/tree/iet-paper. Particularly for antenna state selection, the files developed for this paper are located in 'dragonradio/scripts/:'

• 'ModeSelect.py': class used to defined the antenna state selection algorithm
• 'standalone-radio.py': SDR implementation for normal radio operation with reconfigurable antenna
• 'standalone-radio-tuning.py': SDR implementation for hyperparameter tunning
• 'standalone-radio-onmi.py': SDR implementation for omnidirectional mode only

---------------------------------------------------------------------------------------------

Authors: Marko Jacovic, Xaime Rivas Rey, Geoffrey Mainland, Kapil R. Dandekar
Contact: krd26@drexel.edu

---------------------------------------------------------------------------------------------

Top-level directories and content will be described below. Detailed descriptions of experiments performed are provided in the paper.

---------------------------------------------------------------------------------------------

classifier_training: files used for training classifiers that are integrated into SDR platform

• 'logs-8-18' directory contains OTA SDR collected log files for each jammer type and under normal operation (including congested and weaklink states)
• 'classTrain.py' is the main parser for training the classifiers
• 'trainedClassifiers' contains the output classifiers generated by 'classTrain.py'

post_processing_classifier: contains logs of online classifier outputs and processing script

• 'class' directory contains .csv logs of each RTE and OTA experiment for each jamming and operation scenario
• 'classProcess.py' parses the log files and provides classification report and confusion matrix for each multi-class and binary classifiers for each observed scenario - found in 'results->classifier_performance'

post_processing_mgen: contains MGEN receiver logs and parser

• 'configs' contains JSON files to be used with parser for each experiment
• 'mgenLogs' contains MGEN receiver logs for each OTA and RTE experiment described. Within each experiment logs are separated by 'mit' for mitigation used, 'nj' for no jammer, and 'noMit' for no mitigation technique used. File names take the form *_cj_* for constant jammer, *_pj_* for periodic jammer, *_rj_* for reactive jammer, and *_nj_* for no jammer. Performance figures are found in 'results->mitigation_performance'

ray_tracing_emulation: contains files related to Drexel area, Art Museum, and UAV Drexel area validation RTE studies.

• Directory contains detailed 'readme.txt' for understanding.
• Please note: the processing files and data logs present in 'validation' folder were developed by Wolfe et al. and should be cited as such, unless explicitly stated differently. 
  • S. Wolfe, S. Begashaw, Y. Liu and K. R. Dandekar, "Adaptive Link Optimization for 802.11 UAV Uplink Using a Reconfigurable Antenna," MILCOM 2018 - 2018 IEEE Military Communications Conference (MILCOM), 2018, pp. 1-6, doi: 10.1109/MILCOM.2018.8599696.

results: contains results obtained from study

• 'classifier_performance' contains .txt files summarizing binary and multi-class performance of online SDR system. Files obtained using 'post_processing_classifier.'
• 'mitigation_performance' contains figures generated by 'post_processing_mgen.'
• 'validation' contains RTE and OTA performance comparison obtained by 'ray_tracing_emulation->validation->matlab->outdoor_hover_plots.m'

tuning_parameter_study: contains the OTA log files for antenna state selection hyperparameter study

• 'dataCollect' contains a folder for each jammer considered in the study, and inside each folder there is a CSV file corresponding to a different configuration of the learning parameters of the reconfigurable antenna. The configuration selected was the one that performed the best across all these experiments and is described in the paper.
• 'data_summary.txt'this file contains the summaries from all the CSV files for convenience.