Skip to content

Latest commit

Β 

History

86 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

NagpurLens Banner

πŸ™οΈ NagpurLens

Building the Digital Intelligence Layer for Nagpur

A research-driven Urban Intelligence Platform transforming fragmented city data into trusted, reproducible, and actionable intelligence.

Status Database Language License Version


Engineering First β€’ Data First β€’ Evidence First

"Nagpur's future deserves decisions backed by evidenceβ€”not assumptions."


πŸ“– Overview

NagpurLens is an open Urban Intelligence Platform that integrates fragmented urban datasets into a unified, validated, and reproducible analytical system.

Rather than building dashboards first, NagpurLens follows a research-first and data-first engineering philosophy, where every dataset, SQL query, analytical model, and insight is supported by documented evidence, transparent methodologies, and reproducible workflows.

The platform combines locality information, infrastructure, demographics, connectivity, accessibility, public services, and urban indicators to generate meaningful insights for citizens, planners, researchers, developers, and policymakers.

This repository documents the complete engineering lifecycleβ€”from defining the problem to delivering urban intelligence.


🎯 Problem Statement

Urban information is often:

  • Fragmented across multiple agencies
  • Difficult to validate
  • Poorly documented
  • Missing relationships
  • Challenging to analyze collectively
  • Difficult to reproduce

Most investment, planning, and development decisions are therefore made using assumptions instead of evidence.

NagpurLens exists to solve this problem by building a transparent, reproducible Urban Intelligence Platform.


❓ Three Fundamental Questions

Every component inside this repository ultimately contributes toward answering three questions.

πŸ—οΈ 1. Where does infrastructure lag?

Identify underserved localities using measurable infrastructure indicators.


πŸ“ˆ 2. Which localities demonstrate measurable urban growth?

Analyze infrastructure expansion, connectivity improvements, demographic changes, accessibility, and development patterns over time.


πŸ’° 3. Which localities demonstrate stronger long-term investment potential?

Generate transparent analytical indicators using documented methodologies and reproducible scoring models.

NagpurLens provides decision-support analytics, not financial advice.


πŸ›οΈ Project Vision

NagpurLens aims to become a trusted Urban Intelligence Platform for Nagpur by creating verified datasets, transparent methodologies, and reproducible analytical workflows.

The long-term vision extends beyond a single city.

The engineering architecture is intentionally designed so that additional cities can be integrated through standardized research methodologies, reusable database structures, and scalable analytical pipelines.


βš™οΈ Engineering Philosophy

Every published insight follows the same engineering lifecycle.

Problem Definition
        β”‚
        β–Ό
Research & Evidence Collection
        β”‚
        β–Ό
Raw Data Acquisition
        β”‚
        β–Ό
Validation & Quality Assurance
        β”‚
        β–Ό
Database Engineering
        β”‚
        β–Ό
Analytical Models
        β”‚
        β–Ό
Urban Intelligence
        β”‚
        β–Ό
Reports & Dashboards
        β”‚
        β–Ό
Decision Support

Dashboards are outputs.

Validated data is the product.


πŸ—‚ Repository Structure

NagpurLens/
β”œβ”€β”€ README.md
β”œβ”€β”€ LICENSE
β”‚
β”œβ”€β”€ 01_problem/
β”‚   β”œβ”€β”€ vision.md
β”‚   β”œβ”€β”€ problem_statement.md
β”‚   β”œβ”€β”€ three_questions.md
β”‚   β”œβ”€β”€ success_metrics.md
β”‚   └── user_personas.md
β”‚
β”œβ”€β”€ 02_research/
β”‚   β”œβ”€β”€ sources.md
β”‚   β”œβ”€β”€ research_log.md
β”‚   β”œβ”€β”€ assumptions.md
β”‚   β”œβ”€β”€ evidence/
β”‚   β”‚   β”œβ”€β”€ besa/
β”‚   β”‚   β”œβ”€β”€ hingna/
β”‚   β”‚   β”œβ”€β”€ dharampeth/
β”‚   β”‚   └── ...
β”‚   └── source_registry.csv
β”‚
β”œβ”€β”€ 03_data/
β”‚   β”œβ”€β”€ raw/
β”‚   β”œβ”€β”€ staging/
β”‚   β”œβ”€β”€ validated/
β”‚   β”œβ”€β”€ final/
β”‚   └── data_dictionary.md
β”‚
β”œβ”€β”€ 04_quality/
β”‚   β”œβ”€β”€ coordinate_validation.md
β”‚   β”œβ”€β”€ join_validation.md
β”‚   β”œβ”€β”€ duplicate_report.md
β”‚   β”œβ”€β”€ null_report.md
β”‚   └── quality_score.md
β”‚
β”œβ”€β”€ 05_database/
β”‚   β”œβ”€β”€ schema.sql
β”‚   β”œβ”€β”€ constraints.sql
β”‚   β”œβ”€β”€ seed_data.sql
β”‚   └── queries/
β”‚       β”œβ”€β”€ infra_gap.sql
β”‚       β”œβ”€β”€ growth_trend.sql
β”‚       └── investment_score.sql
β”‚
β”œβ”€β”€ 06_intelligence/
β”‚   β”œβ”€β”€ methodologies/
β”‚   β”œβ”€β”€ notebooks/
β”‚   β”œβ”€β”€ scoring_models/
β”‚   └── findings/
β”‚
β”œβ”€β”€ 07_dashboard/
β”‚   └── streamlit/
β”‚
β”œβ”€β”€ 08_reports/
β”‚   β”œβ”€β”€ executive_summary.md
β”‚   β”œβ”€β”€ findings_report.md
β”‚   └── presentations/
β”‚
└── PROJECT_STATUS.md

🧩 Repository Lifecycle

Every folder represents one stage of the engineering workflow.

Stage Purpose
01 Problem Define objectives, users, and measurable success
02 Research Collect evidence and document sources
03 Data Store raw, processed, validated, and production datasets
04 Quality Validate integrity, completeness, and reliability
05 Database Build the analytical PostgreSQL database
06 Intelligence Develop methodologies, models, notebooks, and findings
07 Dashboard Present insights through interactive applications
08 Reports Publish executive reports and analytical documents

πŸ“Š Core Urban Datasets

The initial platform focuses on building high-quality foundational datasets.

  • Locality Master Dataset
  • Infrastructure Dataset
  • Demographic Dataset
  • Geographic Reference Dataset
  • Connectivity Dataset
  • Accessibility Dataset
  • Urban Indicators Dataset

Every production dataset includes:

  • Source attribution
  • Collection methodology
  • Version history
  • Validation status
  • Geographic verification
  • Data dictionary
  • Quality score

πŸ›‘ Data Quality Principles

Data quality is treated as a first-class engineering objective.

Each production dataset is evaluated for:

  • Source traceability
  • Coordinate validation
  • Referential integrity
  • Duplicate detection
  • Missing value assessment
  • Schema validation
  • Join validation
  • Documentation completeness
  • Reproducibility

Datasets are promoted to production only after passing documented quality standards.


πŸ—„ Database Engineering

NagpurLens uses PostgreSQL as its analytical foundation.

The database layer focuses on:

  • Normalized schema design
  • Referential integrity
  • Constraints
  • Seed datasets
  • Analytical SQL
  • Business queries
  • Urban indicators

The database is designed for reproducibility rather than one-time analysis.


🧠 Urban Intelligence

Urban Intelligence transforms validated datasets into actionable insights.

Current analytical focus includes:

  • Infrastructure Gap Analysis
  • Urban Growth Indicators
  • Connectivity Analysis
  • Accessibility Assessment
  • Locality Benchmarking
  • Investment Potential Scoring

Every methodology is documented and reproducible.


πŸ’» Technology Stack

Database

  • PostgreSQL

Languages

  • SQL
  • Python

Data Processing

  • Pandas

Visualization

  • Streamlit
  • Tableau
  • Power BI (Planned)

Version Control

  • Git
  • GitHub

🚧 Current Development Status

Area Status
Problem Definition βœ… Complete
Research Framework 🚧 In Progress
Evidence Collection 🚧 In Progress
Data Pipeline 🚧 In Progress
Data Validation 🚧 In Progress
PostgreSQL Database 🚧 In Progress
Analytical SQL 🚧 In Progress
Intelligence Models 🚧 In Progress
Dashboard 🚧 Planned
Reports 🚧 Planned

πŸ›£ Roadmap

Phase I β€” Foundation

  • Define urban problems
  • Research framework
  • Source registry
  • Documentation
  • Master datasets

Phase II β€” Data Engineering

  • Data collection
  • Validation pipeline
  • PostgreSQL database
  • Quality framework
  • Documentation

Phase III β€” Urban Intelligence

  • Infrastructure analytics
  • Growth indicators
  • Scoring methodologies
  • Research notebooks
  • Findings

Phase IV β€” Platform

  • Interactive dashboards
  • Public API
  • Executive reports
  • Multi-city architecture
  • AI-assisted Urban Intelligence

🀝 Contributing

Contributions are welcome.

Before submitting a pull request, please ensure that your contribution:

  • Follows documented methodologies
  • Preserves reproducibility
  • Includes appropriate documentation
  • Maintains data quality standards
  • References verifiable sources where applicable

⭐ Guiding Principles

NagpurLens is built on five engineering principles.

  • Research before implementation
  • Evidence before conclusions
  • Quality before quantity
  • Reproducibility before convenience
  • Transparency before complexity

Building the Digital Intelligence Layer for Nagpur

One verified dataset. One reproducible methodology. One evidence-based insight at a time.

v

About

Research-driven Urban Intelligence Platform for Nagpur using PostgreSQL, SQL, Python, GIS, and Data Analytics to generate reproducible infrastructure, growth, and real estate insights.

Topics

Resources

Code of conduct

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors