Merge branch 'master' into ex/mt1d

# Conflicts:
#	SimPEG/Examples/__init__.py
This commit is contained in:
Thibaut Astic
2016-04-07 11:09:07 -07:00
84 changed files with 9650 additions and 1856 deletions
+150
View File
@@ -0,0 +1,150 @@
.. _api_DC:
.. math::
\renewcommand{\div}{\nabla\cdot\,}
\newcommand{\grad}{\vec \nabla}
\newcommand{\curl}{{\vec \nabla}\times\,}
\newcommand{\dcurl}{{\mathbf C}}
\newcommand{\dgrad}{{\mathbf G}}
\newcommand{\Acf}{{\mathbf A_c^f}}
\newcommand{\Ace}{{\mathbf A_c^e}}
\renewcommand{\S}{{\mathbf \Sigma}}
\renewcommand{\Div}{{\mathbf {Div}}}
\renewcommand{\Grad}{{\mathbf {Grad}}}
\newcommand{\St}{{\mathbf \Sigma_\tau}}
\newcommand{\diag}{\mathbf{diag}}
\newcommand{\M}{{\mathbf M}}
\newcommand{\Me}{{\M^e}}
\newcommand{\Mes}[1]{{\M^e_{#1}}}
\newcommand{\be}{\mathbf{e}}
\newcommand{\bj}{\mathbf{j}}
\newcommand{\bphi}{\mathbf{\phi}}
\newcommand{\bq}{\mathbf{q}}
\newcommand{\bJ}{\mathbf{J}}
\newcommand{\bG}{\mathbf{G}}
\newcommand{\bP}{\mathbf{P}}
\newcommand{\bA}{\mathbf{A}}
\newcommand{\bm}{\mathbf{m}}
\newcommand{\B}{\vec{B}}
\newcommand{\D}{\vec{D}}
\renewcommand{\H}{\vec{H}}
\renewcommand {\j} { {\vec j} }
\newcommand {\h} { {\vec h} }
\renewcommand {\b} { {\vec b} }
\newcommand {\e} { {\vec e} }
\newcommand {\c} { {\vec c} }
\renewcommand {\d} { {\vec d} }
\renewcommand {\u} { {\vec u} }
\newcommand{\I}{\vec{I}}
DC resistivity survey
*********************
Electrical resistivity of subsurface materials is measured by causing an electrical current to flow in the earth between one pair of electrodes while the voltage across a second pair of electrodes is measured. The result is an "apparent" resistivity which is a value representing the weighted average resistivity over a volume of the earth. Variations in this measurement are caused by variations in the soil, rock, and pore fluid electrical resistivity. Surveys require contact with the ground, so they can be labour intensive. Results are sometimes interpreted directly, but more commonly, 1D, 2D or 3D models are estimated using inversion procedures (`GPG <http://www.eos.ubc.ca/courses/eosc350/content/>`_).
Background
==========
As direct current (DC) implies, in DC resistivity survey, we assume steady-state. We consider Maxwell's equations in steady state as
.. math::
\curl \frac{1}{\mu} \vec{b} - \j = \j_s \\
\curl \e = 0
Then by taking \\(\\curl\\) for the first equation, we have
.. math::
- \div\j = q \\
where
.. math::
\div \j_s = q = I(\delta(\vec{r}-\vec{r}_{s+})-\delta(\vec{r}-\vec{r}_{s-}))
Since \\(\\curl \\e = 0\\), we have
.. math::
\e = \grad \phi
And by Ohm's law, we have
.. math::
\j = \sigma \grad \phi
Finally, we can compute the solution of the system:
.. math::
- \div\j = q
\j = \sigma \grad \phi
\frac{\partial \phi}{\partial r}\Big|_{\partial \Omega_{BC}} = 0
Discretization
==============
By using finite volume method (FVM), we discretize our system as
.. math::
-\Div \bj = \bq
\diag(\Acf^{T}\sigma^{-1}) \bj = \Grad \bphi
Here boundary condtions are embedded in the discrete differential operators. With some linear algebra we have
.. math::
\bA\bphi = -\bq
where
.. math::
\bA = \Div (\diag(\Acf^{T}\sigma^{-1}))^{-1} \Grad
By solving this linear equation, we can compute the solution of \\(\\phi\\). Based on this discretization, we derive sensitivity in discretized space. Sensitivity matrix can be in general can be written as
.. math ::
\bJ = -\bP\bA^{-1}\bG
where
.. math ::
\bP: \text{Projection}
\bJ = \bP\frac{\partial \phi}{\partial \bm}
Here \\(\\bm\\) indicates model parameters in discretized space.
Verification
============
Comparing to the analytic function:
.. plot::
import simpegDC as DC
DC.Examples.Verification.run(plotIt=True)
API
===
.. automodule:: simpegDC.BaseDC
:show-inheritance:
:members:
:undoc-members:
:inherited-members:
+2 -2
View File
@@ -51,9 +51,9 @@ copyright = u'2013, SimPEG Developers'
# built documents.
#
# The short X.Y version.
version = '0.1.9'
version = '0.1.10'
# The full version, including alpha/beta/rc tags.
release = '0.1.9'
release = '0.1.10'
# The language for content autogenerated by Sphinx. Refer to documentation
# for a list of supported languages.
+21
View File
@@ -0,0 +1,21 @@
.. _examples_DC_Analytic_Dipole:
.. --------------------------------- ..
.. ..
.. THIS FILE IS AUTO GENEREATED ..
.. ..
.. SimPEG/Examples/__init__.py ..
.. ..
.. --------------------------------- ..
DC Analytic Dipole
==================
.. plot::
from SimPEG import Examples
Examples.DC_Analytic_Dipole.run()
.. literalinclude:: ../../SimPEG/Examples/DC_Analytic_Dipole.py
:language: python
:linenos:
@@ -0,0 +1,28 @@
.. _examples_DC_Forward_PseudoSection:
.. --------------------------------- ..
.. ..
.. THIS FILE IS AUTO GENEREATED ..
.. ..
.. SimPEG/Examples/__init__.py ..
.. ..
.. --------------------------------- ..
DC Forward Simulation
=====================
Forward model conductive spheres in a half-space and plot a pseudo-section
Created by @fourndo on Mon Feb 01 19:28:06 2016
.. plot::
from SimPEG import Examples
Examples.DC_Forward_PseudoSection.run()
.. literalinclude:: ../../SimPEG/Examples/DC_Forward_PseudoSection.py
:language: python
:linenos:
@@ -0,0 +1,27 @@
.. _examples_MT_1D_ForwardAndInversion:
.. --------------------------------- ..
.. ..
.. THIS FILE IS AUTO GENEREATED ..
.. ..
.. SimPEG/Examples/__init__.py ..
.. ..
.. --------------------------------- ..
MT: 1D: Inversion
=======================
Forward model 1D MT data.
Setup and run a MT 1D inversion.
.. plot::
from SimPEG import Examples
Examples.MT_1D_ForwardAndInversion.run()
.. literalinclude:: ../../SimPEG/Examples/MT_1D_ForwardAndInversion.py
:language: python
:linenos:
+26
View File
@@ -0,0 +1,26 @@
.. _examples_MT_3D_Foward:
.. --------------------------------- ..
.. ..
.. THIS FILE IS AUTO GENEREATED ..
.. ..
.. SimPEG/Examples/__init__.py ..
.. ..
.. --------------------------------- ..
MT: 3D: Forward
=======================
Forward model 3D MT data.
.. plot::
from SimPEG import Examples
Examples.MT_3D_Foward.run()
.. literalinclude:: ../../SimPEG/Examples/MT_3D_Foward.py
:language: python
:linenos:
+1 -3
View File
@@ -49,9 +49,7 @@ Examples
.. toctree::
:maxdepth: 2
api_Examples
Packages
********
@@ -60,9 +58,9 @@ Packages
:maxdepth: 3
em/index
mt/index
flow/index
Finite Volume
*************
+19
View File
@@ -0,0 +1,19 @@
Magnetotellurics
****************
SimPEG (Simulation and Parameter Estimation in Geophysics) is a python
package for simulation and gradient based parameter estimation in the
context of geoscience applications.
simpegMT uses SimPEG as the framework for the forward and inverse
magnetotellurics geophysical problems.
Problem
=======
.. autoclass:: SimPEG.MT.BaseMT.BaseMTProblem
:show-inheritance:
:members:
:undoc-members: