watex.utils.qc#

watex.utils.qc(z_or_edis_obj_list, /, tol=0.5, *, interpolate_freq=False, return_freq=False, tensor='res', return_data=False, to_log10=False, return_qco=False)[source]#

Check the quality control in the collection of Z or EDI objects.

Analyse the data in the EDI collection and return the quality control value. It indicates how percentage are the data to be representative.

Parameters:

  • tol (float, default=.5) – the tolerance parameter. The value indicates the rate from which the data can be consider as meaningful. Preferably it should be less than 1 and greater than 0. Default is .5 means 50 %. Analysis becomes soft with higher tol values and severe otherwise.

  • interpolate_freq (bool,) – interpolate the valid frequency after removing the frequency which data threshold is under the ``1-tol``% goodness

  • return_freq (bool, default=False) – returns the interpolated frequency.

  • return_data (bool, default= False,) – returns the valid data from up to 1-tol% goodness.

  • tensor (str, default='z') – Tensor name. Can be [ resistivity|phase|z|frequency]. Impedance is used for data quality assessment.

  • to_log10 (bool, default=True) – convert the frequency value to log10.

  • qco (return) –

    retuns quality control object that wraps all usefull informations after control. The following attributes can be fetched as:

    • rate_: the rate of the quality of the data

    • component_: The selected component where data is selected for analysis By default used either xy or yx.

    • mode_: The EM mode. Either the [‘TE’|’TM’] modes

    • freqs_: The valid frequency in the data selected according to the tol parameters. Note that if interpolate_freq is True, it is used instead.

    • invalid_freqs_: Useless frequency dropped in the data during control

    • data_: Valid tensor data either in TE or TM mode.

Returns:

  • return the quality control value and interpolated frequency if

return_freq is set to True otherwise return the only the quality control ratio.

  • return the the quality control object.

Return type:

Tuple (float ) or (float, array-like, shape (N, )) or QCo

Examples

>>> import watex as wx
>>> data = wx.fetch_data ('huayuan', samples =20, return_data =True ,
                          key='raw')
>>> r,= wx.qc (data)
r
Out[61]: 0.75
>>> r, = wx.qc (data, tol=.2 )
0.75
>>> r, = wx.qc (data, tol=.1 )