====== Installation von MIKE IO 1D ======

⯇ Zurück zu  [[mikeplus:anleitungen:ergebnisbericht|Ergebnisbericht aus *.res1d und *.sqlite erstellen]]

<WRAP center round tip 60%>
Diese Seite wird nicht mehr gewartet, weil es eine aktuellere Version gibt: [[mikeplus:anleitungen:installation_python_mikeio1d|Installation von Python und MIKE IO 1D]].
</WRAP>
===== Einleitung =====

MIKE IO 1D ist eine auf [[https://github.com/DHI/mikeio1d|GitHub gepflegte Bibliothek]], mit der man auf die in res1d-Dateien gespeicherten Simulationsergebnisse zugreifen kann. Auf Github ist ein [[https://github.com/DHI/mikeio1d/blob/main/notebooks/Res1D.ipynb|kleines Beispiel]] zu finden. Eine nützliche Anwendung ist beispielsweise der [[Ergebnisbericht]].

Die Installation von MIKE IO 1D anhand folgender Schritte erklärt.

  * Python 3.8
  * Microsoft Visual C++ Redistributable, sofern nicht bereits vorhanden
  * MIKE IO 1D

MIKE IO 1D benötigt Python x64 in den Versionen 3.6, 3.7 oder 3.8.

===== Python 3.8 =====

Python kann ohne weiteres mehrmals auf dem gleichen Computer installiert sein. Falls Sie also bereits mit einer anderen Python-Version arbeiten und Ihr aktuelles Setup nicht mit MIKE IO 1D vermischen möchten, beachten Sie bitte die Hinweise in [[mikeplus:anleitungen:installation_python_mehrere|Installation mehrerer Versionen von Python nebeneinander]]

Laden Sie Python 3.8.10 von der [[https://www.python.org/downloads/windows/|offiziellen Python-Webseite]] herunter:

{{ :mikeplus:anleitungen:installation_mikeio1d_python-download.png?direct&400 |}}

Starten Sie das Setup und lassen Sie die PATH-Variabe um den Pfad zu Python 3.8 erweitern:

{{ :mikeplus:anleitungen:installation_mikeio1d_python-install.png?direct&400 |}}


Dieses Fenster zeigt die erfolgreiche Installation an. Das path length limit müssen Sie in der Regel nicht deaktivieren:

{{ :mikeplus:anleitungen:installation_mikeio1d_python-successful.png?direct&400 |}}


===== Microsoft Visual C++ Redistributable Setup =====

Haben Sie auf Ihrem Rechner bereits MIKE-Software installiert, ist diese Voraussetzung bereits erfüllt und Sie können den Schritt überspringen.

Andernfalls suchen Sie in der Systemsteuerung/installierte Programme nach der „Microsoft Visual C++ 2015-2022 Redistributable (x64)“.

{{ :mikeplus:anleitungen:installation_mikeio1d_vc-check-install.png?direct&600 |}}
 
Falls tatsächlich noch nicht vorhanden, installieren Sie die [[https://docs.microsoft.com/en-US/cpp/windows/latest-supported-vc-redist| Microsoft Visual C++ Redistributable]], und zwar die Version für //Visual Studio 2015, 2017, 2019, and 2022// und für die //X64//-Architektur.


===== MIKE IO 1D =====

Zum Installieren benötigen Sie eine Internet-Verbindung, da sämtliche erforderlichen Bausteine in der passenden Version direkt heruntergeladen werden.

Starten Sie über das Startmenü die Eingabeaufforderung, um mit dem Befehl ''pip install'' Bausteine zu Python hinzuzufügen.

{{ :mikeplus:anleitungen:cmd.png?direct&200 | Eingabeaufforderung starten}}

Für die Ergebnisberichte installieren Sie bitte die development version von MIKE IO 1D. Geben Sie folgenden Befehl ein:

''pip install %%https://github.com/DHI/mikeio1d/archive/main.zip%%''

Ansonsten reicht auch die normale Version:

''pip install mikeio1d''

Nach Drücken der <Eingabe>-Taste wird der Installationsfortschritt angezeigt. Die recht verbreiteten Bibliotheken Pandas und Numpy werden dabei automatisch mitinstalliert.

{{ :mikeplus:anleitungen:installation_mikeio1d_mikeio1d.png?direct&750 |}}
 

Sobald die Eingabeaufforderung wieder erscheint, ist die Installation abgeschlossen. Die gelb geschriebene Warnung können Sie ignorieren.




===== Testen Sie Ihre Installation =====

Starten Sie das Python mit dem Befehl ''python'':

<code>
C:\Users\WDAGUtilityAccount>python
Python 3.8.10 (tags/v3.8.10:3d8993a, May  3 2021, 11:48:03) [MSC v.1928 64 bit (AMD64)] on win32
Type "help", "copyright", "credits" or "license" for more information.
>>>
</code>

Die Python-Version wird angegeben, und der Python-Prompt %%>>>%% gestartet.

Überprüfen Sie Python mit ''import sys'' und ''print(f"Python version: {sys.version}")'':

<code>
>>> import sys
>>> print(f"Python version: {sys.version}")
Python version: 3.8.10 (tags/v3.8.10:3d8993a, May  3 2021, 11:48:03) [MSC v.1928 64 bit (AMD64)]
>>>
</code>



Überprüfen Sie NumPy mit ''import numpy as np'' und ''print("NumPy: " + np.__version__)'':

<code>
>>> import numpy as np
>>> print("NumPy: " + np.__version__)
NumPy: 1.21.4
>>>
</code>


Überrprüfen Sie Pandas mit ''import pandas as pd'' und ''print("Pandas: " + pd.__version__)'':

<code>
>>> import pandas as pd
>>> print("Pandas: " + pd.__version__)
Pandas: 1.3.5
>>>
</code>


Überprüfen Sie MIKE IO 1D mit ''import mikeio1d'' und ''print("MIKE IO 1D: " + mikeio1d.__version__)''

<code>
>>> import mikeio1d
>>> print("MIKE IO 1D: " + mikeio1d.__version__)
MIKE IO 1D: 0.1.0
>>>
</code>

Verlassen Sie das Python-Fenster mit ''exit()'':

<code>
>>> exit()

C:\Users\WDAGUtilityAccount>
</code>


===== Ergänzende Installationen =====

Die folgenden Komponenten werden von MIKE IO 1D zwar nicht benötigt, sind beim Auswerten von Ergebnissen aber durchaus nützlich.

==== Matplotlib ====

Installation:

<code>
pip install matplotlib
</code>

Test in der Python-Konsole:

<code>
>>> import matplotlib as mpl
>>> print("Matplotlib: " + mpl.__version__)
Matplotlib: 3.5.1
>>>
</code>


==== JupyterLab ====

Installation:

<code>
pip install jupyterlab
</code>

Zum Testen starten Sie [[https://jupyterlab.readthedocs.io/en/stable/|JupyterLab]] aus der normalen Windows-Eingabeaufforderung:

<code>
jupyter lab
</code> 

Die JupyterLab Bedienungsoberfläche öffnet sich in Ihrem Browser.