README.md

iosc.py

View/analyze comtrade oscillograms

Requirements:

• Python3 ≥ 3.9 with
  • numpy
  • chardet
  • PyQt5
  • QCustomPlot-PyQt5:
    • Fedora: out from box
    • Debian-based: OBS repo
    • Windows: pip

Bundled:

• python-comtrade
• open-iconic icons

Installation:

Fedora:

sudo dnf install iosc-...noarch.rpm

Debian-based:

# from OBS repo above
sudo apt install https://...python3-qcustomplot-pyqt5_...amd64.deb
sudo apt install iosc_..._all.deb

Packaging:

Fedora:

rpmbuild -ta iosc-<version>.tar.gz

Debian-based:

tar xf iosc-<version>.tar.gz && cd iosc-<version> && dpkg-buildpackage

Windows:

# 1. install python
# 2. install requirements
pip install numpy chardet pyqt5 QCustomPlot_PyQt5 pyinstaller
# 3. install iosc itself (in folder with unpacked sources):
pip install .
# 4. build
pyinstaller -y -w -F -n iosc-<version> contrib/win.py

Run from sources:

1. Download and unpack source tarball
2. Install required dependencies (see below)
3. Run main script: PYTHONPATH="..." iosc/mainwindow.py

OS specific

Windows:

1. Download and install Python3
2. then:

pip install numpy chardet pyqt5 QCustomPlot_PyQt5
pip install .
pythonw.exe -c "from iosc.mqinwindow import main; main()"

Linux:

Fedora:

dnf install python3-numpy python3-chardet python3-qcustomplot-pyqt5

Debian-based:

apt install python3-numpy python3-chardet python3-pyqt5
# see above
apt install https://...python3-qcustomplot-pyqt5_...amd64.deb

macOS

(with homebrew):

brew install python3
pip3 install numpy chardet

… and install QCustomPlot_PyQt5 according to documentation.

Specification

0.3.7