UrbanLife+ Activity Support

This is a pedestrian navigation support system that was developed by Julian Fietkau during the UrbanLife+ project. The software models an outdoor environment and can interface with smart urban objects to assist users in finding their way by providing adaptive routing support. Certain paths are automatically in- or excluded depending on the user's pedestrian mobility situation, e.g. based on the use of a walker or a wheelchair.

While this software can interface with real sensors and end-user devices, the more likely usage scenario is that you want to try out the real-time simulation component. The activity support can simulate users in the model environment which can then be controlled through the web interface.

In addition to the core activity support implemented by Julian Fietkau, this repository also contains the micro info radiator code mainly written by Laura Stojko.

This software is a partial result of Julian Fietkau's doctoral project at the Universität der Bundeswehr München. More detailed information can be found in the corresponding dissertation.

Please note that a number of proprietary files had to be excised from the revision history in anticipation of the public release. As a result, some of the older revisions may be non-functional.

Project website: https://fietkau.software/ulp_activity_support

How to use

This software requires Python 3 with the Flask package for the central service and the simulation. The micro info radiator code is intended to run on Raspberry Pi computers equipped with Sense HATs and comes with its own additional requirements. You will need to provide an MQTT broker.

Out of the box, you can start the activity support by running server.py. By itself it will not do much. If you are also running a micro info radiator management service, you can try launching the activity support as server.py --register to connect the two. If you want the interactive simulation, run it as server.py --sim and then access http://localhost:5500/view/demo in your web browser.

In the simulation view, you can click the users or the info radiators to receive detail information on each. For the virtual users, you can pause and restart their movement, enable the remote control (set new navigation targets by right-clicking on the map) or change the mobility mode. The checkboxes in the bottom left allow you to toggle the individual interface elements.

License

UrbanLife+ Activity Support (c) 2019-2022 Julian Fietkau and Laura Stojko

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. See LICENSE for details.

The image file assets/example-park.png was created by tech_huma and is dedicated to the public domain under the terms of Creative Commons Zero. You may reuse and redistribute it without restriction and/or use it as a basis for derivative works. Credit is appreciated, but not legally required.