Demos for Lecture Information Transmission

Introduction

This repository contains demos for selected topics the lecture "Informationsübertragung" (information transmission), held by Prof. Jens-Rainer Ohm (chair of Institut für Nachrichtentechnik) at RWTH Aachen University.

Visit the notebook index.ipynb for a table of contents.

Quick Start

Run the notebooks directly online . Please note the following limitations:

• The starting process of the session may take up to one minute.
• Please note that the session will be cancelled after 10 minutes of user inactivity.

Usage

To be able to open the IÜ Demos locally, you need to have a Python environment as well as JupyterLab installed. We recommend to use Anaconda for a local installation.

Anaconda

To run the notebooks on your local machine, you may use Anaconda (using pip is also possible for experienced users. You have to install all the requirements listed in binder/environment.yml and install the two jupyter labextension ... commands listed in binder/postBuild).

Installation

• Install Anaconda.

• Download this repository to your local disk. You can download it as a zip-File or use git: git clone --recurse-submodules git@git.rwth-aachen.de:IENT/iue-demos.git.

• It is highly recommended to run the IÜ notebooks in an isolated Anaconda environment. You can create a new environment called iuelab from the provided binder/environment.yml by running conda env create -f binder/environment.yml in the Anaconda prompt. This makes sure that all required packages are installed amd don't interfere with the packages in your base environment.

• Activate this environment with conda activate iuelab.

• Run two final commands in the Anaconda prompt (with activated iuelab environment):

  chmod +x binder/postBuild
  binder/postBuild

  If the latter command fails, please open binder/postBuild and execute the commands listed there manually.

Run

• Activate the environment with conda activate iuelab.
• Run JupyterLab jupyter lab. In your browser, JupyterLab should start. You can then open index.ipynb for an overview over all notebooks.
• You can deactivate the environment with conda deactivate (and switch back to it with conda activate iuelab).

Docker

For advanced users only: If you happen to have Docker installed, you can start a local dockerized JupyterLab with enabled IÜ-Demos with

docker run --name='iue-demos' --rm -it -p 8888:8888 -e JUPYTER_ENABLE_LAB=yes registry.git.rwth-aachen.de/ient/iue-demos:master

Copy and paste the displayed link to your favorite browser.

Contact

• If you found a bug, please use the issue tracker.
• In all other cases, please contact Christian Rohlfing.

The code is licensed under the MIT license.