FASTR Survey Data Fetcher¶
A Shiny application for fetching, cleaning, and integrating health survey data from multiple international sources into the FASTR Analytics Platform.
Key Features¶
- Multi-Source Data Fetching: Connect to DHS, UNICEF (MICS/WUENIC), and UN World Population Prospects APIs
- Data Cleaning & Standardization: Automatically clean and standardize data for FASTR compatibility
- Manual Data Entry: Enter survey values manually with enforced standard indicator codes
- Data Review: Compare fetched data against existing database with visual overlays
- GitHub Integration: Pull the latest database, validate new data, and push updates directly to GitHub
- Collaborative Workflow: Multiple users can contribute to the unified survey database
Architecture¶
flowchart TD
subgraph sources[Data Sources]
DHS[DHS API]
UNICEF[UNICEF SDMX]
UNWPP[UNWPP API]
MANUAL[Manual Entry]
end
subgraph app[Survey Data Fetcher]
FETCH[Fetch Data]
CLEAN[Clean & Standardize]
REVIEW[Data Review]
VALIDATE[Validate Names]
DEDUP[Check Duplicates]
end
subgraph output[GitHub Repository]
SURVEY[survey_data_unified.csv]
POP[population_estimates_only.csv]
end
DHS --> FETCH
UNICEF --> FETCH
UNWPP --> FETCH
MANUAL --> CLEAN
FETCH --> CLEAN
CLEAN --> REVIEW
REVIEW --> VALIDATE
VALIDATE --> DEDUP
DEDUP --> SURVEY
DEDUP --> POP
Data Flow¶
- Fetch - Select data source, indicators, and countries (or use Manual Entry)
- Clean - Apply FASTR standardization to harmonize names and formats
- Review - Compare fetched data against existing database visually
- Validate - Check admin area names against existing database
- Deduplicate - Identify records that already exist, choose to keep or replace
- Push - Append new records to GitHub repository
Output Databases¶
| Database | Contents | Indicators |
|---|---|---|
survey_data_unified.csv |
Survey indicators | anc1, penta1, bcg, measles1, u5mr, etc. |
population_estimates_only.csv |
Population estimates | poptot, livebirth, womenrepage, etc. |
Quick Links¶
- Getting Started - Set up and run the app
- Data Sources - Available APIs and their indicators
- Database Integration - GitHub sync workflow
- Deployment - Deploy to Hugging Face Spaces