libfmp
libfmp: A Python Package for Fundamentals of Music Processing - Published in JOSS (2021)
Science Score: 93.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
✓DOI references
Found 2 DOI reference(s) in README and JOSS metadata -
✓Academic publication links
Links to: mdpi.com, joss.theoj.org -
○Committers with academic emails
-
○Institutional organization owner
-
✓JOSS paper metadata
Published in Journal of Open Source Software
Keywords
Scientific Fields
Repository
libfmp - Python package for teaching and learning Fundamentals of Music Processing (FMP)
Basic Info
- Host: GitHub
- Owner: meinardmueller
- License: other
- Language: Python
- Default Branch: master
- Homepage: https://meinardmueller.github.io/libfmp
- Size: 7.04 MB
Statistics
- Stars: 210
- Watchers: 5
- Forks: 19
- Open Issues: 0
- Releases: 9
Topics
Metadata Files
README.md
libfmp
This repository contains the Python package libfmp. This package goes hand in hand with the FMP Notebooks, a collection of educational material for teaching and learning Fundamentals of Music Processing (FMP) with a particular focus on the audio domain. For detailed explanations and example appliciations of the libfmp-functions we refer to the FMP Notebooks:
https://audiolabs-erlangen.de/FMP
The FMP notebooks also contain a dedicated notebook for libfmp:
https://www.audiolabs-erlangen.de/resources/MIR/FMP/B/B_libfmp.html
There is also an API documentation for libfmp:
https://meinardmueller.github.io/libfmp
If you use the package libfmp, please consider the following references.
References
Meinard Müller and Frank Zalkow. libfmp: A Python Package for Fundamentals of Music Processing. Journal of Open Source Software (JOSS), 6(63), 2021.
Meinard Müller and Frank Zalkow. FMP Notebooks: Educational Material for Teaching and Learning Fundamentals of Music Processing. Proceedings of the International Conference on Music Information Retrieval (ISMIR), pp. 573–580, Delft, The Netherlands, 2019.
Meinard Müller. Fundamentals of Music Processing – Using Python and Jupyter Notebooks. Springer Verlag, 2nd edition, 2021.
Meinard Müller. An Educational Guide Through the FMP Notebooks for Teaching and Learning Fundamentals of Music Processing. Signals, 2(2): 245–285, 2021.
Statement of Need
The libfmp package bundles core concepts from the music information retrieval (MIR) field in the form of well-documented and easy-to-use Python functions. It is designed to aid students with the transition from being learners (e.g., studying the FMP notebooks) to becoming researchers by providing proper software support for building and experimenting with complex MIR pipelines. Going beyond and complementing existing Python packages (such as librosa), the libfmp package contains (previously unpublished) reference implementations of MIR algorithms from the literature and new Python implementations of previously published MATLAB toolboxes. The functionality of libfmp addresses diverse MIR tasks such as tuning estimation, music structure analysis, audio thumbnailing, chord recognition, tempo estimation, beat and local pulse tracking, fragment-level music retrieval, and audio decomposition.
Installing
With Python >= 3.6, you can install libfmp using the Python package manager pip:
pip install libfmp
Contributing
The libfmp-package has been developed in the context of the FMP notebooks. Being an integral part, all libfmp-functions need to manually synchronized with text passages, explanations, and the code in the FMP notebooks. Of course, we are happy for suggestions and contributions. However, to facilitate the synchronization, we would be grateful for either directly contacting us via email (meinard.mueller@audiolabs-erlangen.de) or for creating an issue in our GitHub repository. Please do not submit a pull request without prior consultation with us.
If you want to report an issue with libfmp or seek support, please use the same communication channels (email or GitHub issue).
Tests
The functions of libmfp are also covered in the FMP notebooks. There, you find several test cases for the functions, showing typical input-output behaviors. Beyond these tests, the FMP notebooks offer extensive explanations of these functions. Thus, we consider FMP as a replacement for conventional unit tests.
Furthermore, we provide a small script that tests one function of each subpackage from libfmp. Rather than covering the full functionality of libfmp, it only verifies the correct import structure within the libfmp package.
There are two options for executing the test script. The first is just to run the script, which results in no output if there are no errors.
python test_examples.py
The second option is to use pytest, which results in a more instructive output. pytest is available when installing libfmp with the extra requirements for testing.
pip install 'libfmp[tests]'
pytest test_examples.py
Acknowledgements
The main authors of libfmp, Meinard Müller and Frank Zalkow, are associated with the International Audio Laboratories Erlangen, which are a joint institution of the Friedrich-Alexander-Universität Erlangen-Nürnberg (FAU) and Fraunhofer Institute for Integrated Circuits IIS. We thank the German Research Foundation (DFG) for various research grants that allow us for conducting fundamental research in music processing. Furthermore, we thank the various people who have contributed to libfmp with code and suggestions. In particular, we want to thank (in alphabetic order) Stefan Balke, Michael Krause, Patricio Lopez-Serrano, Julian Reck, Sebastian Rosenzweig, Angel Villar-Corrales, Christof Weiß, and Tim Zunner.
Owner
- Name: Meinard Mueller
- Login: meinardmueller
- Kind: user
- Location: Erlangen, Germany
- Company: International Audio Laboratories Erlangen
- Website: https://www.audiolabs-erlangen.de/fau/professor/mueller
- Repositories: 4
- Profile: https://github.com/meinardmueller
JOSS Publication
libfmp: A Python Package for Fundamentals of Music Processing
Authors
International Audio Laboratories Erlangen
International Audio Laboratories Erlangen
Editor
Arfon Smith
Tags
Music information retrievalGitHub Events
Total
- Issues event: 2
- Watch event: 12
- Issue comment event: 8
- Push event: 1
- Fork event: 2
Last Year
- Issues event: 2
- Watch event: 12
- Issue comment event: 8
- Push event: 1
- Fork event: 2
Committers
Last synced: 5 months ago
Top Committers
| Name | Commits | |
|---|---|---|
| Frank Zalkow | f****w@a****e | 31 |
| Meinard Müller | m****r@a****e | 8 |
| pkendrick | 9****k | 2 |
| mikezzb | m****v@g****m | 1 |
| Thomas Prätzlich | T****r | 1 |
Committer Domains (Top 20 + Academic)
Issues and Pull Requests
Last synced: 4 months ago
All Time
- Total issues: 12
- Total pull requests: 4
- Average time to close issues: 25 days
- Average time to close pull requests: about 7 hours
- Total issue authors: 10
- Total pull request authors: 4
- Average comments per issue: 2.25
- Average comments per pull request: 1.5
- Merged pull requests: 4
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 2
- Pull requests: 0
- Average time to close issues: 19 days
- Average time to close pull requests: N/A
- Issue authors: 2
- Pull request authors: 0
- Average comments per issue: 4.0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
- expectopatronum (3)
- pkendrick (1)
- mikezzb (1)
- faroit (1)
- fabianostermann (1)
- 980202006 (1)
- progsi (1)
- yiitozer (1)
- spencersalazar (1)
- ytinyui (1)
Pull Request Authors
- mikezzb (1)
- arfon (1)
- pkendrick (1)
- TGabor (1)
Top Labels
Issue Labels
Pull Request Labels
Packages
- Total packages: 1
-
Total downloads:
- pypi 1,255 last-month
- Total docker downloads: 59
- Total dependent packages: 4
- Total dependent repositories: 7
- Total versions: 9
- Total maintainers: 3
pypi.org: libfmp
Python module for fundamentals of music processing
- Homepage: http://audiolabs-erlangen.de/FMP
- Documentation: https://libfmp.readthedocs.io/
- License: MIT
-
Latest release: 1.2.6
published almost 2 years ago
Rankings
Maintainers (3)
Dependencies
- ipython *
- librosa *
- matplotlib *
- music21 *
- numba *
- numpy *
- pandas *
- pretty_midi *
- pysoundfile *
- scipy *
- ipython ==7.8.
- librosa ==0.8.
- matplotlib ==3.3.
- music21 ==5.7.
- numba ==0.56.
- numpy ==1.19.
- pandas ==1.1.
- pretty_midi ==0.2.
- scipy ==1.5.
- soundfile ==0.9.
- sphinx ==4.0.
- sphinx_rtd_theme ==0.5.