From f70b6effe2e0f12b5284552c3c0f5b1a56daf564 Mon Sep 17 00:00:00 2001 From: "s0wlz (Matthias Puchstein)" Date: Sat, 13 Dec 2025 23:01:22 +0100 Subject: [PATCH] removed agents --- AGENTS.md | 37 ------------------------------------- 1 file changed, 37 deletions(-) delete mode 100644 AGENTS.md diff --git a/AGENTS.md b/AGENTS.md deleted file mode 100644 index aeb3f0c..0000000 --- a/AGENTS.md +++ /dev/null @@ -1,37 +0,0 @@ -# Repository Guidelines - -## Project Structure & Module Organization -- `raw_dgm1/`: source DGM1 tiles (`.tif` + `.tfw`) named `dgm1___.tif`. -- `raw_3dgeb_lod1/` and `raw_3dgeb_lod2/`: LoD1/LoD2 building geometries as `.gml` with sidecar `.txt` metadata. -- `raw_dop/`: orthophoto download artifacts (scripts, certs, `jp2`, `xml`, `j2w`); treat as read-only inputs. -- `export_unity/`: delivery assets; `height_png16/` holds 16-bit heightmaps, `tile_index.csv` maps tile IDs to world bounds and global min/max. -- `work/`: transient artifacts such as `dgm.vrt` and intermediate `_tmp.tif` files; safe to regenerate. -- `3dgeblod1/`, `3dgeblod2/`, `dgm/`: preserved ZIPs and object lists documenting raw downloads; keep for provenance. -- `export_heightmaps.py`: main Python pipeline that mosaics the VRT, rescales to UInt16, and writes Unity-friendly tiles. - -## Build, Test, and Development Commands -- Create/refresh VRT (run in repo root): - `gdalbuildvrt work/dgm.vrt raw_dgm1/*.tif` -- Export Unity-ready heightmaps and manifest: - `python3 export_heightmaps.py` -- Inspect a tile for sanity (optional spot check): - `gdalinfo export_unity/height_png16/dgm1_32_328_5511.png | head` -- Dependencies: GDAL with Python bindings (`osgeo`) available on PATH/PYTHONPATH. -- If processing LoD GML or DOP imagery, keep scripts/data under the respective `raw_*` folders; avoid scattering inputs. - -## Coding Style & Naming Conventions -- Python: 4-space indentation, snake_case identifiers, and module-level constants for tunables (e.g., `TILE_SIZE_M`, `OUT_RES`). -- Keep tile IDs stable and lower_snake_case to align with file naming and manifest entries. -- Prefer small, composable functions if extending the pipeline; keep GDAL options explicit. - -## Testing & Validation -- No formal test suite yet; validate changes by re-running `export_heightmaps.py` on a small subset and diffing outputs. -- For correctness, compare `gdalinfo` stats of regenerated PNGs against expectations and spot-check manifest bounds. -- When altering scaling or bounds logic, document rationale in comments and update an example command in this guide if needed. - -## Commit & Pull Request Guidelines -- Use short, imperative commit messages (e.g., “add resampling flag”, “document export flow”); follow existing history style. -- PRs should summarize scope, list commands executed (`gdalbuildvrt`, `export_heightmaps.py`), and call out data changes or new dependencies. -- Avoid committing large raw datasets if not required; prefer documenting download steps or using `.gitignore` for temporary exports. -- Include screenshots or brief notes when changes affect Unity import workflows or manifest formats. -- Note the presence of archived downloads in `3dgeblod*` and `dgm/`; do not delete them without replacing provenance elsewhere.