sgwt 0.3.7

Installation

The sgwt package requires Python 3.7+ and is currently only compatible with Windows operating systems due to its reliance on a pre-compiled CHOLMOD library.

Install the latest stable release from PyPI:

pip install sgwt

This command will also install the necessary dependencies (e.g., NumPy, SciPy).

Basic Example

Here is a quick example using a band-pass filter to an impulse signal on the synthetic Texas grid to get the wavelet function at three different scales.

import sgwt

# Graph Laplacian
L = sgwt.DELAY_TEXAS

# Impulse at 600th Vertex
X = sgwt.impulse(L, n=600)

with sgwt.Convolve(L) as conv:

    # Wavelet at 3 scales
    Y = conv.bandpass(X, scales=[0.1, 1, 10])

The examples/ directory contains a comprehensive suite of demonstrations, also rendered in the Examples section of the documentation. Key applications include:

• Static Filtering: Basic low-pass, band-pass, and high-pass filtering on various graph sizes.

• Dynamic Graphs: Real-time topology updates, performance comparisons, and online stream processing.

Citation & Acknowledgements

If you use this library in your research, please cite it. The GitHub repository includes a CITATION.cff file that provides citation metadata. On GitHub, you can use the “Cite this repository” button on the sidebar to get the citation in your preferred format (including BibTeX).

For convenience, the BibTeX entry for the associated paper is:

@inproceedings{lowery-sgwt-2026,
  title={Using Spectral Graph Wavelets to Analyze Large Power System Oscillation Modes},
  author={Lowery, Luke and Baek, Jongoh and Birchfield, Adam},
  year={2026}
}

Luke Lowery developed this module during his PhD studies at Texas A&M University. You can learn more on his research page or view his publications on Google Scholar.

An alternative implementation in Julia is also available and leverages native SuiteSparse support.

• The core performance of this library relies on the CHOLMOD library from SuiteSparse, developed by Dr. Tim Davis at Texas A&M University.

• The graph laplacians used in the examples are derived from the synthetic grid repository, made available by Dr. Adam Birchfield at Texas A&M University.