0.2.7

.github/workflows/code-coverage.yaml

@@ -10,21 +10,16 @@ jobs:
       - name: Checkout code
         uses: actions/checkout@v4
 
-      - name: Set up Python
-        uses: actions/setup-python@v5
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v6
         with:
-          python-version: 3.14
+          python-version: "3.14"
 
       - name: Install dependencies
-        run: |
-          python -m pip install --upgrade pip
-          pip install '.[tests]'
+        run: uv sync --all-groups
 
       - name: Run tests with coverage
-        run: coverage run --source=xdas -m pytest
-
-      - name: Generate coverage report
-        run: coverage xml
+        run: uv run pytest --cov --cov-report=xml
 
       - name: Upload coverage reports to Codecov
         uses: codecov/codecov-action@v4

.github/workflows/tests.yaml

@@ -12,15 +12,11 @@ jobs:
 
     steps:
     - uses: actions/checkout@v4
-    - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v5
+    - name: Set up uv
+      uses: astral-sh/setup-uv@v6
       with:
         python-version: ${{ matrix.python-version }}
-        cache: 'pip'
     - name: Install dependencies
-      run: |
-        python -m pip install --upgrade pip
-        pip install '.[tests]'
+      run: uv sync --all-groups
     - name: Test with pytest
-      run: |
-        pytest
+      run: uv run pytest

.gitignore

@@ -162,4 +162,11 @@ cython_debug/
 #  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
 #  and can be added to the global gitignore or merged into this file.  For a more nuclear
 #  option (not recommended) you can uncomment the following to ignore the entire idea folder.
-#.idea/
+#.idea/
+
+# AI agents
+CLAUDE.md
+.claude
+
+# uv lock not relevant for a library
+uv.lock

docs/api/atoms.md

@@ -24,7 +24,6 @@ Attributes
    Atom.initialized
 ```
 
-
 Methods
 
 ```{eval-rst}
@@ -34,19 +33,57 @@ Methods
    Atom.initialize_from_state
    Atom.call
    Atom.reset
+   Atom.save_state
+   Atom.set_state
+   Atom.load_state
 ```
 
-## Core atoms 
+## Core atoms
 
 ```{eval-rst}
 .. autosummary::
    :toctree: ../_autosummary
 
    Sequential
-   Partial
    State
 ```
 
+### Partial
+
+```{eval-rst}
+.. autosummary::
+   :toctree: ../_autosummary
+
+   Partial
+```
+
+Attributes
+
+```{eval-rst}
+.. autosummary::
+
+   Partial.stateful
+```
+
+Methods
+
+```{eval-rst}
+.. autosummary::
+
+   Partial.call
+   Partial.from_state
+   Partial.get_state
+```
+
+## Decorators
+
+```{eval-rst}
+.. autosummary::
+   :toctree: ../_autosummary
+
+   atomized
+```
+
 ## Signal processing
 
 ```{eval-rst}
@@ -57,6 +94,7 @@ Methods
    FIRFilter
    IIRFilter
    LFilter
+   MLPicker
    ResamplePoly
    SOSFilter
    Trigger

docs/api/processing.md

@@ -4,16 +4,66 @@
 
 # xdas.processing
 
+## Functions
+
 ```{eval-rst}
 .. autosummary::
    :toctree: ../_autosummary
 
    process
+```
+
+## Loaders
+
+```{eval-rst}
+.. autosummary::
+   :toctree: ../_autosummary
+
    DataArrayLoader
    RealTimeLoader
+```
+
+### DataArrayLoader
+
+```{eval-rst}
+.. autosummary::
+   :toctree: ../_autosummary
+
+   DataArrayLoader.nbytes
+```
+
+## Writers
+
+```{eval-rst}
+.. autosummary::
+   :toctree: ../_autosummary
+
    DataArrayWriter
    DataFrameWriter
    StreamWriter
    ZMQPublisher
    ZMQSubscriber
+```
+
+### DataArrayWriter
+
+```{eval-rst}
+.. autosummary::
+   :toctree: ../_autosummary
+
+   DataArrayWriter.submit
+   DataArrayWriter.write
+   DataArrayWriter.shutdown
+   DataArrayWriter.result
+```
+
+### ZMQPublisher
+
+```{eval-rst}
+.. autosummary::
+   :toctree: ../_autosummary
+
+   ZMQPublisher.submit
+   ZMQPublisher.write
+   ZMQPublisher.result
 ```

docs/api/signal.md

@@ -36,7 +36,7 @@
    medfilt
 ```
 
-## Spectral analysisi
+## Spectral analysis
 
 ```{eval-rst}
 .. autosummary::

docs/api/synthetics.md

@@ -10,4 +10,5 @@
 
    wavelet_wavefronts
    randn_wavefronts
+   dummy
 ```

docs/api/virtual.md

@@ -6,57 +6,130 @@
 
 ## VirtualArray
 
+Base class for all virtual array types.
+
+Attributes
+
 ```{eval-rst}
 .. autosummary::
    :toctree: ../_autosummary
 
    VirtualArray.shape
    VirtualArray.dtype
-   VirtualArray.to_dataset
    VirtualArray.ndim
    VirtualArray.size
-   VirtualArray.empty
    VirtualArray.nbytes
+   VirtualArray.empty
+```
+
+Methods
+
+```{eval-rst}
+.. autosummary::
+   :toctree: ../_autosummary
+
+   VirtualArray.to_dataset
+```
+
+## VirtualSource
+
+A lazy pointer to a single dataset inside an HDF5/NetCDF4 file.
+
+Constructor
+
+```{eval-rst}
+.. autosummary::
+   :toctree: ../_autosummary
+
+   VirtualSource
+```
+
+Attributes
+
+```{eval-rst}
+.. autosummary::
+
+   VirtualSource.vsource
+   VirtualSource.shape
+   VirtualSource.dtype
+   VirtualSource.ndim
+   VirtualSource.size
+   VirtualSource.nbytes
+   VirtualSource.empty
+```
+
+Methods
+
+```{eval-rst}
+.. autosummary::
+
+   VirtualSource.to_dataset
 ```
 
 ## VirtualStack
 
+A lazy concatenation of multiple {py:class}`VirtualSource` objects along one axis.
+
+Constructor
+
 ```{eval-rst}
 .. autosummary::
    :toctree: ../_autosummary
 
+   VirtualStack
+```
+
+Attributes
+
+```{eval-rst}
+.. autosummary::
+
    VirtualStack.sources
    VirtualStack.axis
    VirtualStack.shape
    VirtualStack.dtype
+   VirtualStack.ndim
+   VirtualStack.size
+   VirtualStack.nbytes
+   VirtualStack.empty
+```
+
+Methods
+
+```{eval-rst}
+.. autosummary::
+
    VirtualStack.append
    VirtualStack.extend
    VirtualStack.to_dataset
-   VirtualStack._to_layout
 ```
 
 ## VirtualLayout
 
+Internal HDF5 virtual dataset layout object.
+
 ```{eval-rst}
 .. autosummary::
    :toctree: ../_autosummary
 
+   VirtualLayout
+```
+
+Attributes
+
+```{eval-rst}
+.. autosummary::
+
    VirtualLayout.shape
    VirtualLayout.dtype
-   VirtualLayout.to_dataset
 ```
 
-## VirtualSource
+Methods
 
 ```{eval-rst}
 .. autosummary::
-   :toctree: ../_autosummary
 
-   VirtualSource.vsource
-   VirtualSource.shape
-   VirtualSource.dtype
-   VirtualSource.to_dataset
-   VirtualSource._to_layout
+   VirtualLayout.to_dataset
 ```
 
 ## Selection
@@ -65,7 +138,22 @@
 .. autosummary::
    :toctree: ../_autosummary
 
+   Selection
+```
+
+Attributes
+
+```{eval-rst}
+.. autosummary::
+
    Selection.shape
    Selection.ndim
+```
+
+Methods
+
+```{eval-rst}
+.. autosummary::
+
    Selection.get_indexer
-```
+```