MichaelSchwabe / geopython-workshop

GeoPython Workshop as mainly provided at OSGeo FOSS4G (2019, 2021, ...)

Doing Geospatial in Python

Installation

Requirements

The workshop requires Docker and Docker Compose on your system

Docker Images

The Docker Images for this workshop are available on DockerHub. The name of the workshop Image is geopython/geopython-workshop[:latest]. Note that the Docker Images contain mainly all (Python) components/dependencies. The actual workshop content (data+notebooks) will be Docker-Volume-mounted.

You may always build a Docker Image from this repo yourself:

git clone https://github.com/geopython/geopython-workshop.git
cd geopython-workshop.git/workshop/jupyter
./build.sh

Running

All services are started using a Docker Compose file.

cd workshop
# start workshop
./geopython-workshop-ctl.sh start
# display URL and open in default web browser
./geopython-workshop-ctl.sh url

# Browse to http://127.0.01:5000 for workshop pygeoapi service
# Browse to http://127.0.01:8001 for workshop pycsw service
# NB Possibly best if we add a frontend or use docs ("home") as entrypoint
./geopython-workshop-ctl.sh stop

NB Jupyter notebook needs a token. The token is displayed on startup:

http://127.0.0.1:8888/?token=<longtokenhexstring>.

As Docker Compose may run in background you can make logging output visible via docker logs --follow geopython-workshop-jupyter .

Bugs and Issues

All bugs, enhancements and issues are managed on GitHub.

Contact

https://gitter.im/geopython/geopython-workshop