Skip to main content

Library for efficient processing and visualization of time series

Project description

QATS

Python library and GUI for efficient processing and visualization of time series.

Python versions Build Status PyPi Deployment Status Documentation Status

General

About

The python library provides tools for:

  • Import and export from/to various pre-defined time series file formats
  • Signal processing
  • Inferring statistical distributions
  • Cycle counting using the Rainflow algorithm

It was originally created to handle time series files exported from SIMO and RIFLEX. Now it also handles SIMA hdf5 (.h5) files, Matlab (version < 7.3) .mat files, CSV files and more.

QATS also features a GUI which offers efficient and low threshold processing and visualization of time series. It is perfect for inspecting, comparing and reporting:

  • time series
  • power spectral density distributions
  • peak and extreme distributions
  • cycle distributions

Demo

QATS GUI

Getting started

Installation

Run the below command in a Python environment to install the latest QATS release:

python -m pip install qats

To upgrade from a previous version, the command is:

python -m pip install --upgrade qats

You may now import qats in your own scripts:

>>> from qats import TsDB, TimeSeries

... or use the GUI to inspect time series.

New in version 5.0.0. The Qt binding PySide6 is installed with qats. If you would rather like to use PyQt6, run

python -m pip install pyqt6

If multiple Qt bindinds are installed, the one to use may be controlled by setting the environmental variable QT_API to the desired package. Accepted values include pyqt6 (to use PyQt6) and pyside6 (PySide6). For more details, see README file for qtpy.

The GUI may now be launched by:

qats app

To create a start menu link, which you can even pin to the taskbar to ease access to the QATS GUI, run the following command:

qats config --link-app

Take a look at the resources listed below to learn more.

New in version 4.11.0. The command line interface is also accessible by running Python with the '-m' option. The following commands are equvivalent to those above:

python -m qats app
python -m qats config --link-app

Resources

Contribute

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

Prerequisites

Install Python version 3.8 or later from either https://www.python.org or https://www.anaconda.com.

Install Poetry with the official installer.

Install the poetry-dynamic-versioning plugin:

poetry self add "poetry-dynamic-versioning[plugin]"

Clone the source code repository

At the desired location, run:

git clone https://github.com/dnvgl/qats.git

Installing

To get the development environment running...

poetry install

This will

  • create an isolated environment
  • install all dependencies including those required for development, testing and building documentation
  • and install the package in development ("editable") mode

You should now be able to import the package in the Python console,

>>> import qats
>>> help(qats)

... and use the command line interface (CLI).

qats -h

New in version 4.11.0. The CLI is also available from

python -m qats -h

Running the tests

The automated tests are run using unittest.

python -m unittest discover 

Building the package

Build tarball and wheel distributions by

poetry build

The builds appear in the .dist folder. The distributions adhere to the PEP 0427 convention {distribution}-{version}(-{build tag})?-{python tag}-{abi tag}-{platform tag}.whl.

Building the documentation

The html documentation is built using Sphinx

sphinx-build -b html docs\source docs\_build

To force a build to read/write all files (always read all files and don't use a saved environment), include the -a and -E options:

sphinx-build -a -E -b html docs\source docs\_build

Versioning

We apply the "major.minor.micro" versioning scheme defined in PEP 440. See also Scheme choices on https://packaging.python.org/.

Versions are tagged with Git tags like v3.0.1. See the tags on this repository.

Release and deployment

We use the release cycle in GitHub to cut new releases.

Once a new release is published, GitHub Actions takes care of the packaging, unit testing and deployment to PyPi.

The workflows for continuous integration and deployment are found in .github/workflows.

Authors

License

This project is licensed under the MIT License - see the LICENSE file for details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

qats-5.2.1.tar.gz (121.6 kB view details)

Uploaded Source

Built Distribution

qats-5.2.1-py3-none-any.whl (138.0 kB view details)

Uploaded Python 3

File details

Details for the file qats-5.2.1.tar.gz.

File metadata

  • Download URL: qats-5.2.1.tar.gz
  • Upload date:
  • Size: 121.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.4 CPython/3.11.10 Linux/6.5.0-1025-azure

File hashes

Hashes for qats-5.2.1.tar.gz
Algorithm Hash digest
SHA256 d7437b4d7aca3bfe0eacc20937905998b77ae37bf4032ef292f78963dea95410
MD5 59a594983effad3ebce0a40829b253c5
BLAKE2b-256 98094f707dacd4f97eacc93add9b21d57e297861eca7ea99d160839fb641aa9a

See more details on using hashes here.

File details

Details for the file qats-5.2.1-py3-none-any.whl.

File metadata

  • Download URL: qats-5.2.1-py3-none-any.whl
  • Upload date:
  • Size: 138.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.4 CPython/3.11.10 Linux/6.5.0-1025-azure

File hashes

Hashes for qats-5.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 e866b596ac87128d49bad6f28e2345eeff0f3839e28a8f7a2ca3146ed1f948eb
MD5 63ffc447150529b4a58529d729e7850f
BLAKE2b-256 1a7e62ec84e6a7863d0a2dff74780b11230c6ab6b762d789a7552f9eab7506c0

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page