From 479afb4532b2453bba1bdde2b0c96601cf40db23 Mon Sep 17 00:00:00 2001
From: Daniel Vedder <daniel.vedder@idiv.de>
Date: Tue, 14 Jan 2025 16:22:33 +0100
Subject: [PATCH] Added soil map section to GIS docs

---
 CHANGELOG.md    | 21 +++++++++++++++++++--
 docs/src/gis.md | 19 +++++++++++++++----
 2 files changed, 34 insertions(+), 6 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 039086b..737f799 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -8,11 +8,28 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [1.0.0] - in planning
 
-*Aim: 3 species, 2 crop growth models, farm model, GAEC scenarios, experimental analysis*
+*Aim: 4 species, 2 crop growth models, farm model, GAEC scenarios, experimental analysis*
 
 *Plan: decouple CairoMakie (#81), fix & test ALMaSS, set up first experiments*
 
-## [0.6.0]
+## [0.6.1] - unreleased
+
+*Plan: add soil maps, update GIS documentation, add more regions*
+
+### Added
+
+### Changed
+
+- added soil map section to GIS docs
+
+### Deprecated
+
+### Removed
+
+### Fixed
+
+
+## [0.6.0] - 13-01-2025
 
 **This point release re-implements the ALMaSS crop model**
 
diff --git a/docs/src/gis.md b/docs/src/gis.md
index 10370b0..4d02675 100644
--- a/docs/src/gis.md
+++ b/docs/src/gis.md
@@ -1,9 +1,9 @@
 # Maps and weather data
 
-Persefone currently requires two separate map input files: one for land cover,
-the other for field geometry. Additionally, a weather input file is needed. 
-This documents describe how to obtain and process the data needed for each 
-of these.
+Persefone.jl requires three map input files: one for land cover, one for
+for field geometries, and one for soil types. Additionally, a weather input 
+file is needed. This documents describe how to obtain and process the data 
+needed for each of these.
 
 ## Land cover maps
 
@@ -72,6 +72,17 @@ the advanced parameters, set the output data type to `UInt32`. Finally, enter an
 output file name and run. The resulting TIF file can be passed to Persefone
 as the `farmfieldmap` parameter.
 
+## Soil data
+
+Soil data for Germany is provided by the Bundesanstalt für Geowissenschaften und
+Rohstoffe in form of the [Bodenatlas](https://bodenatlas.bgr.de/). This provides
+a (coarse, but for our purposes sufficient) map of the distribution of the basic
+soil types such as clay, silt, sand, and loam.
+
+To create the Persefone input file, you need crop this national map to the same 
+region as the other maps, then rasterise it (see instructions in the last paragraph
+of the previous section).
+
 ## Weather data
 
 Currently, Persefone uses historical weather data from the closes weather station
-- 
GitLab