e MZdZddlZddlZddlmZddlmZmZm Z m Z ddl m Z m Z GddZGd d eZGd d eeZGd deeZGddee ZGddee ZedeDZdS)z Supplies Pane, Layout, NdLayout and AdjointLayout. Pane extends View to allow multiple Views to be presented side-by-side in a NdLayout. An AdjointLayout allows one or two Views to be adjoined to a primary View to act as supplementary elements. N) traversal) Dimension DimensionedViewableElement ViewableTree) NdMappingUniformNdMappingceZdZdZdZdZdS) Layoutablezv Layoutable provides a mix-in class to support the add operation for creating a layout from the operands. ctd||fDr*td|jjd|jjd t ||gS#t $r t cYSwxYw)zCompose objects into a Layoutc3@K|]}t|tVdSN) isinstanceint).0args 5lib/python3.11/site-packages/holoviews/core/layout.py z%Layoutable.__add__..s,66z#s##666666z#unsupported operand type(s) for +: z and z. If you are trying to use a reduction like `sum(elements)` to combine a list of elements, we recommend you use `Layout(elements)` (and similarly `Overlay(elements)` for making an overlay from a list) instead.)any TypeError __class____name__LayoutNotImplementedErrorNotImplemented)xys r__add__zLayoutable.__add__s 661v666 6 6 GF!+BVFF]^]h]qFFFGG G  "1a&>> !" " " "! ! ! ! "sAA,+A,c8|j||Sr)rr selfothers r__radd__zLayoutable.__radd__"s~%%eT222rN)r __module__ __qualname____doc__r r%rrr r s< " " "33333rr ceZdZdZdZdS) Composablezu Composable is a mix-in class to allow Dimensioned objects to be embedded within Layouts and GridSpaces. c0t|tttfrt ||gSt|tr*t |j|gzStdt|j d)z%Compose objects into an AdjointLayoutzCannot append z to a AdjointLayout) rrr Empty AdjointLayoutdatavaluesrtyperr"s r __lshift__zComposable.__lshift__,s eoy%@ A A X $// / } - - X !2!2!4!4dV!;<< <VT%[[-AVVVWW WrN)rr&r'r(r2r)rrr+r+&s2 XXXXXrr+cDeZdZdZejdZfdZxZS)r-z Empty may be used to define an empty placeholder in a Layout. It can be placed in a Layout just like any regular Element and container type via the + operator or by passing it to the Layout constructor as a part of a list. )defaultc :tjdi|dS)Nr)super__init__)r#paramsrs rr7zEmpty.__init__As&(((((((r) rr&r'r(paramStringgroupr7 __classcell__rs@rr-r-7sX EL ) ) )E)))))))))rr-ceZdZdZejedgdZgdZdZ dZ fdZ ddZ dZ ed Zed Zejd Zejd Zdfd Zd dZd!dZdZdZdZedZedZedZedZedZdZdZdZdZ xZ!S)"r.a, An AdjointLayout provides a convenient container to lay out some marginal plots next to a primary plot. This is often useful to display the marginal distributions of a plot next to the primary plot. AdjointLayout accepts a list of up to three elements, which are laid out as follows with the names 'main', 'top' and 'right': _______________ | 3 | | |___________|___| | | | 1: main | | | 2: right | 1 | 2 | 3: top | | | |___________|___| Tr4constantmainrighttopFc d_|r"t|dkrtd|(td|Drt |}t |tr fd|D}|rtdn:t |t r#t tj|}ni}tj |fi|dS)Nrz2AdjointLayout accepts no more than three elements.c3@K|]}t|tVdSr)rtuplervs rrz)AdjointLayout.__init__..ds,#G#GQJq%$8$8#G#G#G#G#G#Grc&g|] }|jv |Sr)) layout_orderrkr#s r z*AdjointLayout.__init__..gs&GGGqAT5F,F,F,F,F,Frz'Wrong AdjointLayout positions provided.) main_layerlen ExceptionalldictrlistziprLr6r7)r#r/r8 wrong_posrs` rr7zAdjointLayout.__init___s  RCIIMMPQQ Q  #G#G$#G#G#G G G ::D dD ! ! GGGGDGGGI K IJJJ K d # # D-t4455DDD(((((((rc|r|n||r|n|g}ttrttrg}|jjzjpjijjkr#|jjznU|jjgz }nCj|jn!j|jjpjijjkr#|jjznU|jjgz }nCj|jn!j|jt|dkrtdnkttr!fd|j D}jz|d<n5ttr fd|j D}jz|d<|r| |StS)NrFzAdjointLayouts could not be overlaid, the dimensions of the adjoined plots do not match and the AdjointLayout can hold no more than two adjoined plots.c<g|]}|jv j|Sr)r/)rolayer1s rrOz)AdjointLayout.__mul__..5333!"fk!1!1%k!n!1!1!1rrc<g|]}|jv j|Sr)rZ)rr[layer2s rrOz)AdjointLayout.__mul__..r]r) rr.appendrBrC dimensionsrDrQ ValueErrorrLcloner)r#r$reverseadjoined_itemsr\r_s @@r__mul__zAdjointLayout.__mul__rs!+t +e fm , ," 5FM1R1R" 5N  ! !&+fk"9 : : :|'FL,D<**,, 0G0G0I0III"))&,v|*CDDDD"v|V\&BBNN)%%fl3333)%%fl333z%&**@:((**fj.C.C.E.EEE"))&*VZ*?@@@@"vz6:&>>NN'%%fj1111'%%fj111>""Q&& "IJJJ'  . . 53333d6G333N & f 4N1    . . 53333d6G333N & 4N1   "::n-- -! !rc0||dSNT)rdrfr"s r__rmul__zAdjointLayout.__rmul__||E4|000rcz|jr3|jjt|jjkr |jjSdS)z!Group inherited from main elementr.)rBr;r1rr#s rr;zAdjointLayout.groups6 9 #DOO,DDD9? ""?rc,|jr |jjndS)z!Label inherited from main element)rBlabelrms rrpzAdjointLayout.labels#')3ty3rcdSrr))r#r;s rr;zAdjointLayout.group DrcdSrr))r#rps rrpzAdjointLayout.labelrrrNrcLt|||S)aClone object and apply new group and/or label. Applies relabeling to child up to the supplied depth. Args: label (str, optional): New label to apply to returned object group (str, optional): New group to apply to returned object depth (int, optional): Depth to which relabel will be applied If applied to container allows applying relabeling to contained objects up to the specified depth Returns: Returns relabelled object )rpr;depthr6relabelr#rpr;rurs rrwzAdjointLayout.relabels!wwU%uEEErc2||jvr |j|n|S)a5 Returns the viewable corresponding to the supplied string or integer based key. Args: key: Numeric or string index: 0) 'main' 1) 'right' 2) 'top' default: Value returned if key not found Returns: Indexed value or supplied default rZ)r#keyr4s rgetzAdjointLayout.gets "% !1!1ty~~w>rcr||dj}|j|||S)aReturn the values along the requested dimension. Applies to the main object in the AdjointLayout. Args: dimension: The dimension to return values for expanded (bool, optional): Whether to expand values Whether to return the expanded values, behavior depends on the type of data: * Columnar: If false returns unique values * Geometry: If false returns scalar values per geometry * Gridded: If false returns 1D coordinates flat (bool, optional): Whether to flatten array Returns: NumPy array of values along the requested dimension T)strict) get_dimensionnamerBdimension_values)r# dimensionexpandedflats rrzAdjointLayout.dimension_valuess9$&&y&>>C y)))XtDDDrcV|dkr|Sdt|tr|dd|d}t|trF|t|kr3|dkr|j}|dkr|j}|dkr|j}r|}|St|tr-||jvr$ |j|S|j|dSt|tr3|j ,|j %|n | fd|DStd|d) z.Index into the AdjointLayout by index or labelr)Nrrc g|] }| Sr)r))rel data_slices rrOz-AdjointLayout.__getitem__..s5?O?O?OCE@B*~?O?O?OrzKey z not found in AdjointLayout.)rrHrrQrBrCrDstrr/slicestartstoprcKeyError)r#rzr/rs @r __getitem__zAdjointLayout.__getitem__sv "99K c5 ! ! QRRJa&C c3   EC3t99$4$4axx$axx$axx$ 2$z"24K S ! ! EcTY&6&6!y~% #z**** U # # E (9ch>N%-444::?O?O?O?OIM?O?O?O4P4P PC#CCCDD Drc|dvr=t|tttfr ||j|<dSt dt d|d)NrAz)AdjointLayout only accepts Element types.z Position z not valid in AdjointLayout.)rrr r-r/rbrR)r#rzvalues r __setitem__zAdjointLayout.__setitem__ sa * * *%/3CU!KLL N!& # !LMMMIIIIJJ JrcdfdjD}td|D|gzS)z%Add another plot to the AdjointLayoutcFg|]}j|dSrr/r{rMs rrOz,AdjointLayout.__lshift__..s)CCCAq$''CCCrcg|]}||Srr)rIs rrOz,AdjointLayout.__lshift__..s@@@A!-a---r)rLr.)r#r$viewss` rr2zAdjointLayout.__lshift__sCCCCC1BCCC@@@@@E7JKKKrc4|jSr)rBrarms rddimszAdjointLayout.ddimssy##%%%rc8|jddS)z-Returns the main element in the AdjointLayoutrBNrrms rrBzAdjointLayout.main sy}}VT***rc8|jddS)z7Returns the right marginal element in the AdjointLayoutrCNrrms rrCzAdjointLayout.right%sy}}Wd+++rc8|jddS)z5Returns the top marginal element in the AdjointLayoutrDNrrms rrDzAdjointLayout.top*sy}}UD)))rcd|jD}|t|S)NcXg|]'\}}t|tr ||jfn||f(Sr))rr last)rrNrJs rrOz&AdjointLayout.last..1sI000Q!+1i 8 8D!QVq!f000r)r/itemsrrT)r#rs rrzAdjointLayout.last/sD00!Y__..000~~d5kk***rcNt|jSr)rUr/keysrms rrzAdjointLayout.keys6sDINN$$%%%rcNt|jSr)rUr/rrms rrzAdjointLayout.items:sDIOO%%&&&rc#|Kd}|t|kr$||V|dz }|t|k"dSdS)Nrr)rQ)r#is r__iter__zAdjointLayout.__iter__>sI #d))mmq'MMM FA#d))mmmmmmrc*t|jS)z$Number of items in the AdjointLayout)rQr/rms r__len__zAdjointLayout.__len__Ds49~~rFNNrr)TT)"rr&r'r(r9ListrkdimsrL_deep_indexable_auxiliary_componentr7rfrjpropertyr;rpsetterrwr{rrrr2rrBrCrDrrrrrr<r=s@rr.r.FsL" EJ / : :;d K K KE+++LO )))))&+"+"+"+"\111##X#44X4  \  \  \  \ FFFFFF$ ? ? ? ?EEEE,EEE8KKKLLL &&X&++X+,,X,**X*++X+ &&&''' rr.ceZdZdZeeefZd fd Ze dZ e dZ dZ dZ e dZfd ZxZS) NdLayoutz NdLayout is a UniformNdMapping providing an n-dimensional data structure to display the contained Elements and containers in a layout. Using the cols method the NdLayout can be rearranged with the desired number of columns. Nc \d|_d|_tjd||d|dS)N) initial_itemsrr)) _max_cols_styler6r7)r#rrr8rs rr7zNdLayout.__init__TsL  #}E # #! # # # # #rc*tj|Sr)runiformrms rrzNdLayout.uniform[s &&&rct|}||jkrd|fS||jz}||jz}||rdndzt||jfS)z@Tuple indicating the number of rows and columns in the NdLayout.rr)rQrrminr#numnrows last_row_colss rshapezNdLayout.shape`sl$))++ $. s8Ot~%dn, =/aaa0#c4>2J2JJJrct|gkriS|jfdt|jDS)z Compute a dict of {(row,column): (key, value)} elements from the current set of items and specified number of columns. c6i|]\}\}}|z|zf||fSr)r))ridxrzitemcolss r z'NdLayout.grid_items..rsJFFF$C#tcDj)C;FFFr)rUrr enumerater/r)r#rs @r grid_itemszNdLayout.grid_itemsksr    " "BY~FFFF(1$)//2C2C(D(DFFF Frc||_|Sa:Sets the maximum number of columns in the NdLayout. Any items beyond the set number of cols will flow onto a new row. The number of columns control the indexing and display semantics of the NdLayout. Args: ncols (int): Number of columns to set on the NdLayout rr#ncolss rrz NdLayout.colsv rcFg}|D]v\}}t|tr$|||j|jff}n#t|t r ||jf}n||f}||w||S)z Returns another NdLayout constituted of the last views of the individual elements (if they are maps). )rrr rclast_keyrr.r`)r# last_itemsrNrJrs rrz NdLayout.lasts  jjll $ $FQ!Y'' 177AJ#7889A}-- 16{1v   d # # # #zz*%%%rcjtj|i|}|j|_|j|_|S)aClones the NdLayout, overriding data and parameters. Args: data: New data replacing the existing data shared_data (bool, optional): Whether to use existing data new_type (optional): Type to cast object to *args: Additional arguments to pass to constructor **overrides: New keyword arguments to pass to constructor Returns: Cloned NdLayout object )r6rcridr#args overridesrcrs rrczNdLayout.clones6 t1y11.7 r)NN)rr&r'r(rr.r data_typer7rrrrrrrcr<r=s@rrrJs!-1ABI######''X'KKXKFFF   &&X&"rrceZdZdZejddZdZdfd ZdZ e dZ fdZ fd Z d Zdfd Zd ZddZdZxZS)ra A Layout is an ViewableTree with ViewableElement objects as leaf values. Unlike ViewableTree, a Layout supports a rich display, displaying leaf items in a grid style layout. In addition to the usual ViewableTree indexing, Layout supports indexing of items by their row and column index in the layout. The maximum number of columns in such a layout may be controlled with the cols method. Tr?Nc Td|jd<tj|||fi|dS)Nrr)__dict__r6r7)r#r identifierparentkwargsrs rr7zLayout.__init__s8%& k" F==f=====rc$ddlm}||S)aPacks Layout of DynamicMaps into a single DynamicMap that returns a Layout Decollation allows packing a Layout of DynamicMaps into a single DynamicMap that returns a Layout of simple (non-dynamic) elements. All nested streams are lifted to the resulting DynamicMap, and are available in the `streams` property. The `callback` property of the resulting DynamicMap is a pure, stateless function of the stream values. To avoid stream parameter name conflicts, the resulting DynamicMap is configured with positional_stream_args=True, and the callback function accepts stream values as positional dict arguments. Returns: DynamicMap that returns a Layout r decollater)r#rs rrzLayout.decollates$ )(((((yrct|}||jkrd|fS||jz}||jz}||rdndzt||jfS)z>Tuple indicating the number of rows and columns in the Layout.rr)rQrrrs rrz Layout.shapesb$ii $. s8Ot~%dn, =/aaa0#c4>2J2JJJrct|trN|t|kr,t|j|St dt|trt dt|dkrtd|Ds|tdtdfkr|S|\}}||j z|z}t|j }|t|ks ||j krt d|d||}t |S)z0Allows indexing Layout by row and column or pathzElement out of range.zdA Layout may not be sliced, ensure that you are slicing on a leaf (i.e. not a branch) of the Layout.rc8g|]}t|tSr))rr)rrNs rrOz&Layout.__getitem__..s"%F%F%FQjC&8&8%F%F%FrNzIndex z is outside available item range) rrrQrUr/r0rrrrrr6r)r#rzrowcolrrrs rrzLayout.__getitem__sX c3   WSYYDI,,..//44233 3 U # # WVWW W s88q==%F%F#%F%F%F!G!G=uT{{E$KK000+HC&,C (())Dc$ii3$.#8#8MMMMNNNs)Cww""3'''rcRtj|i|}|j|_|S)aClones the Layout, overriding data and parameters. Args: data: New data replacing the existing data shared_data (bool, optional): Whether to use existing data new_type (optional): Type to cast object to *args: Additional arguments to pass to constructor **overrides: New keyword arguments to pass to constructor Returns: Cloned Layout object )r6rcrrs rrcz Layout.clones- t1y11. rc||_|Srrrs rrz Layout.colsrrrcJt|||S)aClone object and apply new group and/or label. Applies relabeling to children up to the supplied depth. Args: label (str, optional): New label to apply to returned object group (str, optional): New group to apply to returned object depth (int, optional): Depth to which relabel will be applied If applied to container allows applying relabeling to contained objects up to the specified depth Returns: Returns relabelled object rvrxs rrwzLayout.relabel swwueU333rc^fdtDS)Ncpi|]2\}\}}ttj|j||f3Sr))rHnp unravel_indexr)rrpathrr#s rrz%Layout.grid_items..sTBBB%C$b&sDJ77884,BBBr)rrrms`rrzLayout.grid_itemssFBBBB)24::<<)@)@BBB BrFcddlm}tt|fstSt fd|D}|j|_|S)Nr)HoloMapc(g|]}r|zn|zSr)r))rrJr$rds rrOz"Layout.__mul__..%s*GGGQG8q5GGGr)spacesrrrrrr)r#r$rdrlayouts `` rrfzLayout.__mul__!sg######%/7!;<< "! !GGGGG$GGGHH> rc0||dSrhrir"s rrjzLayout.__rmul__)rkr)NNNrr)rr&r'r(r9r:r;rr7rrrrrcrrwrrfrjr<r=s@rrrs%   ELD 9 9 9EO>>>>>>$KKXK(((((($   444444"BBB1111111rrch|]F\}}t|tt|tst|tD|GSr))rr1 issubclassrr)r_k_vs r r-sgMMMvr2!"d++M1;B 1L1LM4>r64J4JMMMMr)r(numpyrr9rorrrrrr ndmappingr r r r+r-r.rrrUlocalsr__all__r)rrrs LLLLLLLLLLLL2222222233333333, X X X X X X X X" ) ) ) ) )K ) ) )@@@@@J @@@H[[[[[z+[[[|B1B1B1B1B1ZB1B1B1J $MM!1!1MMM N Nr