klb2 / ris-phase-hopping

This repository is accompanying the papers "Artificial Fast Fading from Reconfigurable Surfaces Enables Ultra-Reliable Communications" (SPAWC 2021), "RIS-Assisted Statistical Channel Shaping for Ultra-High Reliability" (WSA 2021), and "Reconfigurable Intelligent Surface Phase Hopping for Ultra-Reliable Communications" (TWC, DOI:10.1109/TWC.2022.3172760).

RIS Phase Hopping for Ultra-Reliable Communications

This repository is accompanying the papers "Artificial Fast Fading from Reconfigurable Surfaces Enables Ultra-Reliable Communications" (Eduard Jorswieck, Karl-L. Besser, and Cong Sun. IEEE SPAWC 2021, doi:10.1109/SPAWC51858.2021.9593269), "RIS-Assisted Statistical Channel Shaping for Ultra-High Reliability" (Karl-L. Besser and Eduard Jorswieck. WSA 2021, IEEExplore), and "Reconfigurable Intelligent Surface Phase Hopping for Ultra-Reliable Communications" (Karl-L. Besser and Eduard Jorswieck, IEEE Transactions on Wireless Communications, vol. 21, no. 11, pp. 9082–9095, Nov 2022. doi:10.1109/TWC.2022.3172760, arXiv:2107.11852).

The idea is to give an interactive version of the calculations and presented concepts to the reader. One can also change different parameters and explore different behaviors on their own.

The material for the conference paper can be found on the spawc branch. The master branch contains the scripts for the journal version.

File List

The following files are provided in this repository:

• RIS Simulation.ipynb: Jupyter notebook that contains an interactive version of the simulations.
• run.sh: Bash script that reproduces the figures presented in the paper.
• constant_phases.py: Python script that runs the simulations for constant RIS phases.
• random_phases.py: Python script that runs the simulations for randomly varying RIS phases.
• discrete_phases.py: Python script that runs the simulations for randomly varying RIS phases with only a discrete set of possible phase values.
• ergodic_capacity.py: Python script that calculates the ergodic capacities for phase hopping systems with different numbers of elements.
• phases.py: Python module that contains helper functions to generate the RIS phases according to the different scenarios.

Usage

Running it online

The easiest way is to use services like Binder to run the notebook online. Simply navigate to https://mybinder.org/v2/gh/klb2/ris-phase-hopping/HEAD to run the notebooks in your browser without setting everything up locally.

Local Installation

If you want to run it locally on your machine, Python3 and Jupyter are needed. The present code was developed and tested with the following versions:

• Python 3.9
• Jupyter 1.0
• numpy 1.20
• scipy 1.6

Make sure you have Python3 installed on your computer. You can then install the required packages (including Jupyter) by running

pip3 install -r requirements.txt
jupyter nbextension enable --py widgetsnbextension

This will install all the needed packages which are listed in the requirements file. The second line enables the interactive controls in the Jupyter notebooks.

Finally, you can run the Jupyter notebooks with

jupyter notebook

You can also recreate the figures from the paper by running

bash run.sh

Acknowledgements

This research was supported in part by the Deutsche Forschungsgemeinschaft (DFG) under grant JO 801/23-1.

License and Referencing

This program is licensed under the GPLv3 license. If you in any way use this code for research that results in publications, please cite our original article listed above.

You can use the following BibTeX entry

@article{Besser2022phasehopping,
  title = {Reconfigurable Intelligent Surface Phase Hopping for Ultra-Reliable Communications},
  author = {Besser, Karl-Ludwig and Jorswieck, Eduard A.},
  journal = {IEEE Transactions on Wireless Communications},
  year = {2022},
  month = {11},
  volume = {21},
  number = {11},
  pages = {9082--9095},
  doi = {10.1109/TWC.2022.3172760},
  archiveprefix = {arXiv},
  eprint = {2107.11852},
  primaryClass = {cs.IT},
}