Merge pull request #5 from ubcgif/dev

Dev

content/examples.rst

@@ -3,58 +3,37 @@
 Introduction
 ============
 
-In this section, we present forward modelling and inversion examples for both DC and IP data
-types. The examples are freely available for download 3 MB and can also be found on the DCIP3D
-website (without the exe files). The example is synthetic and is a 10
--m (0.1 S/m) block in a 1000
-
--m (0.001 S/m) half-space with a pyramid-shaped topography (Figure 5). For added complexity,
-surface data on a 25-m grid is simulated along with borehole data so that the general data format
-is required. The intrinsic chargeability of the block is 0.15 (Figure 6). The electrode locations are
-denoted by the white dots in both Figures. After forward modelling, 5% Gaussian noise is added to
-each data set to create the \observed" data sets. The uncertainties assigned are 5% of each datum
-with a 0.0001
-oor (for both DC and IP). The last section shows the differences between the old
-code and version 5.0 with respect to the nodal-based finite difference scheme (shown in Figure 3).
-The mesh used for the example is 26  26  23 and the file is given by
-
-.. figure:: ../images/example/5prisms.png
-	:align: center
-	:figwidth: 50%
-
-The five blocks are assigned conductivity and chargeability values, which are given in the table below.
-
-.. figure:: ../images/example/table1.PNG
-	:align: center
-	:figwidth: 75%
+.. figure:: ../images/example_model_DC.png
+        :name: dcmodel
+        :align: center
+        :figwidth: 50%
 
-DC resistivity and IP data are forward modelled for both surface and cross-borehole arrays using the ``DCIPoctreeFwd`` code. Three different electrode configurations were used for both DC and IP data types to show the benefits of a joint inversion using both surface and borehole data. Details of the three surveys are as follows:
+        Pyramid topographic model of a used for DC forward modelling and the inversion examples. The block is a :math:`10 \Omega m~(0.1 S/m)` block in a :math:`1000 \Omega m~(0.001 S/m)` half-space. The colour scale is in S/m. The electrode locations are shown in white.
 
-1. Surface dataset: Pole-dipole arrays with a = 50 m (smallest potential electrode spacing) and n (potential electrode position) ranging from 1 to 6. Eleven east-west lines with a line spacing of 100 m were used to cover the core region of the model which is 1 square km. In total, 1089 observations were forward modelled using 209 current electrodes.
+.. figure:: ../images/example_model_IP.png
+        :name: ipmodel
+        :align: center
+        :figwidth: 50%
 
-2. Borehole dataset: Pole-dipole arrays located within 4 boreholes, whose locations are specified in the table below. The data were simulated using a borehole array configuration in which the current electrode is moved down each of the 4 boreholes with 25 m steps to the depth of 350 m. This results in a total of 51 current electrode locations. For each of the current electrode locations, the potential electrode array, with a 50 m spread, was placed in each of the remaining three boreholes and moved down to a depth of 350 m at 25 m intervals, resulting in 1530 forward modelled observations.
+        Pyramid topographic model of a used for IP forward modelling and the inversion examples. The intrinsic chargeability of the block is 0.15 and the background is not chargeable. The colour scale is in fractional percent chargeability. The electrode locations are shown in white.
 
-.. figure:: ../images/example/table2.PNG
-	:align: center
-	:figwidth: 75%
+In this section, we present forward modelling and inversion examples for both DC and IP data
+types. The examples are freely available for download and can also be found on the DCIP3D
+website (without the exe files). The example is synthetic and is a :math:`10 \Omega m~(0.1 S/m)` block in a :math:`1000 \Omega m~(0.001 S/m)` half-space with a pyramid-shaped topography (Figure 5). For added complexity, surface data on a 25-m grid is simulated along with borehole data so that the general data format is required. The intrinsic chargeability of the block is 0.15 (Figure 6). The electrode locations are denoted by the white dots in both Figures. After forward modelling, 5% Gaussian noise is added to each data set to create the \observed" data sets. The uncertainties assigned are 5% of each datum with a 0.0001 oor (for both DC and IP). The last section shows the differences between the old code and version 5.0 with respect to the nodal-based finite difference scheme (shown in Figure 3). The mesh used for the example is 26 X 26 X 23 and the file is given by
 
-3. Combined surface and borehole dataset: A combination of the above pole-dipole surface and borehole arrays, resulting in 260 current electrodes and 2619 total forward modelled observations.
+.. figure:: ../images/example_mesh_file.png
+        :name: mesh
+        :align: center
+        :figwidth: 75%
 
-Prior to inversion, 5% Gaussian noise was added to the forward modelled data, and uncertainties were assigned to be 5% of the data value plus a small floor.
+- `Download zip file for example <https://github.com/ubcgif/dcip3d/raw/master/example/dcip3dv5_example.zip>`__, which contains all the files necessary to run the forward and inverse problems.
 
-The following pages describe the constant inversion parameters used and then the inversion of each dataset.
 
 .. toctree::
         :maxdepth: 2
 
-        Inversion parameters <exe5prism/param>
-        DC inversion of surface data <exe5prism/dcsurf>
-        IP inversion of surface data <exe5prism/ipsurf>
-        DC inversion of borehole data <exe5prism/dcbore>
-        IP inversion of borehole data <exe5prism/ipbore>
-        DC inversion of combined data <exe5prism/dccomb>
-        IP inversion of combined data <exe5prism/ipcomb>
-
-
-
-
+        DC Forward Modeling <exeprism/dcfor>
+        IP Forward Modeling <exeprism/ipfor>
+        DC inversion <exeprism/dcinv>
+        IP inversion <exeprism/ipinv>
+        Version Comparison <exeprism/versioncomparison>