watex.utils.plotutils.plot_profiling#

watex.utils.plotutils.plot_profiling(erp, /, station=None, cz=None, *, style='classic', fig_size=(10, 4), cz_plot_kws=None, marker_kws=None, savefig=None, ax=None, fig=None, **plot_kws)[source]#

Visualizes the resistivity profiling of ERP data.

Function can overlain the selected conductive zone to the ERP if cz is given.

Parameters

  • erp (array_like 1d) –

    The electrical resistivity profiling array. If dataframe is passed, resistivity column must be included.

    Changed in version 0.2.1: Can henceforth accept dataframe that contains resistivity values.

  • station (str, int, optional) –

    Station is used to visualize the conductive zone in the erp profile.

    This seems useful if cz is not given. When station=’auto’ it automatically detect the best conductive zone assuming the very low resistivity in the profile and plot the conductive zone. To have the expected results, station position or cz must be given or the .

    New in version 0.2.1: Can henceforth pass the station to plot the conductive zone.

  • cz (array_like, optional,) – The selected conductive zone. If None, cz should not be plotted.

  • style (str, default='classic') – Matplotlib plottings style.

  • fig_size (tuple, default= (10, 4)) – Matplotlib figure size.

  • marker_kws (dict, default = {'marker':'o', 'c':'#9EB3DD' }) – The dictionnary to customize marker in the plot

  • cz_plot_kws (dict, default = {'ls':'-','c':'#0A4CEE', 'lw'L2 }) – The dictionnary to customize the conductize zone in the plot.

  • savefig (str, optional) – Save figure name. The default resolution dot-per-inch is 300.

  • ax (Matplotlib.pyplot.Axes, optional) –

    Axe to collect the figure.

    New in version 0.2.8.

fig: Matplotlib.pyplot.figure, optional

Supply fig to save automatically the plot, otherwise, keep it to None.

plot_kws: dict,

Additional keyword arguments passed to matplotlib.pyplot.plot() function

Returns

ax – Return axis

Return type

Matplotlib.pyplot.Axis

Examples

>>> from watex.datasets import make_erp
>>> from watex.utils.plotutils import plot_profiling
>>> d= make_erp (n_stations =56, seed = 42)
>>> plot_profiling  (d.resistivity)
>>> # read the frame and get the resistivity values
>>> plot_profiling (d.frame, station ='s07' )
<AxesSubplot:xlabel='Stations', ylabel='App.resistivity ($\Omega.m$)'>