Welcome to ssspy’s documentation!

https://readthedocs.org/projects/sound-source-separation-python/badge/?version=latest https://github.com/tky823/ssspy/actions/workflows/lint.yaml/badge.svg https://codecov.io/gh/tky823/ssspy/branch/main/graph/badge.svg?token=IZ89MTV64G

ssspy is a Python toolkit for sound source separation.

Build status

Python

Ubuntu

MacOS (x86_64)

MacOS (arm64)

Windows

3.9

https://github.com/tky823/ssspy/actions/workflows/test_package_ubuntu-latest_python-3.9.yaml/badge.svg?branch=main https://github.com/tky823/ssspy/actions/workflows/test_package_macos-13_python-3.9.yaml/badge.svg?branch=main https://github.com/tky823/ssspy/actions/workflows/test_package_macos-latest_python-3.9.yaml/badge.svg?branch=main https://github.com/tky823/ssspy/actions/workflows/test_package_windows-latest_python-3.9.yaml/badge.svg?branch=main

3.10

https://github.com/tky823/ssspy/actions/workflows/test_package_ubuntu-latest_python-3.10.yaml/badge.svg?branch=main https://github.com/tky823/ssspy/actions/workflows/test_package_macos-13_python-3.10.yaml/badge.svg?branch=main https://github.com/tky823/ssspy/actions/workflows/test_package_macos-latest_python-3.10.yaml/badge.svg?branch=main https://github.com/tky823/ssspy/actions/workflows/test_package_windows-latest_python-3.10.yaml/badge.svg?branch=main

3.11

https://github.com/tky823/ssspy/actions/workflows/test_package_ubuntu-latest_python-3.11.yaml/badge.svg?branch=main https://github.com/tky823/ssspy/actions/workflows/test_package_macos-13_python-3.11.yaml/badge.svg?branch=main https://github.com/tky823/ssspy/actions/workflows/test_package_macos-latest_python-3.11.yaml/badge.svg?branch=main https://github.com/tky823/ssspy/actions/workflows/test_package_windows-latest_python-3.11.yaml/badge.svg?branch=main

3.12

https://github.com/tky823/ssspy/actions/workflows/test_package_ubuntu-latest_python-3.12.yaml/badge.svg?branch=main https://github.com/tky823/ssspy/actions/workflows/test_package_macos-13_python-3.12.yaml/badge.svg?branch=main https://github.com/tky823/ssspy/actions/workflows/test_package_macos-latest_python-3.12.yaml/badge.svg?branch=main https://github.com/tky823/ssspy/actions/workflows/test_package_windows-latest_python-3.12.yaml/badge.svg?branch=main

Installation

You can install ssspy by pip.

pip install ssspy

To install latest version,

pip install git+https://github.com/tky823/ssspy.git

Instead, you can build package from source.

git clone https://github.com/tky823/ssspy.git
cd ssspy
pip install -e .

Note

If you fail to install ssspy, please update setuptools by

python -m pip install --upgrade setuptools

Note

If you cannot install ssspy due to failure in building wheel for numpy, please install numpy in advance.

Build Documentation Locally (optional)

To build the documentation locally, you have to include docs and notebooks when installing ssspy.

pip install -e ".[docs,notebooks]"

You need to convert some notebooks by the following command:

. ./docs/pre_build.sh

When you build the documentation, run the following command.

cd docs/
make html

Or, you can build the documentation automatically using sphinx-autobuild.

# in ssspy/
sphinx-autobuild docs docs/_build/html

Indices and tables