Newer
Older
[][static-gl-url] [][static-gl-url]
# Mobile Cartography 2023/24 Workshop Series: Social Media, Jupyter Lab & Tag Maps
This is the public repository containing the course material for the
Mobile Cartography Jupyter Lab Workshop.
------
> :warning: Unfortunately, the ZIH is in the midst of migration from `Taurus` system to `Barnard`. You
> can run the workshop in both systems, but the startup is a little bit different between the two. We
> do not know whether or how long Taurus will be available in 2024, so please try to use this only as a fallback.
## Preparations
1. If working from remote: Make sure to connect to TUD network using [a VPN connection][cisco-zih] (Cisco VPN or OpenVPN), otherwise you will not be able to use any of ZIH HPC Services
2. Add your ZIH-Login to the HPC project, using the pre-shared link
- this needs to be done only once
- it may take up to two hours before your login is available
## Barnard (new): Start Jupyter Lab
3. [Login to HPC][login-zih-link-barnard] (do not click "spawn")
- You'll be requested to login using your TUD Account
4. Select `Barnard - 2 core, 3G, 4 hours`
4. **Click Start** to spawn a Jupyter Lab instance on the TUD ZIH Jupyter Hub.
- The Workshop is _not_ automatically setup in the new system yet
- .. and copy &paste the following command, confirm with <kbd>Enter</kbd>:
```bash
cd /home/$USER && \
git clone https://gitlab.hrz.tu-chemnitz.de/tud-ifk/jupyter_python_datascience.git
```
- this will clone the workshop repository to your local user folder (left side)
- open `jupyter_python_datascience/01_raw_intro.ipynb` in the explorer on the left and start following the instructions
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
## Taurus (old): Start Jupyter Lab
3. [Login to HPC][login-zih-link] (do not click "spawn")
- You'll be requested to login using your TUD Account
4. **Click [this link][spawn-zih-link]** to spawn a Jupyter Lab instance on the TUD ZIH Jupyter Hub.
- If you see a pop-up asking "Found slurm parameters in URL. Do you want to submit and spawn now?" - click **Ok**
- Do _not_ click "Start My Server".
- If you see a button or form, click or copy the link again, paste, & the server should start automatically.
- **Important: Do not change configuration if you see a form:** If the Server doesn't start automatically, click the [ZIH Jupyter link][spawn-zih-link] one more time
- If there are not enough resources and you need to wait a very long time (>10 minutes), try [this alternative spawn link][spawn-zih-link2] that uses a different ZIH resource partition
A video showing startup and environment selection:
Afterwards, once the notebook has opened:
- If asked to select a Kernel: Confirm suggestion (Python 3) with "Select".
- execute the first cell, with `SHIFT+ENTER`
- this will link the conda `01_intro_env` to your user folder. Follow any instructions in the notebook.
## FAQ
Based on previous workshops,
we have collected some frequent questions and answers.
Please click on the links below to see possible routes to solve these issues.
1. [**500: Internal Server Error** after clicking spawn the link?](resources/faq/01_error_500.md)
2. [Jupyter Lab Starts, but **the explorer on the left is empty**?](resources/faq/02_explorer_empty.md)
3. [**Cannot activate `workshop_env`**/ the first code cell returns an error?](resources/faq/03_activate_workshop_env.md)
4. [How can I run these notebooks offline (locally)?](resources/faq/04_offline_setup.md)
## HTML Versions of Notebooks
1. [01_raw_intro.html](https://kartographie.geo.tu-dresden.de/ad/jupyter_python_datascience/01_raw_intro.html)
2. [02_hll_intro.html](https://kartographie.geo.tu-dresden.de/ad/jupyter_python_datascience/02_hll_intro.html)
3. [03_tagmaps.html](https://kartographie.geo.tu-dresden.de/ad/jupyter_python_datascience/03_tagmaps.html)
4. [04_topic_classification.html](https://kartographie.geo.tu-dresden.de/ad/jupyter_python_datascience/04_topic_classification.html)
[login-zih-link]: https://taurus.hrsk.tu-dresden.de/jupyter/hub/
[login-zih-link-barnard]: https://jupyterhub.hpc.tu-dresden.de/
[spawn-zih-link]: https://taurus.hrsk.tu-dresden.de/jupyter/hub/user-redirect/git-pull?repo=https%3A%2F%2Fgitlab.hrz.tu-chemnitz.de%2Ftud-ifk%2Fpython_datascience_2022.git&branch=main&urlpath=lab%2Ftree%2Fpython_datascience_2022.git%2Fnotebooks%2F01_raw_intro.ipynb#/~(partition~'ml~project~'p_lv_mobicart_2324~runtime~'2*3a30*3a00~cpuspertask~'2~mempercpu~'4000)
[static-gl-url]: https://gitlab.hrz.tu-chemnitz.de/tud-ifk/jupyter_python_datascience
[cisco-zih]: https://tu-dresden.de/zih/dienste/service-katalog/arbeitsumgebung/zugang_datennetz/vpn?set_language=de