AboveQGIS — KyFromAbove Data Access for QGIS
==============================================

Access Kentucky's KyFromAbove LiDAR, DEM, and orthoimagery directly from
the QGIS Processing toolbox. No credentials required.

Requirements
------------
- QGIS >= 3.22 (compatible through QGIS 4)
- abovepy >= 2.1.1 (installed automatically on first run)

Installation
------------
1. Install this plugin via Plugins > Manage and Install Plugins,
   or install from ZIP.

2. On first launch, the plugin checks for abovepy and offers to
   install it automatically if missing. Just click "Yes" and
   restart QGIS.

   If automatic install fails (e.g., permissions), open the
   OSGeo4W Shell and run:
     pip install abovepy

Processing Tools
----------------
All tools are available from:
  - Plugins > AboveQGIS — KyFromAbove (menu bar)
  - Processing Toolbox > AboveQGIS > KyFromAbove

Tools:
  - Search KyFromAbove Tiles — find tiles by county or map extent
  - Download KyFromAbove Tiles — concurrent downloads, auto-loads
    with hillshade symbology for DEM products
  - Load County Ortho Mosaic — stream a full-county 3-inch ortho
    directly from S3 (no download of 18-110 GB files needed)
  - Mosaic KyFromAbove Tiles — build VRT or GeoTIFF from tiles
  - Generate Hillshade Tile URL — server-side hillshade (no download)

Export Formats (Python)
-----------------------
  - to_stl() — DEM to 3D-printable mesh for Bambu Studio, Cura, Blender
  - to_geotiff(), to_geopackage(), to_shapefile()
  - to_landxml() — DEM to TIN surface (deprecated, scheduled for removal in v3.0)

Data Source
-----------
KyFromAbove (https://kyfromabove.ky.gov/) — Kentucky's statewide
LiDAR, DEM, orthoimagery, and oblique imagery program.
All data is publicly available on AWS S3 with a STAC API.

License
-------
GPL-3.0 — see LICENSE file.

Links
-----
- Documentation: https://chrislyonsKY.github.io/AbovePy/
- Wiki: https://github.com/chrislyonsKY/AbovePy/wiki
- Source code: https://github.com/chrislyonsKY/AbovePy
- Bug tracker: https://github.com/chrislyonsKY/AbovePy/issues
