Skip to content

Add tower research and node-hop analysis tools#27

Merged
vespo92 merged 2 commits into
mainfrom
claude/chicago-tower-research-8aRc9
Mar 19, 2026
Merged

Add tower research and node-hop analysis tools#27
vespo92 merged 2 commits into
mainfrom
claude/chicago-tower-research-8aRc9

Conversation

@vespo92

@vespo92 vespo92 commented Mar 19, 2026

Copy link
Copy Markdown
Owner

Summary

This PR introduces a comprehensive tower research and network planning system for the Chicago Forest Network expansion. It includes interactive tools for exploring FCC-registered tower data, analyzing optimal node-hop paths, and aggregating data from multiple public sources.

Key Changes

New Components

  • TowerDataExplorer (apps/web/components/tower-research/TowerDataExplorer.tsx): Interactive map visualization of 14 strategic tower locations across Illinois with filtering by phase and type. Displays distance calculations from the Mendota origin point using Haversine distance and bearing calculations.

  • NodeHopAnalyzer (apps/web/components/tower-research/NodeHopAnalyzer.tsx): Tool for finding optimal intermediate relay nodes between any two towers. Scores candidates based on line-of-sight viability, path efficiency, tower height, elevation advantage, and link balance.

  • FCCDataSources (apps/web/components/tower-research/FCCDataSources.tsx): Reference documentation for 6 major FCC and open data sources including FCC ASR, HIFLD, OpenCelliD, and AntennaSearch with field mappings and access information.

New Tower Data Package

  • packages/tower-data/: New TypeScript package for geographic calculations and FCC data handling
    • geo.ts: Comprehensive geographic utilities including Haversine distance, bearing calculations, line-of-sight analysis, Fresnel zone calculations, free-space path loss, rain attenuation, and link budget analysis
    • fcc-asr.ts: FCC Antenna Structure Registration data types and HIFLD ArcGIS REST API query builder
    • illinois-towers.ts: Strategic tower locations and expansion zones for the Chicago Forest Network

New Page

  • Tower Research Page (apps/web/app/tower-research/page.tsx): Landing page with hero section, key statistics, disclaimer about theoretical framework, and integration of all three research tools.

Implementation Details

  • All geographic calculations use WGS84/NAD 83 coordinate system and the Haversine formula for distance calculations
  • Line-of-sight analysis uses the 4/3 earth radius model standard for radio propagation
  • Node-hop scoring combines multiple factors: LOS viability (35%), path efficiency (25%), tower height (15%), elevation advantage (10%), and link balance (15%)
  • Interactive map uses SVG with simple Mercator-like projection for Illinois area
  • Data includes 14 strategic nodes spanning ~350 km across Illinois with population coverage of 4M+
  • All tower data sourced from public FCC databases and HIFLD open datasets

Minor Updates

  • Updated apps/web/app/layout.tsx to add navigation link to tower research page
  • Updated apps/web/tsconfig.json to use react-jsx instead of preserve for JSX handling

https://claude.ai/code/session_01D5h7YFafuHYh9cePsnmEpf

claude added 2 commits March 19, 2026 07:51
…hop analysis

New /tower-research page for strategic network expansion planning:
- Interactive tower explorer map with 14 strategic IL nodes (filter by phase/type)
- Node hop analyzer with multi-factor scoring (LOS, path efficiency, elevation, balance)
- FCC data sources reference (ASR, HIFLD, OpenCelliD, IL Broadband Office)
- ASR file schema documentation (CO.dat, RA.dat, EN.dat)
- Expansion corridor analysis (I-39, I-88, I-80, IL River, Chicago Metro, Central IL)

New @chicago-forest/tower-data package:
- Haversine distance, bearing, max LOS (4/3 Earth radius model)
- Fresnel zone, FSPL, rain attenuation (ITU-R P.838)
- Full link budget calculator
- HIFLD ArcGIS REST API query builder
- FCC ASR data types and parsing utilities
- Strategic tower and expansion zone data for Illinois

https://claude.ai/code/session_01D5h7YFafuHYh9cePsnmEpf
@vercel

vercel Bot commented Mar 19, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
chicago-forest-net Error Error Mar 19, 2026 1:11pm
chicago-forest-net-8jk5 Ready Ready Preview, Comment Mar 19, 2026 1:11pm

@vespo92 vespo92 merged commit bc40916 into main Mar 19, 2026
16 of 19 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants