===== Installation für Mac =====
 

====1a. Anaconda====

Die OSX-Distribution von //Anconda// wird als ein Installationspaket angeboten. Es können durchgehend alle per default vorausgewählten Insallationsoptionen akzeptiert werden. Nach der Fertigstellung der Installation kann //Anaconda// im Terminal direkt eingerichtet werden. Um zu verifizieren, dass //Anaconda// korrekt installiert und auf den neusten Stand ist verwendet man den Befehl:

<code>conda --version</code>

sowie

<code>conda update conda</code>

Diese Befehle müssen die Version von //Anaconda// anzeigen und die eventuell für das Update verfügbare Module auflisten; man wird dabei gefragt, ob man die Updates installieren will. Für unsere Zwecke ist ein Update nicht erforderlich, es genügt also die Angabe „n“ (für Update: „y“):

{{:wiki:conda_osx_prompt.png?600|}}


====1b. Miniconda (alternativ zu Anaconda)====

//Miniconda// wird für OSX in zwei Versionen angeboten - als bash-script oder als pkg-Install. Das Bash-Script kann entsprechend in Terminal mit "bash" ausgeführt werden. Es wird empfohlen, die Aufforderung "Do you wish the installer to initialize Anaconda3 by running conda init?” mit "Yes" zu beantworten. Damit wird die Conda-Eingabe in das Terminal integriert (dies erfolgt automatisch bei der pkg-Version). 

<code>shasum -a 256 /Pfad/Dateiname</code>

Ersetzen Sie **/Pfad/Dateiname** durch Ihren Installationspfad und den Dateinamen.

{{ :shasum_mac_installation.png?nolink&600 |}}

Zur Installation der Command Line wird der entsprechende Befehl benötigt:

<code> bash ~/Downloads/Anaconda3-2020.02-MacOSX-x86_64.sh </code>

Der Befehl **bash ~ /** muss ebenfalls um dem Pfad der heruntergeladenen Command-Line-Datei ergänzt werden. Der Pfad wird mit dem sekundären Klick abgerufen; damit wird ein Menü geöffnet, in das Sie die Dateien kopieren. Halten Sie bei geöffnetem Menü die Optionstaste (⌥) gedrückt.

{{ :bash_mac_installation.png?nolink&600 |}}

Um den Pfad des **miniconda3**-Ordners zu finden, gehen Sie zu **Spotlight-Suche**, dann verwenden Sie die gleiche Vorgehensweise, um den Pfad zu kopieren (Sekundärklick + Option / Alt-Taste (⌥) + Kopieren)

{{ :pfadekopieren_mac_installation.png?nolink&600 |}}

Um die Terminal-Integration außerhalb von Bash-Script zu aktivieren, müssen Sie Folgendes eingeben (der Conda-Pfad muss entsprechend individuell angepasst werden):

<code>source *Pfad zur Conda*/bin/activate</code>

{{ :source_mac_installation.png?nolink |}}

Und anschließend:

<code>conda init zsh</code> oder <code>conda init</code>

Damit wird die Conda-Eingabe nahtlos in das Terminal integriert und man kann mit der Einrichtung der projektspezifischen Python-Umgebung fortsetzen!

====2. Projektspezifischen Python-Umgebung====

Anschließend müssen Sie mit Hilfe eines yml-Scripts die für das Analyse-Projekt notwendigen Zusatzmodule installieren. Dazu muss eine spezielle yml-Datei angebunden werden:\\ 
Laden Sie zunächst die aktuelle Datei [[https://analyse.hfm-weimar.de/scripts/hfm_1.1.2.yml|hfm_x.x.x.yml]] auf ihren lokalen Rechner (Rechtsklick -> Ziel speichern unter). Bitte ersetzen im Folgenden die Bezeichnung 'hfm_x.x.x.yml' durch die Bezeichnung der aktuellen Version, die Sie heruntergeladen haben, z.B. 'hfm_1.1.2.yml'.\\ 

Für Mac-Computer werden die herunterladbaren Dateien leider im .txt-Format gespeichert. Sie müssen diese Dateien manuell ändern (sekundärer Klick + Umbenennen). Anschließend kopieren Sie bitte Pfad zur yml-Datei.

{{ :txtformat_mac_installation.png?nolink&400 |}}

Tippen Sie sodann:

<code>conda env create -f *\hfm_1.1.2.yml</code>

Anstelle von "*" müssen Sie den lokalen Pfad zum dem Ordner ergänzen, in dem die yml-Datei nun liegt. (ACHTUNG: Der Dateipfad darf keine Leerzeichen enthalten! Sie können den Pfad in doppelten Anführungszeichen oder ganz ohne Anführungszeichen schreiben). Es ist auch möglich die yml-Datei einfach in das Terminal-Fenster zu ziehen, dann wird der Datei-Pfad automatisch ergänzt.

Dieser Vorgang kann mehrere Minuten dauern. Ihr Bildschirm sieht währenddessen in etwas folgendermaßen aus:

{{ :ymlformat_hfm_mac_installation.png?nolink |}}

Am Schluss der Anzeige finden Sie nun einen Hinweis: 

   To activate this environment, use
   $ conda activate hfm_1.1.2 
   
Aktivieren Sie die hfm-Umgebung, indem Sie den Befehl in das Fenster eingeben und bestätigen. Beachten Sie dabei, die angezeigte Versionsnummer (hier *_1.0.0*) einzugeben! 

<code>conda activate hfm_1.1.2</code> oder <code>conda activate hfm</code> 

{{ :activateconda_mac_installation.png?nolink |}}

Schließen Sie nun das Fenster mit dem Befehl 'exit'.

====3. Starten der Jupyter-Notebooks====

Bei **Anaconda** wird das Programm //Jupyter Notebook// wird über ein neues Icon //Jupyter-Notebook (hfm_1.x.x)// gestartet, das sich im Start-Menu im neuen //Anaconda//-Ordner befindet und das man einfach anklicken kann. Die Jupyter-Notebooks öffnen sich dann im Browser.\\ 
Zugleich öffnet sich ein Command-Fenster, das Sie jedoch nicht weiter beachten müssen. Sie dürfen das Fenster jedoch erst nach Beendigung des Jupyter-Notebooks schließen!\\ 
Alternativ kann der "Anaconda Navigator" und dort das Icon //Jupyter-Notebook// gestartet werden. 

Bei einer **Miniconda**-Installation kann zum Starten der Jupyter-Notebooks auch ein Befehlsfenster (//Power Shell//, //Anaconda Prompt// etc.) geöffnet und der Befehl //jupyter notebook// eingegeben werden. \\ 

Falls Sie einen anderen Browser verwenden wollen, können Sie den URL in den Browser Ihrer Wahl kopieren bzw. die //local host//-Adresse, die im Command-Fenster angezeigt wird, in den Browser Ihrer Wahl kopieren.

Ein kurzes Tutorial zum Start und den Grundfunktionen von Jupyter Notebook ist [[jupyter-basic|hier]] zu finden.

Sobald Sie Ihr erstes Jupyter Notebook gestartet haben, müssen Sie die Notendarstelung mit dem Noteneditor MuseScore dauerhaft in die Jupyter Notebooks integrieren und weitere Settings anpassen. Hierzu findet sich eine detaillierte Anweisung zu Beginn des Tutorials [[https://analyse.hfm-weimar.de/jupyter/Jupyter_Noten_Basics_Grundlagen_music21.ipynb|Jupyter_Noten_Basics_Grundlagen_music21]].

Bei **Miniconda (mit Terminal)** haben manche Catalina-Betriebssysteme ein Problem mit dem Installationspaket. In diesen Fällen wird empfohlen, das Programm über das Terminal auszuführen.

Um das Jupyter Notebook zu starten, müssen Sie diese Befehle in folgender Reihenfolge verwenden:

**1.** <code>conda init</code> oder <code>conda init zsh</code>
**2.** <code>conda activate hfm_1.x.x</code> oder <code>conda activate hfm</code>
**3.** <code>Jupyter Notebook</code>

Weitere hilfreiche Hinweise zur Installation von //Anaconda// bzw. //Miniconda// für Mac OSX (in englischer Sprache) finden Sie unter den folgenden Links:  
  * [[https://www.youtube.com/watch?v=xtcBQvZ3a5Q|YouTube-Tutorial]]
  * [[https://www.anaconda.com/blog/how-to-restore-anaconda-after-macos-catalina-update|Hinweis: How to Restore Anaconda after Update to MacOS Catalina]]
  * [[https://github.com/ContinuumIO/anaconda-issues/issues/10998|Github-Troubleshouting]]