update examples for Google Colab.

Signed-off-by: The Sionna Team <[email protected]> Merged-by: Guillermo Marcus <[email protected]> Co-authored-by: Jakob Hoydis <[email protected]> Co-authored-by: Fayçal Ait-Aoudia <[email protected]> Co-authored-by: Sebastian Cammerer <[email protected]> Co-authored-by: Guillermo Marcus <[email protected]> Co-authored-by: Merlin Nimier-David <[email protected]> Co-authored-by: Lorenzo Maggi <[email protected]>
NVlabs · Oct 1, 2024 · 0aeca34 · 0aeca34
1 parent 6a85e1c
commit 0aeca34
Show file tree

Hide file tree

Showing 27 changed files with 285 additions and 160 deletions.
diff --git a/doc/source/made_with_sionna.rst b/doc/source/made_with_sionna.rst
@@ -6,6 +6,14 @@ We love to see how Sionna is used by other researchers! For this reason, you fin
 
 If you want your paper/project and code be listed here, please send an email to `[email protected] <mailto:[email protected]>`_ with links to the paper (e.g., `arXiv <https://arxiv.org>`_) and code repository (e.g., `GitHub <https://github.com>`_).
 
+.. made-with-sionna::
+    :title: Physically Consistent RIS: From Reradiation Mode Optimization to Practical Realization
+    :authors: Javad Shabanpour, Constantin Simovski, Giovanni Geraci
+    :year: 2024
+    :version: 0.18
+    :link_arxiv: https://arxiv.org/abs/2409.17738
+    :abstract: We propose a practical framework for designing a physically consistent reconfigurable intelligent surface (RIS) to overcome the inefficiency of the conventional phase gradient approach. For a section of Cape Town and across three different coverage enhancement scenarios, we optimize the amplitude of the RIS reradiation modes using Sionna ray tracing and a gradient-based learning technique. We then determine the required RIS surface/sheet impedance given the desired amplitudes for the reradiation modes, design the corresponding unitcells, and validate the performance through full-wave numerical simulations using CST Microwave Studio. We further validate our approach by fabricating a RIS using the parallel plate waveguide technique and conducting experimental measurements that align with our theoretical predictions.
+
 .. made-with-sionna::
     :title: Design of a Standard-Compliant Real-Time Neural Receiver for 5G NR
     :authors: Reinhard Wiesmayr, Sebastian Cammerer, Fayçal Aït Aoudia, Jakob Hoydis, Jakub Zakrzewski, Alexander Keller

diff --git a/examples/5G_Channel_Coding_Polar_vs_LDPC_Codes.ipynb b/examples/5G_Channel_Coding_Polar_vs_LDPC_Codes.ipynb
@@ -95,6 +95,18 @@
     "    os.system(\"pip install sionna\")\n",
     "    import sionna\n",
     "\n",
+    "import tensorflow as tf\n",
+    "# Configure the notebook to use only a single GPU and allocate only as much memory as needed\n",
+    "# For more details, see https://www.tensorflow.org/guide/gpu\n",
+    "gpus = tf.config.list_physical_devices('GPU')\n",
+    "if gpus:\n",
+    "    try:\n",
+    "        tf.config.experimental.set_memory_growth(gpus[0], True)\n",
+    "    except RuntimeError as e:\n",
+    "        print(e)\n",
+    "# Avoid warnings from TensorFlow\n",
+    "tf.get_logger().setLevel('ERROR')\n",
+    "\n",
     "# Set random seed for reproducibility\n",
     "sionna.config.seed = 42\n",
     "\n",

diff --git a/examples/5G_NR_PUSCH.ipynb b/examples/5G_NR_PUSCH.ipynb
@@ -81,6 +81,18 @@
     "    os.system(\"pip install sionna\")\n",
     "    import sionna\n",
     "\n",
+    "import tensorflow as tf\n",
+    "# Configure the notebook to use only a single GPU and allocate only as much memory as needed\n",
+    "# For more details, see https://www.tensorflow.org/guide/gpu\n",
+    "gpus = tf.config.list_physical_devices('GPU')\n",
+    "if gpus:\n",
+    "    try:\n",
+    "        tf.config.experimental.set_memory_growth(gpus[0], True)\n",
+    "    except RuntimeError as e:\n",
+    "        print(e)\n",
+    "# Avoid warnings from TensorFlow\n",
+    "tf.get_logger().setLevel('ERROR')\n",
+    "\n",
     "sionna.config.seed = 42 # Set seed for reproducible results\n",
     "\n",
     "# Load the required Sionna components\n",

diff --git a/examples/Autoencoder.ipynb b/examples/Autoencoder.ipynb
@@ -109,6 +109,21 @@
     "    os.system(\"pip install sionna\")\n",
     "    import sionna\n",
     "\n",
+    "# Configure the notebook to use only a single GPU and allocate only as much memory as needed\n",
+    "# For more details, see https://www.tensorflow.org/guide/gpu\n",
+    "import tensorflow as tf\n",
+    "gpus = tf.config.list_physical_devices('GPU')\n",
+    "if gpus:\n",
+    "    try:\n",
+    "        tf.config.experimental.set_memory_growth(gpus[0], True)\n",
+    "    except RuntimeError as e:\n",
+    "        print(e)\n",
+    "# Avoid warnings from TensorFlow\n",
+    "tf.get_logger().setLevel('ERROR')\n",
+    "\n",
+    "from tensorflow.keras import Model\n",
+    "from tensorflow.keras.layers import Layer, Dense\n",
+    "\n",
     "from sionna.channel import AWGN\n",
     "from sionna.utils import BinarySource, ebnodb2no, log10, expand_to_rank, insert_dims\n",
     "from sionna.fec.ldpc.encoding import LDPC5GEncoder\n",

diff --git a/examples/Bit_Interleaved_Coded_Modulation.ipynb b/examples/Bit_Interleaved_Coded_Modulation.ipynb
@@ -79,6 +79,15 @@
     "    os.environ[\"CUDA_VISIBLE_DEVICES\"] = f\"{gpu_num}\"\n",
     "os.environ['TF_CPP_MIN_LOG_LEVEL'] = '3'\n",
     "\n",
+    "# Import Sionna\n",
+    "try:\n",
+    "    import sionna\n",
+    "except ImportError as e:\n",
+    "    # Install Sionna if package is not already installed\n",
+    "    import os\n",
+    "    os.system(\"pip install sionna\")\n",
+    "    import sionna\n",
+    "\n",
     "# Configure the notebook to use only a single GPU and allocate only as much memory as needed\n",
     "# For more details, see https://www.tensorflow.org/guide/gpu\n",
     "import tensorflow as tf\n",
@@ -95,15 +104,6 @@
     "import matplotlib.pyplot as plt\n",
     "import numpy as np\n",
     "\n",
-    "# Import Sionna\n",
-    "try:\n",
-    "    import sionna\n",
-    "except ImportError as e:\n",
-    "    # Install Sionna if package is not already installed\n",
-    "    import os\n",
-    "    os.system(\"pip install sionna\")\n",
-    "    import sionna\n",
-    "\n",
     "# Load the required Sionna components\n",
     "from sionna.mapping import Constellation, Mapper, Demapper\n",
     "from sionna.fec.ldpc import LDPC5GEncoder, LDPC5GDecoder, LDPCBPDecoder\n",

diff --git a/examples/CIR_Dataset.ipynb b/examples/CIR_Dataset.ipynb
@@ -49,6 +49,15 @@
     "    os.environ[\"CUDA_VISIBLE_DEVICES\"] = f\"{gpu_num}\"\n",
     "os.environ['TF_CPP_MIN_LOG_LEVEL'] = '3'\n",
     "\n",
+    "# Import Sionna\n",
+    "try:\n",
+    "    import sionna\n",
+    "except ImportError as e:\n",
+    "    # Install Sionna if package is not already installed\n",
+    "    import os\n",
+    "    os.system(\"pip install sionna\")\n",
+    "    import sionna\n",
+    "\n",
     "# Configure the notebook to use only a single GPU and allocate only as much memory as needed\n",
     "# For more details, see https://www.tensorflow.org/guide/gpu\n",
     "import tensorflow as tf\n",
@@ -61,16 +70,6 @@
     "# Avoid warnings from TensorFlow\n",
     "tf.get_logger().setLevel('ERROR')\n",
     "\n",
-    "\n",
-    "# Import Sionna\n",
-    "try:\n",
-    "    import sionna\n",
-    "except ImportError as e:\n",
-    "    # Install Sionna if package is not already installed\n",
-    "    import os\n",
-    "    os.system(\"pip install sionna\")\n",
-    "    import sionna\n",
-    "\n",
     "import numpy as np\n",
     "import h5py\n",
     "\n",

diff --git a/examples/DeepMIMO.ipynb b/examples/DeepMIMO.ipynb
@@ -49,6 +49,15 @@
     "    os.environ[\"CUDA_VISIBLE_DEVICES\"] = f\"{gpu_num}\"\n",
     "os.environ['TF_CPP_MIN_LOG_LEVEL'] = '3'\n",
     "\n",
+    "# Import Sionna\n",
+    "try:\n",
+    "    import sionna\n",
+    "except ImportError as e:\n",
+    "    # Install Sionna if package is not already installed\n",
+    "    import os\n",
+    "    os.system(\"pip install sionna\")\n",
+    "    import sionna\n",
+    "\n",
     "# Configure the notebook to use only a single GPU and allocate only as much memory as needed\n",
     "# For more details, see https://www.tensorflow.org/guide/gpu\n",
     "import tensorflow as tf\n",
@@ -61,15 +70,6 @@
     "# Avoid warnings from TensorFlow\n",
     "tf.get_logger().setLevel('ERROR')\n",
     "\n",
-    "# Import Sionna\n",
-    "try:\n",
-    "    import sionna\n",
-    "except ImportError as e:\n",
-    "    # Install Sionna if package is not already installed\n",
-    "    import os\n",
-    "    os.system(\"pip install sionna\")\n",
-    "    import sionna\n",
-    "\n",
     "sionna.config.seed = 42 # Set seed for reproducible random number generation"
    ]
   },

diff --git a/examples/Evolution_of_FEC.ipynb b/examples/Evolution_of_FEC.ipynb
@@ -72,6 +72,19 @@
     "    os.system(\"pip install sionna\")\n",
     "    import sionna\n",
     "\n",
+    "# Configure the notebook to use only a single GPU and allocate only as much memory as needed\n",
+    "# For more details, see https://www.tensorflow.org/guide/gpu\n",
+    "import tensorflow as tf\n",
+    "gpus = tf.config.list_physical_devices('GPU')\n",
+    "if gpus:\n",
+    "    try:\n",
+    "        tf.config.experimental.set_memory_growth(gpus[0], True)\n",
+    "    except RuntimeError as e:\n",
+    "        print(e)\n",
+    "\n",
+    "# Avoid warnings from TensorFlow\n",
+    "tf.get_logger().setLevel('ERROR')\n",
+    "\n",
     "sionna.config.seed = 42 # Set seed for reproducible random number generation\n",
     "\n",
     "# Load the required Sionna components\n",

diff --git a/examples/Introduction_to_Iterative_Detection_and_Decoding.ipynb b/examples/Introduction_to_Iterative_Detection_and_Decoding.ipynb
@@ -116,6 +116,17 @@
     "    os.system(\"pip install sionna\")\n",
     "    import sionna\n",
     "\n",
+    "import tensorflow as tf\n",
+    "from tensorflow.keras import Model\n",
+    "gpus = tf.config.list_physical_devices('GPU')\n",
+    "if gpus:\n",
+    "    try:\n",
+    "        tf.config.experimental.set_memory_growth(gpus[0], True)\n",
+    "    except RuntimeError as e:\n",
+    "        print(e)\n",
+    "# Avoid warnings from TensorFlow\n",
+    "tf.get_logger().setLevel('ERROR')\n",
+    "\n",
     "%matplotlib inline\n",
     "import matplotlib.pyplot as plt\n",
     "import numpy as np\n",

diff --git a/examples/MIMO_OFDM_Transmissions_over_CDL.ipynb b/examples/MIMO_OFDM_Transmissions_over_CDL.ipynb
@@ -116,15 +116,6 @@
     "        print(e)\n",
     "tf.get_logger().setLevel('ERROR')\n",
     "\n",
-    "# Import Sionna\n",
-    "try:\n",
-    "    import sionna\n",
-    "except ImportError as e:\n",
-    "    # Install Sionna if package is not already installed\n",
-    "    import os\n",
-    "    os.system(\"pip install sionna\")\n",
-    "    import sionna\n",
-    "\n",
     "# Set random seed for reproducibility\n",
     "sionna.config.seed = 42"
    ]

diff --git a/examples/Neural_Receiver.ipynb b/examples/Neural_Receiver.ipynb
@@ -88,6 +88,15 @@
     "    os.environ[\"CUDA_VISIBLE_DEVICES\"] = f\"{gpu_num}\"\n",
     "os.environ['TF_CPP_MIN_LOG_LEVEL'] = '3'\n",
     "\n",
+    "# Import Sionna\n",
+    "try:\n",
+    "    import sionna\n",
+    "except ImportError as e:\n",
+    "    # Install Sionna if package is not already installed\n",
+    "    import os\n",
+    "    os.system(\"pip install sionna\")\n",
+    "    import sionna\n",
+    "\n",
     "# Configure the notebook to use only a single GPU and allocate only as much memory as needed\n",
     "# For more details, see https://www.tensorflow.org/guide/gpu\n",
     "import tensorflow as tf\n",
@@ -100,15 +109,6 @@
     "# Avoid warnings from TensorFlow\n",
     "tf.get_logger().setLevel('ERROR')\n",
     "\n",
-    "# Import Sionna\n",
-    "try:\n",
-    "    import sionna\n",
-    "except ImportError as e:\n",
-    "    # Install Sionna if package is not already installed\n",
-    "    import os\n",
-    "    os.system(\"pip install sionna\")\n",
-    "    import sionna\n",
-    "\n",
     "sionna.config.seed = 42 # Set seed for reproducible random number generation"
    ]
   },

diff --git a/examples/OFDM_MIMO_Detection.ipynb b/examples/OFDM_MIMO_Detection.ipynb
@@ -121,6 +121,15 @@
     "    os.environ[\"CUDA_VISIBLE_DEVICES\"] = f\"{gpu_num}\"\n",
     "os.environ['TF_CPP_MIN_LOG_LEVEL'] = '3'\n",
     "\n",
+    "# Import Sionna\n",
+    "try:\n",
+    "    import sionna\n",
+    "except ImportError as e:\n",
+    "    # Install Sionna if package is not already installed\n",
+    "    import os\n",
+    "    os.system(\"pip install sionna\")\n",
+    "    import sionna\n",
+    "\n",
     "# Configure the notebook to use only a single GPU and allocate only as much memory as needed\n",
     "# For more details, see https://www.tensorflow.org/guide/gpu\n",
     "import tensorflow as tf\n",
@@ -133,15 +142,6 @@
     "# Avoid warnings from TensorFlow\n",
     "tf.get_logger().setLevel('ERROR')\n",
     "\n",
-    "# Import Sionna\n",
-    "try:\n",
-    "    import sionna\n",
-    "except ImportError as e:\n",
-    "    # Install Sionna if package is not already installed\n",
-    "    import os\n",
-    "    os.system(\"pip install sionna\")\n",
-    "    import sionna\n",
-    "\n",
     "sionna.config.seed = 42 # Set seed for reproducible random number generation"
    ]
   },

diff --git a/examples/Optical_Lumped_Amplification_Channel.ipynb b/examples/Optical_Lumped_Amplification_Channel.ipynb
@@ -91,6 +91,15 @@
     "    os.environ[\"CUDA_VISIBLE_DEVICES\"] = f\"{gpu_num}\"\n",
     "os.environ['TF_CPP_MIN_LOG_LEVEL'] = '3'\n",
     "\n",
+    "# Import Sionna\n",
+    "try:\n",
+    "    import sionna\n",
+    "except ImportError as e:\n",
+    "    # Install Sionna if package is not already installed\n",
+    "    import os\n",
+    "    os.system(\"pip install sionna\")\n",
+    "    import sionna\n",
+    "\n",
     "import tensorflow as tf\n",
     "# Configure the notebook to use only a single GPU and allocate only as much memory as needed\n",
     "# For more details, see https://www.tensorflow.org/guide/gpu\n",
@@ -103,15 +112,6 @@
     "# Avoid warnings from TensorFlow\n",
     "tf.get_logger().setLevel('ERROR')\n",
     "\n",
-    "# Import Sionna\n",
-    "try:\n",
-    "    import sionna\n",
-    "except ImportError as e:\n",
-    "    # Install Sionna if package is not already installed\n",
-    "    import os\n",
-    "    os.system(\"pip install sionna\")\n",
-    "    import sionna\n",
-    "\n",
     "# Set random seed for reproducibility\n",
     "sionna.config.seed = 42\n",
     "from sionna.channel import utils\n",
@@ -1360,7 +1360,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.10.12"
+   "version": "3.12.4"
   },
   "vscode": {
    "interpreter": {

diff --git a/examples/Pulse_shaping_basics.ipynb b/examples/Pulse_shaping_basics.ipynb
@@ -79,6 +79,15 @@
     "    os.environ[\"CUDA_VISIBLE_DEVICES\"] = f\"{gpu_num}\"\n",
     "os.environ['TF_CPP_MIN_LOG_LEVEL'] = '3'\n",
     "\n",
+    "# Import Sionna\n",
+    "try:\n",
+    "    import sionna\n",
+    "except ImportError as e:\n",
+    "    # Install Sionna if package is not already installed\n",
+    "    import os\n",
+    "    os.system(\"pip install sionna\")\n",
+    "    import sionna\n",
+    "\n",
     "# Configure the notebook to use only a single GPU and allocate only as much memory as needed\n",
     "# For more details, see https://www.tensorflow.org/guide/gpu\n",
     "import tensorflow as tf\n",
@@ -91,15 +100,6 @@
     "# Avoid warnings from TensorFlow\n",
     "tf.get_logger().setLevel('ERROR')\n",
     "\n",
-    "# Import Sionna\n",
-    "try:\n",
-    "    import sionna\n",
-    "except ImportError as e:\n",
-    "    # Install Sionna if package is not already installed\n",
-    "    import os\n",
-    "    os.system(\"pip install sionna\")\n",
-    "    import sionna\n",
-    "\n",
     "# Set random seed for reproducibility\n",
     "sionna.config.seed = 42"
    ]
@@ -735,7 +735,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.10.12"
+   "version": "3.12.4"
   }
  },
  "nbformat": 4,