Skip to content

Commit 45b5ef8

Browse files
Add web and slides from generated version (#52)
1 parent 893a12e commit 45b5ef8

79 files changed

Lines changed: 473 additions & 9291 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

CONTRIBUTING.md

Lines changed: 0 additions & 46 deletions
This file was deleted.

_config.yml

Lines changed: 0 additions & 5 deletions
This file was deleted.

docs/_config.yml

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
title: Python for GIS and Geoscience
2+
logo:
3+
description: Doctoral schools of Ghent University
4+
show_downloads: true
5+
theme: jekyll-theme-minimal

docs/contributing.md

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
---
2+
layout: default
3+
---
4+
5+
# Contributing guide
6+
7+
First of all, thanks for considering contributing to the course! 👍
8+
9+
## How you can contribute
10+
11+
There are several ways you can contribute to this course.
12+
13+
### Share the love ❤️
14+
15+
Think this course is useful? Let others discover it, by telling them in person, via Twitter or a blog post.
16+
17+
### Ask a question ⁉️
18+
19+
Trying out the material and got stuck? Post your question as an [issue on GitHub](https://github.com/jorisvandenbossche/course-python-geospatial/issues). While we cannot offer user support, we'll try to do our best to address it, as questions often lead to the discovery of bugs.
20+
21+
Want to ask a question in private? Contact the course maintainer by [email](jorisvandenbossche@gmail.com).
22+
23+
### Propose an idea 💡
24+
25+
Have an idea for to improve the course? Take a look at the [issue list](https://github.com/jorisvandenbossche/course-python-geospatial/issues) to see if it isn't included or suggested yet. If not, suggest your idea as an [issue on GitHub](https://github.com/jorisvandenbossche/course-python-geospatial/issues/new).
26+
27+
### Report a bug 🐛
28+
29+
Using the course and discovered a bug or a typo? That's annoying! Don't let others have the same experience and report it as an [issue on GitHub](https://github.com/jorisvandenbossche/Have an idea for to improve the course? Take a look at the [issue list](https://github.com/jorisvandenbossche/course-python-geospatial/issues) to see if it isn't included or suggested yet. If not, suggest your idea as an [issue on GitHub](https://github.com/jorisvandenbossche/course-python-geospatial/issues/new).
30+
/issues/new) so we can fix it. A good bug report makes it easier for us to do so, so please include:
31+
32+
* Your operating system name and version (e.g. Mac OS 10.13.6).
33+
* Any details about your local setup that might be helpful in troubleshooting.
34+
* Detailed steps to reproduce the bug.
35+
36+
### Contribute code 📝
37+
38+
Care to fix issues or typo's? Awesome! 👏
39+
40+
Some notes to take into account:
41+
42+
- The course material is developed in the [course-python-geospatial](https://github.com/jorisvandenbossche/course-python-geospatial) repository. When updating course material, edit the notebooks in the [course-python-geospatial](https://github.com/jorisvandenbossche/course-python-geospatial) repository, the other ones (the ones used in the tutorial) are generated automatically.
43+
- the exercises are cleared using the `nbtutor` notebook extension: <https://github.com/jorisvandenbossche/nbtutor>
44+
45+
46+

docs/index.md

Lines changed: 53 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,53 @@
1+
# Python for GIS and Geoscience
2+
3+
## Introduction
4+
5+
6+
An important aspect of daily work in geographic information science and earth sciences is the handling of potentially large amounts of data. Reading in spatial data, exploring the data, creating visualisations and preparing the data for further analysis may become tedious tasks. Hence, increasing efficiency and reproducibility in this process without the need of a GUI interface is beneficial for many scientists. The usage of high-level scripting languages such as R and Python are increasingly popular for these tasks thanks to the development of GIS oriented packages.
7+
8+
This course trains students to use Python effectively to do these tasks, with a focus on geospatial data. It covers both vector and raster data. The course focuses on introducing the main Python packages for handling such data (GeoPandas and Xarray) and how to use those packages for importing, exploring, visualizing and manipulating geospatial data. It is the aim to give the students an understanding of the data structures used in Python to represent geospatial data (geospatial dataframes, (multi-dimensional) arrays and composite netCDF-like multi-dimensional datasets), while also providing pointers to the broader ecosystem of Python packages for GIS and geosciences.
9+
10+
The course has been developed as a course for the Doctoral schools of Ghent University, but can be taught to others upon request.
11+
12+
## Course info
13+
14+
### Aim & scope
15+
16+
This course targets researchers that want to enhance their general data manipulation, explorative visualisation and analysis skills in Python specifically for handling geospatial data.
17+
18+
The course does not aim to provide a course in specific spatial analysis and statistics, cartography, remote sensing, OGC web services or general Geographical Information Management (GIS). It aims to provide researchers the means to effectively tackle commonly encountered spatial data handling tasks in order to increase the overall efficiency. The course does not tackle desktop GIS Python extensions such as arcpy or pyqgis.
19+
20+
### Program
21+
22+
After setting up the programming environment with the required packages using the conda package manager and an introduction of the Jupyter notebook environment, the vector data analysis package GeoPandas is introduced. Next, more advanced features of GeoPandas for spatial joins and overlays are explained.
23+
24+
For working with raster data, the Xarray package is introduced. Next, the combination of raster and vector data and more advanced plotting are taught. The acquired skills will immediately be brought into practice to handle real-world data sets.
25+
26+
In the last part, the use of xarray for spatial data cubes (netcdf-like), out-of-memory raster data and interactive visualisation of spatial data is tackled. Participants work on case studies to apply the learned skills of the full workshop. The course closes with an overview of other packages that are being used in the geospatial Python ecosystem (other visualization frameworks, specialized GIS oriented packages).
27+
28+
## Getting started
29+
30+
The course uses Python 3 and some data analysis packages such as Pandas, Numpy and Matplotlib and geospatial packages such as GeoPandas, Rasterio and Xarray. To install the required libraries,
31+
we recommend Anaconda or miniconda ([https://www.anaconda.com/download/](https://www.anaconda.com/download/)) or another Python distribution that
32+
includes the scientific libraries (this recommendation applies to all platforms, so for both Window, Linux and Mac).
33+
34+
For detailed instructions to get started on your local machine, see the [setup instructions](./setup.html).
35+
36+
In case you do not want to install everything and just want to try out the course material, use the environment setup by
37+
Binder [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/jorisvandenbossche/DS-python-geospatial/HEAD) and open de notebooks
38+
rightaway (inside the `notebooks` directory).
39+
40+
## Slides
41+
42+
For the course slides, click [here](https://jorisvandenbossche.github.io/DS-python-geospatial/slides.html).
43+
44+
## Contributing
45+
46+
Found any typo or have a suggestion, see [how to contribute](./contributing.html).
47+
48+
## Meta
49+
Authors: Joris Van den Bossche, Stijn Van Hoey
50+
51+
<img src="./static/img/logo_flanders+richtingmorgen.png" width="79%">
52+
<img src="./static/img/doctoralschoolsprofiel_hq_rgb_web.png" width="20%">
53+

0 commit comments

Comments
 (0)