Skip to content

fehimaltinisik/deckist

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DeckIst

DeckIst is a hobby project that offers a visual depiction of daily bus traffic in Istanbul. Leveraging the GTFS dataset provided by The Istanbul Metropolitan Municipality, DeckIst employs Deck.gl by Uber to offer an enjoyable visual experience for users, allowing them to explore the city's bus traffic patterns through captivating visualizations. Inspired Uber's visualization of NYC Taxi Trip data.

Live Version

Explore the live version of DeckIst here.

Demo

Project Overview

DeckIst comprises two components:

Webservice

The backend of DeckIst is developed using FastAPI. This component is responsible for processing data and manipulate the bus traffic data. For more technical details, refer to the Webservice README.

Frontend

The frontend of DeckIst is built with React and utilizes Deck.gl to create captivating visualizations of the bus traffic data. Users can visualize their preferred bus lines at different times of the day, allowing for interactive exploration of bus traffic trends. For more technical details, refer to the Frontend README.

Approach

Project utilizes a straightforward approach to visualize bus traffic in Istanbul. The GTFS dataset includes trips, stops, and stop times, with stop times containing arrival data, stops containing geographical and trips containing stop sequence information. By leveraging combinations of these datasets, source code interpolates paths between stops with haversine method. However, it's worth noting that this approach may result in figures appearing off-road in cases where stop distances are too far apart (eg. 500T). Additionally, the GTFS dataset also includes shape data, which could provide a more reliable path compared to the interpolation approach used by DeckIst.

How to Use

To run DeckIst, simply follow these steps:

  1. Run the Webservice: Start the FastAPI-based backend to handle data processing and serve data endpoints.
  2. Launch the Frontend: Access the React-based frontend to visualize the bus traffic data using Deck.gl. The frontend provides a user-friendly interface for exploring the data interactively.

License

DeckIst is licensed under the MIT License, allowing for flexibility in use and distribution.

Data License

It's important to note that while the code for this repository is licensed under the MIT License, the GTFS dataset used in the project is subject to its own licensing terms. Users should refer to the specifics licensing information provided by The Istanbul Metropolitan Municipality for the dataset.