ó mÜJ]c@`swdZddlmZmZmZmZddlZejeƒZ ddl Z ddl m Z ddl mZddlmZddlmZmZdd lmZdd lmZmZmZmZmZmZmZd Zd„Zd„Z d„Z!d„Z"dddddde$d„Z%gdddd„Z&de'fd„ƒYZ(d„Z)d„Z*dd„Z+d„Z,dS(!u0 Functions for arranging bokeh layout objects. i(tabsolute_importtdivisiontprint_functiontunicode_literalsN(t namedtuple(t string_typesi(tLocation(t ProxyToolbart ToolbarBox(tPlot(t LayoutDOMtBoxtRowtColumntGridBoxtSpacert WidgetBoxucolumnugridugridplotuGridSpeculayouturowuSpaceru widgetboxcO`sÂ|jddƒ}|jddƒ}td||Œ}g}xm|D]e}t|tƒrŒ|dk r|t|ƒr|||_n|j|ƒqCtd|t |ƒfƒ‚qCWt d|d||S(uà Create a row of Bokeh Layout objects. Forces all objects to have the same sizing_mode, which is required for complex layouts to work. Args: children (list of :class:`~bokeh.models.layouts.LayoutDOM` ): A list of instances for the row. Can be any of the following - :class:`~bokeh.models.plots.Plot`, :class:`~bokeh.models.widgets.widget.Widget`, :class:`~bokeh.models.layouts.Row`, :class:`~bokeh.models.layouts.Column`, :class:`~bokeh.models.tools.ToolbarBox`, :class:`~bokeh.models.layouts.Spacer`. sizing_mode (``"fixed"``, ``"stretch_both"``, ``"scale_width"``, ``"scale_height"``, ``"scale_both"`` ): How will the items in the layout resize to fill the available space. Default is ``"fixed"``. For more information on the different modes see :attr:`~bokeh.models.layouts.LayoutDOM.sizing_mode` description on :class:`~bokeh.models.layouts.LayoutDOM`. Returns: Row: A row of LayoutDOM objects all with the same sizing_mode. Examples: >>> row([plot_1, plot_2]) >>> row(children=[widget_box_1, plot_1], sizing_mode='stretch_both') u sizing_modeuchildrentchildrenuOOnly LayoutDOM items can be inserted into a row. Tried to insert: %s of type %st sizing_modeN( tpoptNonet_handle_childrent isinstanceR t_has_auto_sizingRtappendt ValueErrorttypeR (targstkwargsRRt row_childrentitem((s,lib/python2.7/site-packages/bokeh/layouts.pytrow7s   cO`sÂ|jddƒ}|jddƒ}td||Œ}g}xm|D]e}t|tƒrŒ|dk r|t|ƒr|||_n|j|ƒqCtd|t |ƒfƒ‚qCWt d|d||S(uÑ Create a column of Bokeh Layout objects. Forces all objects to have the same sizing_mode, which is required for complex layouts to work. Args: children (list of :class:`~bokeh.models.layouts.LayoutDOM` ): A list of instances for the column. Can be any of the following - :class:`~bokeh.models.plots.Plot`, :class:`~bokeh.models.widgets.widget.Widget`, :class:`~bokeh.models.layouts.Row`, :class:`~bokeh.models.layouts.Column`, :class:`~bokeh.models.tools.ToolbarBox`, :class:`~bokeh.models.layouts.Spacer`. sizing_mode (``"fixed"``, ``"stretch_both"``, ``"scale_width"``, ``"scale_height"``, ``"scale_both"`` ): How will the items in the layout resize to fill the available space. Default is ``"fixed"``. For more information on the different modes see :attr:`~bokeh.models.layouts.LayoutDOM.sizing_mode` description on :class:`~bokeh.models.layouts.LayoutDOM`. Returns: Column: A column of LayoutDOM objects all with the same sizing_mode. Examples: >>> column([plot_1, plot_2]) >>> column(children=[widget_1, plot_1], sizing_mode='stretch_both') u sizing_modeuchildrenRuROnly LayoutDOM items can be inserted into a column. Tried to insert: %s of type %sRN( RRRRR RRRRRR (RRRRt col_childrenR((s,lib/python2.7/site-packages/bokeh/layouts.pytcolumnds   cO`sÂ|jddƒ}|jddƒ}td||Œ}g}xm|D]e}t|tƒrŒ|dk r|t|ƒr|||_n|j|ƒqCtd|t |ƒfƒ‚qCWt d|d||S(u& Create a column of bokeh widgets with predefined styling. Args: children (list of :class:`~bokeh.models.widgets.widget.Widget`): A list of widgets. sizing_mode (``"fixed"``, ``"stretch_both"``, ``"scale_width"``, ``"scale_height"``, ``"scale_both"`` ): How will the items in the layout resize to fill the available space. Default is ``"fixed"``. For more information on the different modes see :attr:`~bokeh.models.layouts.LayoutDOM.sizing_mode` description on :class:`~bokeh.models.layouts.LayoutDOM`. Returns: WidgetBox: A column layout of widget instances all with the same ``sizing_mode``. Examples: >>> widgetbox([button, select]) >>> widgetbox(children=[slider], sizing_mode='scale_width') u sizing_modeuchildrenRuVOnly LayoutDOM items can be inserted into a widget box. Tried to insert: %s of type %sRN( RRRRR RRRRRR(RRRRR R((s,lib/python2.7/site-packages/bokeh/layouts.pyt widgetbox‘s   cO`sF|jddƒ}|jddƒ}td||Œ}t|||S(uT Create a grid-based arrangement of Bokeh Layout objects. Args: children (list of lists of :class:`~bokeh.models.layouts.LayoutDOM` ): A list of lists of instances for a grid layout. Can be any of the following - :class:`~bokeh.models.plots.Plot`, :class:`~bokeh.models.widgets.widget.Widget`, :class:`~bokeh.models.layouts.Row`, :class:`~bokeh.models.layouts.Column`, :class:`~bokeh.models.tools.ToolbarBox`, :class:`~bokeh.models.layouts.Spacer`. sizing_mode (``"fixed"``, ``"stretch_both"``, ``"scale_width"``, ``"scale_height"``, ``"scale_both"`` ): How will the items in the layout resize to fill the available space. Default is ``"fixed"``. For more information on the different modes see :attr:`~bokeh.models.layouts.LayoutDOM.sizing_mode` description on :class:`~bokeh.models.layouts.LayoutDOM`. Returns: Column: A column of ``Row`` layouts of the children, all with the same sizing_mode. Examples: >>> layout([[plot_1, plot_2], [plot_3, plot_4]]) >>> layout( children=[ [widget_1, plot_1], [slider], [widget_2, plot_2, plot_3] ], sizing_mode='fixed', ) u sizing_modeuchildrenRN(RRRt _create_grid(RRRR((s,lib/python2.7/site-packages/bokeh/layouts.pytlayout¶s"uabovecC`sÇ|dkri}n|r@tt|ƒs@td|ƒ‚q@ntd|ƒ}|r’td„|Dƒƒrztdƒ‚ntt||ƒƒ}n|s¡g}ng}g} x(t|ƒD]\} } x t| ƒD]ý\} } | dkrñqÓqÓt | t ƒrÄ|rEx<| j t dt ƒƒD]}||jj7}d|_qWnt | t ƒr‡|dk rl|| _n|dk r‡|| _q‡n|dk r«t| ƒr«|| _n| j| | | fƒqÓtdƒ‚qÓWqºW| sæ| rùtd| d|ƒStd| ƒ}td||}td |d |ƒ}|d krTtd||gd|ƒS|d krytd||gd|ƒS|d kržtd||gd|ƒS|dkrÃtd||gd|ƒSdS(u© Create a grid of plots rendered on separate canvases. The ``gridplot`` function builds a single toolbar for all the plots in the grid. ``gridplot`` is designed to layout a set of plots. For general grid layout, use the :func:`~bokeh.layouts.layout` function. Args: children (list of lists of :class:`~bokeh.models.plots.Plot` ): An array of plots to display in a grid, given as a list of lists of Plot objects. To leave a position in the grid empty, pass None for that position in the children list. OR list of :class:`~bokeh.models.plots.Plot` if called with ncols. OR an instance of GridSpec. sizing_mode (``"fixed"``, ``"stretch_both"``, ``"scale_width"``, ``"scale_height"``, ``"scale_both"`` ): How will the items in the layout resize to fill the available space. Default is ``"fixed"``. For more information on the different modes see :attr:`~bokeh.models.layouts.LayoutDOM.sizing_mode` description on :class:`~bokeh.models.layouts.LayoutDOM`. toolbar_location (``above``, ``below``, ``left``, ``right`` ): Where the toolbar will be located, with respect to the grid. Default is ``above``. If set to None, no toolbar will be attached to the grid. ncols (int, optional): Specify the number of columns you would like in your grid. You must only pass an un-nested list of plots (as opposed to a list of lists of plots) when using ncols. plot_width (int, optional): The width you would like all your plots to be plot_height (int, optional): The height you would like all your plots to be. toolbar_options (dict, optional) : A dictionary of options that will be used to construct the grid's toolbar (an instance of :class:`~bokeh.models.tools.ToolbarBox`). If none is supplied, ToolbarBox's defaults will be used. merge_tools (``True``, ``False``): Combine tools from all child plots into a single toolbar. Returns: Row or Column: A row or column containing the grid toolbar and the grid of plots (depending on whether the toolbar is left/right or above/below. The grid is always a Column of Rows of plots. Examples: >>> gridplot([[plot_1, plot_2], [plot_3, plot_4]]) >>> gridplot([plot_1, plot_2, plot_3, plot_4], ncols=2, plot_width=200, plot_height=100) >>> gridplot( children=[[plot_1, plot_2], [None, plot_3]], toolbar_location='right' sizing_mode='fixed', toolbar_options=dict(logo='gray') ) u%Invalid value of toolbar_location: %sRcs`s|]}t|tƒVqdS(N(Rtlist(t.0tchild((s,lib/python2.7/site-packages/bokeh/layouts.pys #su-Cannot provide a nested list when using ncolsRu0Only LayoutDOM items can be inserted into a gridRttoolsttoolbarttoolbar_locationuaboveubelowulefturightN(RthasattrRRRtanyR%t_chunkst enumerateRR tselecttdictR R)R(R*t plot_widtht plot_heightRRRRRRR R (RRR*tncolsR1R2ttoolbar_optionst merge_toolsR(titemstyRtxRtplottgridtproxyR)((s,lib/python2.7/site-packages/bokeh/layouts.pytgridplotàsZ:            c `s»tddgƒ‰tddgƒ‰‡‡fd†}t|tƒrñ|d k s]|d k rÊt|ƒ}|d kr‹tj||ƒ}nˆgtd||ƒD]}ˆ||||!ƒ^q¡ƒ}q]d‡‡‡fd†‰ˆ|ƒ}nlt|tƒr9d„‰t ‡‡‡‡fd†‰ˆ|d t ƒ}n$t|t ƒrQt ‚n t d ƒ‚||ƒ}|d k r·||_x6|jD](} | d}t|ƒrˆ||_qˆqˆWn|S( u¿ Conveniently create a grid of layoutable objects. Grids are created by using ``GridBox`` model. This gives the most control over the layout of a grid, but is also tedious and may result in unreadable code in practical applications. ``grid()`` function remedies this by reducing the level of control, but in turn providing a more convenient API. Supported patterns: 1. Nested lists of layoutable objects. Assumes the top-level list represents a column and alternates between rows and columns in subsequent nesting levels. One can use ``None`` for padding purpose. >>> grid([p1, [[p2, p3], p4]]) GridBox(children=[ (p1, 0, 0, 1, 2), (p2, 1, 0, 1, 1), (p3, 2, 0, 1, 1), (p4, 1, 1, 2, 1), ]) 2. Nested ``Row`` and ``Column`` instances. Similar to the first pattern, just instead of using nested lists, it uses nested ``Row`` and ``Column`` models. This can be much more readable that the former. Note, however, that only models that don't have ``sizing_mode`` set are used. >>> grid(column(p1, row(column(p2, p3), p4))) GridBox(children=[ (p1, 0, 0, 1, 2), (p2, 1, 0, 1, 1), (p3, 2, 0, 1, 1), (p4, 1, 1, 2, 1), ]) 3. Flat list of layoutable objects. This requires ``nrows`` and/or ``ncols`` to be set. The input list will be rearranged into a 2D array accordingly. One can use ``None`` for padding purpose. >>> grid([p1, p2, p3, p4], ncols=2) GridBox(children=[ (p1, 0, 0, 1, 1), (p2, 0, 1, 1, 1), (p3, 1, 0, 1, 1), (p4, 1, 1, 1, 1), ]) urowuchildrenucolc`sítddddddgƒ‰tddd d gƒ‰d „‰‡fd †‰d „‰‡‡‡‡‡‡‡fd†‰ˆ|ƒ}g}xS|jD]H\}}}}}|dk r”|j|||||||fƒq”q”Wtd|ƒS(NuItemulayoutur0uc0ur1uc1uGridunrowsuncolsuitemscS`sAt|ƒt|ƒ}}x!|dkr<|||}}qW|S(Ni(tabs(tatb((s,lib/python2.7/site-packages/bokeh/layouts.pytgcdŽsc`s,x%|D]}||ˆ||ƒ}qW|S(N((R>trestR?(R@(s,lib/python2.7/site-packages/bokeh/layouts.pytlcm”s cS`s|jdko|jdkS(Ni(tnrowsR3(R'((s,lib/python2.7/site-packages/bokeh/layouts.pyt™tc `sit|ˆƒr ttˆtˆ|jƒƒƒ}|sFˆddgƒSˆg|D]}|j^qPŒ}tg|D]}|j^qrƒ}g}d}xw|D]o}||j}xL|jD]A\}}} } } |j |||| ||| | |fƒqºW||j7}qWˆ|||ƒSt|ˆƒr@ttˆtˆ|jƒƒƒ}|sfˆddgƒStg|D]}|j^qpƒ}ˆg|D]}|j^q’Œ}g}d}xw|D]o}||j}xL|jD]A\}}} } } |j ||||| | ||| fƒqÚW||j7}q½Wˆ|||ƒSˆddˆ|ddddƒgƒSdS(Nii( RR%tfiltertmapRRCtsumR3R6R( R$RR'RCR3R6toffsettfactortr0tc0tr1tc1(tGridtItemt_flattentcolRBtnonemptyR(s,lib/python2.7/site-packages/bokeh/layouts.pyRQ›s:!""  0!""  0R(RR6RRR(R$R:RRKRLRMRN(RRR(RORPRQR@RBRSs,lib/python2.7/site-packages/bokeh/layouts.pytflattenŠs  !*  +ic`s]t|tƒrU|ddkr%ˆnˆ}|g|D]}ˆ||dƒ^q5ƒS|SdS(Niii(RR%(Rtlevelt containerR'(RRRttraverse(s,lib/python2.7/site-packages/bokeh/layouts.pyRWÕs*cS`st|ƒo|jdkS(Ni(Rtspacing(R'((s,lib/python2.7/site-packages/bokeh/layouts.pyt is_usableÞsc`s`t|tƒrX|s!ˆ|ƒrXt|tƒr6ˆnˆ}|ttˆ|jƒƒƒS|SdS(N(RR R R%RGR(Rt top_levelRV(RRRYRRW(s,lib/python2.7/site-packages/bokeh/layouts.pyRWás!RZu expected a list, string or modelN(RRR%RtlentmathtceiltrangeR tFalsetTrueRtNotImplementedErrorRRRR( RRRCR3RTtNtiR$R:R'((RRRYRRWs,lib/python2.7/site-packages/bokeh/layouts.pyR:Vs41D  ?        tGridSpeccB`s)eZdZd„Zd„Zd„ZRS(u' Simplifies grid layout specification. cC`s||_||_i|_dS(N(RCR3t _arrangement(tselfRCR3((s,lib/python2.7/site-packages/bokeh/layouts.pyt__init__s  c `sR|\}}t|tƒr9|j|jƒ\‰}}nS|dkrU||j7}n||jksp|dkrtdƒ‚n|d‰}t|tƒr¹|j|jƒ\‰}}nS|dkrÕ||j7}n||jksð|dkrÿtdƒ‚n|d‰}d„}|dkrC|dkrCˆ|jˆˆf s<"  4 - - % * u¨>