dYVUdZddlmZddlZejeZddlZddlm Z ddl m Z m Z m Z mZmZmZmZmZmZddlmZmZmZddlmZmZmZmZmZmZmZm 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 dadZ.edd dbdZ.dd dcdZ.edd dddZ/edd dedZ/dd dfdZ/ddddgd!Z0dd"ddddd#d$dhd0Z1ed1d did4Z2ed1d djd6Z2ed1d dkd:Z2ed1d dld;Z2ed1d dmd<Z2ed1d dnd>Z2gdddfdod?Z2ed@e%AZ3e e4e3e5e3gee%e'dffZ6dBe7dC<dddDdpdKZ8dqdNZ9edOe AZ:ddPdrdTZ;dsdWZdvd`Z?dS)wz0 Functions for arranging bokeh layout objects. ) annotationsN) defaultdict) TYPE_CHECKINGAnyCallableIterableIteratorSequenceTypeVarUnionoverload)Location LocationTypeSizingModeType)ColumnCopyTool ExamineToolFlexBoxFullscreenToolGridBoxGridPlot LayoutDOMPlotRowSaveToolSpacerToolToolbar ToolProxy UIElement) dataclass) TypeAlias)columngridgridplotlayoutrowr) sizing_modechildrenlist[UIElement]r)SizingModeType | Nonekwargsrreturnrc dSNr*r)r-s -lib/python3.11/site-packages/bokeh/layouts.pyr(r(Pshkhkr!cdSr0r1r)r*r-s r3r(r(Rs`c`cr4UIElement | 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') r*Nr(widgetr*r)r1)_parse_children_argpop_handle_child_sizingrr)r*r- _childrens r3r(r(UsT4$XU :t8T8TUUIK>>>>  E { E Ef E EEr4rc dSr0r1r2s r3r$r$ssnqnqr4cdSr0r1r6s r3r$r$usfifir4ct|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') r*Nr$r9r;r1)r<r=r>rr?s r3r$r$xsT4$XU :t8T8TUUIKAAAA  H9+ H H H HHr4r;argslist[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', ) r*)r< _create_grid)r*r)rDr-r@s r3r'r's/B$T=H==I  ; 9 9& 9 99r4aboveT)r)toolbar_locationncolswidthheighttoolbar_options merge_toolslist[list[UIElement | None]]rILocationType | NonerJ int | NonerKrLrMrNboolrc|i}|r'tt|std|t|}|rEt d|Drtdt t ||}|sg}g}g} t|D]\} } t| D]\} } | t| tr|rQ| ttD](}| |jjd|_)||| _||| _|t'| r|| _| | | | ft| t,rtddd }t/dd |s|nt1||i|}t3| |||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: r*c3@K|]}t|tVdSr0 isinstancelist.0childs r3 zgridplot..s,==5z%&&======r4z-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]cjt|ttttfr |SdSr0) issubclassrrrr)r^r`s r3mergezgridplot..merge&s- cHh ^L M M 355L4r4tools)rd)r*toolbarrIr))r^r_r`rar1)hasattrr ValueErrorr<anyrX_chunks enumeraterWrselectdictrextendrfrerIrKrL_has_auto_sizingr)appendr!r group_toolsr)r*r)rIrJrKrLrMrNreitemsyr(xitemplotrdrfs r3r&r&s9|Wx!122 WUCSUUVV V"H555H 2 ==H=== = = NLMM M%0011 %'E.0EH%%cc3 ~~ c cGAt|D),, c5 $ DdOOO < <55 T\%788804--$!&DJ%"(DK*/?/E/E*'2D$ dAq\****D),, c !abbb+ c. mmYEE+eSX:Y:Y:Ym]lmmG UGFVdo p p ppr4.-list[UIElement | list[UIElement | list[Any]]]rcdSr0r1r;s r3r%r%0s{~{~r4 Row | ColumncdSr0r1r;s r3r%r%2sZ]Z]r4list[UIElement | None]nrowsintcdSr0r1)r*r)r|s r3r%r%4pspsr4cdSr0r1)r*r)rJs r3r%r%6rr4cdSr0r1)r*r)r|rJs r3r%r%8s||r4strcdSr0r1r;s r3r%r%:sQTQTr4c& 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]r*N__name__ __module__ __qualname____annotations__r1r4r3r(rn!!!!!!r4r(ceZdZUded<dS)grid..colrr*Nrr1r4r3colrqrr4rcBeZdZUded<ded<ded<ded<ded<dS) grid..Itemrr'r}r0c0r1c1Nrr1r4r3Itemrus@r4rc.eZdZUded<ded<ded<dS)grid..Gridr}r|rJz list[Item]rrNrr1r4r3Gridr}s0  r4rr.rc "dddfd dd d   fd |}g}|jD]L}|jC||j|j|j|j|jz |j|jz fMt|S)Nar}br.cht|t|}}|dkr |||z}}|dk |SNr)abs)rrs r3gcdz"grid..flatten..gcds=q663q66qAq&&!a%1q&&Hr4restc6|D]}||z||z}|Sr0r1)rrrrs r3lcmz"grid..flatten..lcms1 ' 'qSSSAYY&Hr4r[rrRc.|jdko |jdkSr)r|rJr[s r3nonemptyz'grid..flatten..nonemptys;!#8 q(8 8r4r'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 Sr1r|rYs r3 z;grid..flatten.._flatten..BBBuu{BBBr4c3$K|] }|jV dSr0rJrYs r3r\z:grid..flatten.._flatten..$>>EEK>>>>>>r4c3$K|] }|jV dSr0rrYs r3r\z:grid..flatten.._flatten..rr4cg|] }|j Sr1rrYs r3rz;grid..flatten.._flatten..rr4r)rWrXfiltermapr*sumr|rrrpr'rrrrrJ)r'r*r|rJrroffsetr[factorirr_flattenrrrr(s r3rz'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#;#;"<===r4rT)rr}rr}r.r})rr}rr}r.r})r[rr.rR)r'rr.r)rrr'rprrrrr) r'r%r*rrrrrrrrr(s @@@@r3flattenzgrid..flattens             9 9 9 9( >( >( >( >( >( >( >( >( >( >( >( >Tx R RAx#14qtad{AD14K PQQQ))))r4Nc<g|]}||zSr1r1)rZrr*rJr(s r3rzgrid..s0QQQ33x!E' 233QQQr4rr*list[LayoutDOM]levelr}c~t|tr%dzdkrn}|fd|DS|S)Nrc.g|]}|dzS)rr1)rZr[rtraverses r3rz*grid..traverse..s)%W%W%WExxuQw'?'?%W%W%Wr4rV)r*r containerrr(rs ` r3rzgrid..traversesXh--$',qyA~~3I$9%W%W%W%W%WX%W%W%WXXX#Or4r[rrRc6t|o |jdkSr)rospacingrs r3 is_usablezgrid..is_usables#E**Au}/A Ar4Fru top_levelct|trQ|s |rDt|trn}|tt |jS|Sr0)rWrrrXrr*)rurrrrr(rs r3rzgrid..traversesl$(( i 99T?? #-dF#;#;DCC  yc(DM&B&B!C!CDDD r4T)rz expected a list, string or model)r.rr)r*rrr})r[rr.rR)F)rurrrR)r"rWrXlenmathceilrangerrNotImplementedErrorrhr)r*ro)r*r)r|rJrNr'r%r[rrrrr(rs` ` @@@@@@r3r%r%=sb"""""""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" Kr4T)boundr#MergeFn)rdignorerelist[Tool | ToolProxy]rdMergeFn[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..ToolEntryrtoolrpropsNrr1r4r3 ToolEntryrs"  r4rNoverlay rendererscg|] }|j Sr1)r)rZentrys r3rzgroup_tools..s A A A A A Ar4rr)re) r"rrXrWr rpproperties_with_values __class__rrrrremover)rerdrrby_typecomputedrrattrr^entriesmergedheadtailr`rus r3rqrqsIY9DD8I8IG')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 Or4rurc@|jduo|jdko |jdkS)Nauto)r) width_policy height_policy)rus r3roro.s+  t # d(9V(C dHZ^dHddr4LrT 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)rrhrWrX)r*rDargs r3r<r<2sk 4yy1}}-VWWW  t99>>ES#t$$  Dzz Or4r:Nonec |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 )rWr!rrhr]ror))r*r)r:rus r3r>r>As++ dI & &  $ ** DCFCCgkCCvz{wAwACCDD D  "'7'='= "*D  ++r4iterable%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: rrrr;r1) rWrXrprGrror)r!rhr]r$r()rr)rr- return_listrus r3rGrGJs>#%K   dD ! !    |D+uqyII J J J J i ( ( &+;D+A+A&#.   t $ $ $ $ i ( (    t $ $ $ $@"&@@15d@@  qyA~~N{ NNvNNNKK[KKFKKKr4Il 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)rWr}rr)rrJrs r3rjrjbsk eS ! !==#==== 1c!ffe $ $1u9 or4)r*r+r)r,r-rr.r)r*r!r)r,r-rr.r)r*r7r)r,r-rr.r)r*r+r)r,r-rr.r)r*r!r)r,r-rr.r)r*r7r)r,r-rr.r) rDr!r*rEr)r,r-rr.r)r*rOr)r,rIrPrJrQrKrQrLrQrMrrNrRr.r)r*rwr)r,r.r)r*ryr)r,r.r)r*r{r)r,r|r}r.r)r*r{r)r,rJr}r.r) r*r{r)r,r|r}rJr}r.r)r*rr)r,r.r) r*rr)r,r|rQrJrQr.r)rerrdrrrr.r)rurr.rR)rDrr*rr.r)r*r+r)r,r:rr.rr)rrr)r,rr}r.ry)rrrJr}r.r)@__doc__ __future__rlogging getLoggerrlogr collectionsrtypingrrrrr r r r r core.enumsrrrmodelsrrrrrrrrrrrrrrr r!util.dataclassesr"typing_extensionsr#__all__r(r$r'r&r%rr]rXrrrqrorr<r>rGrrjr1r4r3r s#"""""g!! ######                      ?>>>>>>>>>$(''''',++++++   KOkkkkk k CGccccc cUYFFFFFF< NRqqqqq q FJiiiii iX\IIIIII>AEko":":":":":":L.207  !# rqrqrqrqrqrqj jm~~~~~ ~ IL]]]]] ] SVsssss s SVsssss s SV  @CTTTTT T$\`vzsssssr GCttAwQ0%i8M2NNOOOOOPT"&//////jeeee GCy!!!GK      ++++LLLLL, GCLLr4