Unterschiede
Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
Beide Seiten der vorigen Revision Vorhergehende Überarbeitung Nächste Überarbeitung | Vorhergehende Überarbeitung Letzte Überarbeitung Beide Seiten der Revision | ||
en:interaktive_musikanalyse [2022/01/05 12:01] sebastiane [Settings] |
en:interaktive_musikanalyse [2023/07/27 20:48] sebastiane [The Interactive Music Analysis Tool (I-MaT)] |
||
---|---|---|---|
Zeile 1: | Zeile 1: | ||
- | ===== Interactive Music Analysis Tool (I-MaT) ===== | + | ===== The Interactive Music Analysis Tool (I-MaT) ===== |
- | The modular program // | + | The modular program // |
- | Results can be achieved quickly by navigating through simple dialog windows and the selection from the options displayed. The results (visualizations, | + | Results can be achieved quickly by navigating through simple dialog windows and the selection from the options displayed. The results (visualizations, |
Programm code: Sebastian Oliver Eck | Programm code: Sebastian Oliver Eck | ||
- | ==== Download | + | ==== Documentation |
- | It is necessary | + | I-MaT is an innovative tool designed |
+ | The sections contained within the documentation provide detailed information on how to use the Interactive Music Analysis Tool, from [[https:// | ||
- | === Downloading | + | This documentation provides you with the necessary knowledge to navigate I-MaT, explore its features, and conduct your own analyses by using the tool! |
- | Please download the Python script (//right click, save link as//). | + | ==== How To Install, Start and Use I-MaT ==== |
- | If possible, save this on your desktop (Windows/ | + | |
- | * [[https:// | + | |
+ | ===Installation=== | ||
- | === Starting | + | //First//, open the Command Prompt/ |
+ | **Windows** | ||
- | == 1. Opening | + | There are several ways to access |
+ | * Press the '' | ||
+ | * In the Run dialog box, type '' | ||
+ | **macOS** | ||
- | Open the //Anaconda Powershell Prompt/ | + | There are several ways to access |
- | Start > Anaconda 3 (64-bit) > Anaconda Powershell Prompt (anaconda3) bzw. Anaconda Prompt (anaconda3) | + | * Open '' |
+ | * Navigate to the '' | ||
+ | * Locate and double-click on '' | ||
- | On Mac you will find the //Anaconda Powershell Prompt/ | + | Alternatively: |
- | == Alternative: | + | * Press '' |
+ | * type '' | ||
- | Alternatively, on Windows you may be able to choose one of the following | + | //Second//, install the Interactive Music Analysis Tool (I-MaT). Do this by typing |
- | | + | <code> |
+ | pip install imat | ||
+ | </code> | ||
- | In this case you can skip //2. Activation of the project-specific Python environment// | + | Note: The installation is necessary only once. After successfully installing I-MaT, start the tool by following |
+ | MuseScore Installation: | ||
- | == 2. Activation | + | **Attention: |
+ | The installation of MuseScore is free of charge and is therefore **strongly recommended**. MuseScore can be directly downloaded from [[https:// | ||
+ | ===Starting I-MaT=== | ||
- | When opening | + | To run the tool, simply type the following command into your Command |
- | | + | < |
+ | imat | ||
+ | </code> | ||
- | Then enter //' | + | After starting I-MaT, the following menu will be displayed within your console: |
- | | + | <code> |
+ | I-MaT - Interactive Music Analysis Tool, v3.2.1, (2023). Project: " | ||
- | Note: Instead | + | Department |
- | The content of the bracket preceding the line should now have changed as follows: | + | MIT License, Copyright (c) 2023 S.O. Eck. |
- | | + | ---------------------------------------------------------------------- |
- | If you now see an error message, jump to the menu "// | + | LOCATION: Start Menu |
+ | Please make a selection from the options below by entering the entry index number: | ||
+ | No. Menu item < | ||
- | == 3. Starting the program == | + | 1 PROG: Analysis of one sheet music file < |
+ | 2 CONV: Conversion of multiple music files < | ||
+ | 3 TOKE: Tokenisation of multiple music files < | ||
+ | 4 CONF: Update Software Paths and Preferences | ||
+ | Which menu item should be executed? (<No. of menu item>): | ||
+ | </ | ||
+ | Figure 1: The Interactive Music Analysis Tool (I-MaT) - Start Menu (version 3.2.1) | ||
+ | Using the program is relatively straight-forward - the program' | ||
- | Now enter // ' | + | ==== Notes and Support ==== |
- | //' | + | |
- | | + | **Warning:** When starting |
- | Note: Pay attention to entering the double quotation marks! | + | You will be guided through this entire process by I-MaT. |
- | Example: with the program file saved on the desktop (Windows): | + | 4 CONF: Update Software Paths and Preferences |
- | | + | The settings can later be adjusted by choosing the menu entries shown above within |
+ | If all of the above was too fast, don't worry! | ||
- | The program starts after a few seconds! | + | You can find a detailed User Guide for how to install and start I-MaT in the Online Documentation' |
+ | If you have any difficulties with using the program or if you have any questions or suggestions on how to further improve I-MaT' | ||
+ | ==== I-MaT: Features and Accessibility ==== | ||
- | === Troubleshooting === | + | Addressing the steep learning curve often encountered with Python-based music analysis tools like Music21 or CAMAT, the Interactive Music Analysis Tool (I-MaT) was designed specifically with user accessibility in mind. I-MaT utilizes a new and innovative approach to access, work with and implement various python libraries, such as, but not limited to, music21 or MidiTok for textual music analysis, within one unified, user friendly text-based command-line-interface (CLI). |
+ | I-MaT allows users to quickly obtain results by navigating through simple dynamic menu structures and selecting methods and tools from predefined options (see Figure 1). The tool uses an accessible and easily extendable text-based CLI, with the underlying Music21 and MidiTok commands remaining invisible to the user. While requiring minimal familiarity with command-line environments, | ||
+ | This compromise was necessary to keep the barrier to entry as low as possible, and to encourage a broad usage and user-based participation in the tool's ongoing development via [[https:// | ||
- | If you enter the command: | + | While virtually encompassing all the functionalities of the integrated python packages for music information retrieval/ |
- | | + | With all those benefits at hand, I-MaT is a very flexible and powerful tool that could cater to the needs of a diverse range of users, from novice music analysts to advanced researchers. |
- | and receive an error message, either the project-specific Python environment '// | + | ==== Education |
- | | + | In addition to its analytical capabilities, |
- | The following list shows the project-specific Python environments installed on your computer. | + | I-MaT’s various functionalities could provide valuable support for music and musicology courses at both high school and university levels. Its user-friendly interface and simple installation make it an ideal tool for students to quickly obtain results and explore various analytical approaches using computational methods, allowing them to gain a deeper understanding of the musical works they are studying. |
- | # conda environments: | + | Furthermore, |
- | # | + | |
- | | + | |
- | hfm_1.0.0 C: | + | |
- | If the current version of //' | + | By using I-MaT, students can develop valuable analytical skills that are useful not only in musicology but also in other areas of the humanities where data-driven methods are becoming increasingly important. |
+ | The Interactive Music Analysis Tool, I-MaT, should be seen as a contribution to Computational Musicology or Digital Musicology within the Digital Humanities. | ||
+ | ==== External Links/ | ||
- | ==== Using the program ==== | + | [[https:// |
+ | “// | ||
+ | Presentation of Sebastian Oliver Eck: // | ||
+ | Online-Dokumentation (readthedocs.io): | ||
- | The program is self-explanatory: What you have to do next is in front of the blinking cursor. If there are several options, they are displayed in a list from which you can select an option by entering a number. | + | GitHub Repository: https:// |
- | When using it for the first time, you must also configure certain //music21// settings, if you have not already done this for the Jupyter notebooks. When the program starts, you will be guided through the configuration of your //music21// settings file. | + | PyPi Repository: https://pypi.org/project/imat/ |
- | + | ||
- | See: [[en:interaktive_musikanalyse# | + | |
- | + | ||
- | Then please select: | + | |
- | | + | |
- | + | ||
- | After you have loaded a sheet music file, you come to the so-called main menu, which in its rough structure corresponds to the structure of the //Jupyter-Notebooks Basics//: | + | |
- | + | ||
- | | + | |
- | | + | |
- | | + | |
- | | + | |
- | | + | |
- | | + | |
- | | + | |
- | + | ||
- | All further steps are self-explanatory. Enjoy! | + | |
- | + | ||
- | + | ||
- | ====Settings==== | + | |
- | + | ||
- | When using it for the first time, you have to configure the //music21// settings so that you can download music files from the Internet and your music editor (// | + | |
- | 2 SETT: Settings | + | |
- | + | ||
- | If you select the following option: | + | |
- | 3 ENVT: Einstellungen neu konfigurieren | + | |
- | + | ||
- | you will first be asked to delete the existing settings file. Agree to that. You will then be given the option to reconfigure the settings file. You have to have the local path to your sheet music editor (e.g. MuseScore3.exe) as well as to your folder for the exported graphics, sheet music files and tables ready. | + |