From c98af5614d6ca501a506139688ef29d4e81b2454 Mon Sep 17 00:00:00 2001
From: Thomas Fischer <thomas.fischer@ufz.de>
Date: Fri, 11 Jan 2019 11:35:45 +0100
Subject: [PATCH] [web-docu] Documentation of GocadSGridReader tool.

---
 .../gocadsgridreader/WorkflowGO2OGS.png       |  3 +
 .../flow_simulation_klein_Grid_Rinne.png      |  3 +
 .../meshing/gocadsgridreader/index.pandoc     | 63 +++++++++++++++++++
 3 files changed, 69 insertions(+)
 create mode 100644 web/content/docs/tools/meshing/gocadsgridreader/WorkflowGO2OGS.png
 create mode 100644 web/content/docs/tools/meshing/gocadsgridreader/flow_simulation_klein_Grid_Rinne.png
 create mode 100644 web/content/docs/tools/meshing/gocadsgridreader/index.pandoc

diff --git a/web/content/docs/tools/meshing/gocadsgridreader/WorkflowGO2OGS.png b/web/content/docs/tools/meshing/gocadsgridreader/WorkflowGO2OGS.png
new file mode 100644
index 00000000000..710e604ed7c
--- /dev/null
+++ b/web/content/docs/tools/meshing/gocadsgridreader/WorkflowGO2OGS.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:7171cfc40a557ed78cad8abb9997ec849b33f06df7c9f1aada0c0df11ddd4c59
+size 508528
diff --git a/web/content/docs/tools/meshing/gocadsgridreader/flow_simulation_klein_Grid_Rinne.png b/web/content/docs/tools/meshing/gocadsgridreader/flow_simulation_klein_Grid_Rinne.png
new file mode 100644
index 00000000000..e483108a8b9
--- /dev/null
+++ b/web/content/docs/tools/meshing/gocadsgridreader/flow_simulation_klein_Grid_Rinne.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:c966eb26e8fcc32c823c9a5d1ac029f74c43e4a6473907370b766247f157fb96
+size 54462
diff --git a/web/content/docs/tools/meshing/gocadsgridreader/index.pandoc b/web/content/docs/tools/meshing/gocadsgridreader/index.pandoc
new file mode 100644
index 00000000000..94e71b1cdc3
--- /dev/null
+++ b/web/content/docs/tools/meshing/gocadsgridreader/index.pandoc
@@ -0,0 +1,63 @@
++++
+date = "2019-01-11T11:00:13+01:00"
+title = "GocadSGridReader"
+author = "Thomas Fischer"
+
+[menu]
+  [menu.tools]
+    parent = "meshing"
++++
+
+## Introduction
+
+The tool `GocadSGridReader` reads a Gocad stratigraphic grid (file ending sg)
+and writes the data in the open vtk unstructured grid file format (file ending
+vtu). The tool doesn't change the geometry, i.e., it doesn't change the element
+quality. Thus, the mesh may not be usable for finite mesh element simulations
+immediately.
+
+The tool is part of the official [OpenGeoSys git repository](https://github.com/ufz/ogs)
+and is build when the `OGS_BUILD_UTILS` cmake switch is set `ON`. The build
+executable `GocadSGridReader` is placed in the `bin` directory. The tool is a command line tool.
+
+## Usage
+Running `GocadSGridReader` tool will print the required arguments and a short usage message; for detailed usage add the `--help` argument.
+
+```bash
+bin/GocadSGridReader  -s <file_name.sg> -o <file_name.vtu>
+                      [-f <true/false>] [--] [--version] [-h]
+
+Where:
+
+   -s <file_name.sg>,  --sg <file_name.sg>
+     (required)  Gocad stratigraphic grid file name
+
+   -o <file_name.vtu>,  --output-mesh <file_name.vtu>
+     (required)  vtk unstructured grid file name
+
+   -f <true/false>,  --generate-face-sets <true/false>
+     generate face sets; default false, i.e. do not generate face sets
+```
+
+## Example
+
+```
+GocadSGridReader -s flow_simulation_grid_klein_Rinne.sg -o flow_simulation_grid_klein_Rinne.vtu
+```
+![](flow_simulation_klein_Grid_Rinne.png)
+
+## Applications
+
+### Thuringia Syncline (INFLUINS project)
+
+The tool was used to convert Gocad stratigraphic grids (upper left part of the
+figure below) of the Thuringia syncline to a vtk unstructured grid (lower left
+part of the figure) within the INFLUINS project.
+{{< bib id="Fischer:2015" >}}
+![](WorkflowGO2OGS.png)
+
+### Rotenburger Rinne (Geologischer Dienst für Niedersachsen, Referat Hydrogeologie Landesamt für Bergbau, Energie und Geologie (Jörg Elbracht))
+
+### Heat storage model HH (Christian-Albrechts-Universität zu Kiel, Institut für Geowissenschaften (Janine Struß))
+
+### Geothermal project (British Geological Survey (Richard Haslam))
-- 
GitLab