ilyesdjerfaf commited on
Commit
452b65e
Β·
1 Parent(s): a73fc0d

update readme

Browse files
Files changed (1) hide show
  1. README.md +9 -147
README.md CHANGED
@@ -1,148 +1,10 @@
1
-
2
- # Taxi Data Visualization
3
-
4
- πŸš– **Taxi Data Visualization** is an interactive Streamlit application designed for exploring and analyzing taxi pickup and dropoff data, along with temporal and spatial trends of taxi rides in New York City. This tool provides powerful insights into differences between Green and Yellow taxis, as well as ride-hailing services (VTCs), by leveraging various advanced visualization techniques.
5
-
6
  ---
7
-
8
- ## πŸ“ Features
9
-
10
- 1. **Pickup and Dropoff Zones Analysis with Datashader**:
11
- - High-density pickup and dropoff zones are emphasized using pixel intensity on interactive maps. These maps are dynamic, allowing zooming, panning, and resetting to default views using the "home" icon.
12
- - **Why Datashader?**
13
- - Datashader efficiently visualizes millions or even billions of data points by aggregating data based on screen resolution. It ensures high performance using NumPy and Dask, making it ideal for large datasets without overloading graphical resources.
14
-
15
- ![Temporal Analysis](src/first.png)
16
-
17
- 2. **Global Taxi Map**:
18
- - A comprehensive map showcasing all pickup and dropoff data for both Green and Yellow taxis.
19
- - Highlights service areas for each type of taxi, allowing users to explore and interact with the map legends to filter specific data.
20
-
21
- ![Cmp ](src/second.png)
22
-
23
- 3. **Ride-Hailing (VTC) Pickup Zone Analysis**:
24
- - A vibrant visualization displaying activity levels across VTC zones.
25
- - Saturated colors represent high activity, while pale colors indicate lower activity.
26
- - Provides insights into VTC market share compared to traditional taxi services.
27
-
28
- ![Choropleth Maps](src/third.png)
29
-
30
- 4. **Taxi Activity Trends by Hour and Day**:
31
- - A line chart summarizing average pickups for each day of the week in 2015.
32
- - Reveals distinct patterns:
33
- - **Weekdays**: Activity peaks during commute hours (morning and evening).
34
- - **Weekends**: Spread throughout the day, with significant nighttime activity (except for Sunday night, which tapers off).
35
-
36
- ![Temporal Analysis](src/last.png)
37
-
38
- 5. **Image Layer Adjustment**:
39
- - Users can blend and adjust map layer opacity for a deeper exploration of spatial trends.
40
-
41
- ![Images](src/images.png)
42
-
43
- ---
44
-
45
- ## πŸ“‚ Project Structure
46
-
47
- ```bash
48
- β”œβ”€β”€ app.py # Main application script
49
- β”œβ”€β”€ data/ # Data folder containing CSV and GeoJSON files
50
- β”‚ β”œβ”€β”€ GreenDataResize.csv
51
- β”‚ β”œβ”€β”€ YellowDataResize.csv
52
- β”‚ β”œβ”€β”€ vtc_zone_freq.geojson
53
- β”‚ β”œβ”€β”€ YellowVTC_Zone_Freq.csv
54
- β”‚ β”œβ”€β”€ GreenVTC_Zone_Freq.csv
55
- β”‚ β”œβ”€β”€ grouped_by_minute.csv
56
- β”œβ”€β”€ images/ # Processed images folder
57
- β”‚ β”œβ”€β”€ final_image_dropoff_yellow.png
58
- β”‚ β”œβ”€β”€ final_image_pickup_yellow.png
59
- β”‚ β”œβ”€β”€ final_image_pickup_green.png
60
- β”œβ”€β”€ .gitignore # Ignored files for Git
61
- β”œβ”€β”€ README.md # Project README file
62
- β”œβ”€β”€ requirements.txt # Python dependencies
63
- ```
64
-
65
- ---
66
-
67
- ## πŸš€ Deployment
68
-
69
- This project is deployed on **Render**. You can access the live application using the following link:
70
- **[Taxi Data Visualization on Render](https://cabflownyc.onrender.com/)**
71
-
72
- ---
73
-
74
- ## 🌟 Local Installation
75
-
76
- 1. Clone this repository:
77
-
78
- ```bash
79
- git clone https://github.com/ilyesdjerfaf/CabFlowNYC.git
80
- cd CabFlowNYC
81
- ```
82
-
83
- 2. Install required Python dependencies:
84
-
85
- ```bash
86
- pip install -r requirements.txt
87
- ```
88
-
89
- 3. Run the application:
90
-
91
- ```bash
92
- streamlit run app.py
93
- ```
94
-
95
- ---
96
-
97
- ## πŸ“Š Data Sources
98
-
99
- - **Taxi Data**: Processed CSV files for Green and Yellow taxis, including pickup and dropoff details.
100
- - **Spatial Data**: GeoJSON file for taxi zones and their frequencies.
101
- - **Images**: High-resolution images illustrating NYC taxi trends.
102
-
103
- ---
104
-
105
- ## 🌟 Usage
106
-
107
- - **Interactive Datashader Maps**:
108
- - Analyze high-density pickup and dropoff zones interactively.
109
- - Zoom and filter dynamically for detailed exploration.
110
- - **Sidebar Tools**:
111
- - Blend and adjust map layers to visualize spatial overlaps and patterns.
112
- - **Temporal Trends**:
113
- - Explore activity trends by hour and weekday for insightful temporal analysis.
114
-
115
- ---
116
-
117
- ## πŸ›  Requirements
118
-
119
- - Python 3.8+
120
- - Streamlit
121
- - Plotly
122
- - Pandas
123
- - Datashader
124
- - PIL (Pillow)
125
- - colorcet
126
-
127
- ---
128
-
129
- ## πŸ“œ License
130
-
131
- This project is not licensed yet.
132
-
133
- ---
134
-
135
- ## πŸ— Future Enhancements
136
-
137
- - Real-time data integration for live updates.
138
- - Extend the application to analyze taxi trends in other cities.
139
- - Introduce advanced time-series models for better temporal forecasting.
140
-
141
- ---
142
-
143
- ## πŸ“¬ Contact
144
-
145
- For any inquiries or suggestions, please contact:
146
-
147
- - **Ilyes DJERFAF**: [ilyes.djerfaf@etu-upsaclay.fr]
148
- - **Armand BIDAULD**: [armand.bidauld@etu-upsaclay.fr]
 
 
 
 
 
 
1
  ---
2
+ title: Cab Flow NYC
3
+ emoji: πŸš–
4
+ colorFrom: yellow
5
+ colorTo: green
6
+ sdk: streamlit
7
+ sdk_version: "1.40.1"
8
+ app_file: app.py
9
+ pinned: false
10
+ ---