anytimes 0.1.0__tar.gz

anytimes-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Audun Arnesen Nyhus
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

anytimes-0.1.0/MANIFEST.in

@@ -0,0 +1,3 @@
+include README.md
+include LICENSE
+include ANYtimes_logo.png

anytimes-0.1.0/PKG-INFO

@@ -0,0 +1,105 @@
+Metadata-Version: 2.4
+Name: anytimes
+Version: 0.1.0
+Summary: PySide6-based interface for exploring and editing time-series data.
+Author: AnyTimes Developers
+License: MIT License
+        
+        Copyright (c) 2025 Audun Arnesen Nyhus
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/example/anytimes
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy
+Requires-Dist: pandas
+Requires-Dist: scipy
+Requires-Dist: PySide6
+Requires-Dist: matplotlib
+Dynamic: license-file
+
+<p align="center">
+  <img src="ANYtimes_logo.png" alt="AnytimeSeries logo" width="200"/>
+</p>
+
+# ANYtimeSeries
+
+ANYtimeSeries provides a QT-based interface for exploring and editing time-series data. 
+
+The application integrates with the bundled anyqats package and supports various file formats for loading and visualising time-series information.
+
+Some of the features of ANYtimes
+- loading of multiple files
+- detection of commom variables files for effiecent work flow
+- quick manipulation of time series using predefined operations
+- complex manipulation of time series using equation input
+- frequency filtering
+- time sereis statistics
+- many plotting options
+- embdedded and in browser plotting
+- Orcaflex .sim files compability
+- extreme value statstics
+- selection of plotting engine (plotly, bokeh or matplotlib)
+
+
+<p align="center">
+  <img src="dark_mode.png" alt="AnytimeSeries dark mode" width="700"/>
+</p>
+
+
+<p align="center">
+  <img src="light_mode.png" alt="AnytimeSeries light mode" width="700"/>
+</p>
+
+
+<p align="center">
+  <img src="statistics_table.png" alt="AnytimeSeries statistics" width="700"/>
+</p>
+
+## Installation
+
+```bash
+pip install anytimes
+```
+
+## Requirements
+
+- numpy
+- pandas
+- scipy
+- anyqats
+- PySide6
+- matplotlib
+
+## Usage
+
+After installation, import the GUI module in your Python project:
+
+```python
+from anytimes import anytimes_gui
+```
+
+The module exposes Qt widgets for building custom time-series exploration tools. You can also launch the GUI from the command line using the `anytimes` entry point.
+
+## License
+
+Released under the MIT License. See [LICENSE](LICENSE) for details.
+

anytimes-0.1.0/README.md

@@ -0,0 +1,67 @@
+<p align="center">
+  <img src="ANYtimes_logo.png" alt="AnytimeSeries logo" width="200"/>
+</p>
+
+# ANYtimeSeries
+
+ANYtimeSeries provides a QT-based interface for exploring and editing time-series data. 
+
+The application integrates with the bundled anyqats package and supports various file formats for loading and visualising time-series information.
+
+Some of the features of ANYtimes
+- loading of multiple files
+- detection of commom variables files for effiecent work flow
+- quick manipulation of time series using predefined operations
+- complex manipulation of time series using equation input
+- frequency filtering
+- time sereis statistics
+- many plotting options
+- embdedded and in browser plotting
+- Orcaflex .sim files compability
+- extreme value statstics
+- selection of plotting engine (plotly, bokeh or matplotlib)
+
+
+<p align="center">
+  <img src="dark_mode.png" alt="AnytimeSeries dark mode" width="700"/>
+</p>
+
+
+<p align="center">
+  <img src="light_mode.png" alt="AnytimeSeries light mode" width="700"/>
+</p>
+
+
+<p align="center">
+  <img src="statistics_table.png" alt="AnytimeSeries statistics" width="700"/>
+</p>
+
+## Installation
+
+```bash
+pip install anytimes
+```
+
+## Requirements
+
+- numpy
+- pandas
+- scipy
+- anyqats
+- PySide6
+- matplotlib
+
+## Usage
+
+After installation, import the GUI module in your Python project:
+
+```python
+from anytimes import anytimes_gui
+```
+
+The module exposes Qt widgets for building custom time-series exploration tools. You can also launch the GUI from the command line using the `anytimes` entry point.
+
+## License
+
+Released under the MIT License. See [LICENSE](LICENSE) for details.
+

anytimes-0.1.0/anyqats/__init__.py

@@ -0,0 +1,16 @@
+# -*- coding: utf-8 -*-
+"""
+Library for efficient processing and visualization of time series.
+"""
+from .ts import TimeSeries
+from .tsdb import TsDB
+
+# version
+try:
+    from ._version import __version__, __version_tuple__
+except ImportError:
+    __version__ = "0.0.0"
+    __version_tuple__ = (0, 0, 0)
+
+# summary
+__summary__ = __doc__

anytimes-0.1.0/anyqats/__main__.py

@@ -0,0 +1,5 @@
+# -*- coding: utf-8 -*-
+from . import cli
+
+if __name__ == '__main__':
+    cli.main()

anytimes-0.1.0/anyqats/app/__init__.py

@@ -0,0 +1,28 @@
+"""Support for launching the AnyQATS GUI.
+
+This module exposes a :func:`main` function that serves as an entry point
+for the desktop application.  It delegates to :func:`anyqats.cli.launch_app`
+with default arguments, allowing the GUI to be started simply by executing
+``python -m anyqats.app``.
+"""
+
+from __future__ import annotations
+
+
+def main() -> None:
+    """Launch the graphical user interface.
+
+    The heavy lifting of setting up and starting the application lives in
+    :func:`anyqats.cli.launch_app`.  Importing inside the function keeps import
+    time light and avoids circular dependencies during package initialisation.
+    """
+
+    from ..cli import launch_app
+
+    # Mirror the default behaviour of ``anyqats app`` which uses the current
+    # working directory unless the user specifies otherwise.
+    launch_app(home=False)
+
+
+__all__ = ["main"]
+

anytimes-0.1.0/anyqats/app/__main__.py

@@ -0,0 +1,10 @@
+"""Module entry point for :mod:`anyqats.app`.
+
+Executing ``python -m anyqats.app`` will invoke :func:`anyqats.app.main` and
+start the graphical user interface.
+"""
+
+from . import main
+
+if __name__ == "__main__":
+    main()

anytimes-0.1.0/anyqats/app/exceptions.py

@@ -0,0 +1,47 @@
+# -*- coding: utf-8 -*-
+"""
+Module for custom exceptions and exception handlers
+"""
+import os
+import sys
+import traceback
+import webbrowser
+
+from PySide6.QtWidgets import QMessageBox
+
+
+def handle_exception(exc_type, exc_value, exc_traceback):
+    """
+    Handle all exceptions, log it on file, warn the user via a critical message box
+
+    Parameters
+    ----------
+    exc_type : type
+        type of exception e.g. ValueError
+    exc_value : str
+        exception string
+    exc_traceback : traceback
+        traceback for the exception
+
+    """
+    # retrieve traceback
+    filename, line, dummy, dummy = traceback.extract_tb(exc_traceback).pop()
+    filename = os.path.basename(filename)
+    error = "%s: %s" % (exc_type.__name__, exc_value)
+
+    # display critical message box
+    msg = "<html>A critical error has occured.<br/> <b>%s</b><br/><br/>It occurred at <b>line %d</b> of file " \
+        "<b>%s</b>.<br/>Press Yes to see the full error report<br/></html>" % (error, line, filename)
+    message_box = QMessageBox().critical(None, "Error", msg.strip(), QMessageBox.Yes | QMessageBox.No, QMessageBox.Yes)
+
+    # pipe traceback to log file (env variable 'APPDATA' is assumed present on the computer)
+    log_file = os.path.join(os.getenv("APPDATA"), "QATS.launch.pyw.log")
+    with open(log_file,"w") as f:
+        f.write("".join(traceback.format_exception(exc_type, exc_value, exc_traceback)))
+
+    # open log file in default editor if user pressed yes (trick using the webbrowser command)
+    if message_box == QMessageBox.Yes:
+        webbrowser.open(log_file)
+
+    # exit with code 1 (error)
+    sys.exit(1)

anytimes-0.1.0/anyqats/app/funcs.py

@@ -0,0 +1,245 @@
+"""
+Module with functions for handling file operations and calculations. Made for multithreading.
+"""
+import numpy as np
+
+from ..fatigue.rainflow import rebin as rebin_cycles
+from ..stats.gumbel import pwm as gumbel_pwm
+from ..tsdb import TsDB
+
+
+def calculate_psd(container, twin, fargs, nperseg, normalize):
+    """
+    Calculate power spectral density and return as numpy arrays
+
+    Parameters
+    ----------
+    container : dict
+        TimeSeries objects
+    twin : tuple
+        Time window. Time series are cropped to time window before estimating psd.
+    fargs : tuple
+        Filter arguments. Time series are filtered before estimating psd.
+    nperseg : int
+        Size of segments used for estimating PSD using Welch's method.
+        NOTE: the minimum of specified `nperseg` and signal length is used.
+    normalize : bool
+        Normalize power spectral density on maximum density.
+
+    Returns
+    -------
+    dict
+        Frequency versus power spectral density
+    """
+    container_out = dict()
+
+    for name, ts in container.items():
+        # NOTE: nperseg passed on as minimum of specified value and signal input length
+        #       this is done in scipy anyway, which also issues a UserWArnings stating:
+        #       "nperseg = {nperseg} is greater than input length = {input_length:d}, using nperseg = {input_length:d}"
+        t, _ = ts.get(twin=twin, resample=ts.dt)
+        nperseg_ = np.min((nperseg, t.size))
+        # calculate power spectral density 
+        # (resampling to average time step for robustness, necessary for series with varying time step)
+        f, s = ts.psd(twin=twin, filterargs=fargs, resample=ts.dt, taperfrac=0.1, nperseg=nperseg_, normalize=normalize)
+        container_out[name] = tuple([f, s])
+
+    return container_out
+
+
+def calculate_rfc(container, twin, fargs, nbins):
+    """
+    Count cycles using Rainflow counting method
+
+    Parameters
+    ----------
+    container : dict
+        TimeSeries objects
+    twin : tuple
+        Time window. Time series are cropped to time window before estimating psd.
+    fargs : tuple
+        Filter arguments. Time series are filtered before estimating psd.
+    nbins : int
+        Number of bins in cycle distribution.
+
+    Returns
+    -------
+    dict
+        Cycle magnitude versus count
+    """
+    container_out = dict()
+
+    for name, ts in container.items():
+        # rainflow counting
+        cycles = ts.rfc(twin=twin, filterargs=fargs)
+
+        # rebin
+        if nbins is not None:
+            cycles = rebin_cycles(cycles, binby='range', n=nbins)
+
+        # unpack pairs (tuples) in list
+        r, _, c = zip(*cycles)
+        container_out[name] = tuple([r, c])
+
+    return container_out
+
+
+def calculate_trace(container, twin, fargs):
+    """
+    Calculate trace and peaks/troughs of filtered time series
+
+    Parameters
+    ----------
+    container : dict
+        TimeSeries objects
+    twin : tuple
+        Time window. Time series are cropped to time window before extracting maxima.
+    fargs : tuple
+        Filter arguments. Time series are filtered before extracting maxima.
+
+    Returns
+    -------
+    dict
+        Filtered and windowed time series and peaks/throughs
+    """
+    container_out = dict()
+
+    for name, ts in container.items():
+        t, x = ts.get(twin=twin, filterargs=fargs)
+        xmin, tmin = ts.minima(twin=twin, filterargs=fargs, rettime=True)
+        xmax, tmax = ts.maxima(twin=twin, filterargs=fargs, rettime=True)
+
+        container_out[name] = dict(t=t, x=x, tmin=tmin, xmin=xmin,
+                                   tmax=tmax, xmax=xmax)
+
+    return container_out
+
+
+def calculate_stats(container, twin, fargs, minima=False):
+    """
+    Calculate time series statistics
+
+    Parameters
+    ----------
+    container : dict
+        TimeSeries objects
+    twin : tuple
+        Time window. Time series are cropped to time window before extracting maxima.
+    fargs : tuple
+        Filter arguments. Time series are filtered before extracting maxima.
+    minima : bool, optional
+        Fit to sample of minima instead of maxima. The sample is multiplied by -1 prior to parameter estimation.
+
+    Returns
+    -------
+    dict
+        Filtered and windowed time series and peaks/throughs
+    """
+    return {name: ts.stats(twin=twin, filterargs=fargs, statsdur=10800., quantiles=(0.37, 0.57, 0.9),
+                           is_minima=minima, include_sample=True) for name, ts in container.items()}
+
+
+def calculate_gumbel_fit(container, twin, fargs, minima=False):
+    """
+    Calculate time series extremes and fit Gumbel distribution
+
+    Parameters
+    ----------
+    container : dict
+        TimeSeries objects
+    twin : tuple
+        Time window. Time series are cropped to time window before extracting maxima.
+    fargs : tuple
+        Filter arguments. Time series are filtered before extracting maxima.
+    minima : bool, optional
+        Fit to sample of minima instead of maxima. The sample is multiplied by -1 prior to parameter estimation.
+
+    Returns
+    -------
+    dict
+        Sample and fitted gumbel distribution parameters
+    """
+    if len(container.keys()) < 2:
+        raise ValueError(f"Select more than 1 time series to fit Gumbel CDF to extremes sample.")
+
+    # create sample of extremes
+    sample = list()
+    for name, ts in container.items():
+        _, x = ts.get(twin=twin, filterargs=fargs)
+
+        if minima:
+            # sample minimum value
+            sample.append(np.min(x))
+        else:
+            # sample maximum value
+            sample.append(np.max(x))
+
+    # numpy array sorted ascending
+    sample = np.sort(np.array(sample))
+
+    # flip sample of minima to enable Gumbel fit
+    if minima:
+        sample *= -1
+
+    # estimate gumbel distribution parameters
+    loc, scale = gumbel_pwm(sample)
+    return dict(loc=loc, scale=scale, sample=sample, minima=minima)
+
+
+def export_to_file(filename, db, names, twin, fargs):
+    """
+    Export selected time series to file
+
+    Parameters
+    ----------
+    filename : str
+        File name
+    db : TsDB
+        Time series data base
+    names : list
+        Name of time series to export
+    twin : tuple
+        Time window. Time series are cropped to time window before export.
+    fargs : tuple
+        Filter arguments. Time series are filtered before export
+    """
+    db.export(filename, names=names, exist_ok=True, basename=False, twin=twin, filterargs=fargs)
+
+
+def import_from_file(files):
+    """
+    Import time series files
+
+    Parameters
+    ----------
+    files : list
+        File names
+
+    Returns
+    -------
+    TsDB
+        Time series data base
+    """
+    db = TsDB()
+    db.load(files, read=False)
+    return db
+
+
+def read_timeseries(db, names):
+    """
+    Read time series from files
+
+    Parameters
+    ----------
+    db : TsDB
+        Time series data base
+    names : list
+        Name of time series to read
+
+    Returns
+    -------
+    dict
+        Container with TimeSeries objects
+    """
+    return db.getm(names=names, store=False)
+