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

@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)

---

Made with 💛 by [Varna Sri Raman](https://on-web.link/varna) · [GitHub](https://github.com/Varnasr) · [Threads](https://www.threads.net/@varnasriraman)