U Kv f@sPdZddlmZddgZddZdddZdd dZd d Zd d ZddZ dS)z.Helper functions for graphics with Matplotlib.)lrange create_mpl_axcreate_mpl_figcCs*zddlm}WntdYnX|S)z6This function is not needed outside this utils module.rNzMatplotlib is not found.)Zmatplotlib.pyplotZpyplot ImportError)pltr>/tmp/pip-unpacked-wheel-2v6byqio/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 : AxesSubplot, optional If given, this subplot is used to plot in instead of a new figure being created. Returns ------- fig : Figure If `ax` is None, the created figure. Otherwise the figure to which `ax` is connected. ax : AxesSubplot 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)axrfigrrrrs $ 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 : Figure, optional If given, this figure is simply returned. Otherwise a new figure is created. Returns ------- Figure If `fig` is None, the created figure. Otherwise the input `fig` is returned. See Also -------- create_mpl_ax N)figsize)r r )r rrrrrr?s cCs|dkrt|jjd}t|tr2|j|}|}nTt|ttfrvg}g}|D]&}t||\}}| || |qLn|}|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 isinstanceintZ exog_namestuplelistmaybe_name_or_idxappendindex)idxmodelZ exog_nameZexog_idxitemZexog_name_itemZ exog_idx_itemrrrr\s    rcCsxt|dd}|st|dd}|slt|ddg}t|dkr>dn|jd}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).0_rrr sz"get_data_names..r)getattrlenrrangetolist)Zseries_or_dataframenamesrZnvarsrrrget_data_namesus   r%c KsB|D]8}||}||} ||} |j|| f| d|d|q|S)z\ Annotate Axes with labels, points, offset_points according to the given index. z offset points)ZxytextZ textcoordssize)Zannotate) rlabelsZpointsZ offset_pointsr&r kwargsilabelZpointoffsetrrr annotate_axessr,)N)NN) __doc__Zstatsmodels.compat.pythonr__all__r rrrr%r,rrrrs  .