From a2deed8829bab7979a7911c4eeab58a3e6be1351 Mon Sep 17 00:00:00 2001
From: rinkk <karsten.rink@ufz.de>
Date: Thu, 5 Dec 2019 18:40:31 +0100
Subject: [PATCH] added createIntermediateRasters documentation
---
.../createIntermediateRasters-2layers.png | 3 +
.../createIntermediateRasters-3layers.png | 3 +
.../createIntermediateRasters-4layers.png | 3 +
.../createIntermediateRasters-input.png | 3 +
.../createIntermediateRasters-input1.png | 3 +
.../createIntermediateRasters-input2.png | 3 +
.../createIntermediateRasters-output1-1.png | 3 +
.../createIntermediateRasters-output1.png | 3 +
.../createIntermediateRasters-output2-1.png | 3 +
.../createIntermediateRasters-output2-2.png | 3 +
.../createIntermediateRasters-output2.png | 3 +
.../createIntermediateRasters/index.pandoc | 65 +++++++++++++++++++
12 files changed, 98 insertions(+)
create mode 100644 web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-2layers.png
create mode 100644 web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-3layers.png
create mode 100644 web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-4layers.png
create mode 100644 web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-input.png
create mode 100644 web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-input1.png
create mode 100644 web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-input2.png
create mode 100644 web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-output1-1.png
create mode 100644 web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-output1.png
create mode 100644 web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-output2-1.png
create mode 100644 web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-output2-2.png
create mode 100644 web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-output2.png
create mode 100644 web/content/docs/tools/preprocessing/createIntermediateRasters/index.pandoc
diff --git a/web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-2layers.png b/web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-2layers.png
new file mode 100644
index 00000000000..fbe6121adb9
--- /dev/null
+++ b/web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-2layers.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:7078672d1bac349a10e8478e163b4b737cef97d09f940065826709e13467428e
+size 80976
diff --git a/web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-3layers.png b/web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-3layers.png
new file mode 100644
index 00000000000..eb8283776e1
--- /dev/null
+++ b/web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-3layers.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:2f50e76fd56bd25ee2c4c798ef99d4f5603f88abc57dfce2f78c3e888b3bf501
+size 85937
diff --git a/web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-4layers.png b/web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-4layers.png
new file mode 100644
index 00000000000..028bfa1b60b
--- /dev/null
+++ b/web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-4layers.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:78ac76f4fe806255d8a8f73055c4ec5523334d544811eb85b8b4766d5524e6bc
+size 93594
diff --git a/web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-input.png b/web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-input.png
new file mode 100644
index 00000000000..066624e4680
--- /dev/null
+++ b/web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-input.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:abaa81161ba0779f64714206e40a4fbbb8f03d7235d89e73ee59bc806fccec0a
+size 747067
diff --git a/web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-input1.png b/web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-input1.png
new file mode 100644
index 00000000000..8b69417a2a0
--- /dev/null
+++ b/web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-input1.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:ffe6daa8b30bbdcc7dd205553d88e7a0b61c2699ed6445d042f049470e9b2695
+size 52480
diff --git a/web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-input2.png b/web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-input2.png
new file mode 100644
index 00000000000..b0afd48944c
--- /dev/null
+++ b/web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-input2.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:4b8bdf48f0417ec19d67408eee07d2f98113ea5a8fdf4c566f42c8a26956cb6a
+size 97961
diff --git a/web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-output1-1.png b/web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-output1-1.png
new file mode 100644
index 00000000000..3085e5cac41
--- /dev/null
+++ b/web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-output1-1.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:375e676d736fae0cc42b6c9eb7a7c6b3f22f11cd282689e4786e2d761424172a
+size 55326
diff --git a/web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-output1.png b/web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-output1.png
new file mode 100644
index 00000000000..12d63343c85
--- /dev/null
+++ b/web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-output1.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:a55804f58e06983f53f23224c358f04f86c4c721887ab8fdedd1b8739f0d3bb1
+size 456526
diff --git a/web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-output2-1.png b/web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-output2-1.png
new file mode 100644
index 00000000000..34d3e9d578b
--- /dev/null
+++ b/web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-output2-1.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:68e246d303e8d8c79bff36ef3f7005c1678224af39a9bbb89023ac8a04cd2ae7
+size 52470
diff --git a/web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-output2-2.png b/web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-output2-2.png
new file mode 100644
index 00000000000..ba9000fe464
--- /dev/null
+++ b/web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-output2-2.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:484802df120adf4429abf811bf36fcdb1452a56807d0e4bc38e4522888ef8165
+size 84727
diff --git a/web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-output2.png b/web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-output2.png
new file mode 100644
index 00000000000..943e66975ca
--- /dev/null
+++ b/web/content/docs/tools/preprocessing/createIntermediateRasters/createIntermediateRasters-output2.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:b3fce471542de500263c3aa154724ea568a2f69ecfb23aef128aa0597c06a5aa
+size 710714
diff --git a/web/content/docs/tools/preprocessing/createIntermediateRasters/index.pandoc b/web/content/docs/tools/preprocessing/createIntermediateRasters/index.pandoc
new file mode 100644
index 00000000000..3b93416017f
--- /dev/null
+++ b/web/content/docs/tools/preprocessing/createIntermediateRasters/index.pandoc
@@ -0,0 +1,65 @@
++++
+date = "2019-12-03T00:00:00+01:00"
+title = "createIntermediateRasters"
+author = "Karsten Rink"
+
+[menu]
+ [menu.tools]
+ parent = "Preprocessing"
++++
+
+## Introduction
+
+This utility uses two input DEMs (i.e. raster files of digital elevation models) located at the exact same spatial position but at different elevation and calculates a specified number of raster DEMs located at equidistant distance between them (i.e. for n=1, one new raster located precisely in the middle will be created).
+
+The tool is part of the official [OpenGeoSys git repository](https://github.com/ufz/ogs).
+
+## Usage
+
+```bash
+ createIntermediateRasters --file1 <file1.asc> --file2 <file2.asc>
+ -o <output.asc> [-n <int>]
+
+Where:
+
+ --file1 <file1.asc>
+ (required) First DEM-raster file
+
+ --file2 <file2.asc>
+ (required) Second DEM-raster file
+
+ -o <output.asc>, --output-file <output.asc>
+ (required) Raster output file (*.asc)
+
+ -n <int>, --number <int>
+ number of rasters to be calculated
+```
+
+The parameter ```n``` determines how many layers are created between the two input layers. If the parameter is not specified the default value is set as ```n=1```.
+
+## Simple example
+
+**Input data:**
+
+
+Two input rasters as well as their 3D surface representation. Darker pixels represent values at a lower elevation while brighter pixels represent higher elevaton. In the 3D visualisation, the left-most raster is represented by the green surface and the right-most raster by the yellow surface.
+
+**Command:**
+```
+createIntermediateRasters --file1 raster1.asc --file2 raster2.asc -o output.asc -n 1
+```
+
+{ width=66% }
+A new raster is created in the exact center between the two input rasters. In the 3D representation, the new layer is shown in red.
+
+**Command:**
+```
+createIntermediateRasters --file1 raster1.asc --file2 raster2.asc -o output.asc -n 2
+```
+
+
+For ```n>1``` multiple rasters are created at equidistant distances between the two input rasters. For ```n=2```, two new rasters are generated, represented here in red and blue.
+
+## Application
+
+This utility allows to generate additional input data when creating a bulk mesh from geometry and raster layers. The existing layer structure given via raster files can be refined to avoid deformed elements if the resolution in x-/y-direction is significantly more detailed than in z-direction.
--
GitLab