Overview

Bring measurements from the oscilloscope and the circuit simulator into a standardized Channel format. Edit the signals by using the Scope functionality: shifting them in time (different zero points) or define the zero point for measuring equipment that can only record AC. Calculate the FFT or important values such as RMS, mean etc. Bring the originally different input formats into common plots to make comparisons easy.

With the Impedance functionality, ImpedanceChannels can be read in, edited and compared. A conversion to e.g. the inductance value is possible with just one command.

Getting started

Install this repository into your virtual environment (venv) or jupyter notebook:

pip install pysignalscope

Use the toolbox in your python program:

import pysignalscope as pss
...

Example usage

pySignalScope helps to load, edit, display and analyze the signals. The following application example loads a noisy measurement signal, which is first filtered.

import pysignalscope as pss

# Read curves from scope csv file
[voltage_prim, voltage_sec, current_prim, current_sec] = pss.Scope.from_tektronix('scope_example_data_tek.csv')

# Add labels and units to channel: This example considers the Channel 'current_prim' only
current_prim = pss.Scope.modify(current_prim, label='current measured', unit='A', color='red')

# Low pass filter the noisy current signal, modify the Channel attributes label, color and linestyle
current_prim_filtered = pss.Scope.low_pass_filter(current_prim)
current_prim_filtered = pss.Scope.modify(current_prim_filtered, label='current filtered', linestyle='--', color='green')

# Make some modifications on the signal itself: data offset, time offset and factor to the data.
# Short the channel to one period and add label, color and linestyle to the Channel
current_prim_filtered_mod = pss.Scope.modify(current_prim_filtered, data_factor=1.3, data_offset=11, time_shift=2.5e-6)
current_prim_filtered_mod = pss.Scope.short_to_period(current_prim_filtered_mod, f0=200000)
current_prim_filtered_mod = pss.Scope.modify(current_prim_filtered_mod, label='current modified', linestyle='-', color='orange')

# Plot channels, save as pdf
fig1 = pss.Scope.plot_channels([current_prim, current_prim_filtered], [current_prim_filtered_mod], timebase='us')
pss.save_figure(fig1, 'figure.pdf')

# short channels to a single period, perform FFT for current waveforms
current_prim = pss.Scope.short_to_period(current_prim, f0=200000)
current_prim = pss.Scope.modify(current_prim, time_shift=5e-6)
pss.Scope.fft(current_prim)

To simplify the display, colors, linestyle and the label can be attached to the object. This is shown in the plot above.

The lower plot shows the post-processing of the filtered signal. This is multiplied by a small gain, provided with an offset and shortened to a period duration. The label, color and line style are changed. The signals are then plotted with just one plot command.

The functionality for the Impedance module is similar to the Scope module. In here, ImpedanceChannel objects can be loaded from different sources, which can be a .csv measurement file from an impedance analyzer or a computer generated curve. ImpedanceChannel objects can be modified in attributes and data, plotted and equivalent circuit parameters can be obtained from measurements.

Have a look at the Scope example and at the Impedance example to see what you can do with this toolbox.

Naming convention

This toolbox is divided into two modules: The functionality of an oscilloscope (Scope) and the functionality of an impedance analyzer (Impedance).

Documentation

Find the documentation here.

Bug Reports

Please use the issues report button within GitHub to report bugs.

Changelog

Find the changelog here.