Unterschiede
Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
Beide Seiten der vorigen Revision Vorhergehende Überarbeitung Nächste Überarbeitung | Vorhergehende Überarbeitung Nächste Überarbeitung Beide Seiten der Revision | ||
en:interaktive_musikanalyse [2022/01/05 12:01] sebastiane [Settings] |
en:interaktive_musikanalyse [2023/07/27 11:14] sebastiane |
||
---|---|---|---|
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 |
+ | ===Starting I-MaT=== | ||
- | == 2. Activation of the project-specific Python environment == | + | To run the tool, simply type the following command into your Command Prompt/ |
+ | < | ||
+ | imat | ||
+ | </ | ||
+ | After starting I-MaT, the following menu will be displayed within your console: | ||
- | When opening the //Anaconda Powershell Prompt/ | + | < |
+ | I-MaT - Interactive Music Analysis Tool, v3.2.1, (2023). Project: " | ||
- | | + | Department of Musicology Weimar-Jena, |
- | Then enter //' | + | MIT License, Copyright (c) 2023 S.O. Eck. |
- | | + | ---------------------------------------------------------------------- |
- | Note: Instead of //' | + | LOCATION: Start Menu |
- | The content of the bracket preceding | + | Please make a selection from the options below by entering |
- | | + | No. Menu item < |
- | If you now see an error message, jump to the menu "// | + | 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' | ||
- | == 3. Starting the program | + | ==== Notes and Support ==== |
+ | **Warning: | ||
+ | You will be guided through this entire process by I-MaT. | ||
- | Now enter // ' | + | 4 CONF: Update Software Paths and Preferences |
- | //' | + | |
- | | + | The settings can later be adjusted by choosing the menu entries shown above within |
- | Note: Pay attention to entering | + | If all of the above was too fast, don't worry! |
- | Example: with the program file saved on the desktop (Windows): | + | You can find a detailed User Guide for how to install and start I-MaT in the Online Documentation' |
- | (hfm_1.x.x) C: | + | 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 ==== | ||
- | The program starts after a few seconds! | + | 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 |
+ | 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:// | ||
- | === Troubleshooting === | + | 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. | ||
+ | ==== Education and Training ==== | ||
- | If you enter the command: | + | In addition to its analytical capabilities, |
- | | + | 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. |
- | and receive an error message, either the project-specific Python environment '// | + | Furthermore, I-MaT’s modular design opens possibilities for launching educational projects centered around musicological programming, with the added advantage of seamlessly integrating their outcomes and functions into I-MaT through collaborative platforms like GitHub. |
- | | + | 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 following list shows the project-specific Python environments installed on your computer. | + | The Interactive Music Analysis Tool, I-MaT, should be seen as a contribution to Computational Musicology or Digital Musicology within the Digital Humanities. |
- | # conda environments: | + | ==== Further Information (External Links) ==== |
- | # | + | |
- | | + | |
- | | + | |
- | If the current version of //'hfm_1.x.x'// is missing here, install the project-specific Python environments by following the //installation instructions// under [[en: | + | [[https://jadh2023.nijl.ac.jp/home|JADH2023]]: |
+ | “//Possibilities for Data-Driven Humanities//”, National Institute of Japanese Literature (online), 20.9. - 22.9. 2023, \\ | ||
+ | Presentation of Sebastian Oliver Eck: //Interactive Music Analysis Tool (I-MaT)// | ||
+ | Online-Dokumentation (readthedocs.io): | ||
+ | GitHub Repository: https:// | ||
- | ==== Using the program ==== | + | PyPi Repository: https://pypi.org/project/imat/ |
- | + | ||
- | + | ||
- | 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. | + | |
- | + | ||
- | When using it for the first time, you must also configure certain | + | |
- | + | ||
- | See: [[en: | + | |
- | + | ||
- | 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 // | + | |
- | + | ||
- | | + | |
- | | + | |
- | | + | |
- | | + | |
- | | + | |
- | | + | |
- | | + | |
- | + | ||
- | 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. | + |