2020-08-03 20:19:42 +02:00
|
|
|
# Urban Meal Delivery
|
|
|
|
|
|
|
|
|
|
This repository holds code
|
2020-09-30 13:43:00 +02:00
|
|
|
analyzing the data of an undisclosed urban meal delivery platform (UDP)
|
2020-08-03 20:19:42 +02:00
|
|
|
operating in France from January 2016 to January 2017.
|
|
|
|
|
The goal is to
|
|
|
|
|
optimize the platform's delivery process involving independent couriers.
|
|
|
|
|
|
2020-08-11 11:02:09 +02:00
|
|
|
|
|
|
|
|
## Structure
|
|
|
|
|
|
2020-09-30 13:43:00 +02:00
|
|
|
The analysis is structured into the following stages
|
2020-08-03 20:19:42 +02:00
|
|
|
that iteratively build on each other.
|
|
|
|
|
|
2020-09-30 13:43:00 +02:00
|
|
|
|
|
|
|
|
### Data Cleaning
|
|
|
|
|
|
|
|
|
|
The UDP provided its raw data as a PostgreSQL dump.
|
2020-12-14 16:56:27 +01:00
|
|
|
This [notebook](https://nbviewer.jupyter.org/github/webartifex/urban-meal-delivery/blob/develop/research/clean_data.ipynb)
|
2020-09-30 13:43:00 +02:00
|
|
|
cleans the data extensively
|
2020-09-30 13:51:09 +02:00
|
|
|
and maps them onto the [ORM models](https://github.com/webartifex/urban-meal-delivery/tree/develop/src/urban_meal_delivery/db)
|
2020-09-30 13:43:00 +02:00
|
|
|
defined in the `urban-meal-delivery` package
|
2020-09-30 13:51:09 +02:00
|
|
|
that is developed in the [src/](https://github.com/webartifex/urban-meal-delivery/tree/develop/src) folder
|
2020-09-30 13:43:00 +02:00
|
|
|
and contains all source code to drive the analyses.
|
|
|
|
|
|
|
|
|
|
Due to a non-disclosure agreement with the UDP,
|
|
|
|
|
neither the raw nor the cleaned data are published as of now.
|
2020-12-14 16:56:27 +01:00
|
|
|
However, previews of the data can be seen throughout the [research/](https://github.com/webartifex/urban-meal-delivery/tree/develop/research) folder.
|
2020-09-30 13:43:00 +02:00
|
|
|
|
|
|
|
|
|
2020-08-11 11:02:09 +02:00
|
|
|
### Real-time Demand Forecasting
|
|
|
|
|
|
|
|
|
|
### Predictive Routing
|
|
|
|
|
|
|
|
|
|
### Shift & Capacity Planning
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Installation & Contribution
|
|
|
|
|
|
|
|
|
|
To play with the code developed for the analyses,
|
|
|
|
|
you can clone the project with [git](https://git-scm.com/)
|
|
|
|
|
and install the contained `urban-meal-delivery` package
|
|
|
|
|
and all its dependencies
|
|
|
|
|
in a [virtual environment](https://docs.python.org/3/tutorial/venv.html)
|
|
|
|
|
with [poetry](https://python-poetry.org/docs/):
|
|
|
|
|
|
|
|
|
|
`git clone https://github.com/webartifex/urban-meal-delivery.git`
|
|
|
|
|
|
|
|
|
|
and
|
|
|
|
|
|
|
|
|
|
`poetry install --extras research`
|
2020-08-03 20:19:42 +02:00
|
|
|
|
2020-08-11 11:02:09 +02:00
|
|
|
The `--extras` option is necessary as the non-develop dependencies
|
|
|
|
|
are structured in the [pyproject.toml](https://github.com/webartifex/urban-meal-delivery/blob/develop/pyproject.toml) file
|
|
|
|
|
into dependencies related to only the `urban-meal-delivery` source code package
|
|
|
|
|
and dependencies used to run the [Jupyter](https://jupyter.org/) environment
|
|
|
|
|
with the analyses.
|
2020-08-03 20:19:42 +02:00
|
|
|
|
2020-08-11 11:02:09 +02:00
|
|
|
Contributions are welcome.
|
|
|
|
|
Use the [issues](https://github.com/webartifex/urban-meal-delivery/issues) tab.
|
|
|
|
|
The project is licensed under the [MIT license](https://github.com/webartifex/urban-meal-delivery/blob/develop/LICENSE.txt).
|
