[TASK] (issue5lisousi): rework README

src/ts/lisousi/README

@@ -9,7 +9,7 @@ Purpose of lisousi
 Line-source simulation: Transform field data to apparent line-source generated
 waveforms in preparation for Cartesian 2D full-waveform inversion.
 
-Shallow seismic field data is excited by point sources (e.g. hammer blows).
+Seismic field data is excited by point sources (e.g. hammer blows).
 Full waveform inversion (FWI) approaches which make use of Cartesian 2D
 forward modeling implicitly use a line source to fit the observed data.
 Therefore recorded waveforms must be transformed to simulate equivalent
@@ -27,14 +27,6 @@ approximations, most of them being derived from the acoustic wave Green's
 function. Nevertheless, they perform surprisingly well on data from
 visco-elastic wave propagation in heterogeneous structures.
 
-For shallow seismic data we recommend a simple but effective procedure:
-
- 1. scale waveform by r*sqrt(2)    (offset times square root of 2)
- 2. convolve with 1/sqrt(t)        (fractional half integration)
- 3. taper samples with 1/sqrt(t)
-
-Where r is source-to-receiver offset and t is sample time.
-
 Features
 --------
 
@@ -73,9 +65,9 @@ Program documentation
 
 See files
 
-  usage_text.txt
-  help_text.txt
-  description_text.txt
+  usage_text.txt        for a summary of command line options
+  help_text.txt         for a description of command line options
+  description_text.txt  for the theory of operation
 
 for usage information or execute
 
@@ -127,7 +119,7 @@ Dependencies:
 ============================================================================
 
 The home of this software suite is
-http://gpitrsvn.gpi.uni-karlsruhe.de:8000/TFSoftware/wiki/trunk/src/ts/lisousi
+https://git.scc.kit.edu/Seitosh/Seitosh/wikis/src/ts/lisousi/lisousi
 
 Please send bug reports and suggestions to
 Thomas.Forbriger@kit.edu

src/ts/lisousi/description_text.txt

@@ -9,7 +9,7 @@ Purpose of lisousi
 Line-source simulation: Transform field data to apparent line-source generated
 waveforms in preparation for Cartesian 2D full-waveform inversion.
 
-Shallow seismic field data is excited by point sources (e.g. hammer blows).
+Seismic field data is excited by point sources (e.g. hammer blows).
 Full waveform inversion (FWI) approaches which make use of Cartesian 2D
 forward modeling implicitly use a line source to fit the observed data.
 Therefore recorded waveforms must be transformed to simulate equivalent
@@ -27,6 +27,15 @@ approximations, most of them being derived from the acoustic wave Green's
 function. Nevertheless, they perform surprisingly well on data from
 visco-elastic wave propagation in heterogeneous structures.
 
+For shallow seismic data we recommend a simple but effective procedure:
+
+ 1. scale waveform by r*sqrt(2)    (offset times square root of 2)
+ 2. convolve with 1/sqrt(t)        (fractional half integration)
+ 3. taper samples with 1/sqrt(t)
+
+Where r is source-to-receiver offset and t is sample time.
+We call this "direct-wave transformation".
+
 Theory of operation
 ===================