Skip to content

Commit 7d51a56

Browse files
chrislyonsKYclaude
andcommitted
Update docs: 6 QGIS tools, county mosaics, STL export, wiki link
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent f3529a9 commit 7d51a56

3 files changed

Lines changed: 36 additions & 8 deletions

File tree

README.md

Lines changed: 20 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -324,17 +324,35 @@ See [ArcGIS Pro Toolbox Guide](https://chrislyonsKY.github.io/AbovePy/tutorials/
324324

325325
## QGIS Plugin
326326

327-
**AboveQGIS** is a QGIS Processing toolbox plugin with 4 tools:
327+
**AboveQGIS** is a QGIS Processing toolbox plugin with 6 tools:
328328

329329
- **Search KyFromAbove Tiles** — county dropdown (all 120) or map extent, outputs tile footprint layer
330-
- **Download KyFromAbove Tiles** — concurrent downloads to a local folder
330+
- **Download KyFromAbove Tiles** — concurrent downloads, auto-loads with hillshade symbology
331+
- **Load County Ortho Mosaic** — stream a full-county 3-inch ortho directly from S3 (no download)
331332
- **Mosaic KyFromAbove Tiles** — build VRT or GeoTIFF from downloaded tiles
332333
- **Generate Hillshade Tile URL** — server-side hillshade via TiTiler (no download needed)
334+
- **STL Export** — convert DEM to 3D-printable mesh via `abovepy.export.to_stl()`
333335

334336
Install via **Plugins > Manage and Install Plugins** or from the [QGIS Plugin Repository](https://plugins.qgis.org/plugins/aboveqgis/). The plugin auto-installs abovepy on first run.
335337

336338
Tools appear under **Plugins > AboveQGIS — KyFromAbove** and in the Processing Toolbox.
337339

340+
### County Ortho Mosaics
341+
342+
KyFromAbove provides pre-built 3-inch ortho mosaics for all 120 counties. Stream them directly without downloading:
343+
344+
```python
345+
import abovepy
346+
347+
# Get the S3 URL for Franklin County's ortho mosaic
348+
url = abovepy.county_mosaic_url("Franklin")
349+
350+
# Or for ArcGIS users
351+
url = abovepy.county_mosaic_url("Franklin", fmt="tpkx")
352+
```
353+
354+
In QGIS, use **Plugins > AboveQGIS > Load County Ortho Mosaic** to stream directly into your project.
355+
338356
## Web Visualization
339357

340358
abovepy generates TiTiler-compatible URLs for web map integration:

qgis/aboveqgis.zip

222 Bytes
Binary file not shown.

qgis/aboveqgis/README

Lines changed: 16 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6,8 +6,8 @@ the QGIS Processing toolbox. No credentials required.
66

77
Requirements
88
------------
9-
- QGIS >= 3.22
10-
- abovepy >= 2.1.2 (installed automatically on first run)
9+
- QGIS >= 3.22 (compatible through QGIS 4)
10+
- abovepy >= 2.1.1 (installed automatically on first run)
1111

1212
Installation
1313
------------
@@ -29,10 +29,19 @@ All tools are available from:
2929
- Processing Toolbox > AboveQGIS > KyFromAbove
3030

3131
Tools:
32-
- Search KyFromAbove Tiles — find tiles by county dropdown or map extent
33-
- Download KyFromAbove Tiles — concurrent downloads to a local folder
34-
- Mosaic KyFromAbove Tiles — build VRT or GeoTIFF from downloaded tiles
35-
- Generate Hillshade Tile URL — server-side hillshade (no download needed)
32+
- Search KyFromAbove Tiles — find tiles by county or map extent
33+
- Download KyFromAbove Tiles — concurrent downloads, auto-loads
34+
with hillshade symbology for DEM products
35+
- Load County Ortho Mosaic — stream a full-county 3-inch ortho
36+
directly from S3 (no download of 18-110 GB files needed)
37+
- Mosaic KyFromAbove Tiles — build VRT or GeoTIFF from tiles
38+
- Generate Hillshade Tile URL — server-side hillshade (no download)
39+
40+
Export Formats (Python)
41+
-----------------------
42+
- to_landxml() — DEM to TIN surface for Civil 3D, Carlson, OpenRoads
43+
- to_stl() — DEM to 3D-printable mesh for Bambu Studio, Cura, Blender
44+
- to_geotiff(), to_geopackage(), to_shapefile()
3645

3746
Data Source
3847
-----------
@@ -47,5 +56,6 @@ GPL-3.0 — see LICENSE file.
4756
Links
4857
-----
4958
- Documentation: https://chrislyonsKY.github.io/AbovePy/
59+
- Wiki: https://github.com/chrislyonsKY/AbovePy/wiki
5060
- Source code: https://github.com/chrislyonsKY/AbovePy
5161
- Bug tracker: https://github.com/chrislyonsKY/AbovePy/issues

0 commit comments

Comments
 (0)