Skip to content

IENT/PTI

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Praktikum Computer Engineering

RWTHjupyter Binder

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: 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 Binder. 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

The code is licensed under the MIT license.