abovepy 0.1.0

KyFromAbove LiDAR, DEM, and orthoimagery data access for Python

abovepy

KyFromAbove LiDAR, DEM, and orthoimagery data access for Python.

Kentucky's KyFromAbove program provides statewide 2ft DEMs, 3-inch orthoimagery, and COPC LiDAR point clouds — all publicly available on S3 with a STAC API for discovery. abovepy gives you Pythonic access to all of it. No credentials required.

Install

pip install abovepy

Optional extras:

pip install abovepy[lidar]    # COPC/LAZ point cloud support
pip install abovepy[viz]      # leafmap + matplotlib visualization
pip install abovepy[all]      # Everything

Quick Start

Search by county name

import abovepy

# Find DEM tiles covering Franklin County
tiles = abovepy.search(county="Franklin", product="dem_phase3")
print(tiles)

Search by bounding box

tiles = abovepy.search(
    bbox=(-84.9, 38.15, -84.8, 38.25),
    product="dem_phase3"
)

Download tiles

paths = abovepy.download(tiles, output_dir="./data")

Mosaic into a single raster

vrt = abovepy.mosaic(paths, output="frankfort.vrt")

Stream without downloading

data, profile = abovepy.read(
    tiles.iloc[0].asset_url,
    bbox=(-84.85, 38.18, -84.82, 38.21)
)

Explore available products

print(abovepy.info())
#   product        display_name                format  resolution  phase  crs
#   dem_phase1     DEM Phase 1 (5ft)           COG     5ft         1      EPSG:3089
#   dem_phase2     DEM Phase 2 (2ft)           COG     2ft         2      EPSG:3089
#   dem_phase3     DEM Phase 3 (2ft)           COG     2ft         3      EPSG:3089
#   ortho_phase1   Orthoimagery Phase 1 ...    COG     6in         1      EPSG:3089
#   ...

Available Products

Product	Resolution	Format	Collection ID
dem_phase1	5ft	COG	dem-phase1
dem_phase2	2ft	COG	dem-phase2
dem_phase3	2ft	COG	dem-phase3
ortho_phase1	6 inch	COG	orthos-phase1
ortho_phase2	6 inch	COG	orthos-phase2
ortho_phase3	3 inch	COG	orthos-phase3
laz_phase1	Varies	LAZ	laz-phase1
laz_phase2	Varies	COPC	laz-phase2
laz_phase3	Varies	COPC	laz-phase3

All data is natively in EPSG:3089 (Kentucky Single Zone, US feet). abovepy accepts bounding boxes in EPSG:4326 by default.

ArcGIS Pro Toolbox

An ArcGIS Pro Python Toolbox is included in arcgis/AbovePro.pyt with tools for:

• Find KyFromAbove Tiles — draw extent, pick product, see available tiles
• Download Tiles — download with progress tracking
• Download and Load — download + add to map in one step
• DEM Hillshade — automated DEM → hillshade workflow
• County Download — download by county name dropdown

See ArcGIS Pro Toolbox Guide for installation and usage.

Web Visualization

abovepy generates TiTiler-compatible URLs for web map integration:

from abovepy.titiler import cog_tile_url

url = cog_tile_url(
    cog_url=tiles.iloc[0].asset_url,
    titiler_endpoint="http://localhost:8000"
)
# Use with MapLibre GL JS or Leaflet

A docker-compose.yml for local TiTiler is in examples/.

Advanced: Direct STAC Access

For power users who need the full pystac-client:

client = abovepy.KyFromAboveClient()
stac_client = client.get_stac_client()

# Full pystac-client API
results = stac_client.search(
    collections=["dem-phase3"],
    bbox=(-84.9, 38.15, -84.8, 38.25),
    datetime="2022-01-01/..",
).item_collection()

Data Source

All data is provided by the KyFromAbove program, managed by the Kentucky Division of Geographic Information.

• STAC API: https://spved5ihrl.execute-api.us-west-2.amazonaws.com/
• S3 Bucket: s3://kyfromabove/ (public, us-west-2)
• STAC Browser: kygeonet.ky.gov/stac

License

GPL-3.0 — see LICENSE.

---

_{Developed at the Kentucky Energy & Environment Cabinet}