Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- jupyter-anaconda [2021/06/14 15:17]
egor
+++ jupyter-anaconda [2022/03/04 08:00] (aktuell)
martin [Anaconda und Miniconda - Installation und Einrichtung]
@@ Zeile 1: / Zeile 1: @@
 ===== Anaconda und Miniconda - Installation und Einrichtung =====
-[[https://www.anaconda.com/products/individual|Anaconda]] ist eine Open Source-Umgebung für die Programmiersprachen Python und R, die bereits viele verschiedene Softwares wie z.B. Entwicklungsumgebung [[https://www.spyder-ide.org/|Spyder]], Kommandozeileninterpreter [[http://ipython.org/|IPython]] sowie die web-basierte interaktive Umgebung [[https://jupyter.org/|Jupyter]] enthält. Die Installation nimmt ca. 3 GigaByte auf Ihrer lokalen Festplatte in Anspruch.
+[[https://www.anaconda.com/products/individual|Anaconda]] ist eine Open Source-Umgebung für die Programmiersprachen Python und R, die bereits viele verschiedene Software-Module wie z.B. Entwicklungsumgebung [[https://www.spyder-ide.org/|Spyder]], Kommandozeileninterpreter [[http://ipython.org/|IPython]] sowie die web-basierte interaktive Umgebung [[https://jupyter.org/|Jupyter]] enthält. Die Installation nimmt ca. 3 GigaByte auf Ihrer lokalen Festplatte in Anspruch.
-[[https://docs.conda.io/en/latest/miniconda.html|Miniconda]] ist eine Minimalversion von Anaconda, die jedoch alle für unsere Tutorials relevanten Funktionen umfasst. Im Vergleich mit Anaconda fehlen in Miniconda außerdem die GUI-Tools (Graphic User Interface Tools) und man ist somit zum Starten der Jupyter-Notebooks auf die An- und Ausgabe in Terminal (Befehlsfenster, Command Window) angewiesen. Miniconda ist eine Minimalversion von Anaconda. Miniconda benötigt ca. 1 GigaByte Ihrer Festplatte.
+[[https://docs.conda.io/en/latest/miniconda.html|Miniconda]] ist eine verschlankte Version von Anaconda, die jedoch alle für unsere Tutorials relevanten Funktionen umfasst. Im Vergleich mit Anaconda fehlen in Miniconda außerdem die GUI-Tools (Graphic User Interface Tools) und man ist somit zum Starten der Jupyter-Notebooks auf die An- und Ausgabe in Terminal (Befehlsfenster, Command Window) angewiesen. Miniconda ist eine Minimalversion von Anaconda. Miniconda benötigt ca. 1 GigaByte Ihrer Festplatte.
 Im Kontext des Projektes wird vor allem die in Miniconda und Anaconda enthaltene Implementierung von Jupyter Notebook verwendet, die durch eine extra für das Projekt entwickelte Python-Umgebung ergänzt wird.
 Um in den Jupyter Notebooks Noten korrekt darstellen zu können, müssen Sie den Noten-Editor //MuseScore// installieren. Hinweise hierzu finden Sie [[https://analyse.hfm-weimar.de/doku.php?id=installation#musescore|hier]].
 ====Download====
@@ Zeile 20: / Zeile 21: @@
   * [[https://docs.conda.io/en/latest/miniconda.html#linux-installers|Linux]]
-====Windows-Installation====
+====Installation====
+Die Installation besteht aus zwei Schritten: \\
-===1. Anaconda===
+. Zunächst installieren Sie bitte die Python-Umgebung //Anaconda// oder alternativ die Command-Line-Version //Miniconda//. \\
+. Zusätzlich müssen die projektspezifische HfM-Umgebung mit verschiedenen Python-Bibliotheken laden und installieren. Dies geschieht sehr komfortabel mit Hilfe einer yml-Datei. \\
-Die Windows-Installation ist unkompliziert, es können durchgehend die automatisch ausgewählten vorausgewählten Optionen verwendet werden (es sei denn, man will es in einem anderen Ordner installieren - es werden in diesem Fall automatisch die Pfadangaben entsprechend des ausgewählten Ordners angepasst).
-Nach der Fertigstellung der Installation öffnet man den "Anconda Navigator" und wählt den "CMD.exe Prompt" aus:
-{{:wiki:conda_nav.jpg?500|}}
-In CMD.exe-Terminal ist es nun möglich, direkt mit Anaconda zu interagieren und die für die Unterrichtseinheiten notwendigen Zusatzmodule und Libraries zu installieren.
-Um zu verifizieren, dass Anaconda korrekt installiert ist und auf den neusten Stand ist verwendet man:
-<code>conda --version</code>
-sowie
-<code>conda update conda</code>
-Diese Befehle müssen die aktuelle Version von //Anaconda// anzeigen und die eventuell für das Update verfügbare Module auflisten. Für unsere Zwecke ist ein Update nicht erforderlich, es genügt also die Angabe "n" (für Update: "y").
-{{:wiki:conda_prompt1.png?600|}}
-Lassen Sie bitte das CMD.exe-Terminal für den nächsten Installationsschritt (3.) geöffnet.
-===2. Miniconda (alternativ zu Anaconda)===
-Die Windows-Installation von Miniconda entspricht der Anaconda-Installation (s. oben).
-Man sollte jedoch darauf achten die entsprechenden [[https://de.wikipedia.org/wiki/Umgebungsvariable|PATH-Einstellungen]] entweder direkt während der Installation (siehe Bild ) bzw. nachträglich entsprechend einzustellen, damit die conda-Umgebung über das Terminal-Fenster aktiviert werden kann.
-{{:wiki:miniconda-installpath.png?400|}}
-Möchte man nachträglich die PATH-Einstellungen ändern, müssen folgende Schritte ausgeführt werden:
-. "Edit environment variables for your account" öffnen (kann leicht mit Windowstaste und Suche nach "environment" geöffent werden).
-{{:wiki:path-env.png?400|}}
-. Im geöffneten Fenster die Werte für "Path" ändern ("Edit"-Button) und die Pfade für Miniconda sowie Miniconda-Scripts hinzufügen:
-{{:wiki:path-edit.png?800|}}
-. Um zu testen, ob die Path-Eistellungen erfolgreich übernommen worden sind, gibt man in Terminal einfach ein:
-<code>conda --version</code>
-Wird nun die Versionsnummer angezeigt, ist man startklar und kann mit der Einrichtung der projektspezifischen Python-Umgebung fortsetzen!
-===3. Projektspezifische Python-Umgebung===
-Anschließend müssen mit Hilfe eines yml-Scripts die //Analyse-Projekt// notwendigen Zusatzmodule installiert werden. 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).\\
-Tippen Sie sodann in
-<code>conda env create -f *\hfm.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.
-{{:wiki:conda_ymlinstall.png?600|}}
-Am Schluss der Anzeige finden Sie nun einen Hinweis:
-   To activate this environment, use
-   $ conda activate hfm_1.0.0
-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>
-{{:wiki:conda_ymlactive.png?600|}}
-Schließen Sie nun das Fenster mit dem Befehl 'exit'.
-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 befefindet und das man einfach anklicken kann. Die Jupyter-Notebooks öffnen sich dann in 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 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.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]].
-Falls die bereits vorhandene yml-Datei upgedated werden muss, kann folgender Befehl verwendet werden (anstelle von "*" müssen Sie den lokalen Pfad zum dem Ordner ergänzen):
-<code>conda env update -f *\hfm.yml --prune
-</code>
-Optional kann die lokal installierte Umgebung durch folgenden Befehl entfernt werden (anstelle von "*" müssen Sie die genaue Bezeichnung der Version der zu löschenden Umgebung angeben):
-<code>conda env remove -n hfm_*
-</code>
-Die automatisch im Startmenü erzeugten Verknüpfungen (wie z.B. für Jupyter Notebook in einer bestimmten Umgebung) werden jedoch durch diesen Script nicht gelöscht und müssen beim Bedarf manuell entfernt werden!
-====Mac-Installation====
-===1. Anaconda===
-Die OSX-Distribution 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, was mit einer "y/n"-Angabe bestätigt werden muss. Für unsere Zwecke ist ein Update nicht erforderlich:
-{{:wiki:conda_osx_prompt.png?600|}}
-Hilfreiche Hinweise zur Installation von Anaconda bzw. Miniconda für Mac OS (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://github.com/ContinuumIO/anaconda-issues/issues/10998|Github-Troubleshouting]]
-===2. 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).
-Um die Terminal-integration außerhalb von Bash-Script zu aktivieren, muss man Folgendes eingeben (der Conda-Pfad muss entsprechend individuell angepasst werden):
-<code>source *Pfad zur Conda*/bin/activate</code>
-Und anschließend:
-<code>conda init zsh</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===
-Wie bei der Windows-Installation!
-====Linux-Installation====
-===1. Anaconda===
-Generell können sich die Installationsschritte bei der jeweils verwendeten Linux-Distribution stark voneinander unterscheiden. Es wird daher ausdrücklich empfohlen, die Installationsvoraussetzungen für die Linux-Systeme [[https://docs.anaconda.com/anaconda/install/linux/|hier]] zu checken. \\
-Für die folgende Anleitung wird die aktuelle Ubuntu-Desktop-Version (21.04) verwendet.
-Die Anaconda-Package wird in form eines Installationsskripts bereitgestellt, dieser muss im Terminal mit //bash// ausgeführt werden:
-{{:wiki:conda_ubu1.png?500|}}
-Man muss im Laufe der Installation einige Male seine Installationsabsichten mit "yes" bestätigen. Anschließend aktiviert man conda mit der Eingabe in Terminal.
-===2. Miniconda (alternativ zu Anaconda)===
-Miniconda wird für Linux nur als bash-script zur Verfügung gestellt. Das Bash-Script kann im 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.
-Um die Terminal-integration außerhalb von bash-script zu aktiviren, muss man Folgendes eingeben (Conda-Pfad muss entsprechend individuell angepasst werden):
-<code>source *Pfad zur Conda*/bin/activate</code>
-Und anschließend:
-<code>conda init</code>
-Damit wird die Conda-Eingabe nahtlos in das Terminal integriert und man kann mit der Einrichtung der projektspezifischen Python-Umgebung fortfahren!
-===3. Projektspezifischen Python-Umgebung===
+Bitte entnehmen Sie alle relevanten Informationen den folgenden Seiten:
-Wie bei der Windows-Installation!
+  * [[installation_windows|Installation unter Windows]]
+  * [[installation_mac|Installation für Mac]]
+  * [[installation_linux|Installation unter Linux]]
+Außerdem bieten wir Ihnen [[video-tutorials|Video-Tutorials]] mit Installationsanweisungen für Windows und Mac.