B @\H@sdZddlmZmZmZmZddlZeeZ ddl m Z m Z ddl mZmZddlmZddlmZmZmZmZmZdd lmZd Zd d Zd dZddZddZd"ddZGddde Z!ddZ"ddZ#d#ddZ$d d!Z%dS)$z0 Functions for arranging bokeh Layout objects. )absolute_importdivisionprint_functionunicode_literalsN)Location SizingMode) ProxyToolbar ToolbarBox)Plot) LayoutDOMRowColumnSpacer WidgetBox)Widget)columngridplotGridSpeclayoutrow widgetboxcOs|dd}|dd}t|t|d|i}g}x<|D]4}t|trX||_||q8td|t|fq8Wt f||d|S)a 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.WidgetBox`, :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') sizing_modefixedchildrenNz_Only LayoutDOM items can be inserted into a row. Tried to insert: %s of type %s)rr) pop_verify_sizing_mode_handle_children isinstancer rappend ValueErrortyper )argskwargsrr row_childrenitemr&,lib/python3.7/site-packages/bokeh/layouts.pyr4s     rcOs|dd}|dd}t|t|d|i}g}x<|D]4}t|trX||_||q8td|t|fq8Wt f||d|S)a 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.WidgetBox`, :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_box_1, plot_1], sizing_mode='stretch_both') rrrNzbOnly LayoutDOM items can be inserted into a column. Tried to insert: %s of type %s)rr) rrrrr rrr r!r)r"r#rrZ col_childrenr%r&r&r'rcs     rcOs|dd}|dd}t|t|d|i}g}x<|D]4}t|trX||_||q8td|t|fq8Wt f||d|S)a Create a WidgetBox of Bokeh widgets. Forces all to have the same sizing_mode, which is required for complex layouts to work. Args: children (list of :class:`~bokeh.models.widgets.widget.Widget` ): A list of widgets for the WidgetBox. 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 WidgetBox of Widget instances all with the same sizing_mode. Examples: >>> widgetbox([button, select]) >>> widgetbox(children=[slider], sizing_mode='scale_width') rrrNz]Only Widgets can be inserted into a WidgetBox. Tried to insert: %s of type %s)rr) rrrrrrrr r!r)r"r#rrZwidget_childrenr%r&r&r'rs     rcOs8|dd}|dd}t|t|d|i}t||S)a Create a grid-based arrangement of Bokeh Layout objects. Forces all objects to have the same sizing mode, which is required for complex layouts to work. Returns a nested set of Rows and Columns. 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.WidgetBox`, :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_box_1, plot_1], [slider], [widget_box_2, plot_2, plot_3] ], sizing_mode='fixed', ) rrrN)rrr _create_grid)r"r#rrr&r&r'rs $  rraboveTcCs$|dkr i}t||r.tt|s.td|t|d}|rdtdd|DrVtdtt||}|slg}g}g} x|D]} g} g} x| D]} |r| dk rx*| t t dD]}| |j j } d|_ qW| dkrd\}}x$| D]}t|t r|j}|j}PqWt||d } t| trP|| _t| t rD|r8|| _|rD|| _| | qtd qW|| }| t| |d q|Wt| |d }|s|S|rtfd |i|}t||d }|dkrt||g|d S|dkrt||g|d S|dkrt||g|d S|dkrt||g|d S|SdS)a 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') ) Nz%Invalid value of toolbar_location: %s)rcss|]}t|tVqdS)N)rlist).0Zchildr&r&r' /szgridplot..z-Cannot provide a nested list when using ncols)r!)rr)widthheightz.Only LayoutDOM items can be inserted into Grid)rrtools)toolbartoolbar_locationr)Zbelowleftright)rhasattrrr ranyr*_chunksZselectdictr r0r/r1r plot_width plot_heightrr rrr rr r )rrr1ncolsr8r9Ztoolbar_optionsZ merge_toolsr/ZrowsrZ row_toolsr$r%Zplotr-r.ZneighborZgridproxyr0r&r&r'rst:                     rc@s(eZdZdZddZddZddZdS) rz' Simplifies grid layout specification. cCs||_||_i|_dS)N)nrowsr: _arrangement)selfr<r:r&r&r'__init__tszGridSpec.__init__c s|\}}t|tr&||j\}}n6|dkr8||j7}||jksJ|dkrRtd|d}t|trz||j\}}n6|dkr||j7}||jks|dkrtd|d}dd}|dkr|dkr؈|jf<n|dkrxt|D]$|fddd|jf<qWn|dkrZxt|D]&|fddd|jf<q.WnJxHtt|t|D].\|fddd|jf<qrWdS) Nrzindex out of rangecSs y|Stk r|SXdS)N) IndexError)fndefaultr&r&r' get_or_elsesz)GridSpec.__setitem__..get_or_elsecs S)Nr&r&)colcol1objr&r'sz&GridSpec.__setitem__..cs S)Nr&r&)rFrrow1r&r'rGscsS)Nr&r&)rDrErFrrHr&r'rGs) rsliceindicesr<r@r:r=rangezip) r>keyrFZk1Zk2Zrow2_Zcol2rCr&)rDrErFrrHr' __setitem__ys4       & ( zGridSpec.__setitem__csJfddtdjD}x&jD]\\}}}||||<q&Wt|S)Ncsg|]}dgjqS)N)r:)r+rN)r>r&r' sz%GridSpec.__iter__..r)rKr<r=itemsiter)r>ZarrayrrDrFr&)r>r'__iter__szGridSpec.__iter__N)__name__ __module__ __qualname____doc__r?rOrSr&r&r&r'rqs,rcOs~|d}t|dkr&|dk r&td|szt|dkrNt|dtrN|d}n,t|dkrrt|dtrr|d}nt|}|S)Nrrz;'children' keyword cannot be used with positional argumentsr)getlenr rr*r)r"r#rr&r&r'rs   rcCs|tkrtd|dS)Nz Invalid value of sizing_mode: %s)rr )rr&r&r'rsrcCsg}x^|D]V}t|tr0|t|||dq t|trL||_||q td|t|fq W|ddkr|t||dSt ||dS)z)Recursively create grid from input lists.rzbOnly LayoutDOM items can be inserted into a layout. Tried to insert: %s of type %sr)rr) rr*rr(r rr r!rr)iterablerZlayerZ return_listr%r&r&r'r(s       r(ccsBt|tstdx*tdt||D]}||||Vq$WdS)z-Yield successive n-sized chunks from list, l.zncols must be an integerrN)rintAssertionErrorrKrY)lr:ir&r&r'r6sr6)rr)NNNNT)r)&rWZ __future__rrrrZloggingZ getLoggerrTlogZ core.enumsrrZ models.toolsr r Z models.plotsr Zmodels.layoutsr r rrrZmodels.widgetsr__all__rrrrrobjectrrrr(r6r&r&r&r' s*    //*- >