Skip to content

andenick/westchester

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

6 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Westchester County Data Platform

Comprehensive Government Data Analysis & Visualization System

A production-grade data platform providing comprehensive analysis of Westchester County, New York through integrated open data sources, interactive mapping, and professional-grade dashboards for government officials, planners, and researchers.


🎯 Overview

The Westchester County Data Platform is a multi-component application featuring:

  • Government data dashboards - Property tax, county budget, municipal services
  • Interactive mapping - Multi-layer geographic visualization with click-to-inspect
  • Transit accessibility analysis - Metro-North station coverage and walkability
  • Demographic insights - Population, income, housing trends
  • Data analysis tools - Jupyter notebooks for exploratory analysis
  • Public web access - Professional UI suitable for government use

πŸš€ Quick Start

One-Click Startup (Coming Soon)

# Double-click START_LOCAL.bat or run:
./START_LOCAL.bat

Manual Start

# Backend API
cd Technical/src/api
python main.py

# Frontend Application
cd Technical/src/frontend
npm run dev

Open http://localhost:3000 in your browser.


πŸ“Š Data Categories

Government & Finance

  • Property tax assessments and trends
  • County budget data (multi-year analysis)
  • Municipal services coverage
  • Building permits and violations
  • Zoning and land use

Transit & Transportation

  • Metro-North stations (Harlem, Hudson, New Haven lines)
  • Transit accessibility analysis
  • Station coverage and walkability scores
  • GTFS schedule data

Demographics & Census

  • Population trends by municipality
  • Income and housing statistics
  • Census tract data
  • American Community Survey (ACS) data

Geographic Data

  • County and municipality boundaries
  • Census tracts and block groups
  • Parks and recreation areas
  • Major roads and highways

πŸ—οΈ Project Structure

Westchester/
β”œβ”€β”€ README.md (this file)
β”œβ”€β”€ HANDOFF_DOCUMENTATION.md     # Current status and handoff info
β”œβ”€β”€ PROJECT_INDEX.md             # Complete file inventory
β”œβ”€β”€ Output/                      # User-facing deliverables
β”‚   β”œβ”€β”€ Data/
β”‚   β”‚   β”œβ”€β”€ Results/            # Excel files (one sheet each)
β”‚   β”‚   β”œβ”€β”€ Source/             # Original data documentation
β”‚   β”‚   └── Robin/              # Robin database integration
β”‚   β”œβ”€β”€ PDFs/                   # LaTeX reports
β”‚   β”œβ”€β”€ Charts/                 # Visualizations
β”‚   └── Documentation/          # Analysis documentation
└── Technical/                   # Implementation
    β”œβ”€β”€ src/
    β”‚   β”œβ”€β”€ api/                # FastAPI backend
    β”‚   β”œβ”€β”€ frontend/           # React + TypeScript web app
    β”‚   β”œβ”€β”€ analysis/           # Python analysis scripts
    β”‚   β”œβ”€β”€ data_importers/     # API clients for data sources
    β”‚   └── processors/         # Data cleaning/transformation
    β”œβ”€β”€ data/
    β”‚   β”œβ”€β”€ raw/                # Original downloaded data
    β”‚   β”œβ”€β”€ processed/          # Cleaned data
    β”‚   └── cache/              # Temporary/cached data
    β”œβ”€β”€ notebooks/              # Jupyter notebooks
    β”œβ”€β”€ configs/                # Configuration files
    β”œβ”€β”€ scripts/                # Utility scripts
    β”œβ”€β”€ docs/                   # Technical documentation
    └── tests/                  # Test files

🎨 Key Features

Interactive Dashboards

  • Overview Dashboard: High-level county metrics and trends
  • Property Tax Dashboard: Assessment data, rates, geographic analysis
  • Budget Dashboard: County spending by department and year
  • Transit Dashboard: Metro-North accessibility with 1-mile radius analysis
  • Demographics Dashboard: Population, income, housing statistics
  • Municipal Services Dashboard: Police, fire, public works coverage
  • Geographic Explorer: Multi-layer interactive map
  • Municipality Comparison: Side-by-side town/city comparisons

Advanced Mapping

  • Multiple data layers (boundaries, stations, properties, census)
  • Click-to-inspect feature details
  • Buffer/radius analysis tools
  • Heat maps for density visualization
  • Choropleth maps for demographic data

Data Analysis

  • Jupyter notebooks for exploratory analysis
  • Tax assessment trend analysis
  • Budget efficiency comparisons
  • Transit accessibility scoring
  • Demographic change tracking

πŸ’Ύ Data Sources

Primary Sources

  • Westchester County Open Data Portal - Government data, permits, services
  • NY State Open Data - Westchester-specific records and statistics
  • Metro-North Railroad - GTFS schedule and station data
  • U.S. Census Bureau - ACS demographic data for Westchester
  • Westchester County GIS - Geographic boundaries and mapping data

Data Quality

All data sources are documented in Output/Data/Source/README.md with:

  • Source URLs and access methods
  • Download timestamps
  • Data quality assessments
  • Processing notes

πŸ“ˆ Deliverables

Analytical Outputs

  • 15+ Excel datasets - Druck-compliant (one sheet per file, machine-readable)
  • 4+ LaTeX reports - Methodology, analysis findings, executive summaries
  • Interactive visualizations - Charts, maps, and dashboards
  • Complete documentation - Technical guides and user manuals

Reports (in Output/PDFs/)

  1. Methodology Report - Data sources, processing, analysis methods
  2. Tax Assessment Analysis - Trends, patterns, recommendations
  3. Budget Analysis - Spending patterns, efficiency metrics
  4. Transit Accessibility Report - Metro-North coverage analysis
  5. Executive Summary - High-level findings for stakeholders
  6. User Guide - Platform usage instructions

πŸ› οΈ Technology Stack

  • Backend: Python 3.11+, FastAPI, pandas, geopandas
  • Frontend: React 18, TypeScript, Vite, Tailwind CSS
  • Mapping: Mapbox GL JS / Leaflet
  • Data Analysis: Jupyter Lab, matplotlib, seaborn
  • Database: PostgreSQL + PostGIS (optional, starts with JSON/CSV)
  • Deployment: Docker, local-first architecture

πŸ“š Documentation

  • HANDOFF_DOCUMENTATION.md: Current project status and completion metrics
  • PROJECT_INDEX.md: Detailed file inventory and navigation
  • Technical/README.md: Technical architecture and setup (to be created)
  • Output/Documentation/: Analysis methodology and findings

βœ… Compliance

This project follows:

  • Druck Standards: Two-folder structure, data authenticity, documentation
  • Excel Requirements: One sheet per file, machine-readable columns
  • LaTeX Requirements: All final reports in LaTeX, PDFs in Output/PDFs/
  • File Naming: [YYYY.MM.DD] prefix for dated files
  • Production Quality: Professional UI/UX suitable for government officials

🎯 Target Audience

  • Westchester County Government: Planners, officials, analysts
  • Municipal Governments: Town and city administrators
  • Researchers: Academic and policy researchers
  • Public: Residents interested in county data and trends
  • Media: Journalists covering Westchester County

πŸ“Š Project Status

Current Phase: Foundation Complete - Ready for Data Collection & Dashboard Expansion
Overall Progress: 40% Complete
Foundation Phase: βœ… 100% Complete

  • βœ… Complete Druck-standard project structure
  • βœ… Comprehensive documentation (12 files)
  • βœ… FastAPI backend with 8 operational endpoints
  • βœ… React + TypeScript frontend with professional UI
  • βœ… Interactive mapping with Metro-North integration
  • βœ… Data import system ready (3 importers built)
  • βœ… Druck-compliant Excel generator operational
  • βœ… One-click startup system (START_LOCAL.bat)
  • πŸ“‹ Additional dashboards (6 more planned)
  • πŸ“‹ Data collection execution (import scripts ready)
  • πŸ“‹ LaTeX reports (system designed)

πŸ“‹ For Complete Status: See [2025.10.12] COMPLETE_PROJECT_HANDOFF_DOCUMENTATION.md


🀝 Contributing

This is part of the Arcanum Projects ecosystem and follows workspace-wide standards documented in Council/Druck/.

For questions or contributions:

  1. Review Druck documentation: ../../Council/Druck/README.md
  2. Check project index: PROJECT_INDEX.md
  3. Read handoff documentation: HANDOFF_DOCUMENTATION.md

Created: October 2025
Version: 1.0 (In Development)
Part of: Arcanum Projects - Council-supported research infrastructure
Follows: Druck organizational standards


Professional-grade data platform for Westchester County government, planning, and research applications.

About

Westchester Open Data Website

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors