Johanna Kerch (since WiSe 2021/22), Göran Liebs (since WiSe 2023/24)
This workshop takes place from 9.-13. october from 9.00h until 15.00h in MN 13 und MN 13b.
This course likes to introduce modern programming technics to every one, with learning by doing.
This course is a development project on the cloud-based service for software development and version control from the Gesellschaft für wissenschaftliche Datenverarbeitung mbH Göttingen (gitlab, GWDG).
Those git-projects might be cloned and forked by other users, to improve or to use them for new projects, respectivaly.
There are many more of such platforms in the world wide web, working similarly.
Like for every git-repositories in such platforms, this text your are reading is automaticaly displayed from the file README.md and should explain well the project.
Git is a version control programm that tracks changes in any folder (directory) with an hidden folder.
The course uses Jupyter Notebooks, an open source web application that can be used to create and share documents that contain live code, equations, visualizations, and text. The code cells are executable with costumized kernels for several programming languages.
- A real computer with internet connection and a browser
- An user account at gitlab https://gitlab.gwdg.de/ to access, store and manages programming projects
https://docs.gwdg.de/doku.php?id=en:services:email_collaboration:gitlab:start - An user account at https://jupyter-cloud.gwdg.de, a virtual computer with jupyterlab, used via your local browser
- Or Anaconda installed on a real computer that, runs a jupyter lab that you use with your browser.
- How to use a web-browser
- Basic listening/reading comprehension in English
- The lectures (B.Geo.211 Digitale Techniken)
- Forking/Cloning a Git-Repository
- Jupyter Notebook
- Some shell commands in Bash and Git, change and track
- Python
- basics: data types, strings, lists, dictionaries
- control flow and functions, list comprehension
- distribution/environment, package manager/pip
- read data from txt, numpy, pandas, missing data, data access via api (DIGIS/GEOROC example)
- visualise data, datetime
- data analysis: interpolation, regression, polynomial fit, filter
- object-oriented programming, class example
- IDE (PyCharm/Spyder), VScode, Vim, Emacs, etc.
- code testing/unit tests
- and some phantastic real live applications
Please follow bold instructions:
In your Web-browser go to https://jupyter-cloud.gwdg.de/ and click login.
Use your gwdg account, choose the default jupyterlab.
That starts your developer-computer (jupyterlab) in the data center of the GWDG (cloud, many connected computers or servers, ...).
Changing your homecomputer or laptop to a programmers-computer can be hard and all your work might just run at your machine but not necessarily on others.
Or install Anaconda, and use the jupyterlab of this python distribution.
When your jupyterlab is running, click: File -> New -> Terminal.
This is a bash shell, a commando based userinterface of your developermachine.
As we like to integrate this course as a real-live-development-project, you have two possibilities:
First, Preferred: Log in to your gitlab account (if not done already), search this project with the search bar and by clicking the magnifying glass symbole. Than click the fork-symbole at the right of the star symbol. And follow the following pages.
You will see a massage that the project was forked. Now you own a project with the content of this course in your account.
Now if you like to run this project, you will copy a version including the hidden git-file (saves changes and origin) to your computer, that is what we call a clone.
Second: In a repository you may ask the owner for permissions. And then a generated access key is requiered, to work at this project with an owner-defined role (i.e. developer, distributer,...). Consult the file 'Securitykey2bDevOfProject.md' if you like to do so. This allows you to suggest changes to the original repository directly.
Now switch between profile view to the project view at your gitlab home page (account).
You should see this file and others...
Now click the clone-button and click the little clipboard button (under cloning with ssh), to copy the URL (internetadress).
In the web-browser-tab with your jupyter-computer-terminal you run following command, with pasting the copied URL of your
repository fork.
git clone << past here copied URL from YOUR FORK! >>
A clone is not just a copy, there is still a connection between this git-repositories. Knowing each other, there can be exchanges of changes between them.
E.g. a clone can update changes from his origin (git pull), or ask to upload (git push) his changes to the origin.
If you have been successfull, you see a new folder (digitale-techniken-wise2324) in the filebrowser list at the left, in your GWDGjupytercloud-maschine, in your browse, on your sreen...
Now click on the folder (digitale-techniken-wise2324-pre). Then open the file Go_here_after_README_done.ipynb.
A jupyter notebook with the extention .ipynb.