[comment]: # (Set the theme:) [comment]: # (The list of themes is at https://revealjs.com/themes/) [comment]: # (The list of code themes is at https://highlightjs.org/) [comment]: # (Pass optional settings to reveal.js:) [comment]: # (markdown: { smartypants: true }) [comment]: # (plugins:[ RevealHighlight ]) [comment]: # (Other settings are documented at https://revealjs.com/config/) <style type="text/css"> .reveal p { text-align: left; } .reveal ul { display: block; text-align: left; } .reveal ol { display: block; text-align: left; } .reveal h1, h2, h3, h4, h5 { display: block; text-align: left; } .reveal pre { font-size: 1.1em} </style> # GIS Analyses using Free and Open Source Software (FOSSGIS) Christina Ludwig, Veit Ulrich October 23, 2024 | Institut of Geography | Heidelberg University
## Agenda 0. Course organisation 1. Practical: Command line and git 2. FOSSGIS Projects
## 0. Course organisation
### Fro everyone new to the course Please **come to me after class**, so I will tell you all general information. You will also find **all information on the course website**: http://fossgis.courses-pages.gistools.geog.uni-heidelberg.de/home/content/intro.html <center><img src="img/qr-code.png" width=500 ></center>
## Software Setup: Any problems?
## Tutorium dates **This week:** Tuesday, 11:15 - 12:45, seminar room 132, Im Neuenheimer Feld 348, second floor - Attendance is optional - Bring your own laptop. See [software setup instructions](./docs/software_setup.md) - You can drop in anytime to **ask questions about the assignments** or get help with technical issues. If you are not able to attend the tutorial, <br> - have your assignment partner ask them in the tutorium - ask questions Wednesdays after the seminar. - post your questions as GitLab Issues.
## Assignment 1: QGIS + git The first assignment is available at: [https://courses.gistools.geog.uni-heidelberg.de/fossgis2022/fossgis_assignment_01](https://courses.gistools.geog.uni-heidelberg.de/fossgis2022/fossgis_assignment_01). Submission deadline is **next Friday Nov 1 2024.** (Be aware of new submission date!)
## Groups for assignment 1 Groups for assignment 1: https://courses.gistools.geog.uni-heidelberg.de/fossgis/home/-/issues/11 You can contact each other via email: uni_id@stud.uni-heidelberg.de For each group **only one submission will be graded.** Both students get this grade. Provide the uni id of the repo that should be graded in the "grading" column of the table of groups. If you don't provide a uni id, one submission will be selected randomly.
## Rules for collaboration You can work together and help each other, but **don't copy/paste other students solutions.** You're responsible for your own learning progress.
## How to deal with problems during the assignments or project 0. Try it yourself. 1. Google it! Search online for an answer, e.g. forum, documentation, tutorials, videos etc. 2. Ask your assignment partner or other students. You can also post an issue on GitLab. 3. Ask instructor (We will only help you if you have googled before.)
## Any Questions?
# Wake up exercise!
# Pair up! <center><img src="img/pairprogramming2.jpg" width=1000 ></center> One git-experienced person with a non-git-experienced person.
# Practical: Command line and git ### Goals for today 1. Everyone has used the command line. 2. Everyone has forked the repository of the first assignment on GitLab. 3. Everyone has created a commit and pushed it to GitLab. We will work through the exercises in the **section "Topics" - "Version control using git" - "Getting started" on the course webpage.**
## The command line The command line (also called command-line interface, command prompt, shell), is a text-based application for viewing, handling, and manipulating files on your computer. <center><img src="img/cmd.png" width=1000 ></center>
## Usage The general syntax of any command in the command line is: <br> ### $ command + [optional parameters] + [optional flags] **Example:** `ls ./fossgis -l` <br> * **Command:** Name of the command (e.g. `cd`, `ls`) * **Parameter:** Optional parameter for the command (e.g. path to the folder `./fossgis` in this case) * **Flag:** Optional boolean parameter (e.g. `-l` (unix) or `/b` (windows) to list file details) #### Important: The commands, parameters and flags are always **separated by whitespaces**!
## Avoid file names with white spaces! **Avoid file names containing whitespaces**, because this might lead to problems when executing commands, e.g. the command `cd ./my folder` would be interpreted as a command with two parameters _./my_ and _folder_. Setting quotation marks would solve this problem, but it's better to avoid whitespaces in file paths in the first place.
### Practice in Pairs Take a look at the [list of common commands on the course webpage](../02_commandline/commandline.md) to refresh your memory if needed. 1. Open your terminal (on windows maybe also command prompt). 2. Print the current working directory (i.e. the path to the folder you are in). 3. List all directories. 4. Navigate to the folder 'Desktop'. 5. List all directories in the 'Desktop' folder. 6. Create a new folder called 'fossgis'. 7. Navigate to the 'fossgis' folder. 8. List all files in the 'fossgis' folder. You can find these exercises also in the section "Topics" - "Version control using git" - "Getting started"
## Introduction to git See course page.
### git is a Version Control System * A Version Control System is a software that **tracks the file changes** of all contributors within a project. * Originally developed to **assist collaborative open source software development** by Linus Torvalds (Initiator of Linux development) * The **user chooses which files are tracked** and which file changes are recorded. * All tracked files of a project are stored in a **git repository** ("repo"). * You can share your project with others by uploading it to a online software development platform such as GitLab, GitHub, etc.
### git tracks file changes through *commits* <center> <img src="img/git_tracking.svg" width=350> <img src="img/git_commits_small.svg" width=150> </center>
### *git log* shows all commits of this repository ``` git log ``` <center><img src="img/git_log.png" width=1000 ></center> **Note:** You can exit the log by typing "q", if you use the default command line editor *vim*.
### *git status* shows the current state of the repository ``` git status ``` <center><img src="img/git_status_1.png" width=1000 ></center>
## Creating a commit A *commit* records file changes within the *repository*
### 1. Add files to staging area Adding new or edited files to the staging area, which will be included in the next commit. ``` git add ham.py git add spam.txt ``` <center><img src="img/git_status_2.png" width=1000 ></center>
### 2. Create commit Creating the commit containing the files in the staging area: ``` git commit -m "edited ham.py, created spam.txt" ```
### git might ask you who you are git records who is creating the commit. Registering your user name and email: ``` git config --global user.name "Clark Kent" git config --global user.email "clark.kent@gmail.com" ``` **Note:** This has to be done only once. It does not have to be your GitLab user name or email.
### 3. Upload your local commits to the git repository on the server ``` git push origin main ``` <center><img src="img/git_push_pull_s.svg" width=1000 ></center>
## Group work: FOSSGIS projects We are going to compare four popular FOSSGIS projects **Group 1: QGIS** **Group 2: GRASS GIS** **Group 3: SAGA GIS** **Group 4: GDAL** Collect your findings on [https://hackmd.io/@chludwig/S1IqMJ_tw](https://hackmd.io/@chludwig/S1IqMJ_tw) You will have about **10 minutes**.
## The QGIS Processing Toolbox * QGIS Processing Toolbox originated from the Sextante plugin which was developed by [Victor Olaya](https://github.com/volaya). * It makes tools from GRASS GIS, SAGA GIS, Orfeo Toolbox, etc. within QGIS and allows the user to combine them in one analysis * Enables automated GIS analyses using the Model Builder, R or Python scripts Main part of assignment 1 is to find resources on how to use the QGIS Model Builder and to practice using it.
## Learning goals for this seminar session By the end of this session you will be able to * ... describe different FOSSGIS projects and explain how they are related to each other. * ... know different ways of how you can contribute to FOSSGIS. * ... explain the purpose and concept of git. * ... use the command line to work with your file system. * ... track your work progress using git.