> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ihuus.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Data Sources & Methodology

> How iHuus aggregates, fuses, and synthesizes hundreds of authoritative datasets into simple, queryable neighborhood intelligence.

The iHuus Neighborhood Intelligence API is built on a massive, continuously updated data
pipeline. We aggregate, clean, and fuse hundreds of authoritative datasets — from federal
hazard layers to raw satellite imagery — into simple, queryable API endpoints and semantic
**0–255 indices**.

<CardGroup cols={3}>
  <Card title="Schools & Ratings" icon="school" href="#schools--ratings">
    NCES, TEA, CDE and state-level district data
  </Card>

  <Card title="Vibe" icon="eye" href="#vibe">
    Spatial imagery, road networks, and POI density
  </Card>

  <Card title="Environment" icon="leaf" href="#environment">
    OpenAQ, DOT noise models, EPA hazard layers
  </Card>

  <Card title="Demographics" icon="users" href="#demographics">
    US Census Bureau and American Community Survey
  </Card>

  <Card title="Risk" icon="triangle-exclamation" href="#risk">
    FEMA NFHL flood zones and CALFIRE fire hazard tiers
  </Card>

  <Card title="Tools" icon="location-dot" href="#tools-geocoding">
    Mapbox-powered geocoding for agentic workflows
  </Card>
</CardGroup>

***

## Schools & Ratings

We provide comprehensive, location-based school data, district boundaries, and performance
metrics by harmonizing federal and state-level datasets.

<CardGroup cols={3}>
  <Card title="NCES Common Core of Data" icon="landmark">
    Core administrative, enrollment, and demographic data for every public K-12 school in
    the United States.
  </Card>

  <Card title="State Education Agencies" icon="building-columns">
    State-specific performance metrics and district boundaries from sources including the
    Texas Education Agency (TEA), California Department of Education (CDE), and Florida
    Department of Education (FLDOE).
  </Card>

  <Card title="Historical & Enhanced Context" icon="clock-rotate-left">
    We maintain current and historical data releases, further enriched from public school
    websites and local aggregators for completeness.
  </Card>
</CardGroup>

<Tip>
  Both school and district records return ratings on a **1–10 scale**. District results
  also include a `rating_summary` (a plain-language description of the district's
  performance) and a `rating_year` (the vintage of the rating), so you always know
  exactly where a rating came from and how current it is.
</Tip>

***

## Vibe

"Vibe" is fundamentally difficult to quantify. We solve this by fusing multiple geospatial
and physical-world datasets to evaluate the lived experience of a neighborhood across six
dimensions: **Privacy, Walkability, Visual Appeal, Dog Friendliness, Urban-Rural
Character,** and **Liveliness**.

<CardGroup cols={2}>
  <Card title="Spatial Imagery & Road Networks" icon="satellite">
    High-resolution overhead imagery and road network topologies reveal physical
    neighborhood structure: tree canopy coverage, lot sizes, pavement density, and
    sidewalk continuity.
  </Card>

  <Card title="Points of Interest (POIs)" icon="map-pin">
    We analyze the density and category mix of local businesses and amenities — parks,
    cafes, pet stores, transit stops — to map lifestyle accessibility and neighborhood
    character.
  </Card>
</CardGroup>

<Note>
  Visual Appeal, Privacy, Dog Friendliness and Liveliness are <strong>Pro AI</strong> dimensions
  computed via algorithmic synthesis of imagery and POI data. Scores represent
  probabilistic estimates, not guaranteed physical conditions.
</Note>

***

## Environment

Our environmental dimensions are calculated using a complex fusion of sensory data, hazard
reporting, and spatial intelligence.

| Dimension                | Primary Source                                               | What We Measure                                                |
| ------------------------ | ------------------------------------------------------------ | -------------------------------------------------------------- |
| **Air Quality**          | OpenAQ monitoring network                                    | Consistency and severity of AQI readings over time             |
| **Noise Levels**         | US Dept. of Transportation (DOT) + live flight path modeling | Road, railroad, and aviation noise in decibels                 |
| **Industrial Proximity** | EPA Superfund data, spatial imagery, commercial POIs         | Proximity to heavy industry, warehouses, and pollution sources |

<Tip>
  Noise scores include a **per-source breakdown** in the response description — road,
  railroad, and aviation dB levels — so engineers can surface exactly what's driving
  discomfort.
</Tip>

***

## Demographics

We leverage authoritative government data to provide block-group-level insights into the
people who make up a neighborhood.

<CardGroup cols={2}>
  <Card title="US Census Bureau & ACS" icon="flag-usa">
    Health Insurance Coverage and Population Age Profiles are derived strictly from the
    most recent Census Bureau releases and the American Community Survey (ACS).
  </Card>

  <Card title="Ideological Lean" icon="scale-balanced">
    We responsibly model political lean by synthesizing Census demographics with aggregated
    historical voting records and precinct-level data. Scores run from 1 (conservative) to
    255 (liberal), with 128 as an even split.
  </Card>
</CardGroup>

***

## Risk

We surface critical natural hazard data to help users understand the environmental
liabilities of a specific location.

<Note>
  Our risk model coverage is actively expanding. Flood risk covers CA, TX, and FL. Fire
  risk (CALFIRE) remains California only.
</Note>

<CardGroup cols={2}>
  <Card title="Flood Risk" icon="house-flood-water">
    Derived directly from the **FEMA National Flood Hazard Layer (NFHL)**, covering
    coastal high-hazard zones (V/VE), 100-year (A/AE), and 500-year (X/B) floodplains
    nationwide.
  </Card>

  <Card title="Fire Risk" icon="fire">
    Sourced from **CALFIRE** State Responsibility Area (SRA) hazard severity zone
    designations. Currently available for California locations only. Scores range from
    Severe (1) to no risk reported (255).
  </Card>
</CardGroup>

***

## Tools: Geocoding

<CardGroup cols={1}>
  <Card title="Single-Address Geocoder" icon="location-dot" href="/api-reference/tools/geocode-a-single-address">
    Our `/tools/geocode-single` endpoint is powered by the **Mapbox Geocoding API**. It
    takes a free-text address or place name and returns a single, definitive lat/lon pair.
    It is strictly designed for **LLM and agentic workflows**: agents geocode an address
    once, then pass coordinates to our intelligence endpoints.
  </Card>
</CardGroup>