eqJdZddlZddlZddlZddlZddlmZddlmZddl Z ddl Z ddl m Z ddlmZddlmZdd lmZmZmZd(d Zd ZGd d eZGddeZGddeZGddeZGddZedZGdde j Z!Gdde j Z"dZ#Gdde"Z$GddZ%Gd d!eZ&e%Z'Gd"d#e j Z(Gd$d%Z)Gd&d'Z*dS))a Options and OptionTrees allow different classes of options (e.g. matplotlib-specific styles and plot specific parameters) to be defined separately from the core data structures and away from visualization specific code. There are three classes that form the options system: Cycle: Used to define infinite cycles over a finite set of elements, using either an explicit list or some pre-defined collection (e.g. from matplotlib rcParams). For instance, a Cycle object can be used loop a set of display colors for multiple curves on a single axis. Options: Containers of arbitrary keyword values, including optional keyword validation, support for Cycle objects and inheritance. OptionTree: A subclass of AttrTree that is used to define the inheritance relationships between a collection of Options objects. Each node of the tree supports a group of Options objects and the leaf nodes inherit their keyword values from parent nodes up to the root. Store: A singleton class that stores all global and custom options and links HoloViews objects, the chosen plotting backend and the IPython extension together. N) defaultdict)contextmanager)Opts) InfoPrinter)AttrTree)group_sanitizerlabel_sanitizersanitize_identifierc tjrdStj|g}||vr||g}t |D]D}|}| |j|kr||/||E|sUtD];}|tj |vr%tj | |<|s"tj |ddSdS#t$r}td|d|d|d}~wwxYw)z Cleans up unused custom trees if all objects referencing the custom id have been garbage collected or tree is otherwise unreferenced. Nz(Cleanup of custom options tree with id 'z'' failed with the following exception: z4, an unreferenced orphan tree may persist in memory.) Store_options_context _weakrefsgetremovelistidappendloaded_backends_custom_optionspop Exception)rweakrefweakrefsrefswrrbkes 6lib/python3.11/site-packages/holoviews/core/options.pycleanup_custom_optionsr!3s   !  F?&&r2.. h   OOG $ $ $x..  BAyADBJJ#### A 6++-- 6 6.r222)"-11"555 * O  D ) ) ) ) ) * *  1r 1 1-. 1 1 1    s DDD E&D==EcZd} tj||}|j}n#t$rd}YnwxYwt|||}|dkr|||S|dkr)|r'|t|jS|S)z Given a HoloViews object, a plot option group (e.g. 'style') and backend, return the corresponding Options object. Nstyleplot) r renderersplotting_class style_opts SkipRenderinglookup_optionsfilteredrparam)objgroupbackend plot_classr'nodes r r)r)Ts J_W-<r?rAinvalid_keywordallowed_keywords group_namepath)r@rHrIrJrKrBs r r?zOptionError.__init__s] o&6&0$88 9 9 9 / 0# r8c6d|d|d}|r |r d|d|d|}|S)NzInvalid option , valid options are: .zInvalid key for group z on path z; r7)r@rHrIrJrKmsgs r rAzOptionError.messages_ #o # # # # #   QJ QP:PP$PP3PPC r8c|j}|j}||j}|s |j}d}nd}t }|rd|nd}t|dkr d|d}n5dd |d d D}d |d |d }|j r |j dnd}d|d|jd||d|dt j d|dS)zG Return a fuzzy match message based on the OptionError PossibleSimilarzfor r:rz in loaded backend r, c,g|]}t|Sr7repr).0bs r z4OptionError.format_options_error..s%L%L%L!d1gg%L%L%Lr8Nz in loaded backends z and z optionkeywordz Unexpected z 'z' z. z# keywords in the currently active 'z' renderer are: zy If you believe this keyword is correct, please make sure the backend has been imported or loaded with the hv.extension.) rItarget fuzzy_matchrHvaluesr rlenjoinrJcurrent_backend) r@rIr\matches similarityrloaded backend_listr-s r format_options_errorz OptionError.format_options_errors\ 0!("..t/CDD #&-G#JJ"J//11$*2   1 $ $A?1+=AAFF99%L%Lss7K%L%L%LMMLVLVVr?RVVF/3M4?++++I %% % %4#7 % %6 % % %& % %, % % % % % r8NN)r3r4r5r6r?rArfrCrDs@r rFrFzsj(,       r8rFc$eZdZdZdZdZdZdS)AbbreviatedExceptiona Raised by the abbreviate_exception context manager when it is appropriate to present an abbreviated the traceback and exception message in the notebook. Particularly useful when processing style options supplied by the user which may not be valid. cX||_||_||_t||_dSr<)etypevalue tracebackstrrOr@rkrlrms r r?zAbbreviatedException.__init__s(  "u::r8c0|jjd|jdS)Nz: zY To view the original traceback, catch this exception and call print_traceback() method.)rkr3rOr@s r __str__zAbbreviatedException.__str__s,z" - -dh - - - r8cPtj|j|j|jdS)z[ Print the traceback of the exception wrapped by the AbbreviatedException. N)rmprint_exceptionrkrlrqs r print_tracebackz$AbbreviatedException.print_tracebacks% !$*dj$.IIIIIr8N)r3r4r5r6r?rrrur7r8r ririsP    JJJJJr8riceZdZdZdZdZdS)abbreviated_exceptionz Context manager used to to abbreviate tracebacks using an AbbreviatedException when a backend may raise an error due to incorrect style options. c|Sr<r7rqs r __enter__zabbreviated_exception.__enter__s r8cRt|trt|||dSr<) isinstancerriros r __exit__zabbreviated_exception.__exit__s3 eY ' ' @&ueY?? ? @ @r8N)r3r4r5r6ryr|r7r8r rwrwsA @@@@@r8rwc#Ktjtjf}||ct_t_ dV|\t_t_dS#|\t_t_wxYw)zo Context manager to temporarily set the skip_invalid and warn_on_skip class parameters on Options. N)Options skip_invalid warn_on_skip)rrsettingss r options_policyrsk $g&:;H4@,0W7/@ 7?4 w333x4 w3????s AA/ceZdZdZejdZejddZdfd Z d Z d Z d Z d Z d ZdZdZxZS)Keywordsa A keywords objects represents a set of Python keywords. It is list-like and ordered but it is also a set without duplicates. When passed as **kwargs, Python keywords are not ordered but this class always lists keywords in sorted order. In addition to containing the list of keywords, Keywords has an optional target which describes what the keywords are applicable to. This class is for internal use only and should not be in the user namespace. z!Set of keywords as a sorted list.docTzB Optional string description of what the keywords apply to. allow_NonerNc|g}d|D}d|vrtd|tt||dS)Nc8g|]}t|tSr7r{rnrWvs r rYz%Keywords.__init__..s"666!:a%%666r8FzAll keywords must be strings: r^r\) ValueErrorr>r?sorted)r@r^r\stringsrBs r r?zKeywords.__init__sx >F66v666 G  FfFFGG G v5;  = = = = =r8c|jr&|jr|j|jkrtd|jp|j}ttt |j|jz|S)Nz&Targets must match to combine Keywordsr\)r\rrrsetr^)r@otherr\s r __add__zKeywords.__add__ sn K FEL Ft{el/J/JDEE E, s4;#=>>??OOOOr8c6tj||jS)zt Given a string, fuzzy match against the Keyword values, returning a list of close matches. )difflibget_close_matchesr^)r@kws r r]zKeywords.fuzzy_matchs (T[999r8c|jrd}t|j|j}nd}t|j}|jdi|S)Nz#Keywords({values}, target={target})rzKeywords({values})r^r7)r\dictr^format)r@rOinfos r __repr__zKeywords.__repr__sX ; ,7Ct{4;???DD&Ct{+++Dsz!!D!!!r8c*t|jSr<)rnr^rqs r rrzKeywords.__str__"sDK(8(8!8r8c*t|jSr<)iterr^rqs r __iter__zKeywords.__iter__#T[(9(9!9r8c*t|jSr<)boolr^rqs r __bool__zKeywords.__bool__$rr8c||jvSr<r)r@vals r __contains__zKeywords.__contains__%st{(:!:r8rg)r3r4r5r6r+Listr^Stringr\r?rr]rrrrrrrCrDs@r rrs  UZ? @ @ @F U\T0EFFFF======PPP :::"""988999999:::::::r8rceZdZdZejdddZejgdZdgiZ dfd Z d Z d Z dd Z d ZdZxZS)Cyclea# A simple container class that specifies cyclic options. A typical example would be to cycle the curve colors in an Overlay composed of an arbitrary number of curves. The values may be supplied as an explicit list or a key to look up in the default cycles attribute. default_colorsTzs The key in the default_cycles dictionary used to specify the color cycle if values is not supplied. )defaultrrz/ The values the cycle will iterate over.rrNc |%t|tr||d<n ||d<d|d<tjdi|||_dS)Nkeyr^r7)r{rnr>r? _get_valuesr^)r@cycleparamsrBs r r?zCycle.__init__;sm  %%% % %u #(x $u ""6"""&&(( r8c4||jd|S)Nrr)r@nums r __getitem__zCycle.__getitem__Fs t4;tt,----r8c,|jr|jS|jr-|j|jvrt|j|jS|jr=tj}dhd|hz }td|d|dtd)Nz or >bokehplotly matplotlibz3The key you have supplied is not available for the z backend. Try to switch to z with 'hv.extension(backend)'.z'Supply either a key or explicit values.)r^rdefault_cyclesrr rar`r)r@currentotherss r rzCycle._get_valuesJs ; Ht{* X H$(d&999+DH566 6 X H+G[[!B!B!BgY!NOOF0"00?E000  FGG Gr8c z|r|n|j}|jdit|jfd|i|S)Nr^r7)r^rBrr+)r@r^rs r __call__zCycle.__call__ZsM!2t{t~SSTZ%6%6%8%8 R R R6 R RSSSr8c*t|jSr<)r_r^rqs r __len__z Cycle.__len___s4;r8c|j|jddjkrd}n-|jrt |j}nd|jD}t |jd|dS)NFrr:c,g|]}t|Sr7rnrWels r rYz"Cycle.__repr__..is333SWW333r8())rr+objectsrrVr^typer3)r@vreprs r rzCycle.__repr__cs| 8tz))%007? ? ?EE X 4NNEE33t{333Et**%000000r8r<)r3r4r5r6r+rrrr^rr?rrrrrrCrDs@r rr)s %,/DG2 3 3 3CUZ)2333F'+N))))))... H H H TTTT    1111111r8rc|||dfS)Ng?r7)rs r grayscalerns c3 r8ceZdZdZejddZejddZej ddZ ej e j d Zejd d ZdeiZfd Zd ZdZxZS)Palettea Palettes allow easy specifying a discrete sampling of an existing colormap. Palettes may be supplied a key to look up a function function in the colormap class attribute. The function should accept a float scalar in the specified range and return a RGB(A) tuple. The number of samples may also be specified as a parameter. The range and samples may conveniently be overridden with the __getitem__ method. rz> Palettes look up the Palette values based on some key.r)rrz= The range from which the Palette values are sampled. zU The number of samples in the given range to supply to the sample_fn.zA The function to generate the samples, by default linear.Fz( Whether to reverse the palette.c ~tt|jdd|i|||_dS)Nrr7)r>rr?rr^)r@rrrBs r r?zPalette.__init__sB#eT#666v666&&(( r8c|j|jc\}}}t|tr+|j|j}|j|j}|j|j}n|}|||f|S)z Provides a convenient interface to override the range and samples parameters of the Cycle. Supplying a slice step or index overrides the number of samples. Unsupplied slice values will be inherited. N)rangesamples)rrr{slicestartstopstep)r@slcrrrs r rzPalette.__getitem__sv#j$, t c5 ! ! y$ x#xx#xDt5$-6666r8c|j|j|j|jc\}}}fd||||D}|jr |dddn|S)Nc&g|] }|Sr7r7)rWncmaps r rYz'Palette._get_values..s!GGGq4477GGGr8rZ) colormapsrrr sample_fnreverse)r@rrstepsrrs @r rzPalette._get_valuessi~dh'#z4< uGGGGDNN5$$F$FGGG $ 9wttt}}'9r8)r3r4r5r6r+rr NumericTuplerIntegerrCallablenplinspacerBooleanrrrr?rrrCrDs@r rrrs    %,{1A B B BC E v4@ A A AEemB-Gr{9DEEEIemE0+,,,Gi(I))))) 777*:::::::r8rceZdZdZdZdZgdZdgZ ddZdZ dZ dd Z d Z d Z ed Zd ZedZdZdZdS)r~a An Options object holds a collection of keyword options. In addition, Options support (optional) keyword validation as well as infinite indexing over the set of supplied cyclic values. Options support inheritance of setting values via the __call__ method. By calling an Options object with additional keywords, you can create a new Options object inheriting the parent options. T)r#r$normoutputr.Nc x |g}g tD]5}|r1||vr-|jr |%t ||6|ru|dr[||jvrRtdt|d d|jD D].}t |||}t |/ r'|j r |jd d|t! fdtD|_g|_||_t)|t*r|nt+|}||_||_||_dS) NrzTKey {} does not start with a capitalized element class name and is not a group in {}rSc34K|]}t|VdSr<rUrs r z#Options.__init__..saOwOw]_PTUWPXPXOwOwOwOwOwOwr8)rJzInvalid options rMc,g|]}|v||fSr7r7)rWk invalid_kwskwargss r rYz$Options.__init__..s,aaaaAU`L`L`QvayML`L`L`r8)rkeysrrrFislower_option_groupsrrrVr` StoreOptionsrecord_skipped_optionrr+warningrr_options _max_cyclesr{rrImerge_keywordsr) r@rrIr max_cyclesrkwarg invalid_kwerrorrs ` @r r?zOptions.__init__sA  #!  FKKMM** ? ?E ?E1A$A$A$?&&u----%e-=>>>  y3q6>>## y43F(F(Fryyz~@C{D{DFJFOFOOwOwcgcvOwOwOwFwFwxxyy y% 6 6J ,<MMME  . .u 5 5 5 5  l4, l J  j+jjVfjj k k kaaaaa6&++--3H3Haaabb  %0:;KX0V0V<,,!)*:!;!;  0,r8c||j_|S)zZ Helper method to easily set the target on the allowed_keywords Keywords. )rIr\)r@r\s r keywords_targetzOptions.keywords_targets(.$ r8cfd|jD}|jd|j|j|jd|S)z Return a new Options object that is filtered by the specified list of keys. Mutating self.kwargs to filter is unsafe due to the option expansion that occurs on initialization. c$i|] \}}|v || Sr7r7)rWrralloweds r z$Options.filtered..s$BBBsqQ'\\q\\\r8)rrIrr7)ritemsrBrrIr)r@rkwss ` r r*zOptions.filteredsk CBBBdk//11BBBt~I$(/3/D-1-@IIDGII Ir8c d|vr |j|d<|dgfvr|jn|}tdd|i|}|jdit|jfi|S)zO Create a new Options object that inherits the parent options. rNrIr7)rrIrrBr)r@rIrinherited_styles r rzOptions.__call__sz    HF5M2BtBi2O2O..UeKK0@KFKKt~EET[ D DO D DEEEr8chtt|jS)z.The keyword names across the supplied options.)rrrrrqs r rz Options.keys s&d4;++--..///r8cbfd|jD}|ddi|S)z Truncates all contained Palette objects to a maximum number of samples and returns a new Options object containing the truncated or resampled Palettes. cVi|]%\}}|t|tr|n|&Sr7)r{r)rWrargrs r rz&Options.max_cycles..sF666b#:c7#;#;Ds3xx666r8rr7)rr )r@rrs ` r rzOptions.max_cyclessT 6666!%!2!2!4!4666t--s-f---r8cbtd|jDS)z2Returns True if the options cycle, otherwise Falsec3@K|]}t|tVdSr<r{r)rWrs r rz!Options.cyclic..s,JJc:c5))JJJJJJr8)anyrr^rqs r cycliczOptions.cyclics/JJT[5G5G5I5IJJJJJJr8cJt|jdkriSd|jD}i}|D] \}}||t|z||<!d|jD}t|fi|S)z Infinite cyclic indexing of options over the integers, looping over the set of defined Cycle objects. rcNi|]"\}}t|t||j#Sr7)r{rr^rWrrs r rz'Options.__getitem__..%s/TTT1z!U?S?ST!AHTTTr8cDi|]\}}t|t||Sr7rrs r rz'Options.__getitem__..*s-QQQ#!AJq%> 7 7KC!%#f++"56GCLLQQ!2!2!4!4QQQF&&g&&&r8c>|js|dStd)z:Access of the options keywords when no cycles are defined.rz>The options property may only be used with non-cyclic Options.)rrrqs r rzOptions.options-s.{ 97N899 9r8cdfdtjD}t j}jr1jdr|r|djd|dSjr,jdr |djdS|d|dS)NrSc3<K|]}|dj|VdS=N)r)rWrr@s r rz#Options.__repr__..7s7VVa111t{1~11VVVVVVr8rrr)r`rrrrr3risupper)r@r cls_names` r rzOptions.__repr__6siiVVVV6$+BRBRBTBT;U;UVVVVV::& 8 ( ++-- (# (5555s555 5 X ($(1+--// (..... .''''' 'r8c t|Sr<rUrqs r rrzOptions.__str__@sDzzr8)NNTNr<)r3r4r5r6rrr_output_allowed_kwsr?rr*rrrpropertyrrrrrrr7r8r r~r~sL L888N$+GK @ I I IFFFF000...KKXK''' 99X9(((r8r~cfeZdZdZ ddZdZfdZfdZfdZdd Z dd Z dd Z d Z xZ S) OptionTreea A subclass of AttrTree that is used to define the inheritance relationships between a collection of Options objects. Each node of the tree supports a group of Options objects and the leaf nodes inherit their keyword values from parent nodes up to the root. Supports the ability to search the tree for the closest valid path using the find method, or compute the appropriate Options value given an object and a mode. For a given node of the tree, the options method computes a Options object containing the result of inheritance for a given group up to the root of the tree. When constructing an OptionTree, you can specify the option groups as a list (i.e. empty initial option groups at the root) or as a dictionary (e.g. groups={'style':Option()}). You can also initialize the OptionTree with the options argument together with the **kwargs - see StoreOptions.merge_options for more information on the options specification syntax. You can use the string specifier '.' to refer to the root node in the options specification. This acts as an alternative was of specifying the options groups of the current node. Note that this approach method may only be used with the group lists format. Nc D |tdt|tr d|Dn|}||jd<||jd<d|jd<t j||||d|jd<t j||fi|}| dd r>t|tr) fd |D|jd<n rtd |rt ||dSdS) Nz'Please supply groups list or dictionaryc,i|]}|tSr7)r~)rWgs r rz'OptionTree.__init__..ds///11WYY///r8r.groupsF _instantiatedTrNc Ri|]#}|tdi|i$Sr7)r~r)rWr, root_groupss r rz'OptionTree.__init__..os7&b&b&baq)I)I;??1R3H3H)I)I&b&b&br8zgGroup specification as a dictionary only supported if the root node '.' syntax not used in the options.) rr{r__dict__rr?r merge_optionsrrrapply_customizations) r@r  identifierparentr-rr.r_groupsr1s @r r?zOptionTree.__init___sW >FGG G3=fd3K3KW//////QW#* i ") h). o&$z6:::)- o&,W\\^^WOOOOkk#t,,  :fd33 &b&b&b&bSZS_S_SaSa&b&b&bDM( # #  D   =  - -gt < < < < < = =r8c||jvrtd|d||jvr||}|j|}n!t||j|j}t |j}|j}|j|z|d< |jr|di|St|fi|S#t$r(}t|j |j||j |d}~wwxYw)z Computes a merged Options object for the given group name from the existing Options on the node and the new Options which are passed in. zGroup z not defined on SettingTree.rIrI)rJrKNr7) r-KeyErrorchildrenr~rIrrrrFrHrK) r@r5rJr current_node group_optionsoverride_kwargs old_allowedrs r _merge_optionszOptionTree._merge_optionsxs, T[ ( (LJLLLMM M  & & +L(/ ;MM$T[-D-UMw~..#4 .5.F.T*+ 7% >$}77777z==_=== 7 7 7a/0)3%)Y00067 7 7sB" B"" C,#CCcr||jvr |j|St|Sr<)r-r>r)r@itemrBs r rzOptionTree.__getitem__s5 4;  ;t$ $ww""4(((r8c tt||S#t$rYnwxYw|drtt ||jdkrt|j|zt|d}||j vr |j |S| |d|j D||S)zx Allows creating sub OptionTree instances using attribute access, inheriting the group options. _TFescapecBi|]\}}|t||jS)r9r~rIrs r rz*OptionTree.__getattr__..sD&F&F&F*-!A'(ADV(W(W(W&F&F&Fr8)r>r __getattr__AttributeError startswithrnfixed _fixed_errorr r;r2 __setattr__r-r )r@r5valid_idrBs r rIzOptionTree.__getattr__s  4((44Z@@ @    D    % % A Z11 1 Z   !2Z!?@@ @&z%@@@ t} $ $=* * &F&F151B1B1D1D&F&F&F G G GJs '+ 88cPitj|j<t|d}i}t |t r|}nt |t r|jtdt |t r[|jd r.s(IIBtBxxIIIIIIr8z;OptionTree only accepts Options using keys that are one of rN)r5r6r-r.z0OptionTree only accepts a dictionary of Options.)r _lookup_cacher.r r{rr~rrJr#r`rr)r-r;rr@r rr>rNr5) r@r5r new_groups group_itemsr-r<rJrdatanew_nodesubtreerBs r rNzOptionTree.__setattr__so,.DL)(EBBB  c4  %KK W % % %#'/ F W % % %#'!**<*<*>*> %YYII'2HIIIIIF WfWWW W % % %7C.KK Z ( ( %*K+5+F+FtJ''D &- I IJ!ooj%88G I)-)<).sh!T!Tq$)NN1$5$5!T9F9O9OPQ9R9R!T!T!T!T!T!T!Tr8c"t| Sr<r_xs r z!OptionTree.find..sQr8rrr0)r{rnsplitrr r;rrK)r@rKmoderBmatching_childrenr\r]s @@r findzOptionTree.finds#-T3"7"7Gtzz#T$ZZ  E/eDDDM!T!T!T!T!TDM!T!T!T  &'8>O>O P P P   -a01v~~tt494r8Tc|jjt|jt |jf}|p t j}t j |i}|||t|j fz}||vr||Sd d|D}| |||||} | ||<| S)a) This method is designed to be called from the root of the tree. Given any LabelledData object, this method will return the most appropriate Options object, including inheritance. In addition, closest supports custom options by checking the object rNc3K|]}||V dSr<r7rWr[s r rz%OptionTree.closest.. s'44!4!444444r8)r\defaultsr.)rBr3r r-r labelr rarRrrrootr`rgr) r@r,r-rkr. opts_speccache cache_keyr\rs r closestzOptionTree.closests M " CI & & CI & & 2U2#''44uh49 >>   # #44Y44444))I&&.. &8W/FF"ir8c Z||j}|j|ddSt|}|j|r||ur|r~|jj}|t|t|krdndz}| |d}| |} | |ur| |StS|j |j|S|j||||} tdit| jfi|j|jS)z Using inheritance up to the root, get the complete Options object for the given node and the specified group. Nr.r:rNr7)rKr-rr rr6rBr3r_replacerg EMPTY_OPTIONSr~rr) r@r-r\rkr.r root_name replacement option_keymatch parent_optss r rzOptionTree.optionss4 >YF ;??5$ ' ' /4---00 ; 6 t7/B/B/B/I#S[[C NN-J-JrrPSTK R88JLL,,EG##}}U+++$$ [ ;u% %k))%7)SS OOk0NNDK4F4MNNOOOr8c|jd}d\}}d|dzzg}}|D]v}gg}}||jikr"|d||jft |D]A\} } | j|j} |d| | fB|D]@\} |dkrtfddDr'r|| fA|rd |D} td | Dt| d kr|dznd |fd | Dz} |t| d krdnd||| fzxd|d||dS)z< Evalable representation of the OptionTree. r-)z z, z, rNrc3HK|]}|dduVdS)FNr)rWrr s r rz&OptionTree.__repr__..>s6(f(fE):):e)C(f(f(f(f(f(fr8)axiswise framewisec g|]I\}}|dddt|DdfJS)zdict(rSc3*K|]\}}|d|VdSr!r7rs r rz1OptionTree.__repr__...Es0)U)UAQ****)U)U)U)U)U)Ur8r)r`rr )rWtr s r rYz'OptionTree.__repr__..Dsh3X )U)U ATAT)U)U)U U UXXXYr8c3:K|]\}}t|VdSr<r_)rWrrDs r rz&OptionTree.__repr__..Hs,99sqCFF999999r8rr:cNg|]!\}}|d|"S)z : )ljust)rWrrrseps r rYz'OptionTree.__repr__..Js;*`*`*`caPQc+I1775>>+I+Ia+I+I*`*`*`r8z %s%s={ %s}z %s%s={%s}zOptionTree(groups=z )) r2rrrrr r-r`allmaxr_)r@r-tabgsepesepgspecsr-especs accumulatorrrr format_kwsentriesr rrs @@@r rzOptionTree.__repr__*s,x(" Ts1u f[[]] m mE"$bKFe}#r))""C)=#>???tzz||,, : :1%/""CHHQKK#89999' , ,C&==S(f(f(f(fMe(f(f(f%f%f=,MM1c(+++ m"( 99j99999!$Z!!3!3s1uu *`*`*`*`*`U_*`*`*` a aa J0A0A}}{WZ\acjVkklllLFKKMMLLdii6G6GLLLLr8)NNNNNN)r0)TN)NTN)r3r4r5r6r?r@rrIrNrgrqrrrCrDs@r r)r)Es2<@48====2777B)))))      2(J(J(J(J(JT5555*6PPPP2#M#M#M#M#M#M#Mr8r)ceZdZdZejdddgdZejgdZej d Z ej d Z ej d d Z ejd ZejddZejddZgZgZeddZeddZeddZed dZedZ d!fd ZedZdZdZddZ xZ!S)" Compositora A Compositor is a way of specifying an operation to be automatically applied to Overlays that match a specified pattern upon display. Any Operation that takes an Overlay as input may be used to define a compositor. For instance, a compositor may be defined to automatically display three overlaid monochrome matrices as an RGB image as long as the values names of those matrices match 'R', 'G' and 'B'. rUdisplayzW The mode of the Compositor object which may be either 'data' or 'display'.)rrrz: Defines which backends to apply the Compositor for.rz8 The Operation to apply when collapsing overlays.ra The overlay pattern to be processed. An overlay pattern is a sequence of elements specified by dotted paths separated by * . For instance the following pattern specifies three overlaid matrices with values of 'RedChannel', 'GreenChannel' and 'BlueChannel' respectively: 'Image.RedChannel * Image.GreenChannel * Image.BlueChannel. This pattern specification could then be associated with the RGB operation that returns a single RGB matrix for display.TzI The group identifier for the output of this particular compositorrz< Optional set of parameters to pass to the operation.FzE Whether to transfer the options from the input to the output.zF Whether to transfer plot options which match to the operation.Ncfd|jD}d|D}|gkrdSt|dS)a Returns the single strongest matching compositor operation given an overlay. If no matches are found, None is returned. The best match is defined as the compositor operation with the highest match value as returned by the match_level method. ctg|]4}|jk |jr |jv||f5Sr7)rebackends match_level)rWopr.reoverlays r rYz.Compositor.strongest_match..sQ   .0w$ w"+7M7M^^G $ $b )7M7M7Mr8c:g|]\}}||d||dfS)Nrrr7)rWryrs r rYz.Compositor.strongest_match..s;   )4% 1Xr58 $   r8Nr) definitionsr)clsrrer.match_strengthrbs ``` r strongest_matchzCompositor.strongest_matchsx      47O     8F    b==4gq!!r8cddlmddlmm}d}t |s||g}d}d}t t ||||}|1|r-t|dkr| dS|S|\} \} } t ||r(| } || | | } n1| } | | | | } | d g}rMtfd |Dr1|r-t|dkr| dS|S| ||}jr|j }t ||r|g}n0tt%| |g}xxfd |Dz cc<| | d| |z| | dz}fd }t)| d|g}||kr|S|})zA Finds any applicable compositor and applies it. r)Element)CompositeOverlayOverlayFTr7Nrc|Sr<r7r`s r rbz-Compositor.collapse_element..sar8c3,K|]}|vVdSr<r7)rWr applicable_op processeds r rz.Compositor.collapse_element..s-$T$TR9]+C%C$T$T$T$T$T$Tr8)r-cJg|]}|dgD]}| S)c|Sr<r7r`s r rbz8Compositor.collapse_element...s[\r8traverse)rWrrrs r rYz/Compositor.collapse_element..s<(i(i(iajjQ\Q\_f^gFhFh(i(i(i(i(i(ir8c&t| Sr<)r{)rars r rbz-Compositor.collapse_element..sJq2B$C$C Cr8c t|Sr<rr`s r rbz-Compositor.collapse_element..s r!uur8)elementrrrrr{rrrr_r^r clonerrapplyr-relabelziprtuple)rrrangesrer.runpackprev_idsryrDrrr^slicedr resultspec_fnnew_idsrrrrs @@@@r collapse_elementzCompositor.collapse_elements %$$$$$66666666'#344 gwi((GF%% ! ''w??E}/c'lla//">>++A..05 -Q }t'7++ ; )) d !344  veDj'9::OOKK';;E $T$T$T$T$Te$T$T$T!T!T /c'lla//">>++A.."((AAF" Cm.ABB'7++ < c&++--&::;; m $ $ $(i(i(i(iV(i(i(i i $ $ $mmF6E6N6$9&-$GHHGDCCCGG,,__wiHHIIG(""HC! r8c |jgkr|S|d}|r-t|d|jn|j}|D]\}}||||||< |S)zL Given a map of Overlays, apply all applicable compositors. F) shared_datar)rrrrUr^r r)rholomaprrerrUrrs r collapsezCompositor.collapses ?b N % 008>Xs6!9gl1133444GLDVDVDXDX  E ELC--gvtDDE#JJ r8cddlm}djD}djD}|r|fd|g}d|D}|r2|d|r|fd|}|S) zs Applies compositor operations to any HoloViews element or container using the map method. rrcBg|]}t|jdk|Srr_ _pattern_specrjs r rYz"Compositor.map..s-WWWQS=Q=QUV=V=Vq=V=V=Vr8cBg|]}t|jdk|Srrrjs r rYz"Compositor.map..s-VVVQS=Q=QTU=U=Uq=U=U=Ur8c4|SN)rer.rr,r.rres r rbz Compositor.map..c&:&:3TSZ&:&[&[r8cg|] }|j Sr7patternrjs r rYz"Compositor.map..sCCC!AICCCr8c|Sr<r7r`s r rbz Compositor.map..s!r8c4|Srrrs r rbz Compositor.map..rr8)rrrmapr)rr,rer.relement_compositorsoverlay_compositorselement_patternss` `` r rzCompositor.maps .-----WW#/WWWVV#/VVV  .''[[[[[[+,..CCC/BCCC  ,3<< =M#N#N ,''[[[[[[*,,C r8c0d|jD}|j|vr2|j||j|j||j|jvr!|j|jdSdS)Ncg|] }|j Sr7r)rWrs r rYz'Compositor.register..sAAA2BJAAAr8)rrrrr operation operations)r compositordefined_patternss r registerzCompositor.registersAAAAA  !1 1 1 O   0 6 6z7I J J K K K z***  s~ 5 5 N ! !*"6 7 7 7 7 7 6 5r8c  ggc|_ |dD]} td| dD} |j| t | dkr | dt dkr*t fd Dstdt dkr d |_nd |_||_ t |||||pg| || dS) N*c3>K|]}|VdSr<)striprs r rz&Compositor.__init__..s*LLbrxxzzLLLLLLr8rNr|rc30K|]}|dkVdSrNr7)rWllabelss r rz&Compositor.__init__..s+&D&Dq&)|&D&D&D&D&D&Dr8z4Mismatched labels not allowed in compositor patternsrr:)r-rrrerrtransfer_optionstransfer_parameters) rrdrrrr_rr:rl _output_typer>r?)r@rrr-rerr output_typerrrK path_tuplerrBs @r r?zCompositor.__init__sV%'"FMM#&& - -DLLDJJLL4F4Fs4K4KLLLLLJ   % %j 1 1 1:!## jm,,, v;;??3&D&D&D&DV&D&D&D#D#D?QRR R [[A  DJJDJ' u!(#,""*.b &*:-@  B B B B Br8c(|jp |jjS)zg Returns the operation output_type unless explicitly overridden in the kwargs. )rrrrqs r rzCompositor.output_types  >DN$>>r8cd}t|j|D]\}}|dt|jkrdS|dz }t |dkr?|jt |jdg}|d|vr|dz }ndSt |dkr0|jt|jdg}|d|vr|dz }dS|S)z Find the match strength for a list of overlay items that must be exactly the same length as the pattern specification. rNrFrErr|) rrrr3r_r-r rlr )r@ overlay_itemslevelspecrr-s r _slice_match_levelzCompositor._slice_match_levels D. >>  HD"Aw$r((+++tt QJE4yyA~~xXrxFFFGEAw%!-1TT4yyA~~?28E#J#J#JKGu$$QJEE44   r8cLt|j}|t|krdSd\}}tt||z dzD]H}||||z}||}|9||kr |}|||zf}I|dkr||fndS)a0 Given an overlay, return the match level and applicable slice of the overall overlay. The level an integer if there is a match or None if there is no match. The level integer is the number of matching components. Higher values indicate a stronger match. Nrrr)r_rrr^r)r@r slice_widthbest_lvl match_slicei overlay_slicelvls r rzCompositor.match_level4s$,-- W % %dd!*+s7||K/122 1 1A#NN,,Qq}_=M))-88C{HX~~ !K-0 *2a--+&&TAr8cddlm}| tj}djD}t ||rt|dkru|d}j rTt ||dj}| fd|Dj |fd|i|}j r ||urt ||||S) zP Apply the compositor on the input with the given input ranges. rrNc&i|]\}}|dk ||S)rr7rs r rz$Compositor.apply..Rs(MMM41a!}:L:L!Q:L:L:Lr8rr$c8i|]\}}|jjv||Sr7)rr+)rWrrr@s r rz$Compositor.apply..Ws8===1"#t~';";"; !!";";";r8 input_ranges)rrr rarr r{r_r^rr)updaterr)r@rlrr.rr plot_opts transformeds` r rzCompositor.applyLs5 .----- ?e&;GMM4;#4#4#6#6MMM e- . . >3u::??LLNN1%E' >!00%HHO  ==== 0A0A===>>>%dnUPPPPP   @U+%=%=  " "5+w ? ? ?r8r<)NrUN)NrU)rUN)FFNN)"r3r4r5r6r+ObjectSelectorrerr Parameterrrrr-Dictrrrrrr classmethodrrrrrr?r'rrrrrCrDs@r rrSsn   5 )/(;B   D uz"+=>>>H %;<<|jD] }||||_dS)z:Use this method to set the backend to run the switch hooksN)_backend_switch_hooksra)rr.hooks r set_current_backendzStore.set_current_backends3-  D DMMMM%r8cb||jn|}| |j|Si|j|<||j|<dSr<)rarrR)rr.rs r rz Store.optionssD)0#%%g ;<( ()+C g &$'CL ! ! !r8cNt|jS)zs Returns a list of the backends that have been loaded, based on the available OptionTrees. )rrrrs r rzStore.loaded_backendss cl''))***r8cN||jn|}| |j|S||j|<dSr<)rar)rrr.s r custom_optionszStore.custom_optionss9)0#%%g ;&w/ /+.C  ( ( (r8cxt|_tj|}d|_|S)zn Equivalent to pickle.load except that the HoloViews trees is restored appropriately. N)r id_offsetload_counter_offsetpickleload)rfilenamers r rz Store.loads4 #/"8"8":":k(##"& r8cxt|_tj|}d|_|S)zo Equivalent to pickle.loads except that the HoloViews trees is restored appropriately. N)rrrrloads)r pickle_stringrs r rz Store.loadss4 #/"8"8":":l=))"& r8rcPd|_tj|||d|_dS)zq Equivalent to pickle.dump except that the HoloViews option tree is saved appropriately. TprotocolFN)save_option_staterdump)rr,filers r rz Store.dumps1 !% C1111 %r8cNd|_tj||}d|_|S)zr Equivalent to pickle.dumps except that the HoloViews option tree is saved appropriately. TrF)rrdumps)rr,rrs r rz Store.dumpss- !%l3222 % r8Tc|g}t|tj}t|tot |tj} d} |s| rt j||||||} |rj|rh|d} g} | ddD]E} | | vr?t j| ||||}|rdnd}| d||zzz } | | F| S) z Show information about a particular object or component class including the applicable style and plot options. Returns None if the object is not parameterized. N)ansir. visualizationrelementsc t|Sr<)rr`s r rbzStore.info..s tAwwr8r)r r.r!rz %sz%sz ) r{r+ Parameterizedr issubclassrrrr)rr,r r.r! recursiverr"parameterized_objectparameterized_classr hierarchylistedr[ inner_infoblacks r rz Store.infos8  H)#u/BCC)#d33 H$.s53F$G$G   H#6 H#CdG2?,3hHHHD %I % %6%677IFqrr] % %F??!,!1!$@M:A"C"C"CJ6:C11tEVuz'9::DMM!$$$ r8c|j|j|vr/|j||j||||S|stS|j|||||S)Nrs)rrrqr~r)rr.r,r-rks r r)zStore.lookup_optionss 6S(1 1 1&w/7??UHg@77 7 X99 <(00eXw0WW Wr8cd|dD}t|dkrtdt|dkr>ddt |D}td|z|j|t t|S) z Given an object, lookup the corresponding customized option tree if a single custom tree is applicable. ch|]}||Sr<r7rs r zStore.lookup.. sKKKbBNrNNNr8c|jSr<rr`s r rbzStore.lookup.. s14r8rz)Object does not own a custom options treer,c,g|]}t|Sr7rrs r rYz Store.lookup..s===2s2ww===r8zGObject contains elements combined across multiple custom trees (ids %s))rr_rr`rrnextr)rr.r,idsidlists r lookupz Store.lookups LKCLL88KKK s88q==GHH H XX]]XX=====>>F=?EFGG G"7+DcOO<.sOOOqQOOOOr8F)rkc0i|]\}}|v |v||Sr<r7)rWrrexistingnamess r rz*Store.transfer_options..'sBPPPA!MQ%ZZQh=N=N1=N=N=Nr8)rarr3r-r`rlr~rr)rr rr set_options)rr,new_objr.r=r type_namer-rroptsnew_optsr*r<s ` @r rzStore.transfer_optionss '>> F)0#%%gMM*  Y$s))*<<< #)xxOOYsy$A&5&$IOOOPP+ ; ;E%%gsE::D ))'7EE)RRH*2:xHPPPPP):):)<)<PPPH ;wu9999:::  H  $ $WtWow G G G G G H Hr8c||jn|}||j|vrtd|dt|trt d|Dstdt jd5|D]L}||j||jvr0|j||}t|j|gz|_M dddn #1swxYwYtdd| |j ||j <dS) ag Given a component such as an Element (e.g. Image, Curve) or a container (e.g. Layout) specify new style options to be accepted by the corresponding plotting class. Note: This is supplied for advanced users who know which additional style keywords are appropriate for the corresponding plotting class. Nz Component z$ not registered to a plotting class.c3@K|]}t|tVdSr<rrs r rz'Store.add_style_opts..?s-7b7bPR 2s8K8K7b7b7b7b7b7br8z4Please supply a list of style option keyword stringsCRITICALr#T)rrI) raregistryrr{rrr+ logging_levelr'rr~rname)r component new_optionsr.optionr/s r add_style_optszStore.add_style_opts.s*1#%%g CL1 1 1NYNNN +t,, C7b7bVa7b7b7b4b4b F   , , S S% S Sg!6y!A!LLL!$g!6y!AJ,2:3H&3Q,R,RJ) S S S S S S S S S S S S S S S S 18 D;1 1 1  Win---s?ACC #C c  i||jvr i|j|<|j||tj}||jvrt g|||j|<||jvr i|j|<|j|D]C\} fd jD}t fd| jzD}t drt j n }d|D} tjd5| _dddn #1swxYwYt| |j} t||j}t| ttj t| td d d d g d} |j} | |j|| <EdS)z Register the supplied dictionary of associations between elements and plotting classes to the specified backend. Nr-r.cFg|]}|gD]}|Sr7r~)rWropt style_aliasess r rYz"Store.register..`sVDDDS(5(9(9#r(B(BDD!$!DDDDr8c&h|] }|jv |Sr7)_disabled_opts)rWrPr$s r r0z!Store.register..bs3!G!G!G'*$2E'E'E"%'E'E'Er8r+cg|]}|dv| S))rHr7)rWrs r rYz"Store.register..gs"@@@qax.?.?.?.?.?r8rErr9Frr)rrrI)r$rr#r)rFrr~rrr)rr r'rhasattrrr+rrGrr3r&) r associationsr.rQr- view_class expanded_optsr'rr opt_groupsrHr$s ` @r rzStore.registerMs  M #, & &$&CL ! W$$\222' #, & &$.r&'$R$R$RCL ! #- - -+-C  ( # W 5 ; ; = = 5 5 JDDDDDODDDM!G!G!G!G1P!G!G!GHHJ*1w)?)?RT$*%%%T[[]]F@@F@@@I$Z00 - -", - - - - - - - - - - - - - - -")Z5HIIII!*Z5HIIIJ"9===!73NOOO!:>>>!EE4?3LNNN J&D*4CL !$ ' '3 5 5s/EE E c&||j||<dS)z Specify a display hook that will be applied to objects of type objtype. The group specifies the set to which the display hook belongs, allowing the Store to compute the precedence within each group. N)_display_hooks)rr-objtypers r set_display_hookzStore.set_display_hookzs.25!'***r8cftjt|}g}|jD]+\}}|D]#}||vr|||n$,ii}}|D]?}||} | | \} } || || @||fS)z Using any display hooks that have been registered, render the object to a dictionary of MIME types and metadata information. )inspectgetmrorr[r rr) rr,class_hierarchyhooksrD type_hooksrUmetadatarretdmds r renderz Store.renders ".c33 /5577  MAz&  *$$LLC111E%Rh  D$s))C{EAr KKNNN OOB    X~r8rg)r)TrTFNN)T)NNrr<)%r3r4r5r6r%rFdisplay_formatsrrr[rrrrRoption_settersrrrrarrrrrr rrrrrr)r7rrLrr]rhr7r8r r r `suIHhO![&&NHIMN$R(O"O&&[& ((([(++[+///[/[[&&&[&[FJ59[>XXX[X = =[ =HHH[H2   [ <*5*5*5[*5X22[2[r8r ceZdZdZdZedZedZedZedZ edZ eddZ ed Z ed Z ed Zedd Zedd ZedZeddZeddZeddZeeddZedZeddZeddZdS)ra A collection of utilities for advanced users for creating and setting customized option trees on the Store. Designed for use by either advanced users or the %opts line and cell magics which use this machinery. This class also holds general classmethods for working with OptionTree instances: as OptionTrees are designed for attribute access it is best to minimize the number of methods implemented on that class and implement the necessary utilities on StoreOptions instead. Lastly this class offers a means to record all OptionErrors generated by an option specification. This is used for validation purposes. Ncg|_dS)z~ Start collecting OptionErrors for all skipped options recorded with the record_skipped_option method N)_errors_recordedr s r start_recording_skippedz$StoreOptions.start_recording_skippeds "r8c^|jtd|jdd}d|_|S)zu Stop collecting OptionErrors recorded with the record_skipped_option method and return them Nz*Cannot stop recording before it is started)rmr)rrecordeds r stop_recording_skippedz#StoreOptions.stop_recording_skippeds:   'HII I'*#r8cL|j|j|dSdS)zh Record the OptionError associated with a skipped option if currently recording N)rmr)rrs r rz"StoreOptions.record_skipped_options2   +  ' ' . . . . . , +r8cBd|dDS)Nch|]}|Sr7r7rs r r0z.StoreOptions.get_object_ids..s*FFFrFFFr8c$t|ddSNr)getattrr`s r rbz-StoreOptions.get_object_ids..sWQd-C-Cr8rrr,s r get_object_idszStoreOptions.get_object_idss9FFll#C#CDDFFF Fr8ci}|D]Q}d|}i||<||jD]'}||j|j}|r ||||<(R|S)zX Given an OptionTree, convert it into the equivalent dictionary format. rN)rr`r-r)rtreespecsrspec_keygrprs r tree_to_dictzStoreOptions.tree_to_dicts  2 2Axx{{H E(OAw~ 2 2a,32+1E(OC( 2 r8cgfd}||t|dhzt|vrt dzS)z Recursively propagate an id through an object for components matching the applied_keys. This method can only be called if there is a tree with a matching id in Store.custom_options cz|jks|jjdkr|_|dSdS)N DynamicMap)rrBr3r)oappliedmatch_idnew_ids r propagatez-StoreOptions.propagate_ids..propagatesGtxAK$8L$H$Hq!!!!!%I$Hr8r)r|rszINew option id %d does not match any option trees in Store.custom_options.)rrr r AssertionError)rr,rr applied_keysr.rrs `` @r propagate_idszStoreOptions.propagate_idss " " " " " " " Yc,&7&7<.&H III --g->> > > "I#)"*++ +r8c.|dS)zq Given an list of ids, capture a list of ids that can be restored using the restore_ids. c|jSr<r)rs r rbz*StoreOptions.capture_ids..sadr8rrxs r capture_idszStoreOptions.capture_idss ||NN+++r8cVt|fddS)z Given an list of ids as captured with capture_ids, restore the ids. Note the structure of an object must not change between the calls to capture_ids and restore_ids. c@t|dtSrv)setattrr4)rr5s r rbz*StoreOptions.restore_ids..swq$S ::r8N)rr)rr,r5s `r restore_idszStoreOptions.restore_idss23ii ::::;;;;;r8cft|D]t|ttfrd|D}n$d|D}fd|D}||t <|S)zL Apply the given option specs to the supplied options tree. ci|] }|j| Sr7rcrs r rz5StoreOptions.apply_customizations..s = = =a = = =r8c\i|])\}}|t|tr tdi|n|*Sr0)r{rr~rs r rz5StoreOptions.apply_customizations..sK!?!?!?%(Qq"#Z45H5H%OW\\q\\\a!?!?!?r8cti|]4\}}||dd5SrNr)rrd)rWrrrs r rz5StoreOptions.apply_customizations..sL???!$1 1 1#))C..2C D D???r8)rrr{rrr rn)rrr customizationrs @r r4z!StoreOptions.apply_customizationss $))++&& . .C$s)dE]33 ? = =49 = = = !?!?,0IOO,=,=!?!?!? ????(5(;(;(=(=???M -GCHH  r8cZ|tn|}i}tt}|D] }|t dd5t t|j t|j |}| ||dddn #1swxYwY| D]D}|j |jj|jf} |j|| |fz<|| |E| D]Q\\} } } }t|t|kr(| | | tjf} t'| | || RdS)av Given a specification, validated it against the options tree for the specified backends by raising OptionError for invalid options. If backends is None, validates against all the currently loaded backend. Only useful when invalid keywords generate exceptions instead of skipping, i.e. Options.skip_invalid is False. NTF)rrr r-r.)rJrI)r rrrrnrr)rrUr r-r4rqrHrIr\rJaddrarF)rrrr error_infobackend_errorsr.rr error_keyr[r\rJrs r validate_speczStoreOptions.validate_spec#s6>5E%//1118 $S))& 7 7G  ' ' ) ) )TFFF 8 8$--005;;== ==118# ((w777  8 8 8 8 8 8 8 8 8 8 8 8 8 8 83355 7 7"2"3:"-/ 493I 9gZ/0y)--g6666  7:H9M9M9O9O D D 5 *gvzH8}}O 4 444 E4IJ!'-73=c?DDDD5 D DsA5CC# &C# c |||dS#t$r}|cYd}~Sd}~wwxYw)z Returns an options validation error message if there are any invalid keywords. Otherwise returns None. )rN)rrFrf)rrrrs r validation_error_messagez%StoreOptions.validation_error_messageLsf  ,   dX  6 6 6 6 6 , , ,))++ + + + + + + ,s A>AAci}g}dtjD}|D]2\}}||vr|||<dg}||}||t|dz|z<3||fS)z Expands compositor definition keys into {type}.{group} keys. For instance a compositor operation returning a group string 'Image' of element type RGB expands to 'RGB.Image'. c2i|]}|j|jjSr7)r-rr3rs r rz7StoreOptions.expand_compositor_keys..`s.   24BHbn-   r8rrN)rrr rn)rr expanded_specrcompositor_defsrrr@s r expand_compositor_keysz#StoreOptions.expand_compositor_keysWs    8B8N     < .}s*BBB3399S>>!,.BBBr8rscDi|]\}}|t|jS))rIr.rH)rWr~rPr.s r rz4StoreOptions.create_custom_trees..sI*** #c ),)= '***r8rrrNcLi|] \}}|r|n|!Sr7)r4)rWrrrrs r rz4StoreOptions.create_custom_trees..sI+++Aa7I3++GQ777+++r8) ryrr_r rarr-r r r)r.r)rr,rr.clones id_mappingobj_idsoffsetused_obj_typesavailable_options used_optionsobj_type opts_groupsr tree_idoriginalrrAs` `` r create_custom_treesz StoreOptions.create_custom_treesms@  $$S))LLA--4&&7BB'BBB2U2!MM'M:: )  H>))/9@ **** '2&7&7&9&9 *** X&--g->> ' 'G"w.'@'@)'2""..**#?$, 05w'!+,!!7Gf,>+++,67 7r8c t|*t|kr|d}}nC|Atfd|Dr&tddd|in t di|}d|D}|D]}i}|D](\}}||vr||} ||| i)||vri||<|D]E} | ||vr(||| || 4|| ||| <F|S)a Given a full options dictionary and options groups specified as a keywords, return the full set of merged options: >>> options={'Curve':{'style':dict(color='b')}} >>> style={'Curve':{'linewidth':10 }} >>> merged = StoreOptions.merge_options(['style'], options, style=style) >>> sorted(merged['Curve']['style'].items()) [('color', 'b'), ('linewidth', 10)] Nc3 K|]}|vV dSr<r7)rWrr-s r rz-StoreOptions.merge_options..s')G)G!!v+)G)G)G)G)G)Gr8zAll keys must be a subset of rSrNch|] }|D]}| Sr7r7)rWrfrs r r0z-StoreOptions.merge_options..s%:::!::1A::::r8r7) rrrrr`rr^r r) rr-rrall_keysr} additionsrrfr rs ` r r3zStoreOptions.merge_optionssV  C $7$76$A$A%tGFF!c)G)G)G)Gw)G)G)G&G&G!F$))F2C2CFFF!""tg::v}}::: < )rr,rroptstater-s r rzStoreOptions.optionss  F %)E "yy~~H]]__+0022F'c'BB6BBG OOC ) ) ) / EEE")-& #X .....#"w")-& #X ....#s >B++(Cctg}tjD]x}tt|}t |dkrt |dznd}||yt |rt |ndS)z Compute an appropriate offset for future id values given the set of ids currently defined across backends. rsrr)r r%rrr r_rr)rmax_idsr. store_idsmax_ids r rzStoreOptions.id_offsets ++-- # #GU11'1BBGGIIJJI),Y!););S^^A%%F NN6 " " " ""7||2s7|||2r8cT| tjn|}t||itj|<tD]@}||kr tj|}|D]"\}}||d}||||<#AdS)a Given the id_mapping from previous ids to new ids and the new custom tree dictionary, update the current backend with the supplied trees and update the keys in the remaining backends to stay linked with the current object. Nrs)r rar rrRrrr) rr custom_treesr.rX backend_treesold_idrr{s r update_backendszStoreOptions.update_backendss,3?%'' W--44\BBB')G$&&(( 1 1AG||!1!4M$. 1 1 $((66#,0M&) 1  1 1r8c t|j}|j||fi|}||\}}||||\}} || ||g} | D]Z\} } |t|z} | || | | |}|s| | [t| D]} t| |S)a Pure Python function for customize HoloViews objects in terms of their style, plot and normalization options. The options specification is a dictionary containing the target for customization as a {type}.{group}.{label} keys. An example of such a key is 'Image' which would customize all Image components in the object. The key 'Image.Channel' would only customize Images in the object that have the group 'Channel'. The corresponding value is then a list of Option objects specified with an appropriate category ('plot', 'style' or 'norm'). For instance, using the keys described above, the specs could be: {'Image:[Options('style', cmap='jet')]} Or setting two types of option at once: {'Image.Channel':[Options('plot', size=50), Options('style', cmap='Blues')]} Relationship to the %%opts magic ---------------------------------- This function matches the functionality supplied by the %%opts cell magic in the IPython extension. In fact, you can use the same syntax as the IPython cell magic to achieve the same customization as shown above: from holoviews.util.parser import OptsSpec set_options(my_image, OptsSpec.parse("Image (cmap='jet')")) Then setting both plot and style options: set_options(my_image, OptsSpec.parse("Image [size=50] (cmap='Blues')")) rs) r rr-rr3rrrrrrrr!)rr,rr.rr-rcompositor_appliedrrnot_usedrrrrs r r>zStoreOptions.set_optionss:Xw//6;;==###FG>>v>>#&#=#=g#F#F  #&#:#:3g#:#V#V j J gFFF", ( ( Xv$T$))++%6%66C''XvsG(G ('''(mm + +F "6 * * * * r8r<rg)r3r4r5r6rmrrnrqrryrrrrr4rrrrr3rrrrrr>r7r8r rrsf*""["  [ //[/FF[F  [ [(,,[,<<[<["%D%D%D[%DP,,,[,++[+*474747[47l"""["J***[*$///^[/2 3 3[ 3111[1,???[???r8rr<)+r6rr_rrm collectionsr contextlibrnumpyrr+ accessorsrpprintrr{rutilr r r r!r) RuntimeErrorr2rr(rFrirwrr$rrrrr~r)rurr rr7r8r rs!!D ######%%%%%% GGGGGGGGGGB*L """""I"""9 9 9 9 9 )9 9 9 xJJJJJ9JJJ: @ @ @ @ @ @ @ @ @ @ @6;6;6;6;6;u"6;6;6;tA1A1A1A1A1E A1A1A1J   ?:?:?:?:?:e?:?:?:FLLLLLLLL`HMHMHMHMHMHMHMHMV JJJJJ$JJJZzzzzzzzzz BBBBBBBBBBr8