{"id":45646305,"url":"https://github.com/groupmm/libnmfd","last_synced_at":"2026-02-24T04:12:05.966Z","repository":{"id":227675498,"uuid":"764160732","full_name":"groupmm/libnmfd","owner":"groupmm","description":"libnmfd: Music Processing Applications of Nonnegative Matrix Factorization","archived":false,"fork":false,"pushed_at":"2024-08-09T13:31:30.000Z","size":57874,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-08-10T13:18:09.187Z","etag":null,"topics":["audio","decomposition","nmf"],"latest_commit_sha":null,"homepage":"https://groupmm.github.io/libnmfd/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/groupmm.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-02-27T15:32:27.000Z","updated_at":"2024-08-09T13:19:19.000Z","dependencies_parsed_at":"2024-08-08T13:13:04.908Z","dependency_job_id":null,"html_url":"https://github.com/groupmm/libnmfd","commit_stats":null,"previous_names":["groupmm/libnmf","groupmm/libnmfd"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/groupmm/libnmfd","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/groupmm%2Flibnmfd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/groupmm%2Flibnmfd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/groupmm%2Flibnmfd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/groupmm%2Flibnmfd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/groupmm","download_url":"https://codeload.github.com/groupmm/libnmfd/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/groupmm%2Flibnmfd/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29771192,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-24T04:01:02.180Z","status":"ssl_error","status_checked_at":"2026-02-24T03:59:49.901Z","response_time":75,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["audio","decomposition","nmf"],"created_at":"2026-02-24T04:12:05.216Z","updated_at":"2026-02-24T04:12:05.960Z","avatar_url":"https://github.com/groupmm.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ctable border=\"0\"\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003cimg src=docs/build/html/_static/libnmfd_logo.png alt=\"libsoni logo\" width=\"1000\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003ch2\u003elibnmfd: Music Processing Applications of Nonnegative Matrix Factorization\u003c/h2\u003e\n\u003cbr\u003e \u003cbr\u003e\n\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\nNonnegative matrix factorization (NMF) is a family of methods widely used for information retrieval across domains\nincluding text, images, and audio. Within music processing, NMF has been used for tasks such as transcription,\nsource separation, and structure analysis. Prior work has shown that initialization and constrained update rules can \ndrastically improve the chances of NMF converging to a musically meaningful solution. Along these lines we present the \nlibnmfd (NMF toolbox), which contains Python implementations of conceptually distinct NMF variants---in particular,\nthe repository includes an overview for two algorithms. The first variant, called nonnegative matrix factor\ndeconvolution (NMFD), extends the original NMF algorithm to the convolutive case, enforcing the temporal order of \nspectral templates. The second variant, called diagonal NMF, supports the development of sparse diagonal structures in \nthe activation matrix. Our toolbox contains several demo applications and code examples to illustrate its potential and \nfunctionality. See also the [AudioLabs webpage](https://www.audiolabs-erlangen.de/resources/MIR/NMFtoolbox).\n\n## Installation Guide\nWe outline two primary methods for setting up ``libnmfd`` using pip and setting up a dedicated environment.\n\n### Method I: Installing with pip\nUtilize Python's package manager, pip, for a straightforward installation of ``libnmfd``:\n\n```\npip install libnmfd\n```\nNote: We advise performing this installation within a Python environment (such as conda or a virtual environment) \nto prevent any conflicts with other packages. Ensure your environment runs Python 3.7 or higher.\n\n### Method II: Setting Up a Conda Environment\nAlternatively, you can establish a conda environment specifically for ``libnmfd`` by employing the \n``environment_libnmfd.yml`` file. This approach not only installs ``libnmfd`` but also includes necessary packages like\nlibnmfd and jupyter to facilitate running demo files. Run the following command:\n\n\n```\nconda env create -f environment_libnmfd.yml\n```\n\n\n## Running Example Notebooks\nTo explore ``libnmfd`` through example notebooks:\n\n1. **Install ``libnmfd``:** Prior to cloning the repository and running the notebooks, ensure libnmfd and its dependencies are installed (as described above).\n2. **Clone the repository:** Download the ``libnmfd`` repository to your local machine using the following git command:\n   \n```\ngit clone https://github.com/groupmm/libnmfd.git\n```\n\n3. **Install Jupyter:** If not already installed via the conda environment setup, install Jupyter to run the notebooks:\n\n```\npip install jupyter\n```\n\n4. **Launch Jupyter Notebook:** Start the Jupyter notebook server by executing: \n```\njupyter notebook\n```\nThis will open a browser window from where you can navigate to and open the example notebooks.\n\n\n## Licence\nThe code for this toolbox is published under an [MIT licence](LICENCE).\n\n## References\n\n[1] Patricio López-Serrano, Christian Dittmar, Yiğitcan Özer, and Meinard Müller\\\n**NMF Toolbox: Music Processing Applications of Nonnegative Matrix Factorization** \\\nIn Proceedings of the International Conference on Digital Audio Effects (DAFx), 2019.\n\n[2] Christian Dittmar and Meinard Müller \\\n**Reverse Engineering the Amen Break — Score-Informed Separation and Restoration Applied to Drum Recordings** \\\nIEEE/ACM Transactions on Audio, Speech, and Language Processing, 24(9): 1531–1543, 2016. \n\n[3] Jonathan Driedger, Thomas Prätzlich, and Meinard Müller \\\n**Let It Bee — Towards NMF-Inspired Audio Mosaicing** \\\nIn Proceedings of the International Society for Music Information Retrieval Conference (ISMIR): 350–356, 2015. \n\n[4] Paris Smaragdis \\\n**Non-negative Matrix Factor Deconvolution; Extraction of Multiple Sound Sources from Monophonic Inputs** \\\nIn Proceedings of the International Conference on Independent Component Analysis and Blind Signal Separation \n(ICA): 494–499, 2004.\n\n[5] Daniel D. Lee and H. Sebastian Seung \\\n**Learning the parts of objects by non-negative matrix factorization** \\\nNature, 401(6755): 788–791, 1999. \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgroupmm%2Flibnmfd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgroupmm%2Flibnmfd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgroupmm%2Flibnmfd/lists"}