Skip to main content

urban-heat-island-utac

GenesisAeon Package 132 - real surface urban heat island (MODIS LST), park cooling, impervious-surface vs LST relationship structure, and city-scale green-roof ambient air-temperature mitigation. Deliberately has no UTAC/CREP/AFET bridge - see DISCLAIMER.md.

For a plain-language explanation of the same topic (German, no jargon, written for general audiences), see WHITEPAPER.md.

Separate from P108

This is not an extension of urban-green-infrastructure-utac (P108). P108 is hydrology only (sealing vs recharge; green-roof rainfall retention). P132 is temperature (evaporative cooling / albedo / radiation balance) - same precedence as the P107/P108 split itself.

What's real here

  • Peng et al. (2012, Environmental Science & Technology) - annual-mean surface UHI across 419 cities (MODIS LST): day 1.5 ± 1.2 °C, night 1.1 ± 0.5 °C. Day and night are uncorrelated. This is surface temperature, not air temperature.
  • Bowler et al. (2010, Landscape and Urban Planning) - systematic review: parks are on average 0.94 °C cooler (daytime) than surrounding built area.
  • Yang, Huang, Yang, Liu (2021, Environmental Research Letters) - LST vs artificial impervious surface fraction across 682 cities. Cited as core structure; the regression coefficient is intentionally unset until pinned from the primary text (the build prompt does not list the slope number - inventing it is forbidden).
  • Santamouris (2014, Solar Energy) - green roofs at city scale: 0.3-3.0 K reduction of mean ambient air temperature (not LST, not indoor).

Explicitly not used

  • De Cristo et al. (2025) - documented-tier note only; no numeric constants from it.
  • Unverified Phoenix ~1.5 °C / New York ~2.5 °C green-roof case studies (no DOI in source prompt) - excluded.

Quickstart

pip install urban-heat-island-utac
from urban_heat_island_utac import (
    uhi_surface_day_c_mean,
    uhi_surface_night_c_mean,
    park_daytime_cooling_c_mean,
    green_roof_cityscale_air_temp_reduction_k_range,
    yang_2021_lst_vs_impervious_slope,
    is_uhi_a_single_universal_value,
    is_surface_temperature_the_same_as_air_temperature,
)

print(uhi_surface_day_c_mean())          # 1.5  (SURFACE / LST)
print(uhi_surface_night_c_mean())        # 1.1  (SURFACE / LST)
print(park_daytime_cooling_c_mean())     # 0.94
print(green_roof_cityscale_air_temp_reduction_k_range())  # (0.3, 3.0) AIR
print(yang_2021_lst_vs_impervious_slope())  # None until pinned
print(is_uhi_a_single_universal_value())  # False
print(is_surface_temperature_the_same_as_air_temperature())  # False

Development

pip install -e ".[dev]"
ruff check src tests
mypy src
pytest

Citation

See CITATION.cff and .zenodo.json.

Metadata

Release files for urban-heat-island-utac 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for urban-heat-island-utac 1.0.0
File Size Uploaded Provenance
urban_heat_island_utac-1.0.0.tar.gz 13.8 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for urban-heat-island-utac 1.0.0
File Interpreter ABI Platform
urban_heat_island_utac-1.0.0-py3-none-any.whl Python 3 none any Details

Total release size: 25.7 kB

Release files / urban_heat_island_utac-1.0.0.tar.gz

Download URL urban_heat_island_utac-1.0.0.tar.gz
Size 13.8 kB
Tags Source
SHA-256 checksum
How to use checksums
31883240b3c21e1982807d659deed50345243f2dad1c5f42b327e82064b7b9c8
BLAKE2b-256 checksum
How to use checksums
034685eb514d6c1a6ddf676022a72d08c2100c07e48628e31f972de92613609d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / urban_heat_island_utac-1.0.0-py3-none-any.whl

Download URL urban_heat_island_utac-1.0.0-py3-none-any.whl
Size 11.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b6cb1c468b354291493ec9b5367362a6dd97c9e264613bba475f564a7cdaeaf7
BLAKE2b-256 checksum
How to use checksums
fe41f36229411982fc41f51e69240717be7e04792dfb82de3d55804eb436150b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Security for urban-heat-island-utac 1.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page