B Z@sXdZddlmZmZmZddgZddZdddZdd dZd d Z d d Z ddZ dS)z.Helper functions for graphics with Matplotlib.)lrangerangelong create_mpl_axcreate_mpl_figcCs*yddlm}WntdYnX|S)z6This function is not needed outside this utils module.rNzMatplotlib is not found.)Zmatplotlib.pyplotZpyplot ImportError)pltr 9lib/python3.7/site-packages/statsmodels/graphics/utils.py _import_mpls r NcCs0|dkr"t}|}|d}n|j}||fS)aHelper function for when a single plot axis is needed. Parameters ---------- ax : Matplotlib AxesSubplot instance, optional If given, this subplot is used to plot in instead of a new figure being created. Returns ------- fig : Matplotlib figure instance If `ax` is None, the created figure. Otherwise the figure to which `ax` is connected. ax : Matplotlib AxesSubplot instance The created axis if `ax` is None, otherwise the axis that was passed in. Notes ----- This function imports `matplotlib.pyplot`, which should only be done to create (a) figure(s) with ``plt.figure``. All other functionality exposed by the pyplot module can and should be imported directly from its Matplotlib module. See Also -------- create_mpl_fig Examples -------- A plotting function has a keyword ``ax=None``. Then calls: >>> from statsmodels.graphics import utils >>> fig, ax = utils.create_mpl_ax(ax) No)r figureZ add_subplot)axrfigr r r rs % cCs|dkrt}|j|d}|S)aHelper function for when multiple plot axes are needed. Those axes should be created in the functions they are used in, with ``fig.add_subplot()``. Parameters ---------- fig : Matplotlib figure instance, optional If given, this figure is simply returned. Otherwise a new figure is created. Returns ------- fig : Matplotlib figure instance If `fig` is None, the created figure. Otherwise the input `fig` is returned. See Also -------- create_mpl_ax N)figsize)r r )rrrr r r r@s cCs|dkrt|jjd}t|ttfr6|j|}|}nXt|ttfr~g}g}x@|D]&}t ||\}}| || |qRWn|}|j |}||fS)zr Give a name or an integer and return the name and integer location of the column in a design matrix. N) rZexogshape isinstanceintrZ exog_namestuplelistmaybe_name_or_idxappendindex)idxZmodelZ exog_nameZexog_idxitemZexog_name_itemZ exog_idx_itemr r r r^s    rcCsxt|dd}|st|dd}|slt|ddg}t|dkr>dntjd}ddt|D}|dkrt|d}n|}|S) z Input can be an array or pandas-like. Will handle 1d array-like but not 2d. Returns a str for 1d data or a list of strings for 2d data. nameNcolumnsrrcSsg|]}dqS)zX%dr ).0namesr r r sz"get_data_names..r)getattrlenZseriesrrtolist)Zseries_or_dataframerrZnvarsr r r get_data_namesws   r$c KsFx@|D]8}||}||} ||} |j|| f| d|d|qW|S)z\ Annotate Axes with labels, points, offset_points according to the given index. z offset points)ZxytextZ textcoordssize)Zannotate) rlabelsZpointsZ offset_pointsr%rkwargsiZlabelZpointoffsetr r r annotate_axess r*)N)NN) __doc__Zstatsmodels.compat.pythonrrr__all__r rrrr$r*r r r r s /