How c-wilkinson/stravadataanalysis works
StravaDataAnalysis fetches Strava activities and run splits, persists them locally, then produces static charts and datasets for a Streamlit analytics dashboard. The principal workflow is token-backed retrieval, transformation and storage, followed by analysis and visualization; the dashboard loads generated Parquet data and presents filtered overview, distance, pace, effort, activity, and ML views. The graph groups these stages plus authentication/persistence and ML recommendations. Several dashboard routes and chart capabilities are documented or indexed but unsampled, so links without direct evidence are omitted.
Main entry points: main.py Pipeline runner · app.py Streamlit application · analytics.py Analytics preparation · page_utils.py Page rendering helpers
Components 33
Strava ingestion
- Pipeline runner
src/main.py - Token management
src/strava_data/auth.py - Strava API client
src/strava_data/strava_api/client.py - Activity transforms
src/strava_data/strava_api/processing/transform.py
Local data
- Encrypted SQLite DAO
src/strava_data/db/dao.py - Data models
src/strava_data/db/models.py - Dashboard export
src/strava_data/db/parquet.py
Analysis and charts
- Analytics preparation
src/strava_data/strava_api/processing/analytics.py - Distance charts
src/strava_data/strava_api/visualisation/graphs_distance.py - Distribution charts
src/strava_data/strava_api/visualisation/graphs_distribution.py - Effort charts
src/strava_data/strava_api/visualisation/graphs_effort.py - Pace charts
src/strava_data/strava_api/visualisation/graphs_pace.py - Summary cards
src/strava_data/strava_api/visualisation/summary_cards.py - Chart utilities
src/strava_data/strava_api/visualisation/utils.py - Interactive chart helpers
src/strava_data/strava_api/visualisation/interactive_utils.py
Interactive dashboard
- Streamlit application
src/dashboard/app.py - Parquet data loader
src/dashboard/data_loader.py - Dashboard filters
src/dashboard/filters.py - Overview page
src/dashboard/pages/overview.py - Activities page
src/dashboard/pages/activities.py - Distance page
src/dashboard/pages/distance.py - Pace page
src/dashboard/pages/pace.py - Effort page
src/dashboard/pages/effort.py - Machine learning page
src/dashboard/pages/machine_learning.py - Page rendering helpers
src/dashboard/page_utils.py
Training insights
- Pace forecasting
src/strava_data/ml/pace_forecast.py - Run classifier
src/strava_data/ml/run_type_classifier.py - Training advisor
src/strava_data/ml/training_advisor.py - ML charts
src/strava_data/strava_api/visualisation/graphs_ml.py
Other components
- Athlete
- Strava service
- Generated Parquet files
- Dashboard viewer
Connections 48
- Athlete → Token management: authorizes
README.md - Pipeline runner → Token management: loads tokens
src/main.py - Pipeline runner → Strava API client: fetches activities
src/main.py - Strava API client → Strava service: requests data
src/strava_data/strava_api/client.py - Strava API client → Encrypted SQLite DAO: checks latest date
src/strava_data/strava_api/client.py - Pipeline runner → Activity transforms: transforms records
src/main.py - Strava API client → Activity transforms: transforms API payload
src/strava_data/strava_api/client.py - Pipeline runner → Encrypted SQLite DAO: stores records
src/main.py - Pipeline runner → Dashboard export: exports dashboard data
src/main.py - Dashboard export → Analytics preparation: prepares exported data
src/strava_data/db/parquet.py - Dashboard export → Generated Parquet files: writes files
- Streamlit application → Parquet data loader: loads datasets
src/dashboard/app.py - Parquet data loader → Generated Parquet files: reads files
src/dashboard/data_loader.py - Streamlit application → Dashboard filters: filters datasets
src/dashboard/app.py - Streamlit application → Overview page: routes to
src/dashboard/app.py - Streamlit application → Activities page: routes to
src/dashboard/app.py - Streamlit application → Distance page: routes to
src/dashboard/app.py - Streamlit application → Pace page: routes to
src/dashboard/app.py - Streamlit application → Effort page: routes to
src/dashboard/app.py - Streamlit application → Machine learning page: routes to
src/dashboard/app.py - Dashboard viewer → Streamlit application: views
src/dashboard/app.py - Overview page → Page rendering helpers: renders figures
src/dashboard/pages/overview.py - Distance page → Page rendering helpers: renders figures
src/dashboard/pages/distance.py - Pace page → Page rendering helpers: renders figures
src/dashboard/pages/pace.py - Effort page → Page rendering helpers: renders figures
src/dashboard/pages/effort.py - Machine learning page → Page rendering helpers: renders figures
src/dashboard/pages/machine_learning.py - Distance page → Distance charts: builds charts
src/dashboard/pages/distance.py - Distance page → Distribution charts: builds charts
src/dashboard/pages/distance.py - Pace page → Pace charts: builds charts
src/dashboard/pages/pace.py - Pace page → Distance charts: builds charts
src/dashboard/pages/pace.py - Effort page → Effort charts: builds charts
src/dashboard/pages/effort.py - Effort page → Distribution charts: builds charts
src/dashboard/pages/effort.py - Overview page → Analytics preparation: uses summaries
src/dashboard/pages/overview.py - Activities page → Analytics preparation: uses analytics
src/dashboard/pages/activities.py - Distance charts → Analytics preparation: prepares data
src/strava_data/strava_api/visualisation/graphs_distance.py - Distribution charts → Analytics preparation: prepares data
src/strava_data/strava_api/visualisation/graphs_distribution.py - Effort charts → Analytics preparation: prepares data
src/strava_data/strava_api/visualisation/graphs_effort.py - Pace charts → Analytics preparation: prepares data
src/strava_data/strava_api/visualisation/graphs_pace.py - Pipeline runner → Summary cards: generates cards
src/main.py - Pipeline runner → Pace forecasting: runs forecast
src/main.py - Pipeline runner → Run classifier: runs clustering
src/main.py - Pipeline runner → Training advisor: generates plan
src/main.py - Machine learning page → ML charts: builds charts
src/dashboard/pages/machine_learning.py - Run classifier → Training advisor: classifies runs
src/strava_data/ml/training_advisor.py - ML charts → Analytics preparation: uses data preparation
src/strava_data/strava_api/visualisation/graphs_ml.py - Distance charts → Interactive chart helpers: uses chart helpers
src/strava_data/strava_api/visualisation/graphs_distance.py - Distribution charts → Interactive chart helpers: uses chart helpers
src/strava_data/strava_api/visualisation/graphs_distribution.py - Pace charts → Interactive chart helpers: uses chart helpers
src/strava_data/strava_api/visualisation/graphs_pace.py