U cY @s|UdZddlmZddlZeeZddlZddlm Z ddl m Z m Z m Z mZmZmZmZmZmZmZmZddlmZmZmZddlmZmZmZmZmZm Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*dd l+m,Z,e rdd l-m.Z.d Z/edd d ddddddZ0edd dddddddZ0dd dddddddZ0edd d ddddddZ1edd dddddddZ1dd dddddddZ1dddddddddd d!Z2dd"ddddd#d$d%dd&d'd'd'dd(d)d* d+d,Z3ed-d d.dd/d0d1d2Z4ed-d d3dd/d0d4d2Z4ed-d d5dd6d/d7d8d2Z4ed-d d5dd6d/d9d:d2Z4ed-d d5dd6d6d/d;dd2Z4gdddfddd'd'd/d;d?d2Z4ed@e'dAZ5e ee5ee5gee'e)dffZ6dBe7dC<ddDdEdFdEdGdHdIZ8dJd(dKdLdMZ9edNe"dAZ:ddOdPdQdRdSdTdUZ;d dd=dVdWdXdYZd_d6d`dadbdcZ?dS)ez0 Functions for arranging bokeh layout objects. ) annotationsN) defaultdict) TYPE_CHECKINGAnyCallableIterableIteratorListSequenceTypeTypeVarUnionoverload)Location LocationTypeSizingModeType)ColumnCopyTool ExamineToolFlexBoxFullscreenToolGridBoxGridPlot LayoutDOMPlotRowSaveToolSpacerToolToolbar ToolProxy UIElement) dataclass) TypeAlias)columngridgridplotlayoutrowr) sizing_modezlist[UIElement]zSizingModeType | Nonerr)childrenr*kwargsreturncKsdSNr+r*r,r/r/,lib/python3.8/site-packages/bokeh/layouts.pyr)Rsr)r"cOsdSr.r/r*r+r,r/r/r1r)TszUIElement | list[UIElement]cOs8t|d|ddi}t||ddtf||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.LayoutDOM` ): A list of instances for the row. Can be any of the following - |Plot|, :class:`~bokeh.models.Widget`, :class:`~bokeh.models.Row`, :class:`~bokeh.models.Column`, :class:`~bokeh.models.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.LayoutDOM.sizing_mode` description on :class:`~bokeh.models.LayoutDOM`. Returns: Row: A row of LayoutDOM objects all with the same sizing_mode. Examples: >>> row(plot1, plot2) >>> row(children=[widgets, plot], sizing_mode='stretch_both') r+Nr)widgetr+r*)_parse_children_argpop_handle_child_sizingrr*r+r, _childrenr/r/r1r)WsrcKsdSr.r/r0r/r/r1r%usr%cOsdSr.r/r2r/r/r1r%wscOs8t|d|ddi}t||ddtf||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.LayoutDOM` ): A list of instances for the column. Can be any of the following - |Plot|, :class:`~bokeh.models.Widget`, :class:`~bokeh.models.Row`, :class:`~bokeh.models.Column`, :class:`~bokeh.models.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.LayoutDOM.sizing_mode` description on :class:`~bokeh.models.LayoutDOM`. Returns: Column: A column of LayoutDOM objects all with the same sizing_mode. Examples: >>> column(plot1, plot2) >>> column(children=[widgets, plot], sizing_mode='stretch_both') r+Nr%r3r5)r6r7r8rr9r/r/r1r%zsr5zlist[UIElement] | None)argsr+r*r,r-cOst|d|i}t||f|S)a Create a grid-based arrangement of Bokeh Layout objects. Args: children (list of lists of :class:`~bokeh.models.LayoutDOM` ): A list of lists of instances for a grid layout. Can be any of the following - |Plot|, :class:`~bokeh.models.Widget`, :class:`~bokeh.models.Row`, :class:`~bokeh.models.Column`, :class:`~bokeh.models.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.LayoutDOM.sizing_mode` description on :class:`~bokeh.models.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', ) r+)r6 _create_grid)r+r*r;r,r:r/r/r1r(s!r(ZaboveT)r*toolbar_locationncolswidthheighttoolbar_options merge_toolszlist[list[UIElement | None]]zLocationType | Nonez int | Noneboolr) r+r*r=r>r?r@rArBr-cCs||dkr i}|r(tt|s(td|t|d}|r^tdd|DrPtdtt||}|sfg}g}g} t|D]\} } t| D]\} } | dkrqqt| t r|r| t t dD]}| |jjd|_q|dk r|| _|dk r|| _|dk r t| r || _| | | | fqt| tr,qqtdqqvd d d d d }tfd|sX|n t||di|}t| |||dS)aM 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 |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 |Plot| if called with ncols. 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.LayoutDOM.sizing_mode` description on :class:`~bokeh.models.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. width (int, optional): The width you would like all your plots to be 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.Toolbar`). If none is supplied, Toolbar's defaults will be used. merge_tools (``True``, ``False``): Combine tools from all child plots into a single toolbar. Returns: GridPlot: Examples: >>> gridplot([[plot_1, plot_2], [plot_3, plot_4]]) >>> gridplot([plot_1, plot_2, plot_3, plot_4], ncols=2, width=200, 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: r+css|]}t|tVqdSr. isinstancelist.0childr/r/r1 szgridplot..z-Cannot provide a nested list when using ncols)typez>Only UIElement and LayoutDOM items can be inserted into a gridz type[Tool]z list[Tool]clsgroupcSs t|ttttfr|SdSdSr.) issubclassrrrrrMr/r/r1merge(szgridplot..mergetoolsrQ)r+toolbarr=r*)hasattrr ValueErrorr6anyrG_chunks enumeraterFrZselectdictrextendrTrRr=r?r@_has_auto_sizingr*appendr"r group_toolsr)r+r*r=r>r?r@rArBrRitemsyr)xitemZplotrQrTr/r/r1r'sH>     $r'.z-list[UIElement | list[UIElement | list[Any]]]r)r+r*r-cCsdSr.r/r5r/r/r1r&2sr&z Row | ColumncCsdSr.r/r5r/r/r1r&4szlist[UIElement | None]int)r+r*nrowsr-cCsdSr.r/)r+r*rdr/r/r1r&6s)r+r*r>r-cCsdSr.r/)r+r*r>r/r/r1r&8s)r+r*rdr>r-cCsdSr.r/)r+r*rdr>r/r/r1r&:sstrcCsdSr.r/r5r/r/r1r&<sc stGfdddtGfdddtGdddtGfdddd d fd d }ttr|d k sd k rt}d krt||fddtd|D}n"d!dddfdd }n`ttr6dddddd"dddfdd dd}nttrHt nt d ||}|d k r||_ |j D]}|d}t |rn||_ qn|S)#a 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), ]) cseZdZUded<dS)zgrid..rowlist[row | col]r+N__name__ __module__ __qualname____annotations__r/colr)r/r1r)ps r)cseZdZUded<dS)zgrid..colrfr+Nrgr/rlr/r1rmss rmc@s6eZdZUded<ded<ded<ded<ded<dS) zgrid..Itemrr(rcr0c0r1c1Nrgr/r/r/r1Itemws rrcs&eZdZUded<ded<ded<dS)zgrid..Gridrcrdr>z list[Item]r_Nrgr/)rrr/r1Grids rsr)r-c sddddddddddfdd dd d d d d ddfdd |}g}|jD]8}|jdk rj||j|j|j|j|j|j|jfqjt|dS)Nrc)abr-cSs.t|t|}}|dkr*|||}}q|SNr)abs)rtrur/r/r1gcdsz"grid..flatten..gcd)rtrestr-cs |D]}||||}q|Sr.r/)rtryru)rxr/r1lcmsz"grid..flatten..lcmrsrCrJr-cSs|jdko|jdkSrv)rdr>rJr/r/r1nonemptysz'grid..flatten..nonemptyzrow | col | LayoutDOM)r(r-c st|rttt|j}|s0ddgSdd|D}tdd|D}g}d}|D]T}||j}|jD]4}||j ||j |j |||j |j |qt||j7}q`|||St|rttt|j}|sddgStdd|D}dd|D}g}d}|D]X}||j}|jD]6}||j |j |||j |j |||j q8||j7}q$|||Sdd|ddddgSdS) NrcSsg|] }|jqSr/rdrHr/r/r1 sz;grid..flatten.._flatten..css|] }|jVqdSr.r>rHr/r/r1rKsz:grid..flatten.._flatten..css|] }|jVqdSr.r~rHr/r/r1rKscSsg|] }|jqSr/rrHr/r/r1rsr)rFrGfiltermapr+sumrdr_r]r(rnrorprqr>) r(r+rdr>r_offsetrJZfactori)rsrr_flattenrmrzr}r)r/r1rs:    2      4 z'grid..flatten.._flattenrD)r_r(r]rnrorprqr)r(r&r+r)rsrrrmr))rrxrzr}r1flattens *  ,zgrid..flattenNcs g|]}||qSr/r/)rIr)r+r>r)r/r1rszgrid..rzlist[LayoutDOM]rc)r+levelcs>t|tr6ddkrn}|fdd|DS|SdS)Nrcsg|]}|dqS)rr/rH)rtraverser/r1rsz*grid..traverse..rE)r+r container)rmr)r)rr1rs zgrid..traverserrCr{cSst|o|jdkSrv)r\Zspacingr|r/r/r1 is_usableszgrid..is_usableF)rb top_levelcsDt|tr<|s|rrNr(r&rJr/)rsrrr+rmrr>r)rr1r&?s@1C $       T)Zboundr$MergeFnrSzlist[Tool | ToolProxy]zMergeFn[Tool] | None)rRrQr-cCsXtGddd}tt}g}|D]F}t|tr<||q"|}d|krR|d=||j|||q"|D]\}}|dk r||dd|D} | dk r|| qr|rr|^} } | j g} t| D]&} | j | j kr| | j | | q| | t | dkr|| dq|dk r@||| }dk r@||q|t| d qqr|S) z' Group common tools into tool proxies. c@seZdZUded<ded<dS)zgroup_tools..ToolEntryrtoolrpropsNrgr/r/r/r1 ToolEntrys rZoverlayNcSsg|] }|jqSr/)r)rIentryr/r/r1rszgroup_tools..rr)rR) r#rrGrFr!r]Zproperties_with_values __class__r_rrremover)rRrQrZby_typeZcomputedrrrNentriesZmergedheadtailrOrbr/r/r1r^s>         r^r)rbr-cCs|jdko|jdko|jdkS)Nauto)r*Z width_policyZ height_policy)rbr/r/r1r\+sr\LrDz L | list[L]zlist[L] | Nonezlist[L])r;r+r-cGsLt|dkr|dk rtd|sHt|dkr@|\}t|tr@|St|S|S)Nrz;'children' keyword cannot be used with positional argumentsr)rrVrFrG)r+r;argr/r/r1r6/s  r6None)r+r*r4r-c CsX|D]N}t|trqt|tss  r8z%Iterable[UIElement | list[UIElement]])iterabler*layerr-cKsg}|D]|}t|tr.|t|||dqt|trZ|dk rNt|rN||_||qt|trp||qtd|t |fq|ddkrt f||d|St f||d|SdS)z)Recursively create grid from input lists.rNzbOnly LayoutDOM items can be inserted into a layout. Tried to insert: %s of type %srrr5) rFrGr]r<rr\r*r"rVrLr%r))rr*rr,Z return_listrbr/r/r1r<Gs$       r<Iz Sequence[I]zIterator[Sequence[I]])lr>r-ccs>t|tstdtdt||D]}||||Vq"dS)z-Yield successive n-sized chunks from list, l.zncols must be an integerrN)rFrcAssertionErrorrr)rr>rr/r/r1rX_srX)r)@__doc__Z __future__rZloggingZ getLoggerrhlogr collectionsrtypingrrrrrr r r r r rZ core.enumsrrrZmodelsrrrrrrrrrrrrrr r!r"Zutil.dataclassesr#Ztyping_extensionsr$__all__r)r%r(r'r&rrrkr^r\rr6r8r<rrXr/r/r/r1sn   4H   &"u : *0