added Citations

2026-02-11 23:57:33 +01:00
parent 27ec81f53b
commit 675b833833
1 changed files with 115 additions and 0 deletions
--- a/CITATION.md
+++ 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}
+}
+```