From 15b416470face87d293899af32d262623398cf13 Mon Sep 17 00:00:00 2001 From: yiitozer Date: Mon, 4 Mar 2024 13:17:12 +0100 Subject: [PATCH 01/11] Workflow and dir added for the paper --- .github/workflows/draft-pdf.yml | 23 +++++++++++++++++++++++ paper/paper.md | 0 2 files changed, 23 insertions(+) create mode 100644 .github/workflows/draft-pdf.yml create mode 100644 paper/paper.md diff --git a/.github/workflows/draft-pdf.yml b/.github/workflows/draft-pdf.yml new file mode 100644 index 0000000..7631024 --- /dev/null +++ b/.github/workflows/draft-pdf.yml @@ -0,0 +1,23 @@ +on: [push] + +jobs: + paper: + runs-on: ubuntu-latest + name: Paper Draft + steps: + - name: Checkout + uses: actions/checkout@v2 + - name: Build draft PDF + uses: openjournals/openjournals-draft-action@master + with: + journal: joss + # This should be the path to the paper within your repo. + paper-path: paper/paper.md + - name: Upload + uses: actions/upload-artifact@v1 + with: + name: paper + # This is the output path where Pandoc will write the compiled + # PDF. Note, this should be the same directory as the input + # paper.md + path: paper/paper.pdf diff --git a/paper/paper.md b/paper/paper.md new file mode 100644 index 0000000..e69de29 From 05b459f2431b17c7c8ac10e3d13ae10fdfa72ff6 Mon Sep 17 00:00:00 2001 From: yiitozer Date: Mon, 4 Mar 2024 13:21:14 +0100 Subject: [PATCH 02/11] Header added to markdown fle --- paper/paper.md | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/paper/paper.md b/paper/paper.md index e69de29..ef56515 100644 --- a/paper/paper.md +++ b/paper/paper.md @@ -0,0 +1,28 @@ +--- +title: 'libsoni: A Python Package for Music Sonification' +tags: + - Python + - Music information retrieval + - Music sonification +authors: + - name: Yigitcan Özer + orcid: 0000-0003-2235-8655 + affiliation: 1 + - name: Leo Brütting + affiliation: 1 + - name: Simon Schwär + orcid: 0000-0001-5780-557X + affiliation: 1 + - name: Meinard Müller + orcid: 0000-0001-6062-7524 + affiliation: 1 + +affiliations: + - name: International Audio Laboratories Erlangen + index: 1 +date: 12 March 2024 +bibliography: references.bib +link-citations: yes + +# Summary +Music can be described and represented in many different ways, including as sheet music, symbolic representations, and audio recordings [@Mueller15_FMP_SPRINGER]. For each of these representations, different versions (e.g., recordings performed by different orchestras and conductors) that correspond to the same musical work may exist. From fcbe0ddddb650f8abfa8453594d6bc16915eb613 Mon Sep 17 00:00:00 2001 From: yiitozer Date: Mon, 4 Mar 2024 13:23:23 +0100 Subject: [PATCH 03/11] references file added. --- paper/paper.md | 3 +-- paper/references.bib | 0 2 files changed, 1 insertion(+), 2 deletions(-) create mode 100644 paper/references.bib diff --git a/paper/paper.md b/paper/paper.md index ef56515..9afe00e 100644 --- a/paper/paper.md +++ b/paper/paper.md @@ -24,5 +24,4 @@ date: 12 March 2024 bibliography: references.bib link-citations: yes -# Summary -Music can be described and represented in many different ways, including as sheet music, symbolic representations, and audio recordings [@Mueller15_FMP_SPRINGER]. For each of these representations, different versions (e.g., recordings performed by different orchestras and conductors) that correspond to the same musical work may exist. +# Summary \ No newline at end of file diff --git a/paper/references.bib b/paper/references.bib new file mode 100644 index 0000000..e69de29 From 17b9d82a08ea5fe7415fccb0070f9cee0efd6404 Mon Sep 17 00:00:00 2001 From: yiitozer Date: Mon, 4 Mar 2024 13:26:50 +0100 Subject: [PATCH 04/11] maybe the whitespace was the problem? --- paper/paper.md | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/paper/paper.md b/paper/paper.md index 9afe00e..670de1a 100644 --- a/paper/paper.md +++ b/paper/paper.md @@ -16,12 +16,17 @@ authors: - name: Meinard Müller orcid: 0000-0001-6062-7524 affiliation: 1 - affiliations: - name: International Audio Laboratories Erlangen index: 1 date: 12 March 2024 bibliography: references.bib link-citations: yes +--- + +# Summary + +# Acknowledgements + -# Summary \ No newline at end of file +# References From 920edb23056ef83e8243e83f7e9438feca35ebde Mon Sep 17 00:00:00 2001 From: yiitozer Date: Mon, 4 Mar 2024 16:38:33 +0100 Subject: [PATCH 05/11] ? --- paper/paper.md | 1 - 1 file changed, 1 deletion(-) diff --git a/paper/paper.md b/paper/paper.md index 670de1a..9998a9f 100644 --- a/paper/paper.md +++ b/paper/paper.md @@ -28,5 +28,4 @@ link-citations: yes # Acknowledgements - # References From 5fcdfdcea755743191654daa01126156d1805908 Mon Sep 17 00:00:00 2001 From: yiitozer Date: Mon, 4 Mar 2024 13:17:12 +0100 Subject: [PATCH 06/11] Workflow and dir added for the paper --- .github/workflows/draft-pdf.yml | 23 +++++++++++++++++++++++ paper/paper.md | 0 2 files changed, 23 insertions(+) create mode 100644 .github/workflows/draft-pdf.yml create mode 100644 paper/paper.md diff --git a/.github/workflows/draft-pdf.yml b/.github/workflows/draft-pdf.yml new file mode 100644 index 0000000..7631024 --- /dev/null +++ b/.github/workflows/draft-pdf.yml @@ -0,0 +1,23 @@ +on: [push] + +jobs: + paper: + runs-on: ubuntu-latest + name: Paper Draft + steps: + - name: Checkout + uses: actions/checkout@v2 + - name: Build draft PDF + uses: openjournals/openjournals-draft-action@master + with: + journal: joss + # This should be the path to the paper within your repo. + paper-path: paper/paper.md + - name: Upload + uses: actions/upload-artifact@v1 + with: + name: paper + # This is the output path where Pandoc will write the compiled + # PDF. Note, this should be the same directory as the input + # paper.md + path: paper/paper.pdf diff --git a/paper/paper.md b/paper/paper.md new file mode 100644 index 0000000..e69de29 From 1b94dc179ab3fe42e5a9a68de5b3bffe300168c8 Mon Sep 17 00:00:00 2001 From: yiitozer Date: Mon, 4 Mar 2024 13:21:14 +0100 Subject: [PATCH 07/11] Header added to markdown fle --- paper/paper.md | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/paper/paper.md b/paper/paper.md index e69de29..ef56515 100644 --- a/paper/paper.md +++ b/paper/paper.md @@ -0,0 +1,28 @@ +--- +title: 'libsoni: A Python Package for Music Sonification' +tags: + - Python + - Music information retrieval + - Music sonification +authors: + - name: Yigitcan Özer + orcid: 0000-0003-2235-8655 + affiliation: 1 + - name: Leo Brütting + affiliation: 1 + - name: Simon Schwär + orcid: 0000-0001-5780-557X + affiliation: 1 + - name: Meinard Müller + orcid: 0000-0001-6062-7524 + affiliation: 1 + +affiliations: + - name: International Audio Laboratories Erlangen + index: 1 +date: 12 March 2024 +bibliography: references.bib +link-citations: yes + +# Summary +Music can be described and represented in many different ways, including as sheet music, symbolic representations, and audio recordings [@Mueller15_FMP_SPRINGER]. For each of these representations, different versions (e.g., recordings performed by different orchestras and conductors) that correspond to the same musical work may exist. From a7076542997d30ce1154228e6d7259eec0ae247b Mon Sep 17 00:00:00 2001 From: yiitozer Date: Mon, 4 Mar 2024 13:23:23 +0100 Subject: [PATCH 08/11] references file added. --- paper/paper.md | 3 +-- paper/references.bib | 0 2 files changed, 1 insertion(+), 2 deletions(-) create mode 100644 paper/references.bib diff --git a/paper/paper.md b/paper/paper.md index ef56515..9afe00e 100644 --- a/paper/paper.md +++ b/paper/paper.md @@ -24,5 +24,4 @@ date: 12 March 2024 bibliography: references.bib link-citations: yes -# Summary -Music can be described and represented in many different ways, including as sheet music, symbolic representations, and audio recordings [@Mueller15_FMP_SPRINGER]. For each of these representations, different versions (e.g., recordings performed by different orchestras and conductors) that correspond to the same musical work may exist. +# Summary \ No newline at end of file diff --git a/paper/references.bib b/paper/references.bib new file mode 100644 index 0000000..e69de29 From f395ef54a2cdc1df0f92d7acffb4be88aad356bc Mon Sep 17 00:00:00 2001 From: yiitozer Date: Mon, 4 Mar 2024 13:26:50 +0100 Subject: [PATCH 09/11] maybe the whitespace was the problem? --- paper/paper.md | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/paper/paper.md b/paper/paper.md index 9afe00e..670de1a 100644 --- a/paper/paper.md +++ b/paper/paper.md @@ -16,12 +16,17 @@ authors: - name: Meinard Müller orcid: 0000-0001-6062-7524 affiliation: 1 - affiliations: - name: International Audio Laboratories Erlangen index: 1 date: 12 March 2024 bibliography: references.bib link-citations: yes +--- + +# Summary + +# Acknowledgements + -# Summary \ No newline at end of file +# References From ee6704306be538dbcc80680fdfda1cb53938a28f Mon Sep 17 00:00:00 2001 From: yiitozer Date: Mon, 4 Mar 2024 16:38:33 +0100 Subject: [PATCH 10/11] ? --- paper/paper.md | 1 - 1 file changed, 1 deletion(-) diff --git a/paper/paper.md b/paper/paper.md index 670de1a..9998a9f 100644 --- a/paper/paper.md +++ b/paper/paper.md @@ -28,5 +28,4 @@ link-citations: yes # Acknowledgements - # References From bfc0cfd88e0524e702edc5677f4bda0f482663be Mon Sep 17 00:00:00 2001 From: yiitozer Date: Mon, 11 Mar 2024 11:13:02 +0100 Subject: [PATCH 11/11] summary update --- paper/paper.md | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/paper/paper.md b/paper/paper.md index 9998a9f..94bb25c 100644 --- a/paper/paper.md +++ b/paper/paper.md @@ -25,6 +25,33 @@ link-citations: yes --- # Summary +Music Information Retrieval (MIR) stands as a dedicated research field focused on advancing methodologies and tools for +organizing, analyzing, retrieving, and generating data related to music. Key tasks within MIR include beat tracking, +structural analysis, chord recognition, melody extraction, and source separation, just to name a few. These tasks +involve extracting musically relevant information from audio recordings, typically accomplished by transforming music +signals into feature representations such as spectrograms, chromagrams, or tempograms~\citep{Mueller15_FMP_SPRINGER}. +Furthermore, musically relevant annotations such as beats, chords, keys, or structure boundaries become +indispensable for training and evaluating MIR approaches. + +When evaluating and enhancing MIR systems, it is crucial to thoroughly examine the properties of feature representations +and annotations to gain a deeper understanding of algorithmic behavior and the underlying data. In the musical context, +alongside conventional data visualization techniques, data sonification techniques are emerging as a promising avenue +for providing auditory feedback on extracted features or annotated information. This is particularly advantageous given +the finely tuned human perception to subtle variations in frequency and timing within the musical domain. + +This paper introduces \emph{libsoni}, an open-source Python toolbox tailored for the sonification of music annotations +and feature representations. By employing explicit and easy-to-understand sound synthesis techniques, libsoni offers +functionalities for generating and triggering sound events, enabling the sonification of spectral, harmonic, tonal, +melodic, and rhythmic aspects. Unlike existing software libraries focused on creative applications of sound generation, +libsoni is designed to meet the specific needs of MIR researchers and educators. It aims to simplify the process of +music exploration, promoting a more intuitive and efficient approach to data analysis by enabling users to interact with +their data in acoustically meaningful ways. As a result, libsoni not only improves the analytical capabilities of music +scientists but also opens up new avenues for innovative music analysis and discovery. +% +Furthermore, libsoni provides well-documented and stand-alone functions covering all essential building blocks crucial +for both sound generation and sonification, enabling users to efficiently apply and easily extend the methods. +Additionally, the toolbox includes educational Jupyter notebooks with illustrative code examples demonstrating the +application of sonification and visualization methods to deepen understanding within specific MIR scenarios. # Acknowledgements