# sahilgit04/poll-results-visualizer architecture

> Architecture diagram of the GitHub repository sahilgit04/poll-results-visualizer, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sahilgit04/poll-results-visualizer
- Repository: https://github.com/sahilgit04/poll-results-visualizer

## Overview

Poll Results Visualizer is a Streamlit app for exploring cleaned survey data. Users load the bundled CSV, filter by region and age group, inspect summary metrics and visual analyses, and download the filtered rows. A separate command-line entry point prints vote, region, and age summaries. The README also advertises demographic, trend, and insight capabilities; the excerpts show their implementation in the app and analysis module. Edges reflect visible calls; the CSV is identified as the app’s input.

Main entry points: [`app.py`](https://github.com/sahilgit04/poll-results-visualizer/blob/main/app.py) (Streamlit dashboard), [`main.py`](https://github.com/sahilgit04/poll-results-visualizer/blob/main/main.py) (CLI entry point), [`src/analysis.py`](https://github.com/sahilgit04/poll-results-visualizer/blob/main/src/analysis.py) (Data loading), [`data/poll_data.csv`](https://github.com/sahilgit04/poll-results-visualizer/blob/main/data/poll_data.csv) (Poll dataset)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Dashboard"]
  node_dashboard["Streamlit dashboard<br/>[app.py]"]
  node_filters["Region and age filters<br/>[app.py]"]
  node_metrics["Response metrics<br/>[app.py]"]
  node_vote_charts["Vote charts<br/>[app.py]"]
  node_trend_chart["Trend chart<br/>[app.py]"]
  node_region_chart["Region heatmap<br/>[app.py]"]
  node_insights["Top-choice insight<br/>[app.py]"]
  node_download["Filtered CSV download<br/>[app.py]"]
end

subgraph group_analysis["Poll Analysis"]
  node_poll_csv["Poll dataset<br/>[poll_data.csv]"]
  node_loader["Data loading<br/>[analysis.py]"]
  node_cleaner["Data cleaning<br/>[analysis.py]"]
  node_vote["Vote percentages<br/>[analysis.py]"]
  node_trend["Trend analysis<br/>[analysis.py]"]
  node_region["Region analysis<br/>[analysis.py]"]
  node_age["Age analysis<br/>[analysis.py]"]
end

subgraph group_cli["Command Line"]
  node_cli["CLI entry point<br/>[main.py]"]
end

node_user(("Dashboard user"))

node_user -->|"uses"| node_dashboard
node_dashboard -->|"loads data"| node_loader
node_dashboard -->|"selects input"| node_poll_csv
node_dashboard -->|"cleans data"| node_cleaner
node_dashboard -->|"filters rows"| node_filters
node_dashboard -->|"shows metrics"| node_metrics
node_dashboard -->|"calculates shares"| node_vote
node_dashboard -->|"renders shares"| node_vote_charts
node_dashboard -->|"calculates trend"| node_trend
node_dashboard -->|"renders trend"| node_trend_chart
node_dashboard -->|"counts by region"| node_region
node_dashboard -->|"renders heatmap"| node_region_chart
node_dashboard -->|"shows top choice"| node_insights
node_dashboard -->|"offers export"| node_download
node_cli -->|"loads data"| node_loader
node_cli -->|"cleans data"| node_cleaner
node_cli -->|"prints shares"| node_vote
node_cli -->|"prints regions"| node_region
node_cli -->|"prints age groups"| node_age

click node_dashboard "https://github.com/sahilgit04/poll-results-visualizer/blob/main/app.py"
click node_poll_csv "https://github.com/sahilgit04/poll-results-visualizer/blob/main/data/poll_data.csv"
click node_loader "https://github.com/sahilgit04/poll-results-visualizer/blob/main/src/analysis.py"
click node_cleaner "https://github.com/sahilgit04/poll-results-visualizer/blob/main/src/analysis.py"
click node_filters "https://github.com/sahilgit04/poll-results-visualizer/blob/main/app.py"
click node_metrics "https://github.com/sahilgit04/poll-results-visualizer/blob/main/app.py"
click node_vote "https://github.com/sahilgit04/poll-results-visualizer/blob/main/src/analysis.py"
click node_vote_charts "https://github.com/sahilgit04/poll-results-visualizer/blob/main/app.py"
click node_trend "https://github.com/sahilgit04/poll-results-visualizer/blob/main/src/analysis.py"
click node_trend_chart "https://github.com/sahilgit04/poll-results-visualizer/blob/main/app.py"
click node_region "https://github.com/sahilgit04/poll-results-visualizer/blob/main/src/analysis.py"
click node_region_chart "https://github.com/sahilgit04/poll-results-visualizer/blob/main/app.py"
click node_insights "https://github.com/sahilgit04/poll-results-visualizer/blob/main/app.py"
click node_download "https://github.com/sahilgit04/poll-results-visualizer/blob/main/app.py"
click node_cli "https://github.com/sahilgit04/poll-results-visualizer/blob/main/main.py"
click node_age "https://github.com/sahilgit04/poll-results-visualizer/blob/main/src/analysis.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_dashboard,node_filters,node_metrics,node_vote_charts,node_trend_chart,node_region_chart,node_insights,node_download,node_user toneBlue
class node_poll_csv,node_loader,node_cleaner,node_vote,node_trend,node_region,node_age toneAmber
class node_cli toneMint
```

## Components

### Dashboard

- [Streamlit dashboard](https://github.com/sahilgit04/poll-results-visualizer/blob/main/app.py): `app.py`
- [Region and age filters](https://github.com/sahilgit04/poll-results-visualizer/blob/main/app.py): `app.py`
- [Response metrics](https://github.com/sahilgit04/poll-results-visualizer/blob/main/app.py): `app.py`
- [Vote charts](https://github.com/sahilgit04/poll-results-visualizer/blob/main/app.py): `app.py`
- [Trend chart](https://github.com/sahilgit04/poll-results-visualizer/blob/main/app.py): `app.py`
- [Region heatmap](https://github.com/sahilgit04/poll-results-visualizer/blob/main/app.py): `app.py`
- [Top-choice insight](https://github.com/sahilgit04/poll-results-visualizer/blob/main/app.py): `app.py`
- [Filtered CSV download](https://github.com/sahilgit04/poll-results-visualizer/blob/main/app.py): `app.py`

### Poll Analysis

- [Poll dataset](https://github.com/sahilgit04/poll-results-visualizer/blob/main/data/poll_data.csv): `data/poll_data.csv`
- [Data loading](https://github.com/sahilgit04/poll-results-visualizer/blob/main/src/analysis.py): `src/analysis.py`
- [Data cleaning](https://github.com/sahilgit04/poll-results-visualizer/blob/main/src/analysis.py): `src/analysis.py`
- [Vote percentages](https://github.com/sahilgit04/poll-results-visualizer/blob/main/src/analysis.py): `src/analysis.py`
- [Trend analysis](https://github.com/sahilgit04/poll-results-visualizer/blob/main/src/analysis.py): `src/analysis.py`
- [Region analysis](https://github.com/sahilgit04/poll-results-visualizer/blob/main/src/analysis.py): `src/analysis.py`
- [Age analysis](https://github.com/sahilgit04/poll-results-visualizer/blob/main/src/analysis.py): `src/analysis.py`

### Command Line

- [CLI entry point](https://github.com/sahilgit04/poll-results-visualizer/blob/main/main.py): `main.py`

### Other components

- **Dashboard user**

## Connections

- Dashboard user → Streamlit dashboard: uses (evidence: `README.md`)
- Streamlit dashboard → Data loading: loads data (evidence: `app.py`)
- Streamlit dashboard → Poll dataset: selects input (evidence: `app.py`)
- Streamlit dashboard → Data cleaning: cleans data (evidence: `app.py`)
- Streamlit dashboard → Region and age filters: filters rows (evidence: `app.py`)
- Streamlit dashboard → Response metrics: shows metrics (evidence: `app.py`)
- Streamlit dashboard → Vote percentages: calculates shares (evidence: `app.py`)
- Streamlit dashboard → Vote charts: renders shares (evidence: `app.py`)
- Streamlit dashboard → Trend analysis: calculates trend (evidence: `app.py`)
- Streamlit dashboard → Trend chart: renders trend (evidence: `app.py`)
- Streamlit dashboard → Region analysis: counts by region (evidence: `app.py`)
- Streamlit dashboard → Region heatmap: renders heatmap (evidence: `app.py`)
- Streamlit dashboard → Top-choice insight: shows top choice (evidence: `app.py`)
- Streamlit dashboard → Filtered CSV download: offers export (evidence: `app.py`)
- CLI entry point → Data loading: loads data (evidence: `main.py`)
- CLI entry point → Data cleaning: cleans data (evidence: `main.py`)
- CLI entry point → Vote percentages: prints shares (evidence: `main.py`)
- CLI entry point → Region analysis: prints regions (evidence: `main.py`)
- CLI entry point → Age analysis: prints age groups (evidence: `main.py`)
