σ ΞYc @@sΌdZddlmZddlmZmZmZmZmZddl m Z ddl m Z ddl mZdd lmZdddd dd eedd „ Zd efd„ƒYZdS(sϋThis is the Bokeh charts interface. It gives you a high level API to build complex plot is a simple way. This is the Histogram class which lets you build your histograms just passing the arguments to the Chart class and calling the proper functions. i(tabsolute_import(tBooltInttEithertFloattList(tRange1di(tcreate_and_buildi(t BarBuilder(tHistogramGlyphtcounttlinearc K@s•| r%t| tƒ r%tdƒ‚n| } || d<|| d<|| d<|| d<|| d<|| d<|| d<| | d <|| d ` to render the glyphs from input data and specification. This primary use case for the histogram is to depict the distribution of a variable by binning and aggregating the values in each bin. This chart implements functionality to provide convenience in optimal selection of bin count, but also for segmenting and comparing segments of the variable by a categorical variable. Args: data (:ref:`userguide_charts_data_types`): the data source for the chart. Must consist of at least 2 values. If all values are equal, the result is a single bin with arbitrary width. values (str, optional): the values to use for producing the histogram using table-like input data label (str or list(str), optional): the categorical variable to use for creating separate histograms color (str or list(str) or `~bkcharts._attributes.ColorAttr`, optional): the categorical variable or color attribute specification to use for coloring the histogram, or explicit color as a string. agg (str, optional): how to aggregate the bins. Defaults to "count". bins (int or list(float), optional): the number of bins to use, or an explicit list of bin edges. Defaults to None to auto select. density (bool, optional): whether to normalize the histogram. Defaults to False. **kw: In addition to the parameters specific to this chart, :ref:`userguide_charts_defaults` are also accepted as keyword parameters. Returns: :class:`Chart`: includes glyph renderers that generate the histograms Examples: .. bokeh-plot:: :source-position: above from bkcharts import Histogram, output_file, show from bokeh.layouts import row from bokeh.sampledata.autompg import autompg as df hist = Histogram(df, values='mpg', title="Auto MPG Histogram", plot_width=400) hist2 = Histogram(df, values='mpg', label='cyl', color='cyl', legend='top_right', title="MPG Histogram by Cylinder Count", plot_width=400) output_file('hist.html') show(row(hist, hist2)) sCcontinuous_range must be an instance of bokeh.models.ranges.Range1dtlabeltvaluestcolortaggtyscaletxgridtygridty_rangetbins(t isinstanceRt ValueErrorRtHistogramBuilder( tdataR R RRRRRRtcontinuous_rangetkwR((sBlib/python2.7/site-packages/bkcharts/builders/histogram_builder.pyt Histogram#s7          RcB@skeZdZeeeƒedd ddƒZe e ddƒZ e Z d„Zd„Zd„Zd„ZRS( s»Generates one to many histograms with unique attributes. The HistogramBuilder is responsible for producing a chart containing one to many histograms from table-like inputs. tdefaultthelps  If bins is an int, it defines the number of equal-width bins in the given range. If bins is a sequence, it defines the bin edges, including the rightmost edge, allowing for non-uniform bin widths. (default: None, use Freedman-Diaconis rule) sv Whether to normalize the histogram. If True, the result is the value of the probability *density* function at the bin, normalized such that the *integral* over the range is 1. If False, the result will contain the number of samples in each bin. For more info check :class:`~bkcharts.glyphs.HistogramGlyph` documentation. (default: False) cC@s9tt|ƒjƒ|jdjdk r5d|_ndS(NRg333333γ?(tsuperRtsetupt attributestcolumnstNonet fill_alpha(tself((sBlib/python2.7/site-packages/bkcharts/builders/histogram_builder.pyRŽscC@std|jd|jƒS(s6Build kwargs that are unique to the histogram builder.Rtdensity(tdictRR%(R$((sBlib/python2.7/site-packages/bkcharts/builders/histogram_builder.pytget_extra_args•scC@sdS(N((R$((sBlib/python2.7/site-packages/bkcharts/builders/histogram_builder.pyt_apply_inferred_index™scC@sζtg|jD]}|j^q ƒ}tg|jD]}|j^q2ƒ}tg|jD]}|j^qWƒ}tg|jD]}|j^q|ƒ}||dd}td||d||ƒ|_td|d|dƒ|_ dS(s]Push the Bar data into the ColumnDataSource and calculate the proper ranges. g@gš™™™™™©?tstarttendgš™™™™™ρ?N( tmaxt comp_glyphstx_maxtmintx_minty_maxty_minRtx_rangeR(R$t comp_glyphR-R/R0R1tx_buffer((sBlib/python2.7/site-packages/bkcharts/builders/histogram_builder.pyt set_rangess%%%% N(t__name__t __module__t__doc__RRRRR"RRtFalseR%R tglyphRR'R(R5(((sBlib/python2.7/site-packages/bkcharts/builders/histogram_builder.pyRns     N(R8t __future__Rtbokeh.core.propertiesRRRRRt bokeh.modelsRtbuilderRt bar_builderRtglyphsR R"R9tTrueRR(((sBlib/python2.7/site-packages/bkcharts/builders/histogram_builder.pyts(   I