Instalace

Zde předpokládáme, že už máte nainstalovanou požadovanou verzi Pythonu.

Abyste mohli kuimaze2 používat, potřebujete mít v Pythonu nainstalované následující balíčky:

• pillow, abyste mohli načítat mapy z bitmapobých obrázků,
• tkinter, abyste mohli použít vizualizaci, a
• numpy z různých důvodů, např. abyste mohli řešit soustavy rovnic.

Balíčky si můžete nainstalovat pomocí následujících příkazů z vašeho terminálu (ideálně ve virtuálním prostředí nebo v conda prostředí):

# On Linux
pip3 install --user numpy
sudo apt-get install python3-pil.imagetk
 
# On Mac with installed Homebrew package manager
pip3 install numpy
pip3 install Pillow
brew install python-tk
 
# On Windows
pip3 install numpy
pip3 install Pillow

1. Vytvořte si někde na svém disku pracovní adresář. (Doporučujeme vytvořit si pro každou úlohu, na níž budete pracovat, její vlastní pracovní adresář.) Zde budeme předpokládat, že se adresář jmenuje např. kui-task.
2. Existují 2 způsoby, jak dostat kuimaze2 na váš systém: pomocí verzovacího systému git, nebo prostřednictvím ZIP archivu:
   • Pomocí gitu:
     1. Ujistěte se, že máte git nainstalovaný. (Pokud nemáte, nainstalujte jej).
     2. Naklonujte si repozitář kui-maze2:

        cd kui-task
        git clone https://gitlab.fel.cvut.cz/kui-student-materials/kui-maze2 .

        Nezapomeňte na . na konci předchozího příkladu: tečka říká gitu, aby obsah repozitáře naklonoval do aktuálního pracovního adresáře. Pokud . neuvedete, git vytvoří ve složce kui-task podadresář kui-maze2 s obsahem repozitáře (což není to, co v tomto návodu chceme).
   • Pomocí ZIP archivu:
     1. Stáhněte si kódy z repozitáře KUI Maze 2 jako ZIP soubor (nebo si přímo stáhněte kui-maze2-main.zip).
     2. Uvnitř staženého archivu najdete složku kui-maze2-main. Extrahujte její obsah do složky kui-task. (Ve složce kui-task byste neměli vidět podadresář kui-maze2-main.)
3. Nyní byste ve své složce kui-task měli (kromě jiných věcí) vidět podadresář kuimaze2 s několika Pythonskými soubory. Ve složce kui-task byste měli být schopni pracovat na úloze. Pythonské moduly a skripty umístěné a spouštěné z tohoto adresáře by měly být schopny importovat kuimaze2 a další potřebné symboly z tohoto modulu pomocí

   import kuimaze2

Novou, aktualizovanou verzi prostředí (např. na pokyn vyučujících) lze získat následovně:

• Pokud jste k získání kuimaze2 použili git (viz výše), stačí ve složce kui-task spustit příkaz:

  git pull

• Pokud jste kódy stáhli ve formě ZIP archivu, stáhněte si je znovu a rozbalte stejným způsobem na stejné místo.

Obě metody způsobí to, že vaše lokální kopie se přepíše novou verzí. Pokud jste tedy do “učitelských” kódů jakkoli zasahovali (což byste neměli), o tyto změny nejspíš přijdete!