to use the software, please follow the setup steps:

  0. set up a Python virtual environment and install pip: https://packaging.python.org/en/latest/guides/installing-using-pip-and-virtual-environments/
  1. install dependencies: python -m pip install -r requirements.txt
  2. build extensions: ./build.sh

to use the simulator:
  cd python
  python main.py 10 simulate bits_y_multi_gaussian 1.0 1.0

  This will simulate leakages of individual bits of y following multivariate
  normal distributions, with noise level (the standard deviation) 1.0 for both
  bit=0 and bit=1 at each POI, collected from 10 signatures, and recover the
  secret key component s1 from the leakages.

to launch the physical attack:
  cd python
  python main.py 300 --filter 0.15 load_zarr --file $PATH_TO_TRACE_ZARR bits_y_ext

  This will apply filtering level 0.15 on the equations derived from the
  traces, and recover the secret key component s1.