Structure of code/data folders and how to use them

fastzip-code

• Contains codebase to generate results in fastzip-results folder
• Individual notebooks contain comments on their functionality/how to use them
• FastZIP-Resample.ipynb (optional)
  • Resamples the collected sensor data to desired sampling rates (eliminates the effect of sampling rate instability/drift)
  • Input: fastzip-data/exp-X/raw
  • Output: fastzip-data/exp-X/adv and fastzip-data/exp-X/non-adv
• FastZIP-Process.ipynb
  • Computes error rates for adversarial and benign devices in different configurations, generates binary fingerprints (see comments inside the notebook)
  • Input: fastzip-data/exp-X/adv and fastzip-data/exp-X/non-adv
  • Output: fastzip-results/logs and fastzip-results/fps
• FastZIP-Results.ipynb
  • Parses and caches results generated by FastZIP-Process.ipynb notebook to be used for plotting and data analysis
  • Input: fastzip-results/logs and fastzip-results/fps
  • Output: fastzip-results/cache
• The system paths that are used by all notebooks are set in fastzip-code/const/globconst.py --> adjust them before running the code!
• Uses folder fastzip-data as input
• Uses folder fastzip-results as output
• The above notebooks were run using Python 3.6.5 on Ubuntu 18.04.5 LTS bionic (x64)
• The list of python packages with versions installed on the test machine is in fastzip-code/python3-packages.txt

fastzip-data

• Contains sensor data collected from multiple devices in running/stationary cars in various conditions (e.g., in a city, etc.) from three experiments: exp-3, exp-4, and exp-5
• Each exp-X folder has the same structure:
  • adv - sensor data collected when two cars drive one after another
  • non-adv - sensor when two cars drive the same route but not one after another
  • In adv and non-adv the sensor data is resampled (see description of FastZIP-Resample.ipynb )
  • raw - sensor data collected in the experiment before resampling or split into adv and non-adv

fastzip-min_entropy

• Contains input and evaluation results for min-entropy estimation of our generated fingerprints using NIST SP 800 90B tests
• See README inside the folder for more detail

fastzip-results

• Results in json or json.gz formats generated by FastZIP-Process.ipynb and FastZIP-Results.ipynb
• See comments in these notebooks for the type of results stored in folders inside fastzip-results

fpake

• Contains the implementation of the fPAKE protocol as well as input and output for its benchmarking
• See README inside the folder for more detail