Skip to main content

Graph signal processing extensions for Pycsou.

Project description

https://matthieumeo.github.io/pycsou/html/_images/pycsou.png https://zenodo.org/badge/277582581.svg

Pycsou-gsp is the graph signal processing extension of the Python 3 package Pycsou for solving linear inverse problems. The extension offers implementations of graph convolution and differential operators, compatible with Pycsou’s interface for linear operators. Such tools can be useful when solving linear inverse problems involving signals defined on non Euclidean discrete manifolds.

Graphs in Pycsou-gsp are instances from the class pygsp.graphs.Graph from the pygsp library for graph signal processing with Python.

Content

The package, named pycgsp, is organised as follows:

  1. The subpackage pycgsp.linop implements the following common graph linear operators:

    • Graph convolution operators: GraphConvolution

    • Graph differential operators: GraphLaplacian, GraphGradient, GeneralisedGraphLaplacian.

  2. The subpackage pycgsp.graph provides routines for generating graphs from discrete tessellations of continuous manifolds such as the sphere.

Installation

Pycsou-gsp requires Python 3.6 or greater. It is developed and tested on x86_64 systems running MacOS and Linux.

Dependencies

Before installing Pycsou-gsp, make sure that the base package Pycsou is correctly installed on your machine. Installation instructions for Pycsou are available at that link.

The package extra dependencies are listed in the files requirements.txt and requirements-conda.txt. It is recommended to install those extra dependencies using Miniconda or Anaconda. This is not just a pure stylistic choice but comes with some hidden advantages, such as the linking to Intel MKL library (a highly optimized BLAS library created by Intel).

>> conda install --channel=conda-forge --file=requirements-conda.txt

Quick Install

Pycsou-gsp is also available on Pypi. You can hence install it very simply via the command:

>> pip install pycsou-gsp

If you have previously activated your conda environment pip will install Pycsou in said environment. Otherwise it will install it in your base environment together with the various dependencies obtained from the file requirements.txt.

Developer Install

It is also possible to install Pycsou-gsp from the source for developers:

>> git clone https://github.com/matthieumeo/pycsou-gsp
>> cd <repository_dir>/
>> pip install -e .

The package documentation can be generated with:

>> conda install sphinx=='2.1.*'            \
                 sphinx_rtd_theme=='0.4.*'
>> python3 setup.py build_sphinx

You can verify that the installation was successful by running the package doctests:

>> python3 test.py

Cite

For citing this package, please see: http://doi.org/10.5281/zenodo.4486431

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pycgsp-1.0.4.tar.gz (747.8 kB view details)

Uploaded Source

File details

Details for the file pycgsp-1.0.4.tar.gz.

File metadata

  • Download URL: pycgsp-1.0.4.tar.gz
  • Upload date:
  • Size: 747.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/3.10.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.60.0 CPython/3.8.8

File hashes

Hashes for pycgsp-1.0.4.tar.gz
Algorithm Hash digest
SHA256 4fbf4bb2f8258ccf403b6b7e6a92355efb9240467e44a762c56d1c849ef66a4c
MD5 2fafede5ea0e5c88e92d32968fd27dad
BLAKE2b-256 0fab962b9d7f65477e01bdb7b5ebacebf4c97c1fa524e8b86915a2cf1839599e

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page