hMh# ddlmZddlmZddlZddlmZddlmZddl Z ddl Z ddl ZddlmZddlmZddlmZdd lmZddlmZdd lmZmZdd lmZmZm Z dd l!m"Z"dd l#m$Z$ddl%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-ddl.m/Z/ddl0m1Z1m2Z2m3Z3ddl4m5Z5ddl6m7Z7m8Z8gdZ9GddeZ:Gdde:Z;eed?d@edAdBedCdDedEdFedGdHedIdJedKdLedMdNedOdPedQdRedSdTedUdVedWdXedYdZed[d\ed]d^ed_Z=e=>e8 dddddddddd`dadbdcddddbddddedddbddfdgZ?edhj@die=e?_A dddddddddd`dadidedcdbdddbdjdkdldmdndeddddedbeeedddo!dpZBedqj@die=eB_A dddddddddd`dadbdcddddrdsdtdudadddeddbedddddvdwZCedxj@die=eC_A dddddddadeddddyeddddeddbddzd{ZDed|j@die=eD_A dddddddeddddydddddeddbdudd}d~ZEedj@die=eE_A dddddddddddddddd`daddcdbdddeddbddeeedddZFedj@die=eF_A dddddddddddddddeededdeddddbdeeeedddZGedj@die=eG_A dddddddddd`dadddcdbdddeddbdddZHedj@die=eH_A dddddddddddddddddddydmddeddddddbdadadadeded!dZIedj@die=eI_AGddZJeddZKGddZLdS)) namedtuple)dedentN rgb_to_hls)partial)normalize_kwargs)PatchCollection) MarkerStyle) Rectangle)default deprecated) VectorPlotter infer_orientcategorical_order)KDE)utils) desaturate_check_argument _draw_figure_default_color_get_patch_legend_artist_get_transform_functions_scatter_legend_artist_version_predates)groupby_apply_include_groups)EstimateAggregator LetterValuesWeightedAggregator) light_palette) FacetGrid _facet_docs) catplot stripplot swarmplotboxplot violinplot boxenplot pointplotbarplot countplotceZdZddddZddiZdgZdidddddffd Zd#d Zd Zd Z d Z dZ dZ dZ dZdZdZdZdZd$dZd%dZedZdZdZfdZdZdZdZd Zd!Zd"ZxZ S)&_CategoricalPlotterz@columns@valuesxyhuer0colorNFautoc2t|||jdkr|dvr|jddd|_t |j}|jdd} |jdd} |jdd} |jdd} d|vr| |jd<| |jd<d|vr| |jd<| |jd<|jdkrAd|jvr8|6|j dd |jdt|j dd|j dd|d |_ ||_ |jsdS|j |jvr-d|j|j <d |j|j <d|j|j <t|j|j |} | |j|j <dS)N)data variableswide)hr0r0r/r/r0columnsr1axisF)r/r0orientrequire_numeric categorical)super__init__ input_format plot_datarenamesetr6pop var_typesdroprgetr?legend has_xy_datar var_levels)selfr5r6orderr?r@r2rMorig_variablesorig_xorig_y orig_x_type orig_y_type cat_levels __class__s S/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/seaborn/categorical.pyrDz_CategoricalPlotter.__init__8s/ di888   & &6Z+?+?!^223;O;O2PPDN 00N^''T22F^''T22F.,,S$77K.,,S$77Kn$$&,s#&1s#n$$&,s#&1s#   ' '''! N  A  . . . N  u % % %#n  d++n  d++!        F ;dn , ,*.DN4; '*7DN4; '*,DN4; ''t~dk'BEJJ '1 $$$c|dup|du}|rd|jvr|rd|_|j|j|jd<|j|j|jd<d|jd<|j|j}t |trd|D}nFd|jvr4|jd|j|jk }nd}||_d|jvr_|]|[t |tstj |}d|}d|d }tj|t d ||fS) aImplement backwards compatibility for hue parametrization. Note: the force_hue parameter is used so that functions can be shown to pass existing tests during refactoring and then tested for new behavior. It can be removed after completion of the work. Nr1TrAc4i|]\}}t||S)str.0kvs rY z7_CategoricalPlotter._hue_backcompat..s$AAAA3q661AAArZFzdark:zf Setting a gradient palette using color= is deprecated and will be removed in v0.14.0. Set `palette='z'` for the same effect.  stacklevel)r6_redundant_huerFr?rJrO isinstancedictitemsallr^mplcolorsto_hexwarningswarn FutureWarning)rPr2palette hue_order force_huedefault_behavior redundantmsgs rY_hue_backcompatz#_CategoricalPlotter._hue_backcompats$!D=?G4,?  ,dn449I4"&D $(N4;$?DN5 !$(N4;$?DN5 !$1DN5 ! 4I'4(( BAAAAA&&!^E2dnT[6QQVVXX ! "+D  DN " "w5;LeS)) 1 ))%00%eooGX5<XXX  M#} ; ; ; ; !!rZcd|jvr|d|jd}tj|tdd|_|j|j|jd<|j|j|jd<|j|j|jd<|j |j}|j dd|S)z?Provide one cycle where palette= implies hue= when not providedr1Nzf Passing `palette` without assigning `hue` is deprecated and will be removed in v0.14.0. Assign the `z@` variable to `hue` and set `legend=False` for the same effect. rdreF) r6r?rorprqrMrFrLrJrO _var_levelsrI)rPrrrsrws rY_palette_without_hue_backcompatz3_CategoricalPlotter._palette_without_hue_backcompats  & &7+>I?C{III  M#} ; ; ; ;DK$(N4;$?DN5 !$(N$6$6t{$C$CDN5 !$(N$6$6t{$C$CDN5 !++DK88I    - - -rZcF|turRtjddz|z}|dz}|dz}d}tj|d|||||turBs(CaB  M#! , , , , MMBM K K K z ! !U  ,V  +++ 4KC M#! , , , , , , " !rZcfd}| |dd||dd|| d}d}tj|td |fS) zFProvide two cycles where existing signature-level err_kws are handled.c|turdSd|d|d}d|d|d}tj|td||<dS) Nz err_kws={'z': }z The `zA` parameter is deprecated. And will be removed in v0.15.0. Pass `z ` instead. rer rorprq)namekeyvalsuggestrwerr_kwss rYdeprecate_err_paramzD_CategoricalPlotter._err_kws_backcompat..deprecate_err_paramsyj  5C55C555G;D;;%,;;;  M#} ; ; ; ;GCLLLrZNerrcolorr2errwidthrrzi Passing `capsize=None` is deprecated and will be removed in v0.15.0. Pass `capsize=0` to disable caps. rdre)rorprq)rPrrrcapsizerrws ` rY_err_kws_backcompatz'_CategoricalPlotter._err_kws_backcompats          GX > > >J X>>> ?GB  M#} ; ; ; ;rZc|tur$|}d|d}tj|td|tur%|}d| d}tj|td||fS)1Provide two cycles of backcompat for scale kwargsz\ The `scale` parameter has been renamed and will be removed in v0.15.0. Pass `density_norm=z` for the same effect.rdrez` The `scale_hue` parameter has been replaced and will be removed in v0.15.0. Pass `common_norm=r)rPr scale_hue density_norm common_normrws rY_violin_scale_backcompatz,_CategoricalPlotter._violin_scale_backcompats  " " LR27RRR  M#} ; ; ; ; J & &#KW5>WWW  M#} ; ; ; ;[((rZcz|tur1|}td|d}tj|td|S)zGProvide two cycles of backcompat for violin bandwidth parameterization.z{ The `bw` parameter is deprecated in favor of `bw_method`/`bw_adjust`. Setting `bw_method=z`, but please see docs for the new parameters and update your code. This will become an error in seaborn v0.15.0. rdre)r rrorprq)rPbw bw_methodrws rY_violin_bw_backcompatz)_CategoricalPlotter._violin_bw_backcompatsW Z  I$&C M#} ; ; ; ;rZc|tur4|}d|}|dkr|dz }n|dz }tj|td|S)rzl The `scale` parameter has been renamed to `width_method` and will be removed in v0.15. Pass `width_method=areaz<, but note that the result for 'area' will appear different.z for the same effect.rdrer)rPr width_methodrws rY_boxen_scale_backcompatz+_CategoricalPlotter._boxen_scale_backcompat(sl  " " LJ@EJJ UU.. M#} ; ; ; ;rZc|dkr!d}tj|tdd}n | |turd}|dkr|S|j%|dSt j|g}n#d|jD}tj |d }d |D}t|d z}|||fS) zBAllow a color to be set automatically using a basis of comparison.grayzkUse "auto" to set automatic grayscale colors. From v0.14.0, "gray" will default to matplotlib's definition.rdrer3NcLg|]!}tj|"Sr])rlrmto_rgb)r`cs rY z9_CategoricalPlotter._complement_color..Ls(QQQaSZ&&q))QQQrZrr=c<g|]}t|dddS)Nrdr<r)r`rgbs rYrz9_CategoricalPlotter._complement_color..Ns*GGG#j#bqb'*1-GGGrZg333333?) rorprqr lookup_tablerlrmrvaluesnpuniquemin) rPr2 base_colorhue_maprwbasis unique_colors light_valslums rY_complement_colorz%_CategoricalPlotter._complement_color8s F??C  M#} ; ; ; ;EE ]ew..E F??L   '!tZ&&z223EEQQ73G3N3N3P3PQQQE %a000 GGGGG *oo"S#rZctur|||d|jvrK|jj}t t rdt|D}nfd|D}ndi}|S)zFSupport pointplot behavior of modifying the marker/linestyle with hue.r1ci|]\}}|| Sr]r]r_s rYrcz:_CategoricalPlotter._map_prop_with_hue..Zs???DAq1a???rZci|]}|Sr]r])r`ravalues rYrcz:_CategoricalPlotter._map_prop_with_hue..\s4441e444rZN)r rIr6_hue_maplevelsrhlistzip)rPrrfallbackplot_kwsrmappings ` rY_map_prop_with_huez&_CategoricalPlotter._map_prop_with_hueRs G  LLx00E DN " "])F%&& 5??C,>,>???4444V444UmGrZc |j|dkrdS|j|jrdStt |d|d}|dkr7|jd|d|dz d dS|jd| |dz dd dS) z0Set ticks and limits for a categorical variable.rANget_ticksr/Fg?)r3) rJrFemptylengetattrxaxisgridset_xlimyaxisset_ylim)rPaxr>ns rY_adjust_cat_axisz$_CategoricalPlotter._adjust_cat_axisbs >$ = 0 0 F >$  %  F /.4...//11 2 2 3;; HMM% KKQV$K / / / / / HMM% KKB$K / / / / /rZct|jddht|jz}d|jvrR|j|}|jg|d}|j|jkSdS)z3Return True when use of `hue` would cause overlaps.colrowr1F)rr?rHr6rF value_countssize)rPgroupersr?paireds rY _dodge_neededz!_CategoricalPlotter._dodge_neededseU3c$.6I6IIJJ DN " "^H-::<22V #DIN 3 3d6l6K6K6M6M MW ) / /!=3==(CT11 #DIDI /  / /rZc|jdkr|j o |jdk}nt|j}|rO||||||\}}|r||jdSdSdS)Nr3r7) semantic_kws)title)rMrgrEbooladd_legend_dataget_legend_handles_labels legend_title)rPrfunc common_kwsr show_legendhandlesrs rY_configure_legendz%_CategoricalPlotter._configure_legends ;& "11Qd6G66QKKt{++K  3  T:L Q Q Q5577JGQ 3  1 22222  3 3 3 3rZc|j|jdkrdStj|j|j}t |dkr'tjtj|}nd}|S)zCReturn unit of width separating categories on native numeric scale.rAr<)rJr?rr comp_datarnanmindiff)rP unique_values native_widths rY _native_widthz!_CategoricalPlotter._native_widthsp >$+ &- 7 71 $."=>> }   ! !9RW]%;%;<>)(8,,rZcd|jz}|||}|durd}nt|}d|jvr*|r(|jj|t |jjz}||jz}ttj j | | }|j g} |r| d|j } dx} } d|vr=t|ds|dd|| dd D]\} }|| } |H|dkr0||d|jjj} t |d kr|t | nd} ||j | z| z}|||j <|| || j|d |d fd|i|}d|jvr.|||d|| t4|dS)N皙?Tg?r1)lowhighrmarker edgecolorfrom_comp_data allow_emptyr<)rr/r0r2)r)rrfloatr6rrrrrrandomuniformr?appendrr is_filledrI iter_data _get_axesanymaprrscatterset_facecolorsrr)rPjitterr r2rrrjlimjitterer iter_varsr dodge_move jitter_movesub_varssub_data adjusted_datapointss rY plot_stripsz_CategoricalPlotter.plot_stripssxT''&&ue44 T>>DD==D DN " "u "1E1Q C ,-- -D ""29,4%teDDD[M  $   U # # # W#$$ [ x   HX4F(G(G(Q(Q(S(S  LLd + + +"&..@D=A#1#C#C F F Hh))B"1 '9'9';';"$Xe_%8%89M9S%T%TU :=h--!:K:K((H 6666QRK$T[1J>LM$1HT[ !   r8 , , ,RZ x}VVEVXVVF&&%%dmmHUO&D&DEEE r#9hOOOOOrZcdjz}||}jg}|r|dji}d} d|vr=t |ds|dd|ddD]\} } | |0|| d j j j } | js| j| z| j<| j| d| d fd |i|} djvr.|  | d| js| || jjdf<t)|j| |D]P\\} } | jdd kr%| d fd }|| | _Qt5jt:|dS)Nrr1rrrTrr/r0r2)rr? warn_threshr<)centerc|| jdkrd}}n}d} j jdk}|j|s|s|r||t|j | |dS)Nr0FrAscalexscaley) r?get_autoscaley_onget_autoscalex_onrJupdate_datalim get_datalim transDataautoscale_viewrCrXdraw) r/rendererr3r6r7 fixed_scalerXrbeeswarmrPs rYr>z-_CategoricalPlotter.plot_swarms..draw4sHVV,,,{c))!&!#!5!5!7!7!#!5!5!7!7!& #'."="NK%%f&8&8&F&FGGG&HFHfH)))GGG&*F3388BBBBBrZ)rrr?rrr rrIr r!r#rrrrrr$r6r%ilocBeeswarmrj get_offsetsshape__get__r>rfigurerr)rPr r2r2rrrr)point_collectionsr*r,r-r/r3r>rrArXs` @@rY plot_swarmsz_CategoricalPlotter.plot_swarmssT''&&ue44[M  $   U # # # W x   HX4F(G(G(Q(Q(S(S  LLd + + +"&..@D=A#1#C#C P P Hh))B"$Xe_%8%89M9S%T%TU > K(0(= (J%   r8 , , ,RZ x}VVEVXVVF&&%%dmmHUO&D&DEEE> PIO!2x '<'A!'D"EF% UUU$5$;$;$=$= 3 3 LR&!!##)!,q005;CCCCCCCCCC,#ll622 RY r#98DDDDDrZc  dg} ddd|j} tjjf fd } |s|tjd} dtjd} d d d |rtjjntjj}| d || d | d| d| dd}|d dd|ddd|dd| |j }| | dd D]]\}}| |}| |j| }t||jt }d|D}t#jtj|||}||jz}t#j|j|d|i}|r||||r|dxxd|z zcc< dd|dz}|||t3|| \}}dD]}|||||<|d||d<t7|d|jd d!k}d|vr||dn|}|r>||d"|d } d#|i|d }!d#|i|d}"d$|i|d}#d#|i|d}$n.get_props`s*#HLLG1B1B1BB$G$GPP PrZr} bootstrapzboxplot.bootstrap shownotchesnotchFboxmedianwhiskerfliercap)rSrTrUrVrWsolid_capstylebuttrTrc<g|]\}}|Sr])r)r`rr/s rYrz2_CategoricalPlotter.plot_boxes..s$;;;41a!**,,;;;rZ)whisrPrr< capwidthsr)r medq1q3cilocihiwhislowhishifliersrrlinear facecolorrr2markeredgecolorrrecordsr) bxpstats positionswidths patch_artistvert manage_ticksboxprops medianprops whiskerprops flierpropscappropsz3.6.0rboxesrdupdatexupdateymedianscapsrr])0r?rllinesLine2DrrI setdefaultpatchesr rr r!groupbysortedrastyperpd DataFramecbook boxplot_statsrrrLrrr#rrrito_dictrbxpr enumerateget_pathverticesTget_dataset_datar:r transpose get_xydata add_containerBoxPlotContainerrr)4rPrr gapfillr[r2 linecolorr fliersizerr) value_varrOrP box_artistrLrr,r-groupedrk value_datastats orig_widthr5capwidthrrstatlinear_orient_scale maincolorrprqrrrsrt prop_dict default_kws boxplot_kwsartistsori_idxirSp0p1 box_vertsvertsf_fwdf_invline legend_artists4 ` rY plot_boxesz_CategoricalPlotter.plot_boxesOs G C((5 &)i&6 Q Q Q Q Q Q 8 ) %67ILLcl;N.OPP M8<<+G+GHHH.2HS[** 8H 9UJ//i)) y++Yw''9U##    h""#3V<<< i##$4f=== g!!, ::: W"&..@D=B#1#D#Do 8o 8 Hh))B&&t{33I>Gx 4;;==DDUKKLLI;;7;;;JL!8!8$CL"9"N"NOOE!33J<i* MNND , Hd+++ )W S( ||KtG}1DEEH   r4 ( ( (-b)<(2(;(;(=(=(F(HII(2(;(;(=(=I02 '*1-13 '*122.24 '*1Q3/#;&// :::))L33$(K3$6$(K3$6* y)> ' 21 5 @ @ B B D,.Fgqqq) *1-66u===v1'?DK'P'P u$+FOAE!a%!)O$D11D!&uuS-='>'>!q'P!Q!QB!&uuS-='>'>!q'P!Q!QB$(OO$5$5$7E02BE'N111- MM%0000   -g66 7 7 7 7066  r=(;;;;;rZc  |jdg}ddd|j}t| | | }gd}td||| |ni|| } |in|}|in|}|*|rdtjdz}ntjd}|j}||d d D]i\}}||}t||j\}}t||\}}|||}|d d zdz }|d}tj |j||jgd||j zgi}|r| |||r|dxxd|z zcc<|d}|dz |d z t} |dkr|dz}!nD|dkrd | z}!n8|dkr2||d dz k}"d | |"z zt!j|dz }!||j}#|!|!z |dz}$||}%||#|$d z z }&||dd||ddz }'||#|$d z z||#|$d z z z }(d|vr||dn|})d|rdn|)d}*|r&t+|)d }+|+d | d zdz z},n|)},g}-t-|D]r}.|jdkr!|&|.|%|.f}/|(|.|'|.}1}0n |%|.|&|.f}/|'|.|(|.}1}0|-t1|/|0|1s|r|,|d}2nd|,d}2i|2d|i| }3|t5|-fi|3d |t!j|%|%g|jdk|jdk|d}4|dd z }5|jdkr!||#|5z |#|5zg||4|4g}7}6n ||4|4g||#|5z |#|5zg}7}6|r|n|)d d!|zd"}8|j|6|7fii|8|| r||d#}t!jt?||||j}9|jdkr|9|fn||9f\}6}7|j |6|7fii|*d$d%i|k|!|jdk|jdk&tE|}:i| ||d'};|#||:|;dS)(Nr1r0r/r9) exponentialrerrrr}TFrrarr<rrrrerrnonez.45rf)as_cmaprd) facecolors edgecolorsrautolimrvrTrY?)r2rXrrdsr5rr)$r?rrcopyrlrrr r!rrrrrrrrritemrrrrangerr add_collectionr r: column_stackplotfullrr$r=rr)qAA"1+wqz2B'NJqMqA Yr1a001111 M,5YOO ,2)LL N NKNNgNN   oeFF~FFPU  V V V   8 455 s* s*    (#C'"''))A-B{c!!w Vb[9::GGS#J}=tj'|=|"||"j|)d)z }7tj'|=|"||"j|)dz}8tj(|-|7|-|8g}9tj(|.|=|.|=g}:tj(|9|:g)d/d)d};jdkr|;ddddd8ddf};gd?}>t]|;D] \}?}@|||>|?d@| }6|j"|@i|6!| drtj/0|4d)}=tj%|5j}/|r|/|(rd8nd|5d,zd/z z }/|/|/g|/|/g|/gf}/|=dA|=dBg|=dC|=dDg|=dEgf}0jdkr|/|0c\}A}B}C\}D}E}Fn |0|/c\}A}B}C\}D}E}F|rZ|(rdnd8|zdFz d/z }Gjdkr|Gd)fnd)|G f\}H}I|j1tj23|H|I|j4j5z}Jn|j1}J||JdG| dH|i}K|j"|+|A|,|Dfi|K||KdH<|j"|+|B|,|Efi|K||dIz |dJz |JdK| dLdL|dM}L|j"|+|C|,|Ffi|Ltm|}Mi|||dN}N7||M|NdS)PNr1r0r/r9)rSquartstickpointNinnerT)prefixr)rcountrrzpatch.linewidthr}rS box_widthg@ whis_widthrdrr|Frweightsr<weightr)rgrrdensity)position observationsrsupportrr,rc^tfd|DS)Nc3<K|]\}}|jk||fVdSN)r?)r`rarbrPs rY zH_CategoricalPlotter.plot_violins..vars_to_key..s7QQDAqT[@P@P!Q@P@P@P@PQQrZ)tuplerj)r,rPs rY vars_to_keyz5_CategoricalPlotter.plot_violins..vars_to_keys0QQQQHNN,<,<QQQQQ QrZc2g|]}|dS)r,r])r`violinrs rYrz4_CategoricalPlotter.plot_violins..s(OOO[[ !344OOOrZcBg|]}|dS)rrr`rbs rYrz4_CategoricalPlotter.plot_violins..s(+T+T+T1AiL,<,<,>,>+T+T+TrZc8g|]}t|dS)rrrs rYrz4_CategoricalPlotter.plot_violins..s%)V)V)VQ#a.?*@*@)V)V)VrZci|]}|Sr]r])r`rcommon_max_densitys rYrcz4_CategoricalPlotter.plot_violins..sHHHs3 2HHHrZci|]}|Sr]r])r`rcommon_max_counts rYrcz4_CategoricalPlotter.plot_violins..sDDD3.DDDrZignorez All-NaN (slice|axis) encounteredcVi|]$tjfdD%S)cng|]1}|dk|d2S)r,rrr`rbrrs rYrz?_CategoricalPlotter.plot_violins...sL$$$/0&;q}55<<) ((**<<.se$$$$$4?$$$rZcVi|]$tjfdD%S)cdg|],}|dkt|d-S)r,rrrs rYrz?_CategoricalPlotter.plot_violins...sI   /0"{1Z=11S88.)**888rZrr s @rYrcz4_CategoricalPlotter.plot_violins..seRY     4?   rZrrrr)rr,rrrrrrr)r2rrrzorder)r2rrr rrr)r2K)rr)g@r<r)r2rdashesrbrcr^r_r]H)r2 transformrg333333?)rrrrr)rhmarkerfacecolorr2rr])8r?rrlr startswithrIrrr rL _transformrrirr!rrrocatch_warningsfilterwarningsrr RangeIndexrrrrisnanr6rrrrBr r fill_betweenx fill_betweenarrayr$interpstackr collectionsLineCollectionr percentilerrrr< transformsScaledTranslationrGdpi_scale_transrr)SrPrr rsplitr2rrrrrrkde_kws inner_kwsrr)r inner_optionsrrrkderr,r- stat_datarr norm_keys max_density max_count real_widthrrr5norm_keyr peak_densityspanr right_siderrinvxinvyinv_posrrrr/r0 plot_funcobspos_dictkwspos0pos1pos_ptsval_ptssegmentsr{rrrsegmentx0x1x2y0y1y2rdxdytransrdot_kwsrrrrrr sS` @@@@rY plot_violinsz _CategoricalPlotter.plot_violinsxs$[%( C((5 @@@ dCCCC(B(B(BLQQQ   < 3<0A#BB L):;  !1!1%!8!8 ! k9s?CCI"|Y]CCJ]]8DK34F4FSSCPPFnnGnn W #'..@D=B#1#D#D   Hh"*i!;!;HX xB??I:?8:K:K huo666QVI #% " ###K   $T[1 ( 3$Y/$Y/5[5H5$nnX..       R R R R RPOOO;OOO  !#+T+T +T+T+T!U!U !y)V)V+)V)V)VWW HHHHiHHHKDDDD)DDDII(**  '2TUUU#,                 ( IT// "l 7l 7FM!SVI->)?)?%C%CDDE< VJ/6),6), !  D 6 F:.555 )W S( #{6*#566Hg"B!),0022Lx %% 6''IX)>>((F>233I58AT9TU((I5"9U 12D$.00])//z0B50IJJQN  %-7L2tby//dRi_*B.r377GAt.r377GAt t,,T[9G t,,Y7Gx(5Ix %% 4;',Q/^,1133;#%%'!*,cGAJ.>?#sqAA:gaj(8# :J'KqAQa YOOO!.R_EEdkRI IY((T[)GAJ677T[)GAJ677  "    (C VJ%7*MH : F:.999 /!!!a#g.!!!}!!'**\ 7h 56SABBM*3BB!x7HH1LLC%)[C%7%7Szzc3Z1&!*#a-A-$X.228Q??!C    4477DDGG33s3333!!'**N 7yd9otDK7H7ST:7UVVyd9otDK7H7ST:7UVV(GGDMM774==#ABB(GGCLL''#,,#?@@8Wg$677AA!QJJ;#%%'111ddd 3H&!*Q  6xGG3GG!!%!7777!!'**> 7 c<<<88yYdk9JWUVZ9WXXyYdk9JWUVZ9WXX(GGDMM774==#ABB(GGENNGGENN#CDD8Wg$677AA!QJJ;#%%'44R4 3H==="+H"5"5--JAw!*%."()$ C BGW,,,,,-!!%((+ 7 //44Q7hx 455M*3BB!x7HH1LLCCj3*se38_eHo64[%+.5\N ;#%%14c.LRR,2r2214c.LRR,2r2)#-5aa2BRG!KF,0K3,>,>fa[[QLFBL3>+K+KB 9,,EELE&!&    R$$r((77h777(1%R$$r((77h777$"+c/'01}!&     (+'*&   R$$r((66g666066 QQyyQQQ  r=*=====s%JJJc ddd|j} dg} t|tjj}|dtjddz|d|dd z|d |dtjd tj zz| d |d |}| d|d|}|j |j} |j |jdkrt|j|j} t|j|j} dt#| | dzD} |jjdnt)|jj}|durd|z}|j}|| ddD]T\}}||}t1||jd}t3||j\}}||| }|jr|nq||jj|| fit=dtAj!||j"}|rV|jj#|d}||dz z }| d z ||zz}||jxx||j$zz cc<|%|||&}|'||(d||(dd|vr||dn||j)|d|dfi|\}|&}|*}dD]}|||||j+|,||||Vt[tjjgg}d||di} |.|||| dS)Nr0r/r9r1rr}r~rrrrror-rAcg|]}|Sr]r])r`rs rYrz3_CategoricalPlotter.plot_points..sMMMAaMMMrZr<rTg?rr>F)r)rrr2)r2ralphar )rr)/r?rrlr{r|r}rrsqrtpirrOrJintrrrrrrrrr r!rr convert_unitsrrapplyrreindexrIndex reset_indexrrrrrrLr properties error_methodplot_errorbarsrr)!rP aggregatormarkers linestylesr r2rrragg_varr)base_positions min_cat_val max_cat_val n_hue_levelsrr,r-ori_axisrrrkagg_datar step_sizersub_kwsr sub_err_kws line_propsproprrs! rY plot_pointsz_CategoricalPlotter.plot_pointss}#&&t{3G #Hci.>??K6G)H3)NOOO-x /Dt/KLLLL(;*?"'!be)BTBT*TUUU))(GS(KK,,[*c8TT 5 >$+ &- 7 7dnT[9==??@@KdnT[9==??@@KMM{K!O)L)LMMMN M08qqc$-BV>W>W D==<'E W"&..@D=A#1#C#C' H' H Hh))Brdk#7#7#788H3B DDLIq! ("8"8"H"HIII#+>xx%%z7SS.J5.Q.QSS)$+>>>??  E-.44Xe_EE!\A%56 !i'&99%%%$2D)DD%%%   r8 , , ,mmooG NNx||E223$X\\%%8%898=8I8IdmmHUO444u     BGHSM8C=DDGDDED!,,..K**JA ? ?&&tZ-=>>>>&2##B';GGG 0"b99 ' KKL  r='<HHHHHrZc Dddd|j} dg} |j} |jjd}|r||t |jjz }|s)| ddt jdz|ddt jdz|| d d D]\} }| | } |j r|nE| |jj || fitd}||jz|d <|r|| ||r|d xxd |z zcc<||j|d d z z |d<|| ||jdkr,| j}t'|d|d|d }n+| j}t'|d|d|d }d| vr|| dn|}d|d<|r|||n|||d|dii|| |j || ||d|rdn|i|t1|}|| || dS)Nr0r/r9r1Fr?r}Trrr<rr)r/heightr)r0rroalign)r2rgr)r2rrgr2z.26r])r?rrrrr}rlrr r!rrrVrrYrrrbarribarhrr[r\rr)rPr]r rrrr2rrrr`r)rr,r-rfbar_funcr; main_colorrs rY plot_barsz_CategoricalPlotter.plot_barssD#&&t{3G W =  'E  :W(DM$8 9 99G T    S3<@Q3R-R S S S;cl;L.M(MNNN"&..@D=A#1#C#C0 0  Hh))B#+>xx%%z7SS.J5.Q.QSS !&(: :HW  0 Hh/// -!!!QW,!!!' 4x7H17LLHV    r8 , , ,{c!!6v&x}HWDU7v&hsmHWDU?@@C(C3 ,cS+++.>?@@C t11A53B DDSc##c!f++*++SSSVr1A-B-BBn"cN26NC"&3&nVSVRV,cBFCGSW3M&{c!!CxCx BGT %W % % % %/ & &rZ)F)r9)NN)!__name__ __module__ __qualname__wide_structureflat_structure_legend_attributesrDrxr{rrrrrrrrrrrrpropertyrrr0rIrrrLrlrur\ __classcell__)rXs@rYr,r,1s0%IjIIN9%N!L2L2L2L2L2L2\3"3"3"3"j(---<   6)))(    4 000> $ $ $ / / / / 3 3 3 3  X    &1P1P1PfHEHEHEHEHETZ<Z<ZK>K>ZR>R>R>hNININI`P<P<P` for more information. .. note:: By default, this function treats one of the variables as categorical and draws data at ordinal positions (0, 1, ... n) on the relevant axis. As of version 0.13.0, this can be disabled by setting `native_scale=True`. input_paramsz x, y, hue : names of variables in `data` or vector data Inputs for plotting long-form data. See examples for interpretation. categorical_dataz data : DataFrame, Series, dict, array, or list of arrays Dataset for plotting. If `x` and `y` are absent, this is interpreted as wide-form. Otherwise it is expected to be long-form. order_varsz order, hue_order : lists of strings Order to plot the categorical levels in; otherwise the levels are inferred from the data objects. stat_api_paramsa estimator : string or callable that maps vector -> scalar Statistical function to estimate within each categorical bin. errorbar : string, (string, number) tuple, callable or None Name of errorbar method (either "ci", "pi", "se", or "sd"), or a tuple with a method name and a level parameter, or a function that maps from a vector to a (min, max) interval, or None to hide errorbar. See the :doc:`errorbar tutorial ` for more information. .. versionadded:: v0.12.0 n_boot : int Number of bootstrap samples used to compute confidence intervals. seed : int, `numpy.random.Generator`, or `numpy.random.RandomState` Seed or random number generator for reproducible bootstrapping. units : name of variable in `data` or vector data Identifier of sampling units; used by the errorbar function to perform a multilevel bootstrap and account for repeated measures weights : name of variable in `data` or vector data Data values or column used to compute weighted statistics. Note that the use of weights may limit other statistical options. .. versionadded:: v0.13.1 ciz ci : float Level of the confidence interval to show, in [0, 100]. .. deprecated:: v0.12.0 Use `errorbar=("ci", ...)`. r?a orient : "v" | "h" | "x" | "y" Orientation of the plot (vertical or horizontal). This is usually inferred based on the type of the input variables, but it can be used to resolve ambiguity when both `x` and `y` are numeric or when plotting wide-form data. .. versionchanged:: v0.13.0 Added 'x'/'y' as options, equivalent to 'v'/'h'. r2zS color : matplotlib color Single color for the elements in the plot. rraC palette : palette name, list, dict, or :class:`matplotlib.colors.Colormap` Color palette that maps the hue variable. If the palette is a dictionary, keys should be names of levels and values should be matplotlib colors. The type/value will sometimes force a qualitative/quantitative mapping. hue_normz hue_norm : tuple or :class:`matplotlib.colors.Normalize` object Normalization in data units for colormap applied to the `hue` variable when it is numeric. Not relevant if `hue` is categorical. .. versionadded:: v0.12.0 saturationz saturation : float Proportion of the original saturation to draw fill colors in. Large patches often look better with desaturated colors, but set this to `1` if you want the colors to perfectly match the input values. rz[ capsize : float Width of the "caps" on error bars, relative to bar spacing. rz errcolor : matplotlib color Color used for the error bar lines. .. deprecated:: 0.13.0 Use `err_kws={'color': ...}`. rz errwidth : float Thickness of error bar lines (and caps), in points. .. deprecated:: 0.13.0 Use `err_kws={'linewidth': ...}`. rzw fill : bool If True, use a solid patch. Otherwise, draw as line art. .. versionadded:: v0.13.0 rz gap : float Shrink on the orient axis by this factor to add a gap between dodged elements. .. versionadded:: 0.13.0 rz width : float Width allotted to each element on the orient axis. When `native_scale=True`, it is relative to the minimum distance between two values in the native scale. r av dodge : "auto" or bool When hue mapping is used, whether elements should be narrowed and shifted along the orient axis to eliminate overlap. If `"auto"`, set to `True` when the orient variable is crossed with the categorical variable or `False` otherwise. .. versionchanged:: 0.13.0 Added `"auto"` mode as a new default. rzR linewidth : float Width of the lines that frame the plot elements. rzy linecolor : color Color to use for line elements, when `fill` is True. .. versionadded:: v0.13.0 log_scalea log_scale : bool or number, or pair of bools or numbers Set axis scale(s) to log. A single value sets the data axis for any numeric axes in the plot. A pair of values sets each axis independently. Numeric values are interpreted as the desired base (default 10). When `None` or `False`, seaborn defers to the existing Axes scale. .. versionadded:: v0.13.0 native_scalez native_scale : bool When True, numeric or datetime values on the categorical axis will maintain their original scaling rather than being converted to fixed indices. .. versionadded:: v0.13.0 formatterz formatter : callable Function for converting categorical data into strings. Affects both grouping and tick labels. .. versionadded:: v0.13.0 rMa legend : "auto", "brief", "full", or False How to draw the legend. If "brief", numeric `hue` and `size` variables will be represented with a sample of evenly spaced values. If "full", every group will get an entry in the legend. If "auto", choose between brief or full representation based on number of levels. If `False`, no legend data is added and no legend is drawn. .. versionadded:: v0.13.0 rz err_kws : dict Parameters of :class:`matplotlib.lines.Line2D`, for the error bar artists. .. versionadded:: v0.13.0 ax_inzh ax : matplotlib Axes Axes object to draw the plot onto, otherwise uses the current Axes. ax_outzY ax : matplotlib Axes Returns the Axes object with the plot drawn onto it. r%zH boxplot : A traditional box-and-whisker plot with a similar API. r&zL violinplot : A combination of boxplot and kernel density estimation. r#z stripplot : A scatterplot where one variable is categorical. Can be used in conjunction with other plots to show each observation. r$z swarmplot : A categorical scatterplot where the points do not overlap. Can be used with other plots to show each observation. r)zK barplot : Show point estimates and confidence intervals using bars. r*zL countplot : Show the counts of observations in each categorical bin. r(zM pointplot : Show point estimates and confidence intervals using dots. r"zG catplot : Combine a categorical plot with a :class:`FacetGrid`. r'z< boxenplot : An enhanced boxplot for larger datasets. rTr3rrnF)r/r0r1rQrsr?r2rrrrr rrr[rrrrrrrrMrc \t|t|||||||}|tj}|jjr|S| dkr|} |j|j dks|s| |j ||| ||| ||}| |||\}}| r| nd} ||||| t|j||d |D| }||||j}|| | | | |||||| |||||j |S) Nr.r5r6rQr?r2rMr3rArQrrr<rrrQnormrc"i|] \}}|dv || S)rr2fcrgr]r_s rYrczboxplot..])SSS$!QA1R,R,RA,R,R,RrZr rr rrr[r2rrrrr=)r,ripltgcarFrrrJrLr?scale_categorical_attachr{rxmap_huerrrjrrr_add_axis_labelsr)r5r/r0r1rQrsr?r2rrrrr rrr[rrrrrrrrMrrps rYr%r%5s  aS)))    A z WYY{  !!{qx  M111 AHEYGGGIIbII&&&11'9EEI**5'9EEGY#*JIIgYX*IUUU  eSS&,,..SSS   E ##IuajAAILL      rr))) IrZa Draw a box plot to show distributions with respect to categories. A box plot (or box-and-whisker plot) shows the distribution of quantitative data in a way that facilitates comparisons between variables or across levels of a categorical variable. The box shows the quartiles of the dataset while the whiskers extend to show the rest of the distribution, except for points that are determined to be "outliers" using a method that is a function of the inter-quartile range. {categorical_narrative} Parameters ---------- {categorical_data} {input_params} {order_vars} {orient} {color} {palette} {saturation} {fill} {dodge} {width} {gap} whis : float or pair of floats Paramater that controls whisker length. If scalar, whiskers are drawn to the farthest datapoint within *whis * IQR* from the nearest hinge. If a tuple, it is interpreted as percentiles that whiskers represent. {linecolor} {linewidth} fliersize : float Size of the markers used to indicate outlier observations. {hue_norm} {log_scale} {native_scale} {formatter} {legend} {ax_in} kwargs : key, value mappings Other keyword arguments are passed through to :meth:`matplotlib.axes.Axes.boxplot`. Returns ------- {ax_out} See Also -------- {violinplot} {stripplot} {swarmplot} {catplot} Examples -------- .. include:: ../docstrings/boxplot.rst rSrdscottr<r)!r/r0r1rQrsr?r2rrrrrr'rr rrrcutgridsizer bw_adjustrrrrrrrMrrrr)rc! t|t|||||||}#|!tj}!|#jjr|!S|dkr|#}|#j|#j dks|s|# |#j |||# |!||# ||}|# |||\}}| r| nd} |#|||| t|!j||d |"D| }|#|||#j}|#||||\}}|#||}t|||| }$| in| } |#| ||| || ||| |||$| |" |#|!|#|!|#j |!S)Nr.rr3rArrr<rc"i|] \}}|dv || Srr]r_s rYrczviolinplot..rrZr)rrrrrr rr'r2rrrrrrr(r)rr=)r,rirrrFrrrJrLr?rrr{rxrrrrjrrrrrrLrr)%r5r/r0r1rQrsr?r2rrrrrr'rr rrrrrrrrrrrrrrMrrrr)rrrr(s% rYr&r&sZ  aS)))    A z WYY{  !!{qx  M111 AHEYGGGIIbII&&&11'9EEI**5'9EEGY#*JIIgYX*IUUU  eSS&,,..SSS   E ##IuajAAI ! : : y, !!L+''I66IsXiXXXG'Y^^-=-=INN  !"rr))) IrZa, Draw a patch representing a KDE and add observations or box plot statistics. A violin plot plays a similar role as a box-and-whisker plot. It shows the distribution of data points after grouping by one (or more) variables. Unlike a box plot, each violin is drawn using a kernel density estimate of the underlying distribution. {categorical_narrative} Parameters ---------- {categorical_data} {input_params} {order_vars} {orient} {color} {palette} {saturation} {fill} inner : {{"box", "quart", "point", "stick", None}} Representation of the data in the violin interior. One of the following: - `"box"`: draw a miniature box-and-whisker plot - `"quart"`: show the quartiles of the data - `"point"` or `"stick"`: show each observation split : bool Show an un-mirrored distribution, alternating sides when using `hue`. .. versionchanged:: v0.13.0 Previously, this option required a `hue` variable with exactly two levels. {width} {dodge} {gap} {linewidth} {linecolor} cut : float Distance, in units of bandwidth, to extend the density past extreme datapoints. Set to 0 to limit the violin within the data range. gridsize : int Number of points in the discrete grid used to evaluate the KDE. bw_method : {{"scott", "silverman", float}} Either the name of a reference rule or the scale factor to use when computing the kernel bandwidth. The actual kernel size will be determined by multiplying the scale factor by the standard deviation of the data within each group. .. versionadded:: v0.13.0 bw_adjust: float Factor that scales the bandwidth to use more or less smoothing. .. versionadded:: v0.13.0 density_norm : {{"area", "count", "width"}} Method that normalizes each density to determine the violin's width. If `area`, each violin will have the same area. If `count`, the width will be proportional to the number of observations. If `width`, each violin will have the same width. .. versionadded:: v0.13.0 common_norm : bool When `True`, normalize the density across all violins. .. versionadded:: v0.13.0 {hue_norm} {formatter} {log_scale} {native_scale} {legend} scale : {{"area", "count", "width"}} .. deprecated:: v0.13.0 See `density_norm`. scale_hue : bool .. deprecated:: v0.13.0 See `common_norm`. bw : {{'scott', 'silverman', float}} .. deprecated:: v0.13.0 See `bw_method` and `bw_adjust`. inner_kws : dict of key, value mappings Keyword arguments for the "inner" plot, passed to one of: - :class:`matplotlib.collections.LineCollection` (with `inner="stick"`) - :meth:`matplotlib.axes.Axes.scatter` (with `inner="point"`) - :meth:`matplotlib.axes.Axes.plot` (with `inner="quart"` or `inner="box"`) Additionally, with `inner="box"`, the keywords `box_width`, `whis_width`, and `marker` receive special handling for the components of the "box" plot. .. versionadded:: v0.13.0 {ax_in} kwargs : key, value mappings Keyword arguments for the violin patches, passsed through to :meth:`matplotlib.axes.Axes.fill_between`. Returns ------- {ax_out} See Also -------- {boxplot} {stripplot} {swarmplot} {catplot} Examples -------- .. include:: ../docstrings/violinplot.rst rtukeyy&1|?皙?)r/r0r1rQrsr?r2rrrrr rrrrrrrrrrrrrrMrrrrrc \t|t|||||||} |tj}| jjr|S| dkr| } | j| j dks|s| | j ||| ||| ||}| |||\}}| ||}| r| nd} | |||| t!|j||i| }| ||| j}| | | | | |||||||||||| | || || j |S) Nr.rr3rArrr<rrrr rrr2rrrrrrrrrrrr=)r,rirrrFrrrJrLr?rrr{rxrrrrrrrrr)!r5r/r0r1rQrsr?r2rrrrr rrrrrrrrrrrrrrMrrrrrrrs! rYr'r'ps  aS)))    A z WYY{  !!{qx  M111 AHEYGGGIIbII&&&11'9EEI**5'9EEGY,,ULAAL#*JIIgYX*IUUU  e     E ##IuajAAIMM  !!!&rr))) IrZan Draw an enhanced box plot for larger datasets. This style of plot was originally named a "letter value" plot because it shows a large number of quantiles that are defined as "letter values". It is similar to a box plot in plotting a nonparametric representation of a distribution in which all features correspond to actual observations. By plotting more quantiles, it provides more information about the shape of the distribution, particularly in the tails. {categorical_narrative} Parameters ---------- {categorical_data} {input_params} {order_vars} {orient} {color} {palette} {saturation} {fill} {dodge} {width} {gap} {linewidth} {linecolor} width_method : {{"exponential", "linear", "area"}} Method to use for the width of the letter value boxes: - `"exponential"`: Represent the corresponding percentile - `"linear"`: Decrease by a constant amount for each box - `"area"`: Represent the density of data points in that box k_depth : {{"tukey", "proportion", "trustworthy", "full"}} or int The number of levels to compute and draw in each tail: - `"tukey"`: Use log2(n) - 3 levels, covering similar range as boxplot whiskers - `"proportion"`: Leave approximately `outlier_prop` fliers - `"trusthworthy"`: Extend to level with confidence of at least `trust_alpha` - `"full"`: Use log2(n) + 1 levels and extend to most extreme points outlier_prop : float Proportion of data expected to be outliers; used when `k_depth="proportion"`. trust_alpha : float Confidence threshold for most extreme level; used when `k_depth="trustworthy"`. showfliers : bool If False, suppress the plotting of outliers. {hue_norm} {log_scale} {native_scale} {formatter} {legend} box_kws: dict Keyword arguments for the box artists; passed to :class:`matplotlib.patches.Rectangle`. .. versionadded:: v0.12.0 line_kws: dict Keyword arguments for the line denoting the median; passed to :meth:`matplotlib.axes.Axes.plot`. .. versionadded:: v0.12.0 flier_kws: dict Keyword arguments for the scatter denoting the outlier observations; passed to :meth:`matplotlib.axes.Axes.scatter`. .. versionadded:: v0.12.0 {ax_in} kwargs : key, value mappings Other keyword arguments are passed to :class:`matplotlib.patches.Rectangle`, superceded by those in `box_kws`. Returns ------- {ax_out} See Also -------- {violinplot} {boxplot} {catplot} Notes ----- For a more extensive explanation, you can read the paper that introduced the plot: https://vita.had.co.nz/papers/letter-value-plot.html Examples -------- .. include:: ../docstrings/boxenplot.rst r)r/r0r1rQrsr&r r?r2rrrrrrrrrrMrc `t|t|||||| |}|tj}|jjr|S|j|jdks|s| |j||| ||| | |}| | | |\} }| | ||t|j|| |} || | |j} |dd|d | } || d z| | |||| | |||||j |S)Nr.rrArrrrrQrr rdrrrrrr&r r2rr=)r,rirrrFrrJrLr?rrr{rxrrr$rrr}rr0rr)r5r/r0r1rQrsr&r r?r2rrrrrrrrrrMrrrs rYr#r#s  aS)))    A z WYY{ {qx  M111 AHEYGGGIIbII&&&11'9EEI**5'9EEGYIIgYXI>>> 2:sE6 : :E##IuajAAI h""" ::c4 D MM !) MM rr))) IrZa Draw a categorical scatterplot using jitter to reduce overplotting. A strip plot can be drawn on its own, but it is also a good complement to a box or violin plot in cases where you want to show all observations along with some representation of the underlying distribution. {categorical_narrative} Parameters ---------- {categorical_data} {input_params} {order_vars} jitter : float, `True`/`1` is special-cased Amount of jitter (only along the categorical axis) to apply. This can be useful when you have many points and they overlap, so that it is easier to see the distribution. You can specify the amount of jitter (half the width of the uniform random variable support), or use `True` for a good default. dodge : bool When a `hue` variable is assigned, setting this to `True` will separate the strips for different hue levels along the categorical axis and narrow the amount of space allotedto each strip. Otherwise, the points for each level will be plotted in the same strip. {orient} {color} {palette} size : float Radius of the markers, in points. edgecolor : matplotlib color, "gray" is special-cased Color of the lines around each point. If you pass `"gray"`, the brightness is determined by the color palette used for the body of the points. Note that `stripplot` has `linewidth=0` by default, so edge colors are only visible with nonzero line width. {linewidth} {hue_norm} {log_scale} {native_scale} {formatter} {legend} {ax_in} kwargs : key, value mappings Other keyword arguments are passed through to :meth:`matplotlib.axes.Axes.scatter`. Returns ------- {ax_out} See Also -------- {swarmplot} {boxplot} {violinplot} {catplot} Examples -------- .. include:: ../docstrings/stripplot.rst )r/r0r1rQrsr r?r2rrrrrrrrrrMr2rc t|t|||||||}|tj}|jjr|S|j|jdks|s| |j||| |||j s|S| | |}| || |\} }|| || t|j|||}|| ||j} |dd|d | } | | d z } |t| d z| | ||||| |||||j|S)Nr.rrArrrr rdr rrr r2r2rr=)r,rirrrFrrJrLr?rrrNr{rxrrr$rrr}rrIrr)r5r/r0r1rQrsr r?r2rrrrrrrrrrMr2rrrs rYr$r$s  aS)))    A z WYY{ {qx  M111 AHEYGGGIIbII&&& = 11'9EEI**5'9EEGYIIgYXI>>> 2:sE6 : :E##IuajAAI h""" ::c4 D2I  MM$ !) MM rr))) IrZa Draw a categorical scatterplot with points adjusted to be non-overlapping. This function is similar to :func:`stripplot`, but the points are adjusted (only along the categorical axis) so that they don't overlap. This gives a better representation of the distribution of values, but it does not scale well to large numbers of observations. This style of plot is sometimes called a "beeswarm". A swarm plot can be drawn on its own, but it is also a good complement to a box or violin plot in cases where you want to show all observations along with some representation of the underlying distribution. {categorical_narrative} Parameters ---------- {categorical_data} {input_params} {order_vars} dodge : bool When a `hue` variable is assigned, setting this to `True` will separate the swarms for different hue levels along the categorical axis and narrow the amount of space allotedto each strip. Otherwise, the points for each level will be plotted in the same swarm. {orient} {color} {palette} size : float Radius of the markers, in points. edgecolor : matplotlib color, "gray" is special-cased Color of the lines around each point. If you pass `"gray"`, the brightness is determined by the color palette used for the body of the points. {linewidth} {log_scale} {native_scale} {formatter} {legend} {ax_in} kwargs : key, value mappings Other keyword arguments are passed through to :meth:`matplotlib.axes.Axes.scatter`. Returns ------- {ax_out} See Also -------- {boxplot} {violinplot} {stripplot} {catplot} Examples -------- .. include:: ../docstrings/swarmplot.rst r )r_i)r/r0r1rQrsrerrorbarn_bootseedunitsrr?r2rrrrrrr rrrrrMrrrrrrc tj||}|turd}t|t |||| | || | |} |t j}| jjr|S|dkr| }| j | j dks|s| | j ||| ||| ||}| | ||\}}|r|nd}| |||| t%|j|| || } d | jvrt(nt*}!|!|||| }"|int-|t.jj}| ||||\}}| |"|||| |||| | || || j |S)Nrr/r0r1rrrr3rArrr<rrrrr r]r rrr2rrrrr=)r _deprecate_cirrrirrrFrrrJrLr?rrr{rxrrrqrrrrlr{r|rrurr)#r5r/r0r1rQrsrrrrrrr?r2rrrrrrr rrrrrMrrrrrrrragg_clsr]s# rYr)r) s>"8R00HC  aSgFFF    A z WYY{  !!{qx  M111 AHEYGGGIIbII&&&11'9EEI**5'9EEGY#*JIIgYX*IUUU 263v* M M ME$, $;$;  ASGHV$GGGJObb)9'39CS)T)TG,,Wh'RRGWKK     rr))) IrZaS Show point estimates and errors as rectangular bars. A bar plot represents an aggregate or statistical estimate for a numeric variable with the height of each rectangle and indicates the uncertainty around that estimate using an error bar. Bar plots include 0 in the axis range, and they are a good choice when 0 is a meaningful value for the variable to take. {categorical_narrative} Parameters ---------- {categorical_data} {input_params} {order_vars} {stat_api_params} {orient} {color} {palette} {saturation} {fill} {hue_norm} {width} {dodge} {gap} {log_scale} {native_scale} {formatter} {legend} {capsize} {err_kws} {ci} {errcolor} {errwidth} {ax_in} kwargs : key, value mappings Other parameters are passed through to :class:`matplotlib.patches.Rectangle`. Returns ------- {ax_out} See Also -------- {countplot} {pointplot} {catplot} Notes ----- For datasets where 0 is not a meaningful value, a :func:`pointplot` will allow you to focus on differences between levels of one or more categorical variables. It is also important to keep in mind that a bar plot shows only the mean (or other aggregate) value, but it is often more informative to show the distribution of values at each level of the categorical variables. In those cases, approaches such as a :func:`boxplot` or :func:`violinplot` may be more appropriate. Examples -------- .. include:: ../docstrings/barplot.rst )r/r0r1rQrsrrrrrrr2rrrr^r_r rrr?rrrMrrrrrrc tj||}t|t|||| | ||| | dn| |}|t j}|jjr|S|j |j dks|s| |j ||| ||| | |}|| | |\} }|| ||t!|j|| |} d|jvrt$nt&} | |||| }!|int)|t*jj}||||||d||\}}||!|||| ||| |||||j |S) NrC0rrArrrrrr]r^r_r r2rrrr=)rrrrirrrFrrJrLr?rrr{rxrrrrrrrlr{r|rrrlrr)"r5r/r0r1rQrsrrrrrrr2rrrr^r_r rrr?rrrMrrrrrrrrrr]s" rYr(r( s""8R00H aSgFFF}ddu   A z WYY{ {qx  M111 AHEYGGGIIbII&&&11'9EEI**5'9EEGYIIgYXI>>> 27C 7 7E$, $;$;  ASGHV$GGGJObb)9'39CS)T)TGudF333,,WdHgNNGWMM   rr))) IrZa Show point estimates and errors using lines with markers. A point plot represents an estimate of central tendency for a numeric variable by the position of the dot and provides some indication of the uncertainty around that estimate using error bars. Point plots can be more useful than bar plots for focusing comparisons between different levels of one or more categorical variables. They are particularly adept at showing interactions: how the relationship between levels of one categorical variable changes across levels of a second categorical variable. The lines that join each point from the same `hue` level allow interactions to be judged by differences in slope, which is easier for the eyes than comparing the heights of several groups of points or bars. {categorical_narrative} Parameters ---------- {categorical_data} {input_params} {order_vars} {stat_api_params} {color} {palette} markers : string or list of strings Markers to use for each of the `hue` levels. linestyles : string or list of strings Line styles to use for each of the `hue` levels. dodge : bool or float Amount to separate the points for each level of the `hue` variable along the categorical axis. Setting to `True` will apply a small default. {log_scale} {native_scale} {orient} {capsize} {formatter} {legend} {err_kws} {ci} {errwidth} join : bool If `True`, connect point estimates with a line. .. deprecated:: v0.13.0 Set `linestyle="none"` to remove the lines between the points. scale : float Scale factor for the plot elements. .. deprecated:: v0.13.0 Control element sizes with :class:`matplotlib.lines.Line2D` parameters. {ax_in} kwargs : key, value mappings Other parameters are passed through to :class:`matplotlib.lines.Line2D`. .. versionadded:: v0.13.0 Returns ------- {ax_out} See Also -------- {barplot} {catplot} Notes ----- It is important to keep in mind that a point plot shows only the mean (or other estimator) value, but in many cases it may be more informative to show the distribution of values at each level of the categorical variables. In that case, other approaches such as a box or violin plot may be more appropriate. Examples -------- .. include:: ../docstrings/pointplot.rst r)r/r0r1rQrsr?r2rrrrrrrr rrrrrMrc ||d}t|rdnd}n-||d}t|rdnd}n||tdt|t|||||||}|t j}|jjr|S|dkr|}|j |j dks|s| |j || | || |||}||||\}}| r| nd} |||| | t#|j|||| }ddd |j }|jd kr d|j|<t)dgd| | |j|<| dkr4| dkrdnd}|j|xxt-|j|z zcc<t/dd}|||| ||| di| |||||j |S)Nr0r<r/(Cannot pass values for both `x` and `y`.r.rr3rArrrr9r7rrpercent probability proportionrrrsumrrrr=)r TypeErrorrrirrrFrrrJrLr?rrr{rxrrrqrErr6rrrurr)r5r/r0r1rQrsr?r2rrrrrrrr rrrrrMrrr count_axisdenomr]s rYr*r*7 s yQ]a "AAd 19a "AAd 1=BCCC aS)))    A z WYY{  !!{qx  M111 AHEYGGGIIbII&&&11'9EEI**5'9EEGY#*JIIgYX*IUUU 263vz B BE%%ah/J~"# JFMMMtTTT"AK  wy((a J3q{#3#3e#;;#ED999JKK     rr))) IrZao Show the counts of observations in each categorical bin using bars. A count plot can be thought of as a histogram across a categorical, instead of quantitative, variable. The basic API and options are identical to those for :func:`barplot`, so you can compare counts across nested variables. Note that :func:`histplot` function offers similar functionality with additional features (e.g. bar stacking), although its default behavior is somewhat different. {categorical_narrative} Parameters ---------- {categorical_data} {input_params} {order_vars} {orient} {color} {palette} {saturation} {hue_norm} stat : {{'count', 'percent', 'proportion', 'probability'}} Statistic to compute; when not `'count'`, bar heights will be normalized so that they sum to 100 (for `'percent'`) or 1 (otherwise) across the plot. .. versionadded:: v0.13.0 {width} {dodge} {log_scale} {native_scale} {formatter} {legend} {ax_in} kwargs : key, value mappings Other parameters are passed through to :class:`matplotlib.patches.Rectangle`. Returns ------- {ax_out} See Also -------- histplot : Bin and count observations with additional options. {barplot} {catplot} Examples -------- .. include:: ../docstrings/countplot.rst strip)!r/r0r1rrkindrrrrrrrQrs row_order col_ordercol_wraproaspectrrrr?r2rrrrM legend_outsharexsharey margin_titles facet_kwsrc! d|"vr5d|d}#tj|#t|"dgd}$gd}%|dvrt}&nt }&|dkr%||d}d }n||d }d }n||t d |&|t|||||| | | ||d kr||dn||}'dD]&}(|(|'jvr|'j|(d|(d|'j|(<'|'j |'j})|)j dd|)j f})|'jdd}*|'jdd}+| i} tdy|)|+|*|||||||||d | },|'j}-|r|'j|'jdkr|'|'j| ||'|,||-s|,S|'||}|'|||\}}t/j||!}|"d||$vr|"ddrdnd }.|'||||.||dn|}|.d krt5||.}|dvrWt7|"t8jj}"|'|"dt@||'j!|"d<|"d d!}/|"d"||%vrd#nd$}0|0d$kr|'"}0d%|'j vr(|d&vrd'|d(}#tj|#d)*tF}1ntH}1|d+kr|"d,d}2|"%}3|3&d-d.|3&d/d0d1|3vr|3d2d3d)z|3d1<|''|2|0||34nL|d5kr|"d6d7}4|"%}3|3&d-d.d1|3vr|3d2d3d)z|3d1<|3&d/d0 tQj)|3d1d8z |3d/<|'*|0||4|39n|d:kr|"%}3|3d;d0}5|3dd}6|3dd3}9|'|3d?d$||'j!}:|'+|/|0|5|6|7||:|8|9|3@ n|dAkr|"%}3|3d;d0}5|3dd}6|3dBd#};|3dCd:}<|3dDdE}=|3dFd#}>|3dGtX}?|3dHtX}@|'-|?|@|=|>\}=}>|'.|3dItX|3dJdK}At|3dLd)|3dMdN|3dOd |AP}B|3dQi%}C|3d/d}8|3d?d$}:|'|:||'j!}:|'/|/|0|5|;||6|:|8|<|=|>|B|C|3Rn|dSkr|"%}3|3d;d0}5|3dd}6|3d?d$}:|3d/d}8|3dTdU}D|3dVdW}E|3dXdY}F|3dZd7}G|3d[d}H|3d\i}I|3d]i}J|3d^i}KdG|3vr|'0|3dG|E}E|'|:||'j!}:|'1|/|0|5|6||:|8|E|D|F|G|H|I|J|K|3_n|d kr'|1||| | `}L|"dat@}M|"dbt@}N|'2|"dGtX|"dctX|"|'3t7|"ddit8j4j5d|"detX|"dfd0g\}O}P|'6|L|M|N|0||P|O|"hn|dikr|1||| | `}L|'3t7|"ddit8j4j5|"djtX|"detX|"dfd0k\}O}P|"d;d0}5|"dd}6|'7|L|0|/|5||6|P|O|"l n|dkrtIdmdn}Ldd do|'j}Qd |'j |Q<gdp}Rtqdq|R|"dqd}S|S|'j|Q<|Sdkr4|SdrkrdNnd }T|'j |Qxxts|'j |Tz zcc<|"d;d0}5|"dd}6|'7|L|0|/|5||6d0i|"l nds|dt}#t |#|,j:j;D]}U|'<|U|'ju|,=|'jd |'jd|,>|,?|,j:j;D]}U|,@|Ud|U_A|d$kr|'jB o |'jCdvk}Vnt|}V|Vr/|,E|'jdw|x|||,_F|,S)zNrzXcatplot is a figure-level function and does not accept target axes. You may wish to try r)rqrrSrr)rswarmr)rqrrrr0r<r/r)r/r0r1rrrrrrr)rrrr:rr) r5rrrrrrrrrrorrArrrrTrr)rrrrrr Fr3r)rqrz0The `weights` parameter has no effect with kind=.rrerr&r rdrrrrrrrr2rrrrSrr[rnrrrrr'rrrrrrrrrrrrr)rrrrr)rrrrrrrrrrrrrrrr^r_rrrr)rrrrqr)rrrrrrr9rrrzInvalid `kind`: zV. Options are 'strip', 'swarm', 'box', 'boxen', 'violin', 'bar', 'count', and 'point'.r=r7r1)r label_orderr])Grorp UserWarningrIrr, ValueErrorrir6rFrGlocr; duplicatedrLr rNrJr?rrr{rxrrrrrrlr!PathCollectionrr rrrrrr}r0rrRrIrr rrrLrrrrr{r|rlrurraxesflatrset_axis_labels set_titles tight_layout_update_legend_datalegend_rgrEr add_legendr5)Wr5r/r0r1rrrrrrrrrrQrsrrrrorrrrr?r2rrrrMrrrrrrrrwdesaturated_kindsundodged_kindsPlotterrr facet_datacol_namerow_namegrNrrr rr&rr2rrr[rrrr'rrrrrrr(r)rrrrrrrrr]r^r_rrr stat_optionsrrrrsW rYr"r" s v~~>37>>> c;''' 4BBB000N ((((% w 9FAA ]qyFAA ]q}GHH H 1#3CuW   goo'/emddQV   A** !+  !+c"2":)3zzzAK ##AK#88JJ$6$A$A$C$C#C CDJ{ud++H{ud++H   X8hy]f       A-K H1;qx0MAA AHEYGGGIIa9I%%% 11'9EEI**5'9EEGY"8R00H)))fjj.F.F)AJIIgYX*IUUU { 5 >>uj11E !!!!&#/*HII11 JJ{G , ,eQZ  { JJw $ $E JJw)?)?V L LE !!1; ' ' 'NTNNNC M#! , , , ,$$ wHd++;;==Ha(((K+++ h  $LL33q8HSM       jj44 ;;==Ha((( h  $LL33q8HSM   {A . . 6$&GHSM$:$:R$?H[ ! #      ;;==ll5!$$||FD))||FC((LLd33 LLa00 '' LLf - -uaj        ;;==ll5!$$||FD)) We,, We,,||NF;; ll=%88  Wj11LLj99 $%$>$> 9lK% % ! k++ LLz * *HLLg,N,N   UA&&\\*c22ll;22    LLb116688 LLd33 LLf55 '' 5!*EE  %#     " ;;==ll5!$$||FD))LLf55 LLd33 ,,y'22||NMBB ||NE:: ll=$77 \\,55 ,,y"--LLb11 << B// h  44!<L'' 5!*EE  %%#!!     & WYdKKK **Y00ZZ g66 "" JJw + + JJvz * *    00 VZZ 266 8H I I ZZ J77JJy!,, 1   !!   WYdKKK 00 VZZ 266 8H I IZZ J77ZZ J77JJy!,, 1   jj""zz&$'' !   '=== S))!(3 "# JHHH v|VZZ5P5PQQ"& J 7??9,,CC!E K # # #s1;'7'7%'? ? # # #jj""zz&$'' !   Et E E E oofk.. 2AH----akooc**AKOOC,@,@AAALLNNNNNfk b!!!  **Gq~/G 6ll J 1;??511y III  HrZa Figure-level interface for drawing categorical plots onto a FacetGrid. This function provides access to several axes-level functions that show the relationship between a numerical and one or more categorical variables using one of several visual representations. The `kind` parameter selects the underlying axes-level function to use. Categorical scatterplots: - :func:`stripplot` (with `kind="strip"`; the default) - :func:`swarmplot` (with `kind="swarm"`) Categorical distribution plots: - :func:`boxplot` (with `kind="box"`) - :func:`violinplot` (with `kind="violin"`) - :func:`boxenplot` (with `kind="boxen"`) Categorical estimate plots: - :func:`pointplot` (with `kind="point"`) - :func:`barplot` (with `kind="bar"`) - :func:`countplot` (with `kind="count"`) Extra keyword arguments are passed to the underlying function, so you should refer to the documentation for each to see kind-specific options. {categorical_narrative} After plotting, the :class:`FacetGrid` with the plot is returned and can be used directly to tweak supporting plot details or add other layers. Parameters ---------- {categorical_data} {input_params} row, col : names of variables in `data` or vector data Categorical variables that will determine the faceting of the grid. kind : str The kind of plot to draw, corresponds to the name of a categorical axes-level plotting function. Options are: "strip", "swarm", "box", "violin", "boxen", "point", "bar", or "count". {stat_api_params} {order_vars} row_order, col_order : lists of strings Order to organize the rows and/or columns of the grid in; otherwise the orders are inferred from the data objects. {col_wrap} {height} {aspect} {native_scale} {formatter} {orient} {color} {palette} {hue_norm} {legend} {legend_out} {share_xy} {margin_titles} facet_kws : dict Dictionary of other keyword arguments to pass to :class:`FacetGrid`. kwargs : key, value pairings Other keyword arguments are passed through to the underlying plotting function. Returns ------- :class:`FacetGrid` Returns the :class:`FacetGrid` object with the plot on it for further tweaking. Examples -------- .. include:: ../docstrings/catplot.rst c>eZdZdZd dZdZdZdZd Zd Z d Z d S)rCz6Modifies a scatterplot artist to show a beeswarm plot.r/rrc0||_||_||_dSr)r?rr2)rPr?rr2s rYrDzBeeswarm.__init__ s  &rZc|j}|jj}|}|jdkrdnd}||dd|f<|j\}}|j|} |jdkr| ddddgf} |} | j dkr tj | | j d} | } tj| | zdz |dz z} tj| | f} tj| dddf} | | }tj|}|||| <|jdkr|ddddgf}n|ddddf}|j|j\}}t+||j\}}|jdkr|||||n||||||jdkr)|tj||fdS|tj||fdS)z?Swarm `points`, a PathCollection, around the `center` position.r0r<rNrr)rrGdpirDr?rr<r get_sizesrrrepeatrE get_linewidthrrRc_argsort empty_likerAinvertedr add_gutters set_offsets)rPr/r3rr orig_xy_datacat_idx orig_x_data orig_y_dataorig_xysizesrradiisorterorig_xyrnew_xyrnew_xy new_x_data new_y_datat_fwdt_invs rY__call__zBeeswarm.__call__ s[im))++ {c))!!q#) QQQZ $0> [,((66 ;#  aaa!Qi(G  "" :??IeW]1%566E##%%**,,$&!+sRx8%'GAAAqDM**6?-))--11 ;#  QQQAY'FFQQQU^F!#!6!6!8!8!B!B6!J!J!L J0DK@@ u ;#     Z > > > >   Z > > > ;#     ru[*%<= > > > > >   ruZ%<= > > > > >rZc|d}tj|d}|ddD]}|||}|||}tj|dddf|z }|tj|}|||}tj||g}|S)z.Adjust x position of points to avoid overlaps.)rrrr<N)r atleast_2d could_overlapposition_candidatesabsrfirst_non_overlapping_candidatevstack) rPr midlinerxyr_i neighbors candidatesr new_xyr_is rYrAzBeeswarm.beeswarm s4. hqk**abb\ 2 2E**5%88I11%CCJfZ1-788G#BJw$7$78J<Find the first candidate that does not overlap with the swarm.rNr<rz>Q  a= 1o 1o 1o   E!MCcs"Bs"B9R==29R==8L;#455J  VLJ$>??N    J   rZc|jdz }||||z }||k}|r|||<||||z}||k} | r||| <| |zt|z } | |jkr/d| } t j| t|S)z2Stop points from extending beyond their territory.rzi{:.1%} of the points cannot be placed; you may want to decrease the size of the markers or use stripplot.) rr"rrr2formatrorpr) rPr/r3 trans_fwd trans_inv half_width low_gutteroff_low high_gutteroff_high gutter_proprws rYrzBeeswarm.add_gutters5 sZ!^ Yyy00:=>> :% ;;== )(F7Oi & 1 1J >?? K' <<>> +*F8 ')..003v;;> ) ) )Hf[!!  M#{ + + + rZN)r/rr) r|r}r~__doc__rDrrArrrrr]rZrYrCrC s@@'''' :?:?:?x@ ) ) )$$$"   BrZrCBoxPlotArtistsz$box median whiskers caps fliers meanc>eZdZdZdZdZdZdZdZdZ dZ d S) rc|d|_|d|_|d|_|d|_|d|_|d|_d|_g|j|j|j|j|j|j|_dS)Nrurywhiskersrzrdmeans)ruryrFrzrdrG_label _children)rP artist_dicts rYrDzBoxPlotContainer.__init__Q s ) "9- #J/ ' !(+  )   Z \ ] Y  [  Z  rZc2dt|jdS)Nz)rrurPs rY__repr__zBoxPlotContainer.__repr__d sHDJHHHHrZc Ltd|zd|zdz}t|jr |j|ng|jr |j|ng|jr |j|ng|jr |j|ng|jr |j|ng|jr |j|ngS)Nr)slicerCruryrFrzrdrG)rPidx pair_slices rY __getitem__zBoxPlotContainer.__getitem__g s1s7AGaK00 #z 1DJsOOr!% 5DL  2)- >DM* % %B%)Y 6DIj ! !B $ 3DK  "j 0DJsOOb    rZc#rKfdttjDEd{VdS)Nc3(K|] }|V dSrr])r`rrPs rYrz,BoxPlotContainer.__iter__..s s'<<DG<<<<<rws """"""------222222******((((((44444444HHHHHHHHHH&&&&&&                    988888 +*****33333333   W&W&W&W&W&-W&W&W&t(555550555 D```!&"   `   `"V   #`,v   -`6F   7`dv   e`r 6  s`F &   G`N F   O`ZV   [`hv   i`t F   u`|V   }`JV   K`X    Y`d    e`p &   q`z &  {`Nf   O`Vf   W`bf   c`t   u`Bf   C`P 6  Q`d F   e`p &   q`x 6   y`D F   E`Jv   K`Pf   Q`Xf   Y`` F   a`ff   g`lf   m`r F   s`xf   y`D%%% =Dd$$ tTc vTQU d =====@:&&:: : t u:%:%t$u:%:%| LDd$$ tTc uBf!f!cU TT zjtLLLLL^lVVll l X Yl%l%X$Yl%l% ` IDd$$ tTc TTeQUddRV TTD IIIIIX[FF[[ [ v w[%[%v$w[%[% ~ :Dd$$ uTt g Tf :::::z=FF== = z {=%=%z${=%=% B =Dd$$ D$ da$$$v3 =====@;FF;; ; v w;%;%v$w;%;% ~ FDd$$z$T T4C Bf!t$vq$J FFFFFRB&&BB B D EB%B%D$EB%B%L ?Dd$$z$T dT7et% d64JZz ?????DOFFOO O ^ _O%O%^$_O%O% f KDd$$ tTct &a4e6d KKKKK\3FF33 3 f g3%3%f$g3%3% n C Dd$Wz$T  !AE4tTD d44JC C C C C L M&&MM M Z [M%M%Z$[M%M%`xxxxxxxxv,.TUU1111111111rZ