Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- installation_mac [2021/07/01 16:35]
martin [Starten der Jupyter-Notebooks]
+++ installation_mac [2021/12/03 10:38] (aktuell)
andres_romero [3. Starten der Jupyter-Notebooks]
@@ Zeile 2: / Zeile 2: @@
-===1. Anaconda===
+====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:
+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>
+<code>conda --version</code>
 sowie
-   <code>conda update conda</code>
+<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, was mit einer "y/n"-Angabe bestätigt werden muss. Für unsere Zwecke ist ein Update nicht erforderlich:
+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|}}
-===2. Miniconda (alternativ zu Anaconda)===
+====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>
+<code>shasum -a 256 /Pfad/Dateiname</code>
 Ersetzen Sie **/Pfad/Dateiname** durch Ihren Installationspfad und den Dateinamen.
@@ Zeile 29: / Zeile 29: @@
 Zur Installation der Command Line wird der entsprechende Befehl benötigt:
-   <code> bash ~/Downloads/Anaconda3-2020.02-MacOSX-x86_64.sh </code>
+<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.
@@ Zeile 41: / Zeile 41: @@
 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>
+<code>source *Pfad zur Conda*/bin/activate</code>
 {{ :source_mac_installation.png?nolink |}}
@@ Zeile 47: / Zeile 47: @@
 Und anschließend:
-   <code>conda init zsh</code> oder <code>conda init</code>
+<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!
-===3. Projektspezifischen Python-Umgebung===
+====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 Datei [[https://analyse.hfm-weimar.de/scripts/hfm.yml|hfm.yml]] auf Ihren lokalen Rechner (Rechtsklick -> Ziel speichern unter).\\
+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 .txl-Format gespeichert. Sie müssen diese Dateien manuell ändern (sekundärer Klick + Umbenennen). Anschließend kopieren Sie bitte Pfad zur yml-Datei.
+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 |}}
@@ Zeile 62: / Zeile 62: @@
 Tippen Sie sodann:
-   <code>conda env create -f *\hfm.yml</code>
+<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.
@@ Zeile 73: / Zeile 73: @@
    To activate this environment, use
-   $ conda activate hfm_1.0.0
+   $ 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.0.0</code> oder <code>conda activate hfm</code>
+<code>conda activate hfm_1.1.2</code> oder <code>conda activate hfm</code>
 {{ :activateconda_mac_installation.png?nolink |}}
@@ Zeile 83: / Zeile 83: @@
 Schließen Sie nun das Fenster mit dem Befehl 'exit'.
-====Starten der Jupyter-Notebooks====
+====3. Starten der Jupyter-Notebooks====
-**Bei Anaconda** wird das Programm //Jupyter Notebook// wird über ein neues Icon //Jupyter-Notebook (hfm_1.0.0)// gestartet, das sich im Start-Menu im neuen //Anaconda//-Ordner befindet und das man einfach anklicken kann. Die Jupyter-Notebooks öffnen sich dann in Browser.\\
+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!
+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.
-Alternativ kann bei einer //Anconda//-Installation 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.
-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.exe// eingegeben werden. \\
-Falls Sie einen anderen Browser verwenden wollen, können Sie den URL in den neuen Browser Ihrer Wahl kopieren bzw. die //local host//-Adresse, die im Command-Fenster angezeigt wird, in den neuen 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 intergrieren und weitere Settings anpassen. Hierzu findet sich eine detaillierte Anweisung zu Beginn des Tutorial-Notebooks [[https://analyse.hfm-weimar.de/jupyter/Jupyter_Noten_Basics_Part1_Grundlagen.ipynb|Jupyter_Noten_Basics_Part1_Grundlagen]].
+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.
+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>
+**1.** <code>conda init</code> oder <code>conda init zsh</code>
-   **2.** <code>conda activate hfm_1.0.0</code> oder <code>conda activate hfm</code>
+**2.** <code>conda activate hfm_1.x.x</code> oder <code>conda activate hfm</code>
-   **3.** <code>Jupyter Notebook</code>
+**3.** <code>Jupyter Notebook</code>
-Hilfreiche Hinweise zur Installation von Anaconda bzw. Miniconda für Mac OSX (in englischer Sprache) finden Sie unter den folgenden Links:
+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|Offilzielle Hinweise]]
+  * [[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]]