add write up

app.py

@@ -303,7 +303,26 @@ def create_category_distribution_chart(df, selected_category, selected_year):
     return fig
 
 def main():
-    st.title('Traffic Crash Analysis')
+    st.title('Traffic Accident Dataset')
+
+    st.markdown("""
+     **Team Members:**
+    - Janhavi Tushar Zarapkar （[email protected]）
+    - Hangyue Zhang ([email protected])
+    - Andrew Nam ([email protected])
+    - Nirmal Attarde
+    - Maanas Sandeep Agrawa
+    """)
+    
+
+    st.markdown("""
+    ### Introduction to the Traffic Accident Dataset
+    This dataset contains detailed information about traffic accidents in the city of **Tempe**. It includes various attributes of the accidents, such as the severity of injuries, the demographics of the drivers involved, the locations of the incidents, and the conditions at the time of the accidents. The dataset covers accidents that occurred over several years, with data on factors like **weather conditions**, **road surface conditions**, the **time of day**, and the type of **violations** (e.g., alcohol or drug use) that may have contributed to the accident.
+    
+    The data was sourced from **Tempe City's traffic incident reports** and provides a comprehensive view of the factors influencing road safety and accident severity in the city. By analyzing this dataset, we can gain insights into the key contributors to traffic incidents and uncover trends that could help improve traffic safety measures, urban planning, and law enforcement policies in the city.
+    """)
+    
+    
     
     # Load data
     df = load_and_preprocess_data('1.08_Crash_Data_Report_(detail).csv')
@@ -361,6 +380,25 @@ def main():
                 key=f"map_{selected_year}",
                 returned_objects=["null_drawing"]
             )
+
+        st.markdown("""
+            ### Traffic Crash Location Map
+            This interactive map visualizes traffic accidents in Tempe for the selected year. It combines **marker clustering** and a **heatmap** to show:
+            1. **Accident Markers**: Red markers indicate individual accidents, with popups displaying the coordinates, date/time, and severity of each incident.
+            2. **Heatmap**: The heatmap highlights accident hotspots with colors ranging from blue (low frequency) to yellow (moderate) and red (high frequency), showing areas with more frequent accidents.
+            
+            **Key Features:**
+            * **Interactive Year Selection**: Users can select a year to view accidents for that specific time.
+            * **Accident Patterns**: The map reveals accident-prone areas and severity patterns, helping identify dangerous locations.
+            
+            **Color Scheme:**
+            * **Red**: Individual accident markers.
+            * **Blue to Red**: Heatmap colors indicate accident frequency, from low (blue) to high (red).
+            
+            This map provides insights into accident trends and can help guide safety improvements in the city.
+            """)
+
+        
     
     with tab3:
         # Weather condition filter
@@ -372,6 +410,27 @@ def main():
         trend_fig = create_crash_trend_chart(df, selected_weather)
         st.plotly_chart(trend_fig, use_container_width=True)
 
+        st.markdown("""
+        ## **Crash Trend Over Time**
+        This interactive line chart visualizes the trend of unique traffic crashes over the years, optionally filtered by weather conditions. It highlights how crash frequency changes over time, helping identify trends and potential contributing factors.
+
+        **Key Features:**
+        * **Time Trend Analysis**: Displays the total number of unique crashes for each year, showing long-term patterns.
+        * **Weather Filter**: Users can filter the data by weather conditions (e.g., "Rainy", "Sunny") to analyze how weather impacts crash trends.
+        * **Interactive Tooltips**: Hovering over data points reveals the exact crash count for each year, providing detailed insights.
+
+        **Color Scheme and Design:**
+        * **Line and Markers**: A smooth line connects data points, with prominent markers for each year to highlight trends clearly.
+        * **Dynamic Title**: The chart updates its title to reflect the selected weather condition or "All Conditions" for the overall trend.
+
+        **Insights:**
+        This chart helps uncover:
+           * Annual fluctuations in crash incidents.
+           * Correlations between weather conditions and crash frequencies.
+           * Historical patterns that can guide future safety measures and urban planning decisions
+        """)
+        
+
     with tab4:
         # Dropdown for Unit Type selection
         unit_type_pairs = set()
@@ -408,6 +467,18 @@ def main():
         distribution_chart = create_category_distribution_chart(df, selected_category, selected_year)
         st.plotly_chart(distribution_chart, use_container_width=True)
 
+        st.markdown("""
+        ## Distribution by Category
+        This visualization explores the distribution of traffic incidents across various categories, such as Collision Manner, Weather, Surface Condition, Alcohol Use, and Driver Gender. Each bar represents a specific category value (e.g., "Male" or "Female" for Gender), and the bars are divided into segments based on Injury Severity (e.g., Minor, Moderate, Serious, Fatal).
+
+        **Key features include:**
+        * Interactive Filters: Select a category and filter by year to analyze trends over time.
+        * Insightful Tooltips: Hover over each segment to view the exact count and percentage of incidents for a given severity level.
+        * Comparative Analysis: Quickly identify how different conditions or behaviors correlate with injury severity.
+
+        This chart provides actionable insights into factors contributing to traffic incidents and their outcomes, helping stakeholders target interventions and improve road safety.
+        """)
+
 
 if __name__ == "__main__":
     main()