Update documentation

GIScience · Oct 24, 2023 · 77563e2 · 77563e2
1 parent c603817
commit 77563e2
Show file tree

Hide file tree

Showing 131 changed files with 3,921 additions and 870 deletions.
diff --git a/.buildinfo b/.buildinfo
@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: dbdf52310030f4d57c449a5c0a56e760
+config: 34aa3e3192fa3344092af829ef79ec53
 tags: 645f666f9bcd5a90fca523b33c5a78b7
diff --git a/README.html b/README.html
@@ -253,6 +253,7 @@
 
 
 <li class="toctree-l1"><a class="reference internal" href="content/Modul_5/en_qgis_non_spatial_tools.html">Non-Spatial Geodataprocessing</a></li>
+
 </ul>
 <p aria-level="2" class="caption" role="heading"><span class="caption-text">Trainers corner</span></p>
 <ul class="nav bd-sidenav">

diff --git a/_downloads/54547c7e6d6f20d020245b033bbce8f1/en_QGIS_User_Interface.png b/_downloads/54547c7e6d6f20d020245b033bbce8f1/en_QGIS_User_Interface.png
diff --git a/_images/Colour_Blindness.png b/_images/Colour_Blindness.png
diff --git a/_images/Colour_Gradients_2.png b/_images/Colour_Gradients_2.png
diff --git a/_images/en_30.30.2_categorized_layer_symbology_1.png b/_images/en_30.30.2_categorized_layer_symbology_1.png
diff --git a/_images/en_30.30.2_categorized_layer_symbology_2.png b/_images/en_30.30.2_categorized_layer_symbology_2.png
diff --git a/_images/en_30.30.2_raster_data_colour_gradient.png b/_images/en_30.30.2_raster_data_colour_gradient.png
diff --git a/_images/en_30.30.2_setting_up_labels.png b/_images/en_30.30.2_setting_up_labels.png
diff --git a/_images/en_30.30.2_vector_layer_styling_transparent.png b/_images/en_30.30.2_vector_layer_styling_transparent.png
diff --git a/_images/en_Add_a_vector_file_a.png b/_images/en_Add_a_vector_file_a.png
diff --git a/_images/en_Add_basemaps.png b/_images/en_Add_basemaps.png
diff --git a/_images/en_Aerial_measuring_results.jpg b/_images/en_Aerial_measuring_results.jpg
diff --git a/_images/en_Attribute_table.png b/_images/en_Attribute_table.png
diff --git a/_images/en_Data_behind_the_Map_CartONG02.png b/_images/en_Data_behind_the_Map_CartONG02.png
diff --git a/_images/en_Excel_Data_a.png b/_images/en_Excel_Data_a.png
diff --git a/_images/en_Excel_Data_b.png b/_images/en_Excel_Data_b.png
diff --git a/_images/en_Excel_Data_c.png b/_images/en_Excel_Data_c.png
diff --git a/_images/en_Excel_Data_d.png b/_images/en_Excel_Data_d.png
diff --git a/_images/en_Excel_Data_e.png b/_images/en_Excel_Data_e.png
diff --git a/_images/en_Excercise_0_a.png b/_images/en_Excercise_0_a.png
diff --git a/_images/en_Excercise_0_b.png b/_images/en_Excercise_0_b.png
diff --git a/_images/en_Excercise_1_a.png b/_images/en_Excercise_1_a.png
diff --git a/_images/en_Excercise_1_b.png b/_images/en_Excercise_1_b.png
diff --git a/_images/en_GIS_CartONG01.png b/_images/en_GIS_CartONG01.png
diff --git a/_images/en_Graphic_information_CartONG04.png b/_images/en_Graphic_information_CartONG04.png
diff --git a/_images/en_Interface_01.png b/_images/en_Interface_01.png
diff --git a/_images/en_Spreadsheet_CartONG03.png b/_images/en_Spreadsheet_CartONG03.png
diff --git a/_images/en_add_vector_join.png b/_images/en_add_vector_join.png
diff --git a/_images/en_buffer.png b/_images/en_buffer.png
diff --git a/_images/en_buffer_point_line_polygon.png b/_images/en_buffer_point_line_polygon.png
diff --git a/_images/en_clip.png b/_images/en_clip.png
diff --git a/_images/en_colour_gradients_saturation.png b/_images/en_colour_gradients_saturation.png
diff --git a/_images/en_delete_table_fields.png b/_images/en_delete_table_fields.png
diff --git a/_images/en_delete_table_fields01.png b/_images/en_delete_table_fields01.png
diff --git a/_images/en_different_crs.gif b/_images/en_different_crs.gif
diff --git a/_images/en_dissolve_results.png b/_images/en_dissolve_results.png
diff --git a/_images/en_field_calculator.png b/_images/en_field_calculator.png
diff --git a/_images/en_field_calculator01.png b/_images/en_field_calculator01.png
diff --git a/_images/en_field_calculator02.png b/_images/en_field_calculator02.png
diff --git a/_images/en_geoprocessing_icons.png b/_images/en_geoprocessing_icons.png
diff --git a/_images/en_geoprocessing_tools.png b/_images/en_geoprocessing_tools.png
diff --git a/_images/en_good_map_composition_example.png b/_images/en_good_map_composition_example.png
diff --git a/_images/en_join_attributes_by_field_value.png b/_images/en_join_attributes_by_field_value.png
diff --git a/_images/en_join_attributes_by_location.png b/_images/en_join_attributes_by_location.png
diff --git a/_images/en_logical_operators.png b/_images/en_logical_operators.png
diff --git a/_images/en_map_design_example_variable_ranges.png b/_images/en_map_design_example_variable_ranges.png
diff --git a/_images/en_query_builder.png b/_images/en_query_builder.png
diff --git a/_images/en_query_builder_location.png b/_images/en_query_builder_location.png
diff --git a/_images/en_region_indication.png b/_images/en_region_indication.png
diff --git a/_images/en_research_tools.png b/_images/en_research_tools.png
diff --git a/_images/en_save_vector_layer.png b/_images/en_save_vector_layer.png
diff --git a/_images/en_select_by_expression.png b/_images/en_select_by_expression.png
diff --git a/_images/en_select_by_location.png b/_images/en_select_by_location.png
diff --git a/_images/en_select_feature.png b/_images/en_select_feature.png
diff --git a/_images/en_select_features_expression.png b/_images/en_select_features_expression.png
diff --git a/_images/en_select_unique_value.png b/_images/en_select_unique_value.png
diff --git a/_images/en_selection_attribute_table.png b/_images/en_selection_attribute_table.png
diff --git a/_images/en_spatial_joins.png b/_images/en_spatial_joins.png
diff --git a/_images/en_symbolization_vector_data.png b/_images/en_symbolization_vector_data.png
diff --git a/_images/en_table_fields.png b/_images/en_table_fields.png
diff --git a/_images/en_without_dissolve_results.png b/_images/en_without_dissolve_results.png
diff --git a/_images/example_scale_bar.png b/_images/example_scale_bar.png
diff --git a/_images/gui_numbered.png b/_images/gui_numbered.png
diff --git a/_images/screenshot_video_every_world_map_is_wrong.png b/_images/screenshot_video_every_world_map_is_wrong.png
diff --git a/_sources/content/Modul_1/en_gis_theorie.md b/_sources/content/Modul_1/en_gis_theorie.md
diff --git a/_sources/content/Modul_1/geodatenformate.md b/_sources/content/Modul_1/geodatenformate.md
@@ -0,0 +1,57 @@
+# Geodatenformate
+Auf dieser Seite werden die für dieses Tutorium wichtigsten Geodatenformate behandelt, um einen allgemeinen Überblick für die Teilnehmenden zu schaffen. Dabei werden folgende Themen angesprochen: 
+- [Unterschiede bei der Arbeit mit Raster- und Vektordaten](#unterschiede-bei-der-arbeit-mit-raster-und-vektordaten)
+- [verschiedene Vektordatenformate](#vektordatenformate) (Shapefiles und GeoJSON)
+- [Rasterdatenformate](#rasterdatenformate) (GeoTiff)
+- [Datenformate für Raster- und Vektordaten](#datenformate-für-raster-und-vektordaten) (Geopackage), und
+- [Web Map Service (WMS)](#web-map-service-wms)
+
+# Unterschiede bei der Arbeit mit Raster- und Vektordaten
+Tools für Vektordaten **sind nicht** für die Verarbeitung von Rasterdaten geeignet, und umgekehrt.
+
+# Vektordatenformate
+## Shapefiles
+Shapefiles werden in **mehreren verschiedenen Dateien** aufgeteilt gespeichert. Dabei trägt jede "Teil-Datei" ganz bestimmte Informationen, wie in der Darstellung hier gesehen werden kann. Dateien mit der Endung .shp, zum Beispiel, sind die hauptsächliche Datei und beinhalten die Geometrien, während dbf-Dateien die Attributtabelle enthalten.
+
+![Shapefile_Dateiformate_1](uploads/43feaa0744cd1a6b29d52a6639730b2c/Shapefile_Dateiformate_1.png)  
+
+Shapefiles können immer **nur einen Geometrietyp beinhalten,** das heißt sie enthalten entweder ausschließlich Punkt, Linien, oder Polygon Features, niemals eine Mischung der drei.
+
+## Textuelle Austauschformate, wie z.B. GeoJSON
+
+Vektordaten können auch in textuellen Austauschformaten, wie zum Beispiel GeoJSON, vorhanden sein. 
+GeoJSON ist ein offenes Standardaustauschformat für räumliche Daten und basiert auf JSON (JavaScript Object Notation). Daten, die in diesem Format dargestellt werden, beziehen sich auf das geographische Koordinatenbezugssystem "World Geodetic System 1984". Zur Veranschaulichung finden sich in der folgenden Darstellung Beispiele für gültige GeoJSON-Dateien.
+
+![GeoJSON_Dateiformat](uploads/db464273a2aecd3cf0c9d53a1e7325ed/GeoJSON_Dateiformat.PNG)
+
+*Quelle: ArcGIS Online. o.J. GeoJSON. Online unter: https://doc.arcgis.com/de/arcgis-online/reference/geojson.htm, abgerufen am 19.10.2020.*
+
+Weitere Informationen zu GeoJSON und der Verwendung in GIS finden sich unter: https://doc.arcgis.com/de/arcgis-online/reference/geojson.htm.
+
+GeoJSON-Daten können zudem unter der Adresse geojson.io leicht **selbst erstellt** werden.
+
+# Rasterdatenformate
+## GeoTiff
+* GeoTiffs beinhalten georeferenzierte Bilddateien, zum Beispiel Luft- oder Satellitenbilder.
+* GeoTiff (**Geo**graphic **T**agged **I**mage **F**ile **F**ormat) wird heute nahezu standardmäßig als Speicherformat für Rasterdaten verwendet.
+* In die Bilddatei eingebettete Metadaten enthalten Informationen zur Georeferenz des Bildes, wie etwa Koordinaten zur Georeferenzierung oder das Koordinatenbezugssystem.
+
+Weitere Informationen finden sich unter folgendem Link des OGC (Open Geospatial Consortium): http://docs.opengeospatial.org/is/19-008r4/19-008r4.html#_geotiff.
+
+# Datenformate für Raster- und Vektordaten
+## Geopackages
+Ein Geopackage (standardisiert durch das *Open Geospatial Consortium (OGC)*) ist ein Format zur Speicherung von Vektor- und Rasterdaten, das von den meisten GIS unterstützt wird.
+- Idee: Eine dateibasierte Datenbank (SQLite), in welcher auf standardisierte Weise alle Daten gespeichert werden.
+- Dateibasierte Datenbank = eine Datei, welche in strukturierter Weise abgefragt werden kann
+
+**Probleme mit Geopackages:**
+
+Beim Arbeiten mit Geopackages kann es zuweilen zu dem Dateiformat spezifischen Problemen kommen. So kann die Verarbeitung mit Tools wie Clip, oder anderen Wekrzeugen, besonders wenn Änderungen in der Attributtabelle vorgenommen werden, Fehlermeldungen hervorrufen. Lösen lässt sich dieses Problem, wenn das Dateiformat *Geopackage* nur zum Speichern, also zum Exportieren ausgewählt wird (der Vorteil liegt hier besonders im Vergleich zu Shapefiles darin, dass ein Geopackage nur aus einer Datei, und nicht mehreren besteht und so keine Teildatei verloren gehen kann). Während der Arbeit im Projekt, sollte dagegen besser mit GeoTiffs oder Shapefiles gearbeitet werden, um Fehlerquellen zu minimieren.
+
+Herunterladen werden können leere Geopackages zum Weiterverarbeiten unter folgendem Link: http://www.geopackage.org/data/empty.gpkg
+
+# Web Map Service (WMS)
+
+**W**eb **M**ap **S**ervices (WMS) erlauben es euch, Geodaten aus dem Web mit eurem GIS zu verknüpfen und abzurufen. Als Ergebnis wird euch dabei dann ein georeferenziertes Kartenbild angezeigt. Dieses Prinzip wird beispielsweise auch bei [Basemaps](qgis-Basemaps) angewendet. Im zugehörigen Wikibeitrag finden sich Informationen darüber, wie sich WMS Daten in QGIS hereinladen lassen, und welche Funktionen genutzt werden können. 
+
+*Further Resources:* Weitere Informationen zu WMS finden sich auch unter: https://www.ogc.org/standards/wms.
diff --git a/_sources/content/Modul_1/ger_qgis_installation.md b/_sources/content/Modul_1/ger_qgis_installation.md
@@ -0,0 +1,44 @@
+# Installation
+QGIS ist Open Source und daher frei und ohne Kosten für jeden verfügbar. Ihr könnt QGIS für Windows, Mac und Linux Rechner installieren. 
+
+## Windows
+Für die Installation unter Windows verwenden wir den OSGeo4W Netzwerkinstaller. OSGeo4W ist ein Projekt, das Open Geo bezogene Software für Windows einfach zu installieren anbietet. Besucht die Projektseite [https://trac.osgeo.org/osgeo4w/](https://trac.osgeo.org/osgeo4w/) und klickt dort auf den link `Download the OSGeo4W network installer`. 
+
+* Achtet darauf während des Installationsprozesses _Advanced Install_ / _Fortgeschrittene Installation_ zu wählen. Nur dann können die für diesen Kurs relevante Software präzise wählen:
+   - QGIS Desktop
+   - GRASS GIS
+   - SAGA
+
+Videotutorial: https://www.youtube.com/watch?v=pja_EX0tVZA
+
+Die gewählte Software wird dann über das Internet heruntergeladen und on-the-fly installiert.
+
+
+## Mac
+
+__**Ab Version 3.30 muss SAGA per plugin eingebunden werden**__
+
+ Unter https://qgis.org/en/site/forusers/download.html `Download for macOS` wählen. Dann den Link _Download QGIS_ nutzen. 
+
+In QGIS dann das Plugin _Processing Saga NextGen Provider_ installieren. 
+
+Mehr zu wie man Plugins in QGIS installiert und aktiviert findet ihr hier:
+[qgis-Interface#erweiterungen-plugins-installieren](https://courses.gistools.geog.uni-heidelberg.de/giscience/gis-einfuehrung/-/wikis/qgis-Interface#erweiterungen-plugins-installieren)
+
+## Linux
+
+__**Ab Version 3.30 muss SAGA per plugin eingebunden werden**__
+
+Für die installation unter Linux Systemen mit apt könnt ihr QGIS installieren:
+
+```
+sudo apt install qgis qgis-plugin-grass
+```
+
+In den herkömmlichen apt Paketquellen wird vermutlich eine ältere Version von QGIS installiert sein. Solltet ihr die Paketquelle [Ubuntugis](https://launchpad.net/~ubuntugis/+archive/ubuntu/ppa) nutzen, beachtet die folgenden installations Hinweise auf https://qgis.org/en/site/forusers/alldownloads.html#repositories
+
+Solltet ihr hierüber eine QGIS Version >3.30 installieren müsst ihr das Plugin _Processing Saga NextGen Provider_ noch installieren. 
+
+Mehr zu wie man Plugins in QGIS installiert und aktiviert findet ihr hier:
+[qgis-Interface#erweiterungen-plugins-installieren](https://courses.gistools.geog.uni-heidelberg.de/giscience/gis-einfuehrung/-/wikis/qgis-Interface#erweiterungen-plugins-installieren)
+
diff --git a/_sources/content/Modul_2/en_qgis_geodata_concept.md b/_sources/content/Modul_2/en_qgis_geodata_concept.md
@@ -13,7 +13,8 @@
 ## Projections 
 ### Theory
 
-The earth is a sphere and cannot be represented on a flat map without being distorted. To able able to display the earth on a flat map for example as a rectangle it needs to be projected. For further explanation, watch this [video](https://www.youtube.com/watch?v=kIID5FDi2JQ). 
+The earth is a sphere and cannot be represented on a flat map without being distorted. To able able to display the earth on a flat map for example as a rectangle it needs to be projected. For further explanation, watch this video.
+[![preview video](../../fig/screenshot_video_every_world_map_is_wrong.png)](https://www.youtube.com/watch?v=kIID5FDi2JQ "Why every world map is wrong")
 
 For this translation, from a curved on a flat surface, thousands of different methods exist. These are called **Coordinate Reference Systems (CRS)**.
 
@@ -43,12 +44,14 @@ For smaller areas local projections should be used, since they give a more accur
 You can find all the projections and their CRS code at this [website](http://epsg.io). 
 
 
-To change the projection of a **vector file**, click on *Vector*, *Data Management Tools*, *Reproject Layer*. Select your input layer and the target crs. Click on the three dots to *Save to File...* and click *Run*. For a detailed instruction click on this [video](https://gitlab.gistools.geog.uni-heidelberg.de/giscience/disaster-tools/gis-in-anticipatory-humanitarian-action/-/wikis/uploads/7e7a28698859062d1b832b558b2721c6/qgis_reproject_vector.mp4).
+To change the projection of a **vector file**, click on *Vector*, *Data Management Tools*, *Reproject Layer*. Select your input layer and the target crs. Click on the three dots to *Save to File...* and click *Run*. For a detailed instruction click on this video.
+<video width="100%" controls src="/Users/celinathome/Desktop/HeiGIT/visualstudiocode/gis-training-resource-center/fig/qgis_reproject_vector.mp4"></video>
 
-To change the projection of a **raster file**, clickclick on *Raster*, *Projections*, *Warp (Reproject)*. Choose your input layer and target crs. Click on the three dots to *Save to File...* and click *Run*. For a detailed instruction click on this [video](https://gitlab.gistools.geog.uni-heidelberg.de/giscience/disaster-tools/gis-in-anticipatory-humanitarian-action/-/wikis/uploads/3b7a1bb2408f4453f22d73f54156888b/qgis_reproject_raster.mp4).
+To change the projection of a **raster file**, clickclick on *Raster*, *Projections*, *Warp (Reproject)*. Choose your input layer and target crs. Click on the three dots to *Save to File...* and click *Run*. For a detailed instruction click on this video. <video width="100%" controls src="https://github.com/GIScience/gis-training-resource-center/blob/main/fig/qgis_reproject_raster.mp4"></video>
+
+
+It is crucial that you are aware of the difference in data projection and project projection. They should always be the same, or else you will get wrong results! You can change the data projection by following the steps explained above. The project projection is on the bottom left corner, as seen [here](../../fig/en_QGIS_User_Interface.png). 
 
-It is crucial that you are aware of the difference in data projection and project projection. They should always be the same, or else you will get wrong results! You can change the data projection by following the steps explained above. The project projection is on the bottom left corner, as seen here. 
-![QGIS Interface](../../fig/en_QGIS_User_Interface.png) 
 The interface then will be the same and by searching for the right EPSG you can change the projection. 
 
 ## Excercises

diff --git a/_sources/content/Modul_4/en_qgis_map_design_2.md b/_sources/content/Modul_4/en_qgis_map_design_2.md
@@ -8,7 +8,7 @@ The print layout in QGIS is where you design and finalize the map in order to pr
 
 ```{figure} ../../fig/en_30.30.2_create_print_layout.png
 ---
-width: 700px
+width: 500px
 name: Create Print Layout
 ---
 Create a new Print Layout
@@ -51,7 +51,7 @@ _A4 and A3 are the most commonly used sizes for maps_
 
 ```{figure} ../../fig/en_30.30.2_adding_a_map.png
 ---
-width: 750px
+width: 500px
 name: Add a new map
 ---
 Adding a new map to the Print Layout
@@ -68,7 +68,7 @@ A title should describe the phenomenen represented on the map.
 
 ```{figure} ../../fig/en_30.30.2_print_layout_add_text.png
 ---
-width: 750px
+width: 500px
 name: Add text to the print layout
 ---
 Adding text to the print Layout
@@ -86,7 +86,7 @@ To add a legend, you can use the __add legend__ button on the __left toolbar__.
 
 ```{figure} ../../fig/en_30.30.2_print_layout_add_legend.png
 ---
-width: 750px
+width: 500px
 name: Add a legend to the print layout
 ---
 Adding a legend to the print layout
@@ -102,7 +102,7 @@ Before adding a scale bar, select your main map and check in the __Item Properti
 
 ```{figure} ../../fig/en_30.30.2_print_layout_scale.png
 ---
-width: 750px
+width: 500px
 name: Round number for scale
 ---
 Make sure that the scale is at a round number
@@ -120,7 +120,7 @@ _There are many other options to customize the scale bar (change the font, colou
 
 ```{figure} ../../fig/en_30.30.2_print_layout_add_scale_bar.png
 ---
-width: 750px
+width: 500px
 name: Add scale bar
 ---
 Add and customize the scale bar
@@ -144,7 +144,7 @@ To create an overview map, you need to follow these steps:
 
 ```{figure} ../../fig/en_30.30.2_print_layout_overview_map_preparations.png
 ---
-width: 500px
+width: 200px
 name: Overview map preparation
 ---
 An overview map should show important landmarks and borders
@@ -153,7 +153,7 @@ An overview map should show important landmarks and borders
 
 ```{figure} ../../fig/en_30.30.2_print_layout_add_overview_map.png
 ---
-width: 750px
+width: 500px
 name: Add Overview map
 ---
 Add an overview map and __lock the layer__
@@ -162,7 +162,7 @@ Add an overview map and __lock the layer__
 
 ```{figure} ../../fig/en_30.30.2_print_layout_add_map_extent_overview_map.png
 ---
-width: 750px
+width: 500px
 name: Create an Overview
 ---
 Add a the extent of the main map to your overview map (the red rectangle on the overview)
@@ -190,13 +190,7 @@ A map is never complete without the following elements:
 - Localization (Overview) Map
 - Author
 
-```{figure} ../../fig/en_good_map_composition_example.png
----
-name: good map composition example
-width: 750px
----
-Elements of good map composition
-```
+> Image?
 
 ----
 
@@ -219,7 +213,7 @@ __The legend__ is key to interpreting the information represented on the map. Wi
 
 ```{figure} ../../fig/en_legend_good_practice.png
 ---
-width: 750px
+width: 500px
 name: Organized Legend
 ---
 Example of a well organized legend
@@ -231,7 +225,7 @@ __The scale bar__ is essential to a map since it gives the correspondence betwee
 
 - __the graphical scale__ is expressed by a line on the map, with an associated distance value. This scale is very useful to have an idea of the distances on the ground. The graphical scale will always be the correct size, even if a different printing format is used, since it will undergo the same transformation as the rest of the map
 
-```{figure} ../../fig/example_scale_bar.png
+```{figure} ../../fig/example_scale_bar.png" 
 ---
 name: scale bar
 ---
@@ -300,4 +294,5 @@ __The eye can easily distinguish 4 to 5 different symbols. Beyond that, it is di
 
 It is a mistake because:
 - It complicates the map and limits its impact. 
-- Sometimes you are forced to represent several symbols, so you must be careful about overlapping points and overloading the map.
+- Sometimes you are forced to represent several symbols, so you must be careful about overlapping points and overloading the map.
+
-Original file line number
+Diff line change
@@ Expand Up / @@ -253,6 +253,7 @@ @@
     <li class="toctree-l1"><a class="reference internal" href="content/Modul_5/en_qgis_non_spatial_tools.html">Non-Spatial Geodataprocessing</a></li>
     </ul>
     <p aria-level="2" class="caption" role="heading"><span class="caption-text">Trainers corner</span></p>
     <ul class="nav bd-sidenav">
@@ Expand Down @@