mapper

University of Toronto ECE297 project:

A Geographic Information System (GIS) software program that will let you visualize and solve travel and optimization problems in maps of any city of the world.

Or just a mapper for short. This project was created for the 2020 Winter semester.

Note that due to the size of the database binaries, the only map included in this repository is of Hamilton, Ontario. However, the osm2bin tool can be used to generate maps for other cities using OpenStreetMap data.

Usage

In order to run the mapper executable, you will need to first build the Docker image from within the repository directory.

docker build -t mapper .

Before running, a bidirectional byte stream must be set-up to allow the GUI to run on your host machine. This could be done in the background using socat.

socat TCP-LISTEN:6000,reuseaddr,fork UNIX-CLIENT:\"$DISPLAY\" &

In order to connect the image to your host's window server, you must set the container's DISPLAY environment variable to the host's static IP address.¹

Finally, use the following command (replacing $IP_ADDRESS) to run the image in a container.²

docker run -it --rm -e DISPLAY=$IP_ADDRESS:0 mapper

Support

1. On macOS and Windows, host.docker.internal can be used as a substitute which Docker will resolve automatically. See more.
2. On macOS, XQuartz must also be installed in order to host X11 windows. See more.