MVTS-Analyzer 0.0.3

Plotting, annotation and analysis tools for multivariate time series data

MVTS-Analyzer is an open-source Python app/package for plotting, analyzing and annotating multivariate time series. The app was mainly implemented using PySide6, Pandas and Matplotlib and makes it easy to quickly load, display and manipulate multivariate time-series data from a .CSV, .XLSX or pandas-dataframe-pickle file.

• Features
  • Display-control
  • Datapoint Selection and Annotation
  • Multiple Views
  • Python Code
  • Supported formats
  • And more!
• Future and Contributing
• Installation
  • GitHub
  • PyPi
• Running
  • Tested on
• Acknowledgments

Features

Display-control

We can select what columns/sensors to display using the plot-settings, each sensor gets its own axis on which the data is plotted. All data is normalized to the view to enable visualization of data with widely different scales. Individual axes can be controlled (pan/zoom) by dragging the axis using left- or right mouse button. We can plot label-columns (pandas-category/integer/string) underneath the main-plot to visualize the annotation for the data-points.

What data to plot is also controlled using the side-window with the plot-settings.

Datapoint Selection and Annotation

We can use domain (Right Mouse Button), lasso- (LMB) and rectangle-selection (MMB) methods to select and annotate data. The user can select new datapoints either complementary, subtractively or additively. Selected datapoints are highlighted in the plot and can be hidden/shown and annotated.

Multiple Views

We can open multiple views and plot the same data in different ways using line- and scatter-plots. Point-selection is shared between views, so we can plot different sensors against each other, and select point in one view to highlight them in the other views. This is useful for example to quickly identify and annotate outliers in the data - or to select certain patterns in the data.

Python Code

We can run python-scripts to manipulate the loaded Dataframe using the built-in python-console. This allows us to quickly manipulate the (selected) data and plot the results. Python-scripts can be saved and loaded, allowing us to quickly apply the same manipulations to different datasets.

Several example-scripts (e.g. data normalization) are included and can be found under the "Apply"-tab in the main-window.

Supported formats

MVTS-Analyzer supports CSV (',' or ';' delimited), XLSX and Pandas-dataframe-pickle files. The app will automatically detect the file-format and load the data accordingly. An example of the supported formats can be found under /mvts_analyzer/example/. For FFT-analyses - a datetime column with the exact nameDateTime is required, formatted as YYYY-MM-DD HH:MM:SS or YYYY-MM-DD HH:MM:SS.ffffff.

And more!

Other features include:

• Renaming and deleting columns
• Renaming and deleting annotations
• Copying the currently displayed figure
• Exporting the currently displayed figure
• Displaying fft-plots behind the main-plot, pandas columns with numpy arrays are automatically detected

Future and Contributing

If you have any suggestions, bug-reports or feature-requests, feel free to open an issue or submit a pull-request.

Installation

GitHub

Clone the repository and install the requirements (e.g. using pip):

git clone https://github.com/Woutah/MVTS-Analyzer.git
cd MVTS-Analyzer
pip install -r requirements.txt

PyPi

MVTS-Analyzer is also available as a python-package on PyPi, and can be installed using package managers such as pip:

pip install mvts-analyzer

Running

If the package was installed, the app can be started using the mvts-analyzer command:

mvts-analyzer <options>

Or the short-hand version:

mvtsa <options>

To check if everything is working, we can pass the --example option to launch the app and load the example data:

mvtsa --example

If the package was only cloned from GitHub, the app can instead be started by running the main.py file:

python main.py <options>

(or we can first install the app using "pip install ." in the root directory of the repository to install it, at which point we can launch it using the mvts-analyzer command)

We can use the --help option to see what options are available:

Option	Argument(s)	Description
-h or --help	-	Show help message and exit
-e or --example	-	Load the example data
-f or --file	FILE	Path to the initial data to load (.xlsx, .csv or pickled Pandas Dataframe)
-m or --use_monitor	MONITOR	Integer-index on which to launch the app
-d or --dark_mode	-	Enables dark mode for the app
--default_plot_list	LIST[STR]	List of columns that we want to try to add to the plot-list when loading new dataframes

Loading Dataframes

We can also launch the app with a dataframe directly. For example:

import sys
from PySide6 import QtGui, QtWidgets
from mvts_analyzer.windows.main_window import MainWindow
import numpy as np
import pandas as pd
import datetime

if __name__ == "__main__":
	timestamps = pd.date_range("2024-01-01 00:00:00", periods=50, freq=datetime.timedelta(seconds=5)) 
	data = { 
		"sensor_A": np.random.normal(loc=20, scale=2, size=50),
		"sensor_B": np.random.normal(loc=50, scale=5, size=50),
		"sensor_C": np.random.normal(loc=100, scale=10, size=50),
	}
	new_df : pd.DataFrame = pd.DataFrame(data)
	app = QtWidgets.QApplication(sys.argv)
	main_win = MainWindow()
	main_win.graph_data_model.load_existing_df(new_df)
	main_win.show()
	app.exec_()

Tested on

• Windows 11 - Python 3.10.8
• Windows 11 - Python 3.8.17
• Ubuntu 22.04.2 LTS - Python 3.8.0
• Windows 10 - Python 3.8.17

Acknowledgments

This project uses several Icons from the Tango-Icons library. The icons can be found here and here.