a \:bE@s"ddlZddlmZd ddZdS) N)utilsFTbothcC s ddlm}t|\}}t|}dd}||}||}||}||}t|}|durft|}|durxt|}|durt|}d}tt |}|durtt |}|durd}d}n*|durd}|}n|dk}|dkr|nd}||}| d | d |dur&t t |}| n|}| durJt t |}| n| }i}t|D]n}|durz|||vrzqZ| dur||| vrqZ||||f} | |vrg|| <|| |qZ||j}!|!j|!j}"}#t|}$d \}%}&| r||j|j}'n||j|j}'||#}(| rL|&|%||(t|$})n|&|%t|$})| durl| nt t | | rddd t}*|*dkr|)d t|*d}+nd }+fddD},gd}-|durddD}t|*D]v}.|.}/d||/vr,|-|.t|-||/d<d||/vrFd||/d<d||/vr|+dkrbdnd||/d<q|durddD}t|*D]P}.|.}/d||/vrd||/d<d||/vr|+dkrdnd||/d<q| r|dkr|&|)dn|&}0n |%|)d}0t }1g}2|D]ȉ|r>| r|dkrL|0|)dn|0}3|jd |3|3f|0d|(|0d|(fd|jdd|jd|0d |(d!d!|jd"}4|4d#|0|(8}0ntfd$d%|D}5|j|0|)dd&|0|5d|)|)dd&fd'd(d|jddd)|j|0|5d|)dd*d!d+|jd"}4|4d#d}6|D]}7|7f|vr^qF| rt|j|0dd,n|j|0dd,|dur|7|}8t|8dkr|8d|8d}9}:n |7d}9}:n |7d}9}:|dur||9}9|dur||:}:| rz|6ddkrz| rN|jd |0|)d|0|)df|0|)d|0|)dfd-|jddn,|j|0|)d|0|)dfd.d/d-|jdd|6d7}6| d0vr| r|jd1|"|0|9d2d!|jd3d4n|j|0d1|#|9d!d5|jd3d4| d6vr8|:dur8| r|jdd7|"|0|:d8d!|jd3d4n"|j|0dd7|#|:d!d+|jd3d4|2|0t!||7fD]v\};}|durLt"||<r|>||<|>||<}?}@n"|>||<d|>||<d}?}@| r|j#|?|@g|0|=|0|=gd:fd;|'i|||<n2|j#|0|=|0|=g|?|@gd:fd;|'i|||<||<}A|A|1vrb|And}B|1$|A| r|j#|>g|0|=gfd<|'|Bd=||An(|j#|0|=g|>gfd<|'|Bd=||AqR| r|0|)8}0n|0|)7}0qFq | r|j%&d+|j'&d>|(g|j)d8*d>|j)d2*d>|j)d5*d>|j)d++d?d1|#f|,dd|j'-|2|j.ddd@n|j'&d8|j%&d>|/g|j)d+*d>|j)d2*d>|j)d5*d>|j)d8+d?d1|"f|0dd|j%-|2|j.dddA|S)Ba- Dot plotting (also known as forest and blobbogram). Produce a dotplot similar in style to those in Cleveland's "Visualizing Data" book ([1]_). These are also known as "forest plots". Parameters ---------- points : array_like The quantitative values to be plotted as markers. intervals : array_like The intervals to be plotted around the points. The elements of `intervals` are either scalars or sequences of length 2. A scalar indicates the half width of a symmetric interval. A sequence of length 2 contains the left and right half-widths (respectively) of a nonsymmetric interval. If None, no intervals are drawn. lines : array_like A grouping variable indicating which points/intervals are drawn on a common line. If None, each point/interval appears on its own line. sections : array_like A grouping variable indicating which lines are grouped into sections. If None, everything is drawn in a single section. styles : array_like A grouping label defining the plotting style of the markers and intervals. marker_props : dict A dictionary mapping style codes (the values in `styles`) to dictionaries defining key/value pairs to be passed as keyword arguments to `plot` when plotting markers. Useful keyword arguments are "color", "marker", and "ms" (marker size). line_props : dict A dictionary mapping style codes (the values in `styles`) to dictionaries defining key/value pairs to be passed as keyword arguments to `plot` when plotting interval lines. Useful keyword arguments are "color", "linestyle", "solid_capstyle", and "linewidth". split_names : str If not None, this is used to split the values of `lines` into substrings that are drawn in the left and right margins, respectively. If None, the values of `lines` are drawn in the left margin. section_order : array_like The section labels in the order in which they appear in the dotplot. line_order : array_like The line labels in the order in which they appear in the dotplot. stacked : bool If True, when multiple points or intervals are drawn on the same line, they are offset from each other. styles_order : array_like If stacked=True, this is the order in which the point styles on a given line are drawn from top to bottom (if horizontal is True) or from left to right (if horizontal is False). If None (default), the order is lexical. striped : bool If True, every other line is enclosed in a shaded box. horizontal : bool If True (default), the lines are drawn horizontally, otherwise they are drawn vertically. show_names : str Determines whether labels (names) are shown in the left and/or right margins (top/bottom margins if `horizontal` is True). If `both`, labels are drawn in both margins, if 'left', labels are drawn in the left or top margin. If `right`, labels are drawn in the right or bottom margin. fmt_left_name : callable The left/top margin names are passed through this function before drawing on the plot. fmt_right_name : callable The right/bottom marginnames are passed through this function before drawing on the plot. show_section_titles : bool or None If None, section titles are drawn only if there is more than one section. If False/True, section titles are never/always drawn, respectively. ax : matplotlib.axes The axes on which the dotplot is drawn. If None, a new axes is created. Returns ------- fig : Figure The figure given by `ax.figure` or a new instance. Notes ----- `points`, `intervals`, `lines`, `sections`, `styles` must all have the same length whenever present. References ---------- .. [1] Cleveland, William S. (1993). "Visualizing Data". Hobart Press. .. [2] Jacoby, William G. (2006) "The Dot Plot: A Graphical Display for Labeled Quantitative Values." The Political Methodologist 14(1): 6-14. Examples -------- This is a simple dotplot with one point per line: >>> dot_plot(points=point_values) This dotplot has labels on the lines (if elements in `label_values` are repeated, the corresponding points appear on the same line): >>> dot_plot(points=point_values, lines=label_values) rNcSs|dur dSt|S)N)npasarray)xrzdot_plot..g?FTrg{Gz?)rrg@gcsi|]}||qSr)index.0r) style_codesrr r zdot_plot..)rgbykZpurpleZorangecSsi|] }|iqSrrrrrr rr colorZmarkeroZms cSsi|] }|iqSrrrrrr rr ZgreyZ linewidthgffffff?Zdarkgrey)r transformzordergffffff?center)horizontalalignmentverticalalignmentrZboldcsg|]}|dkr|qS)rr)rr)k0rr =r zdot_plot..g{Gz?))\(?r$)(\?r%)rrrZclip_ongRQ?bottom)rZ lightgrey)rr)rr)leftrgrightZ monospace)r r!rZfamilytop)r(rg?r'-rNone)ZlsrZlabelZnoneZaxes)Zscaleytight)Zscalexr-)1Zmatplotlib.transforms transformsrZ create_mpl_axrrlenZarangeZzerossetZ set_xmarginZ set_ymarginlistsortrangeappendZget_window_extentZ transformedZdpi_scale_transinvertedwidthZheightZblended_transform_factoryZ transDataZ transAxesfloatZ fill_betweentextZset_fontweightZaxhlineZaxvlinesplitlower enumerateZisscalarZplotaddZxaxisZset_ticks_positionZyaxisZset_yticklabelsZspinesZ set_colorZ set_positionZset_ylimZ set_ticksZautoscale_viewZset_xticklabelsZset_xlim)CZpointsZ intervalslinesZsectionsZstylesZ marker_propsZ line_propsZ split_namesZ section_orderZ line_orderZstackedZ styles_orderZstripedZ horizontalZ show_namesZ fmt_left_nameZfmt_right_nameZshow_section_titlesZaxr.ZfigZasarray_or_noneZnpointZsection_title_spaceZnsectZdraw_section_titlesZ nsect_titleZsection_space_totalZlines0Zlines1Z lines_mapiZkyZbboxZawidthZaheightZnrowsr&r)ZtransZtitle_space_axesZdposZnvalZstackdZstyle_codes_mapZcolorsjZscposZlabeledZticksZy0ZtxtmZjrowZk1usZ left_labelZ right_labelZjiZjpZyoZptZlcbZucbZslZsllr)r"rr dot_plots w                                                             rC)NNNNNNNNNFNFTrNNNN)ZnumpyrrrCrrrr s