Bicycle-sharing data analysis
Branch: master
Clone or download
garaud update the README file
add a logo, courtelesy designs by @sylvainbeo -- https://github.com/sylvainbeo
Latest commit 1269e56 Feb 16, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
images update the README file Feb 16, 2019
jitenshea specify an data output dir in the config file Feb 15, 2019
sql add some new lines to the database refactoring SQL file Aug 16, 2018
tests add and update some webapi unit tests Nov 4, 2018
.gitignore update the gitignore file Feb 16, 2019
.yarnrc drop bower to install/manage CSS and JS packages Oct 16, 2018
LICENSE add the MIT license Dec 2, 2017
README.md update the README file Feb 16, 2019
config.ini.sample
package.json ui: fix package and path for swagger-ui and API '/doc' route Oct 18, 2018
pytest.ini add the pytest.ini file May 26, 2018
setup.cfg
setup.py update the setup.py Feb 15, 2019

README.md

Jitenshea: bicycle-sharing data analysis

License: MIT

logo

In Japanese:

Jitensha (bicycle) + Shea (share) = Jitenshea

Analyze bikes sharing station data some cities where there are Open Data.

You have three parts in this project:

  • a data pipeline and data processing with luigi to get, transform and store data

  • Some statistics and Machine Learning to analyze the timeseries and predict the bikes availability for each station.

  • Web application to get and visualize some data through a REST API

screenshot

Data

Open Data from French cities Bordeaux and Lyon:

Some luigi tasks can be called every 10 minutes for instance to gather the bicycle-sharing stations data. Another one is called every day to aggregate some data. You can use cron-job to carry out this stuff.

Contributions for other cities are welcomed! e.g. Nantes, Paris, Marseille, etc.

Configuration

A configuration file sample can be found at the root directory config.ini.sample. Copy it into the jitenshea directory , rename it into config.ini and update it.

It is used for the database access, some tokens for API, etc.

Requirements

PostgreSQL database with PostGIS. You must have the shp2pgsql command.

All Python requirements are specified in the setup.py file.

Create a new virtualenv, then do pip install . in the project root directory.

For Javascript and CSS dependencies, you have to install yarn then launch yarn install.

Development

  • Install the extras dependencies, e.g. pip install -e ."[dev]".
  • Launch test with pytest.

Logo

Logo was designed by Sylvain. Thanks to him!