e1VdZddlmZddlZddlZddlmZmZm Z m Z ddl m Z m Z mZmZddlmZddlmZmZmZGd d ZGd d e e ZGd de eeeZGddeeeZedeDd gzZdS)aA Supplies Layer and related classes that allow overlaying of Views, including Overlay. A Layer is the final extension of View base class that allows Views to be overlaid on top of each other. Also supplies ViewMap which is the primary multi-dimensional Map type for indexing, slicing and animating collections of Views. )reduceN) Dimension DimensionedViewableElement ViewableTree) AdjointLayout ComposableLayout Layoutable)UniformNdMapping)dimensioned_streamssanitize_identifier unique_arrayceZdZdZdZdS) Overlayablezp Overlayable provides a mix-in class to support the mul operation for overlaying multiple elements. cddlm}t|rGddlm}fd}||g}d|_d|t SttrttstSnttrJtts5fd  D}|StttfrttstS tgS#t$r tcYSwxYw) z!Overlay object with other object.r) DynamicMap)Callablec|}|zSN)argskwargselementotherselfs 6lib/python3.11/site-packages/holoviews/core/overlay.py dynamic_mulz(Overlayable.__mul__..dynamic_mul!s+g~%)inputsTF) shared_datacallbackstreamsc$g|] \}}||zf Srr).0kvrs r z'Overlayable.__mul__..-s%CCC6Aq!TAXCCCr )spacesr isinstancer _is_overlayclonerOverlayrNotImplementedr CompositeOverlayitemsr rNotImplementedError)rrrrrr#r1s`` r__mul__zOverlayable.__mul__s '&&&&& eZ ( ( & ( ( ( ( ( ( & & & & & & x T5MBBBH#'H ;;58':5'A'ACC C$(( &!%99*))*E#344 &ZO_=`=` &CCCCU[[]]CCC{{5)))EM<#@AA &*UZ\cJdJd &%% &e}---& & & &%%%% &s*D;;EEN)__name__ __module__ __qualname____doc__r3rr rrrs-&&&&&r rc4eZdZdZdZ ddZd fd ZxZS) r0zK CompositeOverlay provides a common baseclass for Overlay classes. TNFc Ntddpd}ttodcxkotknc} dDv} t | | gst d| r}| r'}|)d|j D}fd|D} fd| D} |rR} t|j D]}|j | vr| | |j z} || _ nJt|d kr/tt| } n| d} | S) aComputes and adjoins histogram along specified dimension(s). Defaults to first value dimension if present otherwise falls back to first key dimension. Args: dimension: Dimension(s) to compute histogram on, Falls back the plot dimensions by default. num_bins (int, optional): Number of bins bin_range (tuple optional): Lower and upper bounds of bins adjoin (bool, optional): Whether to adjoin histogram index (int, optional): Index of layer to apply hist to show_legend (bool, optional): Show legend in histogram (don't show legend by default). Returns: AdjointLayout of element and histogram or just the histogram main_layerNrcg|] }|j Srlabelr&els rr)z)CompositeOverlay.hist..Ys#<#<#<BH#<#<#Please supply a suitable index or label for the histogram datacg|] }|j Sr)name)r&dims rr)z)CompositeOverlay.hist..bsWWWcWWWr c i|]AtfdtDBS)c ~g|]9\}\}}t|ddks|k%||jdddf:S)Nr>F)adjoin dimension bin_rangenum_binsr)getattrhist) r&ielem_keyelemrHrCindexrrIs rr)z4CompositeOverlay.hist...es   (A'$MwtWd'C'Cu'L'LRW[\R\R\ idi$y!)-3S]R\R\r )dict enumerater1)r&rCrHrOrrIrs @r z)CompositeOverlay.hist..ds             ,5TZZ\\+B+B         r cji|]/\}}||0S)) show_legend)r-opts)r&rChistsrrTs rrRz)CompositeOverlay.hist..rsL! ! ! U E""''K'@@! ! ! r r)rJr+intlenany TypeErrorkeysrOvalueskdimsr1reversedrBr;r list)rrGrIrHrFrOrTrmain_layer_int_index valid_ind valid_label hists_per_dimhists_overlay_per_dimlayoutrCs` `` ``` rrKzCompositeOverlay.hist?s, 't\4@@EA  "5#..KA4J4J4J4JT4J4J4J4JI#<#.s#@@@q}Q}!}}}r ) dimensionsappenddimension_valuessupernparray concatenater) rrGexpandedflatr\foundr@vals __class__s rrjz!CompositeOverlay.dimension_valuess   BBMMM5555 b11)<<=== G77++IxFF F@@V@@@ 8:: ~f%%7tt\$%7%77r )Nr9NTNF)TT)r4r5r6r7_deep_indexablerKrj __classcell__rss@rr0r08smO:>27AAAAH8888888888r r0ceZdZdZdfd ZdZdfd ZdZdZe dZ e j d Z e d Z e j d Z e d Z e d Zdfd ZxZS)r.a An Overlay consists of multiple Elements (potentially of heterogeneous type) presented one on top each other with a particular z-ordering. Overlays along with elements constitute the only valid leaf types of a Layout and in fact extend the Layout structure. Overlays are constructed using the * operator (building an identical structure to the + operator). Nc xd|jd<||jd<||jd<tj|fi|dS)NF_fixed_group_label)__dict__rk__init__)rr1groupr>paramsrss rr}zOverlay.__init__sL"' h"' h"' h))&)))))r c^tfd|DS)z Allows transparently slicing the Elements in the Overlay to select specific layers in an Overlay use the .get method. c*g|]\}}||fSrr)r&r'r(keys rr)z'Overlay.__getitem__..s%===1AcF ===r )r.r1)rrs `r __getitem__zOverlay.__getitem__s0 ==== ===>>>r c t|trMt|j}d|cxkrt |kr nn||S|St ||S)aPGet a layer in the Overlay. Get a particular layer in the Overlay using its path string or an integer index. Args: identifier: Index or path string of the item to return default: Value to return if no item is found Returns: The indexed layer of the Overlay r)r+rWr_datar\rXrkget)r identifierdefaultr\rss rrz Overlay.gets j# & & $)**,,--FJ,,,,V,,,,,j))ww{{:w///r cHtd|S)zu Collates any objects in the Overlay resolving any issues the recommended nesting structure. c ||zSrr)xys rz!Overlay.collate..s !A#r )rr\rs rcollatezOverlay.collates oot{{}}555r c$ddlm}||S)aPacks Overlay of DynamicMaps into a single DynamicMap that returns an Overlay Decollation allows packing an Overlay of DynamicMaps into a single DynamicMap that returns an Overlay 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 an Overlay r decollaterrrs rrzOverlay.decollates$ )(((((yr cL|jr|jSd|D}d|D}d|D}|r>tt|}tt|j}ngd}}t |dkr||kr|St |jS)Nc g|] }|j | Sr)_auxiliary_componentr?s rr)z!Overlay.group..s EEE2R-DEBEEEr ch|] }|j Sr)r~r?s r z Overlay.group..s...r"(...r c,h|]}t|Sr)typer?s rrz Overlay.group..s---bb---r r)rznextiterr4rXr)relementsr\typesr~vtypes rr~z Overlay.groups ; ; EEEEE..X...--H---  "f&&Ee%%.EEr5E v;;!  L::& &r cbtj|std|d||_dSNzSupplied group z contains invalid characters.)r allowable ValueErrorrz)rr~s rr~z Overlay.groups:",U33 SuSSSTT TDKKKr c|jr|jSd|D}t|dkrtt|SdS)Nc*h|]}|j |jSr)rr>r?s rrz Overlay.label..s1222r02"(222r rr)r{rXrr)rlabelss rr>z Overlay.labels[ ; ; 22T222 v;;!  V %% %2r cbtj|std|d||_dSr)rrrr{)rr>s rr>z Overlay.label s;",U33 USuSSSTT T r cg}g}|D]Q}|D]:}|j|vr/||||j;R|Sr)rhrBri)rrhdimension_namesr@rCs rddimsz Overlay.ddimssw  5 5B}} 5 58?22%%c***#**38444 5r ctr)r2rs rshapez Overlay.shapes!!r Tc \| |r |j|d<tj|f|||d|S)Nplot_id)r"new_typelink)_plot_idrkr-)rrr"rr overridesrss rr-z Overlay.clone"sA rrr-rurvs@rr.r.s`  ****** ???000000*666$''X'  \  \ X \\ X""X"ggggggggggr r.cheZdZdZejedgddZdZd fd Z dZ xZ S) NdOverlayz An NdOverlay allows a group of NdOverlay to be overlaid together. NdOverlay can be indexed out of an overlay and an overlay is an iterable that iterates over the contained layers. ElementTz< List of dimensions the NdOverlay can be indexed by.)rconstantdocNc @tj|fd|i|dS)Nr])rkr})roverlaysr]rrss rr}zNdOverlay.__init__4s-999&99999r c$ddlm}||S)aPacks NdOverlay of DynamicMaps into a single DynamicMap that returns an NdOverlay Decollation allows packing a NdOverlay of DynamicMaps into a single DynamicMap that returns an NdOverlay 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 an NdOverlay rrrrs rrzNdOverlay.decollate7s$ )(((((yr )NN) r4r5r6r7paramListrr]rtr}rrurvs@rrr(s EJ ) 4 45K? @ @ @EO::::::r rclh|]1\}}t|tt|t/|2Sr)r+r issubclassr)r&_k_vs rrrKsTMMMvr2!"d++M0:2{0K0KMMMMr )r7 functoolsrnumpyrlrrGrrrrrer r r r ndmappingr utilrrrrr0r.rr_localsr1__all__rr rrs LLLLLLLLLLLLAAAAAAAAAAAA''''''HHHHHHHHHH & & & & & & & &Fg8g8g8g8g8 g8g8g8TCgCgCgCgCgl,j+CgCgCgL      -/?   F $MM!1!1MMM N NQ^P_ `r