diff --git a/CITATION.md b/CITATION.md new file mode 100644 index 0000000..0d275d2 --- /dev/null +++ b/CITATION.md @@ -0,0 +1,115 @@ +# Geodata and Tooling Citation + +## 1) LVermGeo RLP / GeoShop RLP (terrain, ortho, buildings) + +Source: GeoShop RLP - Digitale Gelaendemodelle (DGM) +Source URL: https://geoshop.rlp.de/digitale_gelaendemodelle/digitale_gelaendemodelle_dgm.html +GeoShop entry point: https://geoshop.rlp.de/ +Open data portal: https://www.lvermgeo.rlp.de/geodaten-geoshop/open-data +License: Data Licence Germany - Attribution - Version 2.0 (dl-de/by-2-0) +License URL: https://www.govdata.de/dl-de/by-2-0 +Accessed: 2026-01-19 + +Products used: +- DGM1 (Digitales Gelaendemodell, GeoTIFF) +- DOM1 (Digitales Oberflaechenmodell, GeoTIFF) +- DOP20 (Digitale Orthophotos, JP2) +- 3D-Gebaeudemodelle LOD2 (CityGML) +- BDOM20RGBI (Gebaeude-/Objektpunktwolke, LAZ) +- LPOLPG (LAS-Punktwolke, kombiniert; abgeleitete Teilmengen: LPG/LPO) + +GeoBasis download patterns used in the pipeline: +- DGM1: `https://geobasis-rlp.de/data/dgm1/current/tif/dgm01_32_{x}_{y}_1_rp.tif` +- DOM1: `https://geobasis-rlp.de/data/dom1/current/tif/dom1_32_{x}_{y}_1_rp_2020.tif` +- DOP20: `https://geobasis-rlp.de/data/dop20rgb/current/jp2/dop20rgb_32_{x}_{y}_2_rp_2023.jp2` +- LoD2 CityGML: `https://geobasis-rlp.de/data/geb3dlo/current/gml/LoD2_32_{x}_{y}_2_RP.gml` +- BDOM20RGBI: `https://geobasis-rlp.de/data/bdom20rgbi/current/las/bdom20rgbi_32_{x}_{y}_2_rp.laz` +- LPOLPG: `https://geobasis-rlp.de/data/las/current/las/lpolpg_32_{x}_{y}_1_rp.laz` + +Required attribution (verbatim): +(c) GeoBasis-DE / LVermGeoRP 2026, dl-de/by-2-0, www.lvermgeo.rlp.de + +If modified, append: +[Data modified] (or in German: [Daten bearbeitet]) + +## 2) HydroRIVERS (river network for erosion workflow) + +Dataset: HydroRIVERS v1.0 (Europe tile used in pipeline) +Download URL used by pipeline: https://data.hydrosheds.org/file/HydroRIVERS/HydroRIVERS_v10_eu_shp.zip +Project page: https://www.hydrosheds.org +License: Covered by the HydroSHEDS License Agreement (see https://www.hydrosheds.org) +Accessed: 2026-01-23 + +Recommended citation (from HydroRIVERS Technical Documentation v1.0): +Lehner, B., Grill G. (2013): Global river hydrography and network routing: baseline data and new approaches to study the world's large river systems. Hydrological Processes, 27(15): 2171-2186. Data is available at www.hydrosheds.org. + +## 3) HydroLAKES (lake depth support for erosion workflow) + +Dataset: HydroLAKES v1.0 polygon database +Download URL used by pipeline: https://data.hydrosheds.org/file/hydrolakes/HydroLAKES_polys_v10_shp.zip +Project page: https://www.hydrosheds.org +License: Creative Commons Attribution 4.0 International (CC BY 4.0) +License URL: https://creativecommons.org/licenses/by/4.0/ +Accessed: 2026-01-23 + +Recommended citation (from HydroLAKES Technical Documentation v1.0): +Messager, M.L., Lehner, B., Grill, G., Nedeva, I., Schmitt, O. (2016): Estimating the volume and age of water stored in global lakes using a geo-statistical approach. Nature Communications: 13603. doi: 10.1038/ncomms13603. Data is available at www.hydrosheds.org. + +## 4) GeoData pipeline tools used + +Core geospatial and conversion tooling used by `GeoData/geodata_to_unity.py` and `GeoData/geodata_pipeline/`: +- Python (project runtime; configured for 3.11-3.12) +- `uv` (environment and dependency management) +- GDAL / OGR / OSR (`osgeo`) including `gdalbuildvrt` +- PDAL +- citygml-tools 2.4.0 +- cjio (`cjio[export,reproject]`) +- laspy (`laspy[lazrs]`) +- NumPy +- SciPy +- scikit-learn +- Shapely +- trimesh +- requests +- tomli-w + +Reference implementation locations: +- Dependencies: `GeoData/pyproject.toml` +- Main CLI: `GeoData/geodata_to_unity.py` +- Pipeline modules: `GeoData/geodata_pipeline/` + +## 5) Numerical methods and related implementations (BibTeX) + +```bibtex +@article{saetra2012, + title={Shallow Water Simulations on Multiple GPUs}, + author={S{\ae}tra, ML and Brodtkorb, AR}, + year={2012} +} + +@book{toro2009, + title={Riemann Solvers and Numerical Methods for Fluid Dynamics}, + author={Toro, EF}, + edition={3}, + year={2009} +} + +@article{kader2022, + title={A New Variant of Rusanov Scheme}, + author={Kader, ...}, + journal={IJAM}, + year={2022} +} + +@article{audusse2004, + title={A Fast and Stable Well-Balanced Scheme...}, + author={Audusse, E and Bouchut, F and ...}, + year={2004} +} + +@github{bshishov2019, + title={UnityTerrainErosionGPU}, + author={Bshishov, A}, + url={https://github.com/bshishov/UnityTerrainErosionGPU} +} +```