aptapy 0.1.1__py3-none-any.whl → 0.3.0__py3-none-any.whl

aptapy/strip.py

@@ -0,0 +1,92 @@
+# Copyright (C) 2025 Luca Baldini (luca.baldini@pi.infn.it)
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+"""Strip charts.
+"""
+
+import collections
+from typing import Sequence
+
+import numpy as np
+
+from .plotting import plt, setup_axes
+
+
+class StripChart:
+
+    """Class describing a sliding strip chart, that is, a scatter plot where the
+    number of points is limited to a maximum, so that the thing acts essentially
+    as a sliding window, typically in time.
+
+    Arguments
+    ---------
+    max_length : int, optional
+        the maximum number of points to keep in the strip chart. If None (the default),
+        the number of points is unlimited.
+
+    label : str, optional
+        a text label for the data series (default is None).
+
+    xlabel : str, optional
+        the label for the x axis.
+
+    ylabel : str, optional
+        the label for the y axis.
+
+    datetime : bool, optional
+        if True, the x values are treated as POSIX timestamps and converted to
+        datetime objects for plotting purposes (default is False).
+    """
+
+    def __init__(self, max_length: int = None, label: str = '', xlabel: str = None,
+                 ylabel: str = None, datetime: bool = False) -> None:
+        """Constructor.
+        """
+        self.label = label
+        self.xlabel = xlabel
+        self.ylabel = ylabel
+        self._datetime = datetime
+        self.x = collections.deque(maxlen=max_length)
+        self.y = collections.deque(maxlen=max_length)
+
+    def clear(self) -> None:
+        """Reset the strip chart.
+        """
+        self.x.clear()
+        self.y.clear()
+
+    def append(self, x: float, y: float) -> None:
+        """Append a data point to the strip chart.
+        """
+        self.x.append(x)
+        self.y.append(y)
+
+    def extend(self, x: Sequence[float], y: Sequence[float]) -> None:
+        """Append multiple data points to the strip chart.
+        """
+        if len(x) != len(y):
+            raise ValueError("x and y must have the same length")
+        self.x.extend(x)
+        self.y.extend(y)
+
+    def plot(self, axes=None, **kwargs) -> None:
+        """Plot the strip chart.
+        """
+        kwargs.setdefault("label", self.label)
+        if axes is None:
+            axes = plt.gca()
+        x = np.array(self.x).astype('datetime64[s]') if self._datetime else self.x
+        axes.plot(x, self.y, **kwargs)
+        setup_axes(axes, xlabel=self.xlabel, ylabel=self.ylabel, grids=True)

{aptapy-0.1.1.dist-info → aptapy-0.3.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aptapy
-Version: 0.1.1
+Version: 0.3.0
 Summary: Statistical tools for online monitoring and analysis
 Project-URL: Homepage, https://github.com/lucabaldini/aptapy
 Project-URL: Issues, https://github.com/lucabaldini/aptapy/issues
@@ -694,9 +694,17 @@ Requires-Dist: pytest; extra == 'dev'
 Requires-Dist: ruff; extra == 'dev'
 Provides-Extra: docs
 Requires-Dist: sphinx; extra == 'docs'
+Requires-Dist: sphinx-gallery; extra == 'docs'
 Requires-Dist: sphinxawesome-theme; extra == 'docs'
 Description-Content-Type: text/markdown
 
 <img src="docs/_static/logo.png" alt="logo" width="175"/>
 
-Statistical tools for online monitoring and analysis
+![License](https://img.shields.io/github/license/lucabaldini/aptapy.svg)
+[![CI](https://github.com/lucabaldini/aptapy/actions/workflows/ci.yml/badge.svg)](https://github.com/lucabaldini/aptapy/actions/workflows/ci.yml)
+[![Docs](https://github.com/lucabaldini/aptapy/actions/workflows/docs.yml/badge.svg)](https://github.com/lucabaldini/aptapy/actions/workflows/docs.yml)
+[![Docs](https://img.shields.io/badge/docs-latest-blue.svg)](https://lucabaldini.github.io/aptapy/)
+[![Ceasefire Now](https://badge.techforpalestine.org/default)](https://techforpalestine.org/learn-more)
+
+Statistical tools for online monitoring and analysis.
+[Read more](https://lucabaldini.github.io/aptapy/).

aptapy-0.3.0.dist-info/RECORD

@@ -0,0 +1,12 @@
+aptapy/__init__.py,sha256=a7Au1ukdeJbjiIZ-UL-qZE1xk-d2WnKKkoqjg_0SzqA,1707
+aptapy/_version.py,sha256=VrXpHDu3erkzwl_WXrqINBm9xWkcyUy53IQOj042dOs,22
+aptapy/hist.py,sha256=jvHULR2lW_gyoemNaRI-vpqhFqmLLCB319CaKjwU69E,9752
+aptapy/modeling.py,sha256=mHHHFMYmMuXTRQD2yR1XLM6E4KaBk8md7Z7dDp5ReD8,32566
+aptapy/plotting.py,sha256=p9YNdrcFcTimRCtoXcV3zORaEd4EfMtsDd4ETxGKKHM,27483
+aptapy/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+aptapy/strip.py,sha256=qGsVXWp-Dz-lz7KQxktMifUTNkSxh8ZQwYme8_bealQ,3026
+aptapy/typing_.py,sha256=JIbEqKI8kn_fd90yDt0JmI1AojjmLhAEB_1RfMFxLx4,807
+aptapy-0.3.0.dist-info/METADATA,sha256=ae7Q-HEWZCiZW8QjbAMNqCwZQVTFv52oH2n4J5tMRfg,42131
+aptapy-0.3.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+aptapy-0.3.0.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+aptapy-0.3.0.dist-info/RECORD,,

aptapy-0.1.1.dist-info/RECORD

@@ -1,10 +0,0 @@
-aptapy/__init__.py,sha256=a7Au1ukdeJbjiIZ-UL-qZE1xk-d2WnKKkoqjg_0SzqA,1707
-aptapy/_version.py,sha256=rnObPjuBcEStqSO0S6gsdS_ot8ITOQjVj_-P1LUUYpg,22
-aptapy/modeling.py,sha256=Ba-kHfvwjSc5oM3XZGsxN5wAONQZaKmICQa-P65qxNE,18234
-aptapy/plotting.py,sha256=Pv0uo7fqoKYmyFmX2CiSRujzTkYNKiUsW7ZHSBWQowE,25991
-aptapy/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-aptapy/typing_.py,sha256=JIbEqKI8kn_fd90yDt0JmI1AojjmLhAEB_1RfMFxLx4,807
-aptapy-0.1.1.dist-info/METADATA,sha256=bJ44czUH6kc516OHBIbge9neKPWTm3jAyz2fBEvPUkY,41456
-aptapy-0.1.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-aptapy-0.1.1.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-aptapy-0.1.1.dist-info/RECORD,,