Regardless of the means of transportation, individual human mobility is an aspect of our modern society with utmost relevance. In order to maintain a mobility system without severe problems or to improve its efficiency and convenience, data-driven services based on mobility data of individual humans increasingly gain importance. The availability of such data, however, is limited due to data privacy issues. This concise tool helps to create synthetic mobility data in a realistic way that can then be used for all kinds of predictive tasks.
To run the mobility-data-creator
, you may clone this repository and install the dependencies
pandas~=1.3.3
numpy~=1.21.2
as stated in the requirements file. Then, you essentially need to provide
- a set of known locations, and
- the travel times in between those,
in the data
directory;
for your convenience, exemplary default files are already provided.
When running the main.py
script, a CSV-file
is created containing a sequence of journeys, e.g. trips taken by car, ordered by time.
The columns represent the following information:
Name | Description |
---|---|
gps_start_lat | Latitude of GPS position at start of trip |
gps_start_lon | Longitude of GPS position at start of trip |
t_start | Start time of trip as UTC time code in Milliseconds |
t_end | End time of trip as UTC time code in Milliseconds |
gps_end_lat | Latitude of GPS position at end of trip |
gps_end_lon | Longitude of GPS position at end of trip |
For the already provided example data, the created raw data points are visualized here:
In addition, the logic of how the sequence of journeys is extended can be
adapted in trip_creation.py
.
The data set presented here was used for this study on estimating the parking duration of vehicles. Beyond this, however, a variety of further use cases, e.g. predicting the next place to visit, is conceivable. For all contributions that supported this research, many thanks also goes to
- Kaleb Phipps (Karlsruhe Institute of Technology)
- Benjamin Briegel (Mercedes-Benz AG)
- Veit Hagenmeyer (Karlsruhe Institute of Technology)
- Ralf Mikut (Karlsruhe Institute of Technology)
If you find a use case for which the mobility-data-creator
or the provided data can be helpful,
feel free to use it under the provided MIT license and make a friendly remark to this repository or its creator Karl Schwenk.
Furthermore, if adaptions of the source code could help to improve this tool,
you are more than welcome to open an issue and discuss on how to integrate your suggestions.
For further questions, please contact Karl Schwenk.