Praktikum Computer Engineering

Introduction

This repository contains Jupyter Notebooks for the Praktikum Computer Engineering (formerly known as Praktikum Technische Informatik) at RWTH Aachen University.

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

Quick Start

Run the notebooks directly online RWTHjupyter:

• The starting process of the session may take up to one minute.

As a fall back: Use Binder or offline usage (see below).

Binder

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.

Offline Usage

To be able to open the PTI notebooks 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 [email protected]:IENT/pti.git.

• It is highly recommended to run the PTI notebooks in an isolated Anaconda environment. You can create a new environment called ptilab 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 ptilab.

• Run two final commands in the Anaconda prompt (with activated ptilab 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 ptilab.
• 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 ptilab).

Docker

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

docker run --name='pti' --rm -it -p 8888:8888 -e JUPYTER_ENABLE_LAB=yes registry.git.rwth-aachen.de/ient/pti: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.