British Shorthair

Codename British Shorthair is a project to experiment and understand more about Singapore's Public Transport, specifically the bus network, through urban data science.

This repository provides scripts for running CRON Jobs to obtain data from various open data sources on a server.

Some of the use cases of this project may include:

• Analysis and insights of bus routes, loading and trip times for planning
• Improved bus arrival timing estimations
• Optimisation of bus schedules, etc.
• Democratisation of open data - Insights allowing citizens to understand more about the city

Datasets included

• LTA DataMall Bus Arrival
• LTA DataMall Bus Stop
• LTA DataMall Bus Routes
• LTA DataMall Bus Service
• LTA DataMall Origin-Destination Bus Stops
• LTA DataMall Origin-Destination Train
• LTA DataMall Passenger Volume Train Stations
• LTA DataMall Passenger Volume Bus Stops

Future:

• NEA Weather Data

Planned Stages

• Data Collection
• Data Exploitation - Time-series Clustering, etc.
• Visualising Data
• Deriving Insights

Setting Up

1. Clone this repository
2. Run pip install -r requirements.txt in the root folder
3. Obtain the LTA Datamall API Key here
4. Create a .env file in the scripts folder and paste the following:

   API_KEYS = []
   

5. Insert the API Key(s) obtained from LTA Datamall into the list in the .env file with quotes

Running

There is one script available at the moment for Data Collection, to run:

python scripts/target_BSArrival.py