ó ¤Ç>Yc@@s‘dZddlmZddlZddlmZddlmZddl m Z ddl m Z m Z mZmZmZmZmZmZmZddlmZmZmZdd lmZd d lmZmZmZd d lm Z d d l!m"Z"m#Z#d dl$m%Z%d dl&m'Z'm(Z(d dl)m*Z*m+Z+m,Z,d„Z-de fd„ƒYZ.de.fd„ƒYZ/de.fd„ƒYZ0dS(sÉ This is the Bokeh charts interface. It gives you a high level API to build complex plot in a simple way. This is the Builder class, a minimal prototype class to build more chart types on top of it. i(tabsolute_importN(t string_types(t SortDirection(tHasProps( tBooltColortDicttEithertEnumtInstancetListtStringtTuple(t FactorRangetRangetRange1d(tColumnDataSourcei(tAttrSpectCatAttrt ColorAttr(tChart(tChartDataSourcetOrderedAssigner(tCompositeGlyph(t Dimensiont ColumnLabel(tbuild_hover_tooltipstcollect_attribute_columnstlabel_from_index_dictc @s4t|dƒdkr+td|jƒ‚nt|dƒdkrVtd|jƒ‚nt|jƒƒtt|dgƒƒB‰x|jD]}ˆj|ƒqˆWx$|jj ƒD]}ˆj|ƒq¯W‡fd†|j ƒDƒ}|||Ž}‡fd†|j ƒDƒ}t |}|j |ƒ|j ƒ|S( sgA factory function for handling Chart and Builder generation. Returns: :class:`Chart` t dimensionss6Each builder must specify its dimensions, %s does not.tdefault_attributess>Each builder must specify its default_attributes, %s does not.t__deprecated_attributes__c@s+i|]!\}}|ˆkr||“qS(((t.0tktv(t builder_props(s/lib/python2.7/site-packages/bkcharts/builder.pys 2s c@s+i|]!\}}|ˆkr||“qS(((R R!R"(R#(s/lib/python2.7/site-packages/bkcharts/builder.pys 6s N(tgetattrtNonetNotImplementedErrort__name__tsett propertiesRtaddRtkeystitemsRt add_buildert start_plot( t builder_classtdatatkwstdimt attr_namet builder_kwstbuildert chart_kwstchart((R#s/lib/python2.7/site-packages/bkcharts/builder.pytcreate_and_builds"   tBuildercB@sýeZdZeeƒZeeƒZeƒZeƒZ eƒZ eƒZ e e ddƒZdZgZeeeeƒddƒZdZe eddƒZe eeƒddƒZe eddƒZgZeZe eeƒƒZeeediƒZ eddƒZ!e"e#dd ƒZ$ee%ƒZ&e'e e(eeƒƒe eƒedddd ƒZ)dZ*d „Z+d „Z,d „Z-d„Z.d„Z/d„Z0d„Z1d„Z2dd„Z3e4d„ƒZ5d„Z6d„Z7dd„Z8e9d„ƒZ:e4d„ƒZ;RS(sâ A prototype class to inherit each new chart Builder type. It provides useful methods to be used by the inherited builder classes, in order to automate most of the charts creation tasks and leave the core customization to specialized builder classes. In that pattern inherited builders just need to provide the following methods: Required: * :meth:`~bkcharts.builder.Builder.yield_renderers`: yields the glyphs to be rendered into the plot. Here you should call the :meth:`~bkcharts.builder.Builder.add_glyph` method so that the builder can setup the legend for you. * :meth:`~bkcharts.builder.Builder.set_ranges`: setup the ranges for the glyphs. This is called after glyph creation, so you are able to inspect the comp_glyphs for their minimum and maximum values. See the :meth:`~bkcharts.builder.Builder.create` method for more information on when this is called and how the builder provides the ranges to the containing :class:`Chart` using the :meth:`Chart.add_ranges` method. Optional: * :meth:`~bkcharts.builder.Builder.setup`: provides an area where subclasses of builder can introspect properties, setup attributes, or change property values. This is called before :meth:`~bkcharts.builder.Builder.process_data`. * :meth:`~bkcharts.builder.Builder.process_data`: provides an area where subclasses of builder can manipulate the source data before renderers are created. thelps\Optional input to override the default palette used by any color attribute. sç The attribute specs used to group data. This is a mapping between the role of the attribute spec (e.g. 'color') and the :class:`~bkcharts.attributes.AttrSpec` class (e.g., :class:`~bkcharts.attributes.ColorAttr`). The Builder will use this attributes property during runtime, which will consist of any attribute specs that are passed into the chart creation function (e.g., :class:`~bkcharts.Bar`), ones that are created for the user from simple input types (e.g. `Bar(..., color='red')` or `Bar(..., color=)`), or lastly, the attribute spec found in the default_attributes configured for the subclass of :class:`~bkcharts.builder.Builder`. sí All columns used for specifying attributes for the Chart. The Builder will set this value on creation so that the subclasses can know the distinct set of columns that are being used to assign attributes. sn A list of composite glyphs, where each represents a unique subset of data. The composite glyph is a helper class that encapsulates all low level :class:`~bokeh.models.glyphs.Glyph`, that represent a higher level group of data. For example, the :class:`BoxGlyph` is a single class that yields each :class:`GlyphRenderer` needed to produce a Box on a :class:`BoxPlot`. The single Box represents a full array of values that are aggregated, and is made up of multiple :class:`~bokeh.models.glyphs.Rect` and :class:`~bokeh.models.glyphs.Segment` glyphs. s4Represents the unique labels to be used for legends.tdefaultsµ Attribute that should be used to sort the legend, for example: color, dash, maker, etc. Valid values for this property depend on the type of chart. s† Sort direction to apply to :attr:`~bkcharts.builder.Builder.sort_legend`. Valid values are: `ascending` or `descending`. sF Tells the builder to add tooltips to the chart by either using the columns specified to the chart attributes (True), or by generating tooltips for each column specified (list(str)), or by explicit specification of the tooltips using the valid input for the `HoverTool` tooltips kwarg. c O@sÀd}t|ƒdks*t|ƒdkr8t|jjƒƒ}|j|}i}x1|D])}||jƒkrY||||R<t data_argsR2RAR!((s/lib/python2.7/site-packages/bkcharts/builder.pyRLßs6$          c C@syt|jƒ}|jjƒ}|jdƒ}tƒ}x|D]}|j|dƒ}t|t ƒrq|||((s/lib/python2.7/site-packages/bkcharts/builder.pytcollect_attr_kwargsãs ( c@s‡fd†|DƒS(Nc@si|]}ˆ||“qS(((R Ra(Ru(s/lib/python2.7/site-packages/bkcharts/builder.pys ìs ((RQRuR>((Rus/lib/python2.7/site-packages/bkcharts/builder.pytget_group_kwargsëscC@s9|jƒ|jƒ|jƒ}|dkr8tƒ}n|j||ƒ|jƒ|jd|jƒ|jd|j ƒ|j |j |j |j |jƒ|_ |j|j ƒ|jd|jƒ|jd|jƒ|jd|jƒ|jd|jƒ|jdk r5td|jd|jƒ}|j|ƒn|S(sBuilds the renderers, adding them and other components to the chart. Args: chart (:class:`Chart`, optional): the chart that will contain the glyph renderers that the `Builder` produces. Returns: :class:`Chart` txtyt hover_spect chart_colsN(R\RbRdR%Rt add_renderersRet add_rangestx_rangety_ranget _sort_legendtlegend_sort_fieldtlegend_sort_directionRPRAt add_legendt add_labelstxlabeltylabelt add_scalestxscaletyscalettooltipsRRMt add_tooltips(RQR7RtR‘((s/lib/python2.7/site-packages/bkcharts/builder.pytcreateîs,        cC@s4d}x'|jD]}|t|jƒƒ7}qW|S(Nt(tcomp_glyph_typesRYtglyph_properties(tclsthelp_strt comp_glyph((s/lib/python2.7/site-packages/bkcharts/builder.pyt generate_helpsc@sÊ|rÆt||jƒdkrÆg||jD]%}t|tƒrL|dn|^q-‰gˆD]'}t|tƒs€t|ƒn|^q_‰‡fd†}|dk}tt|d|d|ƒƒSn|S(s|Sort legends sorted by looping though sort_legend items ( see :attr:`Builder.sort_legend` for more details) ic@sˆj|dƒS(Ni(tindex(tleg(t item_order(s/lib/python2.7/site-packages/bkcharts/builder.pytfoo8st descendingtkeytreverse( RBRUR,RXRDRRYRCtsorted(RˆR‰tlegendsRARRžR¡((Rs/lib/python2.7/site-packages/bkcharts/builder.pyR‡%s61 N((<R't __module__t__doc__R RR…R†R RŒRRRR RRTR%RRERRRARRRMRRkRsRqRRFR•Rtsort_dimRˆRRR‰RR^RR R‘RRLRHR\RbRdReRnRxRrt staticmethodRzR}R~R“t classmethodRšR‡(((s/lib/python2.7/site-packages/bkcharts/builder.pyR9>s\                 *  F 3  $    /t XYBuildercB@soeZdZedƒZedƒZddgZdgdgddggZieƒd6Z d„Z d„Z RS(s0Implements common functionality for XY Builders.RR€tcolorcC@s:|jƒ}|d}|d}|jd||ƒ|_|d}|d}|jd||ƒ|_|jd krÍ|jjd k r¯|jj}t|t ƒs¸|g}q¸n dg}dj |ƒ|_n|j d kr6|j jd k r|j j}t|t ƒs!|g}q!n dg}dj |ƒ|_ nd S( s%Calculate and set the x and y ranges.RfRhRRgRiR€R”s, N( Rnt _get_rangeR…R†RŒR%Rt selectionRXRCtjoinRR€(RQtextentstendxtstartxtendytstartytselect((s/lib/python2.7/site-packages/bkcharts/builder.pyReLs*         c C@swt||ƒ}|j}|j}|jj|ƒ}|jdkr¶|jƒ}|ry|jdtƒWqt k r‹|j dtƒqXnt ||ddƒt d|j ƒƒStj|tjƒròt ||ddƒtd|d|ƒS|d ks||d kr2t ||ddƒt dd gƒS||} t ||dd ƒtd|d | d|d | ƒSd S(s-Create a :class:`Range` for the :class:`Chart`. Args: dim (str): the name of the dimension, which is an attribute of the builder start: the starting value of the range end: the ending value of the range Returns: :class:`Range` tobjecttinplacetscalet categoricaltfactorstdatetimetstarttendR%itlineargš™™™™™¹?N(R$R0tdtypeR¦RWtnametdrop_duplicatest sort_valuestTruetAttributeErrortsortRNR ttolisttnpt issubdtypet datetime64R( RQR2RºR»tdim_refRyR½RÃR¸tdiff((s/lib/python2.7/site-packages/bkcharts/builder.pyR«ks,      ( R'R¤R¥RRR€RRERRReR«(((s/lib/python2.7/site-packages/bkcharts/builder.pyR©?s    tAggregateBuildercB@s4eZdZedƒZieƒd6eƒd6ZRS(s™A base class for deriving specific builders performing aggregation with stats. The typical AggregateBuilder takes a single dimension of values. RyRoRª(R'R¤R¥RRyRRR(((s/lib/python2.7/site-packages/bkcharts/builder.pyRʘs  (1R¥t __future__RtnumpyRÅtsixRtbokeh.core.enumsRtbokeh.core.has_propsRtbokeh.core.propertiesRRRRRR R R R tbokeh.models.rangesR RRtbokeh.models.sourcesRRARRRR7Rt data_sourceRRtmodelsRR)RRtutilsRRRR8R9R©RÊ(((s/lib/python2.7/site-packages/bkcharts/builder.pyts( @ $ÿÿY