Welcome to EquityStack 📊

Hey there! I’m Varna Sri Raman, and I’m thrilled you’re exploring EquityStack. 🎉 This toolkit is my passion project—a modular, field-aware collection of Python scripts, notebooks, and pipelines built to make data work smooth and insightful, especially in public health, gender, climate, education, and evaluation.

🗺️ Folder Map

EquityStack/ ├── notebooks/ # Jupyter notebooks with step-by-step examples ├── social_sector/ # Domain-specific helpers for social development ├── cleaning/ # Wrangling, tidying, and validation functions ├── visualisation/ # Custom plots and interactive maps ├── modelling/ # Statistical and predictive model templates ├── io_helpers/ # File I/O utilities (CSV, Excel, GIS) ├── validation/ # Schema checks and data quality tests ├── tests/ # pytest tests for key modules ├── sample_data/ # Synthetic datasets to follow along ├── README.md # You are here! ├── ROADMAP.md # Detailed v1.x plans ├── LICENSE # MIT License ├── requirements.txt # Python dependencies ├── CONTRIBUTING.md # How to join the fun

📘 What’s Inside

• Easy‑to‑use scripts (.py) for cleaning, validating, and transforming your data
  
• Jupyter & Quarto notebooks showcasing real‑world examples — from exploratory analysis to modeling
  
• Spatial mapping tools powered by geopandas and folium to visualize health & access indices
  
• Survey & WEE analyses with clear, commented code you can adapt to your own projects
  
• Dashboard‑ready workflows that reshape data (wide ↔ long) and export clean CSVs
  
• Automated tests via pytest ensuring everything runs reliably every time

🧭 Roadmap Snapshot

✅ v1.0: Clean modular structure, core domain helpers, spatial & social‑sector tools, and automated tests
🚀 v1.1+: Interactive dashboards, NLP utilities, integration with real datasets, multi‑language support

For the full details on upcoming features, check out ROADMAP.md.

🤝 Get In Touch

I love feedback and contributions! Reach out anytime:

• ✉️ Email: varna[DOT]sr [AT] gmail [DOT] com
  
• 🌐 Website: varnasr.github.io
  
• 💼 LinkedIn: Varna Sri Raman

Or just open an issue or PR here on GitHub — I’m always happy to collaborate.

📑 Citation

If EquityStack helps your work, please cite:

Sri Raman, V. (2025). EquityStack: Reusable Tools for Applied Data Analysis and Evaluation. Zenodo. https://doi.org/10.5281/zenodo.15249477

BibTeX bibtex @software{sriraman_equitystack_2025, author = {Varna Sri Raman}, title = {EquityStack: Reusable Tools for Applied Data Analysis and Evaluation}, year = 2025, publisher = {Zenodo}, doi = {10.5281/zenodo.15249477}, url = {https://doi.org/10.5281/zenodo.15249477} }

📊 Repository Status & Metadata

<!-- --> CI workflow enabled (badge will display after first successful run)