README.md 1.74 KB
Newer Older
Michael König's avatar
Michael König committed
1
TCPlivePLOT - realtime-visualization of TCP flows
2 3 4
================================================================================
Realtime-visualization of TCP flows logged by TCPlog.

Michael König's avatar
Michael König committed
5
![TCPlivePLOT screenrecording](screenrecording.gif)
6

Michael König's avatar
Michael König committed
7 8 9 10

Based on
--------------------------------------------------------------------------------
TCPlivePLOT is written in Python3 and tested on GNU/Linux 4.{1-15}.
11 12

For TCPlog see https://git.scc.kit.edu/CPUnetLOG/TCPlog/
13 14


15
Requirements TCPlivePLOT:
16
--------------------------------------------------------------------------------
17
* python3
Michael König's avatar
Michael König committed
18
* matplotlib (1.4.X recommended)
19
* numpy
20
* matplotlib-interactive backend
21 22

* recommended backends:
23 24 25 26
    * Qt4Agg or
    * Qt5Agg


27 28
Running TCPlivePLOT:
--------------------------------------------------------------------------------
29 30
* ./tcpliveplot.py OR
* tcpliveplot (after installation)
31 32


33 34
Installation of TCPlivePLOT:
--------------------------------------------------------------------------------
Michael König's avatar
Michael König committed
35
* via pip3 (from Repo):
36 37
    * sudo pip3 install .               # system-wide installation
    * pip3 install --user .             # local installation
Michael König's avatar
Michael König committed
38 39 40 41 42 43 44 45 46 47 48 49 50 51 52
* via pip3 (from PyPi):
    * sudo pip3 install tcpliveplot     # system-wide installation
    * pip3 install --user tcpliveplot   # local installation


Notes:
--------------------------------------------------------------------------------
* Installation on Ubuntu 16.04 requires the following additional packages:
    * libfreetype6-dev
    * libxft-dev
    * python3-pyside
* A matplotlibrc with an interactive backend is mandatory:
    * "matplotlibrc.example" has to be placed here: ~/.config/matplotlib/matplotlibrc
* Binaries installed via pip3 (local installation) are usually located in ~/.local/bin ($PATH may has
        to be extended)