Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- en:interaktive_musikanalyse [2023/07/27 10:09]
sebastiane updated WikiPage
+++ en:interaktive_musikanalyse [2023/08/22 10:43]
martin [How To Install, Start and Use I-MaT]
@@ Zeile 1: / Zeile 1: @@
-===== Interactive Music Analysis Tool (I-MaT) =====
+===== The Interactive Music Analysis Tool (I-MaT) =====
-The modular program //Interactive Music Analysis Tool (I-MaT)// produces visualizations of and statistical analyses of sheet music files. The basic idea is to choose between the various options listed by entering //yes//-//no// or numbers (//1, 2, 3 //etc.). The //music21// commands on which the program is based are not visible to the user.
+The modular program //Interactive Music Analysis Tool (I-MaT)// produces visualizations and statistical analyses of sheet music files. The basic idea is to choose between the various menu options listed by entering corresponding index numbers (//1, 2, 3 //etc.). The //music21/////MidiTok// commands on which the program is based are not visible to the user.
-Results can be achieved quickly by navigating through simple dialog windows and the selection from the options displayed. The results (visualizations, diagrams, transformed sheet music files, CSV files) are displayed in external programs (//MuseScore//, //matplotlib//), in which they can then be further processed or exported.
+Results can be achieved quickly by navigating through simple dialog windows and the selection from the options displayed. The results (visualizations, diagrams, transformed sheet music files, CSV files) can be displayed within I-MaT as well as exported in order to be opened in external programs (//MuseScore//, //PSPP/SPSS//), in which they can then be further processed.
 Programm code: Sebastian Oliver Eck
@@ Zeile 17: / Zeile 17: @@
 ==== How To Install, Start and Use I-MaT ====
-//First//, open the terminal in Windows/Mac by executing the following steps:
+===Installation===
-**Windows:** There are several ways to access the Command Prompt in Windows, here's one:
+//First//, please, open the Command Prompt/Terminal in Windows/Mac by executing the following steps:
-Press the ''Windows key + R'' to open the Run dialog box.
+**Windows**
-In the Run dialog box, type ''cmd'' and then press ''Enter''. This will open the Command Prompt window.
+There are several ways to access the Command Prompt in Windows, here's one:
-**macOS:** There are several ways to access the Terminal in macOS, here's one:
+  * Press the ''Windows key + R'' to open the Run dialog box.
+  * In the Run dialog box, type ''cmd'' and then press ''Enter''. This will open the Command Prompt window.
-Open ''Finder''.
+**macOS**
-Navigate to the ''Applications'' folder, then go to ''Utilities''.
+There are several ways to access the Terminal in macOS, here are two:
-Locate and double-click on ''Terminal'' to open it.
+  * Open ''Finder''.
+  * Navigate to the ''Applications'' folder, then go to ''Utilities''.
+  * Locate and double-click on ''Terminal'' to open it.
-//Second//, install the Interactive Music Analysis Tool (I-MaT). Do this by typing the following line into the Terminal window:
+Alternatively:
+  * Press ''Command + Space'' to bring up ''Spotlight'',
+  * type ''terminal'', and hit Enter.
+//Second//, please, install the Interactive Music Analysis Tool (I-MaT). Do this by typing the following line into the Command Prompt/Terminal window:
 <code>
@@ Zeile 39: / Zeile 47: @@
 </code>
-//Third//, to run the tool, simply type the following command into your shell:
+Note: The installation is necessary only once. After successfully installing I-MaT, start the tool by following the steps below.
+MuseScore Installation:
+**Attention:** Users who want to use all functions of I-MaT must necessarily install a notation program, such as the free program MuseScore.
+The installation of MuseScore is free of charge and is therefore **strongly recommended**. MuseScore can be directly downloaded from [[https://musescore.org/en]].
+===Starting I-MaT===
+To run the tool, simply type the following command into your Command Prompt/Terminal window:
 <code>
@@ Zeile 75: / Zeile 93: @@
 ==== Notes and Support ====
-**Warning:** When starting I-MaT for the first time, in the most cases you have to configure the //music21// settings so that you can download music files from the Internet as well as display music files within a music editor (i.e., //MuseScore3//).
+**Warning:** When starting I-MaT for the first time, in the most cases you have to configure the //music21// settings so that you can download music files from the Internet as well as display music files within a music editor (i.e., //MuseScore//).
 You will be guided through this entire process by I-MaT.
@@ Zeile 101: / Zeile 119: @@
 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 ===
+==== Education and Training ====
 In addition to its analytical capabilities, I-MaT serves as an effective didactic tool, further bridging the gap between musicology and the broader field of computer-assisted analysis and Music Information Retrieval (MIR).
@@ Zeile 113: / Zeile 131: @@
 The Interactive Music Analysis Tool, I-MaT, should be seen as a contribution to Computational Musicology or Digital Musicology within the Digital Humanities.
-===== Further Information (External Links) =====
+==== External Links/Sources ====
+[[https://jadh2023.nijl.ac.jp/home|JADH2023]]: 12th annual conference of the Japanese Association for Digital Humanities (JADH), \\
+“//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): https://i-mat.readthedocs.io/en/latest/