-eaUdZddlmZddlZejeZddlZddlm Z ddl m Z m Z m Z mZmZmZmZmZmZmZddlmZmZmZddlmZmZdd lmZmZmZm Z m!Z!m"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.dd l/m0Z0e rdd l1m2Z2d Z3e redZ4edddedZ5edddfdZ5dddgdZ5edddhdZ6edddidZ6dddjd Z6ddd!dkd$Z7dd%ddddd&d'dld4Z8ed5ddmd8Z9ed5ddnd:Z9ed5ddod>Z9ed5ddpd?Z9ed5ddqd@Z9ed5ddrdBZ9gdddfdsdCZ9edDe)EZ:e e;e:edG<dddHdtdOZ?dudRZ@edSe$EZAddTdvdXZBdwd[ZCdxdyd_ZDed`ZEdzddZFdS){z0 Functions for arranging bokeh layout objects. ) annotationsN) defaultdict) TYPE_CHECKINGAnyCallableIterableIteratorLiteralSequenceTypeVarUnionoverload)Location LocationTypeSizingModeType) Undefined UndefinedType)ColumnCopyTool ExamineToolFlexBoxFullscreenToolGridBoxGridPlot LayoutDOMPlotRowSaveToolSpacerToolToolbar ToolProxy UIElement) dataclass)warn) TypeAlias)columngridgridplotlayoutrowr )logoautohide active_dragactive_inspect active_scroll active_tap active_multi) sizing_modechildrenlist[UIElement]r4SizingModeType | Nonekwargsrreturnrc dSNr5r4r8s -lib/python3.11/site-packages/bokeh/layouts.pyr,r,Vshkhkr$cdSr;r<r4r5r8s r>r,r,Xs`c`cr?UIElement | list[UIElement]ct|d|ddi}t||dtd||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') r5Nr,widgetr5r4r<)_parse_children_argpop_handle_child_sizingrr4r5r8 _childrens r>r,r,[sT4$XU :t8T8TUUIK>>>>  E { E Ef E EEr?rc dSr;r<r=s r>r(r(ysnqnqr?cdSr;r<rAs r>r(r({sfifir?ct|d|ddi}t||dtd||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') r5Nr(rDrFr<)rGrHrIrrJs r>r(r(~sT4$XU :t8T8TUUIKAAAA  H9+ H H H HHr?rFargslist[UIElement] | Nonec6t|d|i}t||fi|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', ) r5)rG _create_grid)r5r4rOr8rKs r>r+r+s/B$T=H==I  ; 9 9& 9 99r?aboveT)r4toolbar_locationncolswidthheighttoolbar_options merge_toolslist[list[UIElement | None]]rTLocationType | NonerU int | NonerVrWrX dict[ToolbarOptions, Any] | NonerYboolrc Li|r'tt|std|t|}|rEt d|Drtdt t ||}|sg}g}g} t|D]\} } t| D]\} } | t| tr|rL| ttD]#}| |jd|_$||| _||| _|t%| r|| _| | | | ft| t(rtdd'd}g}|D]}||j|rt/||}d|D}d|D}d|D}d|D}d|D}d|D}d|D}t1d}d(fd }||d}||d}||d }||d!}||d"}||d#} ||d$}!t3||||||| |!%}t5| |||&}"|"S))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: r5c3@K|]}t|tVdSr; isinstancelist.0childs r> zgridplot..s,==5z%&&======r?z-Cannot provide a nested list when using ncols)typez>Only UIElement and LayoutDOM items can be inserted into a gridcls type[Tool]group list[Tool]r9Tool | ToolProxy | Nonecjt|ttttfr |SdSr;) issubclassrrrr)rjrls r>mergezgridplot..merge,s- cHh ^L M M 355L4r?)rqcg|] }|j Sr<)r-rftoolbars r> zgridplot..:s 4 4 4wgl 4 4 4r?cg|] }|j Sr<)r.rss r>ruzgridplot..;s<<ruzgridplot..<sBBBWW(BBBr?cg|] }|j Sr<)r0rss r>ruzgridplot..=sHHH7.HHHr?cg|] }|j Sr<)r1rss r>ruzgridplot..>sFFFw,FFFr?cg|] }|j Sr<)r2rss r>ruzgridplot..?s@@@7G&@@@r?cg|] }|j Sr<)r3rss r>ruzgridplot..@sDDDwg*DDDr?Vvalueslist[V]nameToolbarOptionsV | UndefinedTypec|vr|Stt|}|dkrtS|dkrtd|d|dS)Nrrz-found multiple competing values for 'toolbar.z"' property; using the latest value)lensetrr&)r}rnrXs r> assert_uniquezgridplot..assert_uniqueCsh ? " ""4( ( F   66  UU iiii j j jbzr?r-r.r/r0r1r2r3)toolsr-r.r/r0r1r2r3)r5rtrTr4)rjrkrlrmr9rn)r}r~rrr9r)hasattrr ValueErrorrGanyrd_chunks enumeratercrselectdictrappendrtrTrVrW_has_auto_sizingr4r$extendr group_toolsr r"r)#r5r4rTrUrVrWrXrYtoolbarsitemsyr,xitemplotrqrrtlogos autohides active_dragsactive_inspectsactive_scrolls active_taps active_multisr|rr-r.r/r0r1r2r3gps# ` r>r*r*s|Wx!122 WUCSUUVV V"H555H 2 ==H=== = = NLMM M%0011 !H.0EH%%cc3 ~~ c cGAt|D),, c5 $ DdOOO < <55  55504--$!&DJ%"(DK*/?/E/E*'2D$ dAq\****D),, c !abbb+ c. %'E$$ W]####0E/// 4 4( 4 4 4E<<(<<r)r)js{~{~r? Row | ColumncdSr;r<rFs r>r)r)lsZ]Z]r?list[UIElement | None]nrowsintcdSr;r<)r5r4rs r>r)r)npspsr?cdSr;r<)r5r4rUs r>r)r)prr?cdSr;r<)r5r4rrUs r>r)r)rs||r?strcdSr;r<rFs r>r)r)tsQTQTr?c& tGdd tGdd tGdd tGdd d fd }ttrj|Qt}t j||z   fd t d|D}nqd d! fd }n\ttrd"d d#d$ fd d}n+ttrttd||}|/||_ |j D] }|d}t|r||_ !|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), ]) ceZdZUded<dS)grid..rowlist[row | col]r5N__name__ __module__ __qualname____annotations__r<r?r>r,r!!!!!!r?r,ceZdZUded<dS)grid..colrr5Nrr<r?r>colrrr?rcBeZdZUded<ded<ded<ded<ded<dS) grid..Itemrr+rr0c0r1c1Nrr<r?r>Itemrs@r?rc.eZdZUded<ded<ded<dS)grid..GridrrrUz list[Item]rNrr<r?r>Gridrs0  r?rr9rc "dddfd dd d   fd |}g}|jD]L}|jC||j|j|j|j|jz |j|jz fMt|S)Narbr9cht|t|}}|dkr |||z}}|dk |SNr)abs)rrs r>gcdz"grid..flatten..gcds=q663q66qAq&&!a%1q&&Hr?restc6|D]}||z||z}|Sr;r<)rrrrs r>lcmz"grid..flatten..lcms1 ' 'qSSSAYY&Hr?rgrr^c.|jdko |jdkSr)rrUrgs r>nonemptyz'grid..flatten..nonemptys;!#8 q(8 8r?r+row | col | LayoutDOMc t|rttt |j}|s  ddgS d|D}t d|D}g}d}|D]g}||jz}|jD]I}| |j ||j z|j |z||j z|j |zJ||jz }h |||St| rttt |j}|s  ddgSt d|D} d|D}g}d}|D]g}||jz}|jD]I}| |j |j |z||j z|j |z||j zJ||jz }h |||S dd |ddddgS)Nrcg|] }|j Sr<rres r>ruz;grid..flatten.._flatten..BBBuu{BBBr?c3$K|] }|jV dSr;rUres r>rhz:grid..flatten.._flatten..$>>EEK>>>>>>r?c3$K|] }|jV dSr;rres r>rhz:grid..flatten.._flatten..rr?cg|] }|j Sr<rres r>ruz;grid..flatten.._flatten..rr?r)rcrdfiltermapr5sumrrrr+rrrrrU)r+r5rrUroffsetrgfactorirr_flattenrrrr,s r>rz'grid..flatten.._flattens~&#&&' >xXv1O1O P PQQ*41b>>)BBBBBC>>X>>>>>$&%**E"EK/F"[mm TT!(F14KPVWXW[P[]^]adj]j%k%kllllek)FFtE5%000FC(( >xXv1O1O P PQQ*41b>>)>>X>>>>>BBBBBC%**E"EK/F"[mm TT!(AD6M6!$;PQPTW]P]_efgfj_j%k%kllllek)FFtE5%000tAq441a#;#;"<===r?r`)rrrrr9r)rrrrr9r)rgrr9r^)r+rr9r)rr+rrrrrr) r+r)r5rrrrrrrrr,s @@@@r>flattenzgrid..flattens             9 9 9 9( >( >( >( >( >( >( >( >( >( >( >( >Tx R RAx#14qtad{AD14K PQQQ))))r?Nc<g|]}||zSr<r<)rfrr5rUr,s r>ruzgrid..s0QQQ33x!E' 233QQQr?rr5list[LayoutDOM]levelrc~t|tr%dzdkrn}|fd|DS|S)Nrc.g|]}|dzS)rr<)rfrgrtraverses r>ruz*grid..traverse.. s)%W%W%WExxuQw'?'?%W%W%Wr?rb)r5r containerrr,rs ` r>rzgrid..traversesXh--$',qyA~~3I$9%W%W%W%W%WX%W%W%WXXX#Or?rgrr^c6t|o |jdkSr)rspacingrs r> is_usablezgrid..is_usables#E**Au}/A Ar?Fr top_levelct|trQ|s |rDt|trn}|tt |jS|Sr;)rcrrrdrr5)rrrrrr,rs r>rzgrid..traversesl$(( i 99T?? #-dF#;#;DCC  yc(DM&B&B!C!CDDD r?T)rz expected a list, string or model)r9rr)r5rrr)rgrr9r^)F)rrrr^)r%rcrdrmathceilrangerrNotImplementedErrorrr4r5r)r5r4rrUrNr+r)rgrrrrr,rs` ` @@@@@@r>r)r)wsb"""""""Y""""""""Y"YY @*@*@*@*@*@*@*@*@*F(D!!=   1H A} !E'**SQQQQQQU1a=O=OQQQRRFF $ $ $ $ $ $ $ $ $Xh''FF Hi ( (= B B B B          (d333 Hc " "=!!;<<< 76??D&] 1 1E1XF'' 1%0" Kr?T)boundr'MergeFn)rqignorerlist[Tool | ToolProxy]rqMergeFn[Tool] | Nonerset[str] | NonectGdd}tt}g}|ddh}|D]w}t|tr||-|}|D] }||vr||= ||j|||x|D]$\} } |.|| d| D} | || 6| r| ^} } | j g}t| D]A}|j | j kr/||j | |B| | t|dkr||dnI|$|| |x}||n#|t | | &|S) z' Group common tools into tool proxies. c$eZdZUded<ded<dS)group_tools..ToolEntryr!toolrpropsNrr<r?r> ToolEntryr6s"  r?rNoverlay rendererscg|] }|j Sr<)r)rfentrys r>ruzgroup_tools..Ms A A A A A Ar?rr)r) r%rrdrcr#rproperties_with_values __class__rrrremover)rrqrrby_typecomputedrrattrrjentriesmergedheadtailrlrs r>rr3sIY9DD8I8IG')H ~[)CC dI & & C OOD ! ! ! !//11E $ $5==d DN # * *99T5+A+A B B B B 88 W  U3 A A A A ABBF!''' 8!KD4!% ET  ) ):++LL+++NN4((( NN4 5zzQa))))"c50A0A(A'N%%%%  6 6 6777 8 Or?rrc@|jduo|jdko |jdkS)Nauto)r4 width_policy height_policy)rs r>rrhs+  t # d(9V(C dHZ^dHddr?Lr` L | list[L]list[L] | Nonelist[L]ct|dkr|td|s=t|dkr|\}t|tr|St|S|S)Nrz;'children' keyword cannot be used with positional argumentsr)rrrcrd)r5rOargs r>rGrGlsk 4yy1}}-VWWW  t99>>ES#t$$  Dzz Or?rENonec |D]j}t|trt|ts%td|d|dt ||t |r||_kdS)Nz,Only LayoutDOM items can be inserted into a z. Tried to insert: of type )rcr$rrrirr4)r5r4rErs r>rIrI{s++ dI & &  $ ** DCFCCgkCCvz{wAwACCDD D  "'7'='= "*D  ++r?iterable%Iterable[UIElement | list[UIElement]]layerc g}|D]}t|tr(|t|||dz?t|tr.|t |r||_||t|tr||td|dt||dzdkrtd||d|Std||d|S) z)Recursively create grid from input lists.rNzUOnly LayoutDOM items can be inserted into a layout. Tried to insert: rrrrFr<) rcrdrrRrrr4r$rrir(r,)r r4r"r8 return_listrs r>rRrRs>#%K   dD ! !    |D+uqyII J J J J i ( ( &+;D+A+A&#.   t $ $ $ $ i ( (    t $ $ $ $@"&@@15d@@  qyA~~N{ NNvNNNKK[KKFKKKr?Il Sequence[I]Iterator[Sequence[I]]c#Kt|ts Jdtdt||D]}||||zVdS)z-Yield successive n-sized chunks from list, l.zncols must be an integerrN)rcrrr)r&rUrs r>rrsk eS ! !==#==== 1c!ffe $ $1u9 or?)r5r6r4r7r8rr9r)r5r$r4r7r8rr9r)r5rBr4r7r8rr9r)r5r6r4r7r8rr9r)r5r$r4r7r8rr9r)r5rBr4r7r8rr9r) rOr$r5rPr4r7r8rr9r)r5rZr4r7rTr[rUr\rVr\rWr\rXr]rYr^r9r)r5rr4r7r9r)r5rr4r7r9r)r5rr4r7rrr9r)r5rr4r7rUrr9r) r5rr4r7rrrUrr9r)r5rr4r7r9r) r5rr4r7rr\rUr\r9r)rrrqrrrr9r)rrr9r^)rOrr5rr9r)r5r6r4r7rErr9rr)r r!r4r7r"rr9r)r&r'rUrr9r()G__doc__ __future__rlogging getLoggerrlogr collectionsrtypingrrrrr r r r r r core.enumsrrrcore.property.singletonsrrmodelsrrrrrrrrrrrr r!r"r#r$util.dataclassesr% util.warningsr&typing_extensionsr'__all__rr,r(r+r*r)rrirdrrrrrrGrIrRr%rr<r?r>r8sZ#"""""g!! ######                        ?>>>>>>>>>>>>>>>>>$(''''',++++++  AAN  KOkkkkk k CGccccc cUYFFFFFF< NRqqqqq q FJiiiii iX\IIIIII>AEko":":":":":":L.207  !<@ ffffffR jm~~~~~ ~ IL]]]]] ] SVsssss s SVsssss s SV  @CTTTTT T$\`vzsssssr GCttAwQ0%i8M2NNOOOOOPT"&//////jeeee GCy!!!GK      ++++LLLLL, GCLLr?