Metadata-Version: 2.4
Name: zynamon
Version: 0.2.0
Summary: Generalized & powerful time-series class and related functions
Author-email: "Dr. Marcus Zeller" <dsp4444@gmail.com>
License-Expression: GPL-3.0-or-later
Project-URL: Homepage, https://github.com/zynt3c/zynamon
Project-URL: Package, https://pypi.org/project/zynamon/
Keywords: timeseries,analysis,monitoring,prediction,visualisation
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: h5py~=3.15.1
Requires-Dist: numpy~=2.4.2
Requires-Dist: pandas~=3.0.0
Requires-Dist: psutil~=7.2.2
Requires-Dist: pyarrow
Requires-Dist: scipy~=1.17.0
Requires-Dist: typer
Requires-Dist: zdev~=0.2.1
Dynamic: license-file

# zynamon

## Synopsis

Generalized & powerful time-series class and related functions.

## Contents

This library defines a powerful time-series representation based on the well-known ```pandas``` DataFrames. However, it adds meta-data as well as conveniently built-in filtering & alignment routines for both value and time dimension. Moreover, the central time-series objects can be constructed from *nearly any 1D data* such that handling of various sources in a standardised way is made possible (e.g. regularly-sampled sensor data, event logs as well as audio streams).

As of now, this package is structured into the following modules:

**zeit**: Main class ```TimeSeries``` containing time-, value- and samples-related methods and algorithmic operators (+, -, *, /)

**zeitspec**: Class ```TimeSpec``` and conversion routine for a unified treatment of various timestamp representations as settings or from data (types and strings)

**imex**: Routines for the automatic bulk import, conversion & aggregation of data from (a lot of) CSV-like files, e.g. proper extraction of all individual time-series hidden in lengthy event logs

**utils**: Utilities working on ```TimeSeries``` objects such as helpers for general analysis (e.g. outliers, predictions, history etc) and operators on two arbitrary objects (incl. routines to make objects "coherent" in time)

**xutils**: Special conversion utilities for CSV-files containing DFT spectra as generated by the "CMS X-Tools" real-time multi-channel analysis software (Siemens AG).

[ Dr. Marcus Zeller | <dsp4444@gmail.com> | Erlangen, Germany | 2022-2026 ]
