Export Summary

Export summary and other patches

Author: Varnasr

equitystack_banner.png banner/EquityStack-banner.pngequitystack_banner.png renamed to banner/EquityStack-banner.png

@@ -0,0 +1,13 @@
+
+---
+## 🟢 Run-Ready Notebook
+
+This notebook is ready to run out-of-the-box. It uses data from the `/sample_data` folder and requires no additional configuration.
+
+Steps:
+1. Install requirements from `requirements.txt`
+2. Run each cell in order
+3. Outputs will be saved or displayed inline
+
+Make sure you're using a virtual environment or sandbox for reproducibility.
+---

docs/run_ready_header.md

@@ -0,0 +1,9 @@
+
+### 🗺 Spatial Tools
+
+EquityStack uses:
+- `geopandas` for reading, transforming, and joining shapefiles
+- `folium` for interactive mapping (especially useful for dashboards)
+- Sample `.geojson` and `.csv` overlays for public health or climate data
+
+These tools let you generate programmatic maps and embed them in reports or dashboards.

docs/spatial_tools_snippet.md

@@ -0,0 +1,16 @@
+
+# export_summary_to_excel.py
+
+import pandas as pd
+import xlsxwriter
+
+def export_summary_to_excel(df, filename="output.xlsx"):
+    writer = pd.ExcelWriter(filename, engine='xlsxwriter')
+    df.to_excel(writer, index=False, sheet_name='Summary')
+
+    workbook  = writer.book
+    worksheet = writer.sheets['Summary']
+    format1 = workbook.add_format({'num_format': '#,##0', 'bold': True})
+    worksheet.set_column('A:Z', 18, format1)
+
+    writer.close()

scripts/export_summary_to_excel.py

@@ -1,22 +1,35 @@
-# Use Cases
 
-This repository supports real-world applied research tasks across:
+# 📂 USE CASES: EquityStack
 
-## Public Health
-- Mapping service access across districts
-- NFHS-style weighted summaries
-- Health index creation from binary variables
+This document lists sample use cases where EquityStack components have been used, adapted, or are intended to support real-world workflows.
 
-## Education
-- Dropout/completion rate comparisons
-- Visualising educational outcomes by group
+---
 
-## Gender & WEE
-- Gender-disaggregated indicators
-- Time use patterns across activities
-- Summarised dashboards for MEL reports
+## 🏫 Education
+- Aggregating learning outcomes from surveys
+- Creating gender-disaggregated indicators for school completion
+- Exporting structured Excel reports for dashboards
 
-## MEL & Evaluation
-- Export summary tables for reporting
-- Calculate SROI from outcome-cost data
-- Survey diagnostics and profile summaries
+## 💉 Public Health
+- Building district-level access indices (health, WASH)
+- Mapping service reach using shapefiles and vulnerability overlays
+- Combining survey + administrative data in visual reports
+
+## ♀️ Gender & WEE
+- Constructing gender gap summaries using simulated time-use and income data
+- Preparing SROI outputs by gender group
+- Integrating outputs into mixed-method evaluations
+
+## 🌏 Climate & Resilience
+- Mapping spatial exposure using mock flood data + shapefiles
+- Creating baselines using existing secondary datasets
+- Preparing dashboard exports for climate program M&E
+
+## 📊 General MEL / Dashboards
+- Wide → long format reshaping for Looker Studio / Power BI
+- Exporting styled `.xlsx` summaries using `xlsxwriter`
+- Structuring testable workflows and integrating data validation
+
+---
+
+This list grows with each contribution or reuse. Want to add your use case? Open an issue or pull request.