.. DO NOT EDIT.
.. THIS FILE WAS AUTOMATICALLY GENERATED BY SPHINX-GALLERY.
.. TO MAKE CHANGES, EDIT THE SOURCE PYTHON FILE:
.. "glr_examples/utils/plot_confidence_in_data.py"
.. LINE NUMBERS ARE GIVEN BELOW.

.. only:: html

    .. note::
        :class: sphx-glr-download-link-note

        :ref:`Go to the end <sphx_glr_download_glr_examples_utils_plot_confidence_in_data.py>`
        to download the full example code or to run this example in your browser via Binder

.. rst-class:: sphx-glr-example-title

.. _sphx_glr_glr_examples_utils_plot_confidence_in_data.py:


===================================
Plot confidence in EM data
===================================

plot the confidence in the data to determine the 
weak and useless signals for restoring or deleting.  

.. GENERATED FROM PYTHON SOURCE LINES 9-12

.. code-block:: Python

    # Author: L.Kouadio 
    # Licence: BSD-3-clause








.. GENERATED FROM PYTHON SOURCE LINES 13-40

The default tensor for evaluating the data confidence is the resistivity 
at TE mode ('xy'). 

Check confidence in the data before starting the concrete processing 
seems meaningful. In the area with complex terrain, with high topography 
addition to interference noises, signals are weals or missing 
especially when using :term:`AMT` survey. The most common technique to 
do this is to eliminate the bad frequency and interpolate the remains one. 
However, the tricks for eliminating frequency differ from one author 
to another. Here, the tip using the data confidence seems meaningful
to indicate which frequencies to eliminate (at which stations/sites)
and which ones are still recoverable using the tensor recovering 
strategy (:meth:`~watex.methods.Processing.zrestore`)  

The plot implements three levels of confidence: 

- High confidence: :math:`conf. \geq 0.95` values greater than 95% 
- Soft confidence: :math:`0.5 \leq conf. < 0.95`. The data in this 
  confidence range can be beneficial for tensor recovery to restore 
  the weak and missing signals. 
- bad confidence: :math:`conf. <0.5`. Data in this interval must be 
  deleted.
In the following, we used 25 samples of :term:`EDI` data from a locality 
where :term:`AMT` data is collected with strong interference noises.  
%% 
* Plot confidence in two-dimensional view
Two-dimensional view is ensured by the parameter ``view`` set to ``2d``. 

.. GENERATED FROM PYTHON SOURCE LINES 40-45

.. code-block:: Python

    import watex as wx 
    from watex.utils import plot_confidence_in
    edi_data= wx.fetch_data ( 'huayuan', samples = 25, key='raw', return_data =True, clear_cache =True)
    plot_confidence_in (edi_data , distance =20 ,  view ='2d', figsize =(6, 2)
                         )



.. image-sg:: /glr_examples/utils/images/sphx_glr_plot_confidence_in_data_001.png
   :alt: plot confidence in data
   :srcset: /glr_examples/utils/images/sphx_glr_plot_confidence_in_data_001.png
   :class: sphx-glr-single-img


.. rst-class:: sphx-glr-script-out

 .. code-block:: none


    <AxesSubplot:xlabel='Distance(m)', ylabel='Frequency[$H_z$]'>



.. GENERATED FROM PYTHON SOURCE LINES 46-50

* Plot one-dimensional confidency in :term:`EDI` data 
Turn of ``view`` parameter to ``None`` to visualize the one dimensional 
view or use any other value passed to the ``view`` parameter. 
Here is an example in confidencity plot in 1D. 

.. GENERATED FROM PYTHON SOURCE LINES 50-50

.. code-block:: Python

    plot_confidence_in (edi_data , distance =20 ,  figsize =(6, 3),fontsize =5,)


.. image-sg:: /glr_examples/utils/images/sphx_glr_plot_confidence_in_data_002.png
   :alt: plot confidence in data
   :srcset: /glr_examples/utils/images/sphx_glr_plot_confidence_in_data_002.png
   :class: sphx-glr-single-img


.. rst-class:: sphx-glr-script-out

 .. code-block:: none


    <AxesSubplot:xlabel='Distance (m)', ylabel='Confidence ratio x100 (%)'>




.. rst-class:: sphx-glr-timing

   **Total running time of the script:** (0 minutes 1.382 seconds)


.. _sphx_glr_download_glr_examples_utils_plot_confidence_in_data.py:

.. only:: html

  .. container:: sphx-glr-footer sphx-glr-footer-example

    .. container:: binder-badge

      .. image:: images/binder_badge_logo.svg
        :target: https://mybinder.org/v2/gh/watex/watex/0.3.X?urlpath=lab/tree/notebooks/glr_examples/utils/plot_confidence_in_data.ipynb
        :alt: Launch binder
        :width: 150 px

    .. container:: sphx-glr-download sphx-glr-download-jupyter

      :download:`Download Jupyter notebook: plot_confidence_in_data.ipynb <plot_confidence_in_data.ipynb>`

    .. container:: sphx-glr-download sphx-glr-download-python

      :download:`Download Python source code: plot_confidence_in_data.py <plot_confidence_in_data.py>`


.. only:: html

 .. rst-class:: sphx-glr-signature

    `Gallery generated by Sphinx-Gallery <https://sphinx-gallery.github.io>`_