U /eQr@s0dZddlmZddlZeeZddlZddlm Z m Z m Z m Z ddlmZddlmZmZmZmZmZddlmZmZmZmZmZmZmZmZmZm Z m Z m!Z!m"Z"m#Z#m$Z$dd l%m&Z&m'Z'dd l(m)Z)dd l*m+Z+m,Z,dd l-m.Z.m/Z/m0Z0m1Z1dd l2m3Z3m4Z4m5Z5m6Z6ddl7m8Z8ddl9m:Z:ddlm;Z;mm?Z?ddl@mAZAddlBmCZCddlDmEZEddlFmGZGmHZHmIZImJZJddlKmLZLmMZMmNZNddlOmPZPmQZQmRZRmSZSddlTmUZUmVZVmWZWddlXmYZYmZZZm[Z[e rddl\m]Z]dZ^GdddeEZ_dd Z`Gd!d"d"eaZbd#ZcGd$d%d%ebZdd&d'ZedS)(z2 Models for representing top-level plot objects. ) annotationsN) TYPE_CHECKINGAnyListoverload)Literal)Location OutputBackendPlace PlaceType ResetPolicy)AliasBoolDictEitherEnumFloatIncludeInstanceIntrNullNullableOverrideReadonlyString)ScalarFillPropsScalarLineProps)find)errorwarning)BAD_EXTRA_RANGE_NAMEINCOMPATIBLE_SCALE_AND_RANGEREQUIRED_RANGEREQUIRED_SCALE)FIXED_HEIGHT_POLICYFIXED_SIZING_MODEFIXED_WIDTH_POLICYMISSING_RENDERERS)Model) nice_join) AnnotationLegendTitle)Axis)Glyph)Grid) LayoutDOM) DataRange1d FactorRangeRangeRange1d) GlyphRendererRenderer TileRenderer)CategoricalScale LinearScaleLogScaleScale)ColumnarDataSourceColumnDataSource DataSource) HoverToolToolToolbar) TileSource)Plotc@seZdZUdZddZddZddZdd Zed d Z ed d Z eddZ eddZ eddZ ddddZeddZeddZeddZeddd d!Zejdd"d#d!Zdd%d&d'd(d)d*Zd+d'd,d-d.Zed/d0d1d2d3d4Zed5d/d0d1d6d7d4Zdd9d:d0d1d;dd?d@dAZeedBddCdDZeedBddEdFZeedBddGdHZe e!dBddIdJZ"ee#dBddKdLZ$e%e&dMdNdOdPZ'e%e&dQdNdRdPZ(e)dSdTdUdVdWZ*e%e+dXdNdYdPZ,e%e+dZdNd[dPZ-e.e/e%e&d\d]Z0e.e/e%e&d^d]Z1e.e/e%e+d_d]Z2e.e/e%e+d`d]Z3e4dadbdPZ5e6e7e%e8dcdNdddP9e/dedNZ:e;ee?e@dhdidjZAeBdkdlZCeDe%eEdmd]ZFe%eGdndNdodPZHe;es zPlot._axis..)extendgetattrrG)rHZsidesobjssaxisrLrLrM_axiss z Plot._axiscCs |ddS)z[ Splattable list of :class:`~bokeh.models.axes.Axis` objects for the x dimension. abovebelowr]rHrLrLrMxaxissz Plot.xaxiscCs |ddS)z[ Splattable list of :class:`~bokeh.models.axes.Axis` objects for the y dimension. leftrightr`rarLrLrMyaxissz Plot.yaxiscCst|j|jS)zG Splattable list of :class:`~bokeh.models.axes.Axis` objects. )rGrbrerarLrLrMr\sz Plot.axiscCs4|j|j|j|j|j}dd|D}t|S)z/ Splattable list of |Legend| objects. cSsg|]}t|tr|qSrL)rSr-rTrLrLrMrWs zPlot.legend..)r^r_rcrdcenter_legend_attr_splat)rHZpanelsZlegendsrLrLrMlegendsz Plot.legendcCsdd|jD}t|S)zM Splattable list of :class:`~bokeh.models.tools.HoverTool` objects. cSsg|]}t|tr|qSrL)rSrArTrLrLrMrWs zPlot.hover..)toolsrG)rHZhoversrLrLrMhoversz Plot.hoverzLiteral[(0, 1)] dimensioncsfdd|jD}t|S)Ncs$g|]}t|tr|jkr|qSrL)rSr1rlrTrkrLrMrWs zPlot._grid..)rfrG)rHrlgridrLrkrM_gridsz Plot._gridcCs |dS)z\ Splattable list of :class:`~bokeh.models.grids.Grid` objects for the x dimension. rrnrarLrLrMxgridsz Plot.xgridcCs |dS)z\ Splattable list of :class:`~bokeh.models.grids.Grid` objects for the y dimension. r+rorarLrLrMygridsz Plot.ygridcCst|j|jS)zH Splattable list of :class:`~bokeh.models.grids.Grid` objects. )rGrprqrarLrLrMrmsz Plot.gridz TList[Tool])returncCs|jjSNtoolbarrirarLrLrMrisz Plot.tools)ricCs ||j_dSrsrt)rHrirLrLrMrisrfr8r None)rVplacerrcCs4|tkr td|dttt|||dS)aG Adds an object to the plot in a specified place. Args: obj (Renderer) : the object to add to the Plot place (str, optional) : where to add the object (default: 'center') Valid places are: 'left', 'right', 'above', 'below', 'center'. Returns: None zInvalid place 'z%' specified. Valid place values are: N)r ValueErrorr*rYappend)rHrVrwrLrLrM add_layouts zPlot.add_layoutrB)rirrcGs.|D]$}t|tstd|jj|qdS)z Adds tools to the plot. Args: *tools (Tool) : the tools to add to the Plot Returns: None z2All arguments to add_tool must be Tool subclasses.N)rSrBrxruriry)rHriZtoolrLrLrM add_tools*s  zPlot.add_toolsr0rr7)glyphrJrrcKsdSrsrL)rHr|rJrLrLrM add_glyph:szPlot.add_glyphr>)sourcer|rJrrcKsdSrsrL)rHr~r|rJrLrLrMr}<sNzGlyph | ColumnarDataSourcez Glyph | None)source_or_glyphr|rJrrcKsdt|tr|}n t|}}t|ts.tdt|ts@tdtf||d|}|j||S)a Adds a glyph to the plot with associated data sources and ranges. This function will take care of creating and configuring a Glyph object, and then add it to the plot's list of renderers. Args: source (DataSource) : a data source for the glyphs to all use glyph (Glyph) : the glyph to add to the Plot Keyword Arguments: Any additional keyword arguments are passed on as-is to the Glyph initializer. Returns: GlyphRenderer z<'source' argument to add_glyph() must be DataSource subclassz6'glyph' argument to add_glyph() must be Glyph subclass)Z data_sourcer|) rSr>r?r@rxr0r7 renderersry)rHrr|rJr~grLrLrMr}?s     rDr9) tile_sourcerJrrcKs"tfd|i|}|j||S)aU Adds new ``TileRenderer`` into ``Plot.renderers`` Args: tile_source (TileSource) : a tile source instance which contain tileset configuration Keyword Arguments: Additional keyword arguments are passed on as-is to the tile renderer Returns: TileRenderer : TileRenderer r)r9rry)rHrrJZ tile_rendererrLrLrMadd_tileas  z Plot.add_tilez str | NonecCs>g}|js|d|js$|d|r:d|d|SdS)Nx_rangey_range,  [%s])rryrjoinrHmissingrLrLrM_check_required_rangers  zPlot._check_required_rangecCs>g}|js|d|js$|d|r:d|d|SdS)Nx_scaley_scalerr)rryrrrrLrLrM_check_required_scalezs  zPlot._check_required_scalecCsg}t|j}|jr$||jt|j}|jrD||j|jdk r|D]}t|t t frt|jt t fs|d||jfn*t|t rt|jts|d||jft|t t frRt|jtrR|d||jfqR|jdk r|D]}t|t t fr0t|jt t fs0|d||jfn.t|t r^t|jts^|d||jft|t t frt|jtr|d||jfq|rd|d|SdS)Nz&incompatibility on x-dimension: %s, %sz%incompatibility on x-dimension: %s/%sz%incompatibility on y-dimension: %s/%sz&incompatibility on y-dimension: %s, %srr)listextra_x_rangesvaluesrryextra_y_rangesrrrSr3r6r;r<r4r:rr)rHZ incompatibleZx_rangesZy_rangesrngrLrLrM"_check_compatible_scale_and_rangess2    "z'Plot._check_compatible_scale_and_rangescCs2t|jdkr.tdd|jDdkr.t|SdS)NrcSsg|]}t|tr|qSrL)rSr,rUxrLrLrMrWs z1Plot._check_missing_renderers..)lenrrfstrrarLrLrM_check_missing_rendererss&zPlot._check_missing_rendererscsd}fdddD}ttdgD]T}t|D]Ddfdd|D}|r2||r`dnd|d d 7}q2q$|r|SdS) Nc s,i|]$}|ddhtd|dqS)_namedefaultZextra_r[rY)rUr\rarLrM sz4Plot._check_bad_extra_range_name..)rrrrc3s8|]0\}}t|d|kr|dt|dVqdS)rz=''Nr)rUr\keys)refrLrM sz3Plot._check_bad_extra_range_name..z [])rr rYritems)rHmsgZvalidrwbadrL)rrHrM_check_bad_extra_range_names $z Plot._check_bad_extra_range_namecCstSrsr3rLrLrLrMz Plot.zK The (default) data range of the horizontal dimension of the plot. )rhelpcCstSrsrrLrLrLrMrrzI The (default) data range of the vertical dimension of the plot. z1Literal[('auto', 'linear', 'log', 'categorical')]r=)scalerrcCs<|dkrtS|dkrtS|dkr*tStd|dS)N)autoZlinearlogZ categoricalzUnknown mapper_type: )r;r<r:rx)clsrrLrLrM_scalesz Plot._scalecCstSrsr;rLrLrLrMrrzr What kind of scale to use to convert x-coordinates in data space into x-coordinates in screen space. cCstSrsrrLrLrLrMrrzr What kind of scale to use to convert y-coordinates in data space into y-coordinates in screen space. z~ Additional named ranges to make available for mapping x-coordinates. This is useful for adding additional axes. )rz~ Additional named ranges to make available for mapping y-coordinates. This is useful for adding additional axes. z Additional named scales to make available for mapping x-coordinates. This is useful for adding additional axes. .. note:: This feature is experimental and may change in the short term. z Additional named scales to make available for mapping y-coordinates. This is useful for adding additional axes. .. note:: This feature is experimental and may change in the short term. Tz3 Whether to use HiDPI mode when available. cCs tddS)Nrtextr.rLrLrLrMrrzK A title for the plot. Can be a text string or a Title annotation. cCs t|dS)NrrrrLrLrMrrr^z` Where the title will be located. Titles on the left or right side will be rotated. outlinez1 The {prop} for the plot border outline. )prefixrz#e5e5e5)ra A list of all renderers for this plot, including guides and annotations in addition to glyphs. This property can be manipulated by hand, but the ``add_glyph`` and ``add_layout`` methods are recommended to help make sure all necessary setup is performed. cCstSrs)rCrLrLrLrMrrz The toolbar associated with this plot which holds all the tools. It is automatically created with the plot if necessary. rdzi Where the toolbar will be located. If set to None, no toolbar will be attached to the plot. z Stick the toolbar to the edge of the plot. Default: True. If False, the toolbar will be outside of the axes, titles etc. zI A list of renderers to occupy the area to the left of the plot. zJ A list of renderers to occupy the area to the right of the plot. zC A list of renderers to occupy the area above of the plot. zC A list of renderers to occupy the area below of the plot. zL A list of renderers to occupy the center area (frame) of the plot. iXz int | NonewidthheightzU The outer width of a plot, including any axes, titles, border padding, etc. plot_widthzV The outer height of a plot, including any axes, titles, border padding, etc. plot_heightzv The width of a plot frame or the inner width of a plot, excluding any axes, titles, border padding, etc. zx The height of a plot frame or the inner height of a plot, excluding any axes, titles, border padding, etc. al This is the exact width of the plotting canvas, i.e. the width of the actual plot, without toolbars etc. Note this is computed in a web browser, so this property will work only in backends capable of bidirectional communication (server, notebook). .. note:: This is an experimental feature and the API may change in near future. an This is the exact height of the plotting canvas, i.e. the height of the actual plot, without toolbars etc. Note this is computed in a web browser, so this property will work only in backends capable of bidirectional communication (server, notebook). .. note:: This is an experimental feature and the API may change in near future. aa This is the exact width of the layout, i.e. the height of the actual plot, with toolbars etc. Note this is computed in a web browser, so this property will work only in backends capable of bidirectional communication (server, notebook). .. note:: This is an experimental feature and the API may change in near future. ab This is the exact height of the layout, i.e. the height of the actual plot, with toolbars etc. Note this is computed in a web browser, so this property will work only in backends capable of bidirectional communication (server, notebook). .. note:: This is an experimental feature and the API may change in near future. Z backgroundz3 The {prop} for the plot background style. z#ffffffZborderz/ The {prop} for the plot border style. z Minimum size in pixels of the padding region above the top of the central plot region. .. note:: This is a *minimum*. The padding region may expand as needed to accommodate titles or axes, etc. z Minimum size in pixels of the padding region below the bottom of the central plot region. .. note:: This is a *minimum*. The padding region may expand as needed to accommodate titles or axes, etc. z Minimum size in pixels of the padding region to the left of the central plot region. .. note:: This is a *minimum*. The padding region may expand as needed to accommodate titles or axes, etc. z Minimum size in pixels of the padding region to the right of the central plot region. .. note:: This is a *minimum*. The padding region may expand as needed to accommodate titles or axes, etc. z A convenience property to set all all the ``min_border_X`` properties to the same value. If an individual border property is explicitly set, it will override ``min_border``. zL Decimation factor to use when applying level-of-detail decimation. iz A number of data points, above which level-of-detail downsampling may be performed by glyph renderers. Set to ``None`` to disable any level-of-detail downsampling. i,zo Interval (in ms) during which an interactive tool event will enable level-of-detail downsampling. ia Timeout (in ms) for checking whether interactive tool events are still occurring. Once level-of-detail mode is enabled, a check is made every ``lod_timeout`` ms. If no interactive tool events have happened, level-of-detail mode is disabled. Zcanvasz Specify the output backend for the plot area. Default is HTML5 Canvas. .. note:: When set to ``webgl``, glyphs without a WebGL rendering implementation will fall back to rendering onto 2D canvas. Fa; Specify the aspect ratio behavior of the plot. Aspect ratio is defined as the ratio of width over height. This property controls whether Bokeh should attempt to match the (width/height) of *data space* to the (width/height) in pixels of *screen space*. Default is ``False`` which indicates that the *data* aspect ratio and the *screen* aspect ratio vary independently. ``True`` indicates that the plot aspect ratio of the axes will match the aspect ratio of the pixel extent the axes. The end result is that a 1x1 area in data space is a square in pixels, and conversely that a 1x1 pixel is a square in data units. .. note:: This setting only takes effect when there are two dataranges. This setting only sets the initial plot draw and subsequent resets. It is possible for tools (single axis zoom, unconstrained box zoom) to change the aspect ratio. .. warning:: This setting is incompatible with linking dataranges across multiple plots. Doing so may result in undefined behavior. r+a A value to be given for increased aspect ratio control. This value is added multiplicatively to the calculated value required for ``match_aspect``. ``aspect_scale`` is defined as the ratio of width over height of the figure. For example, a plot with ``aspect_scale`` value of 2 will result in a square in *data units* to be drawn on the screen as a rectangle with a pixel width twice as long as its pixel height. .. note:: This setting only takes effect if ``match_aspect`` is set to ``True``. standardaq How a plot should respond to being reset. By deafult, the standard actions are to clear any tool state history, return plot ranges to their original values, undo all selections, and emit a ``Reset`` event. If customization is desired, this property may be set to ``"event_only"``, which will suppress all of the actions except the Reset event. cCsdSrsrLrarLrLrM_check_fixed_sizing_modeszPlot._check_fixed_sizing_modecCsdSrsrLrarLrLrM_check_fixed_width_policyszPlot._check_fixed_width_policycCsdSrsrLrarLrLrM_check_fixed_height_policyszPlot._check_fixed_height_policy)rf)N)y__name__ __module__ __qualname____doc__rNrOrQr]propertyrbrer\rhrjrnrprqrmrisetterrzr{rr}rrr#rr$rr"rr r(rr!rrr5rr classmethodrr=rrrrrrZextra_x_scalesZextra_y_scalesrZhidpirrr.Zacceptstitlerrr Ztitle_locationrrZ outline_propsrZoutline_line_colorrr8rrCruZtoolbar_locationZtoolbar_stickyrcrdr^r_rfr__annotations__rrrrrZ frame_widthZ frame_heightrZ inner_widthZ inner_heightZ outer_widthZ outer_heightrZbackground_propsZbackground_fill_colorZ border_propsZborder_fill_colorZmin_border_topZmin_border_bottomZmin_border_leftZmin_border_rightZ min_borderZ lod_factorZ lod_thresholdZ lod_intervalZ lod_timeoutr Zoutput_backendZ match_aspectrZ aspect_scaler Z reset_policyr&rr'rr%rrLrLrLrMrEqs 9          "                   rEcCs$||kr ||kr td||fdS)Nz-Conflicting properties set on plot: %r and %r)rx)Za1Za2rJrLrLrM_check_conflicting_kwargs src@s$eZdZddZddZddZdS)rGcCs|D]}t|||qdSrs)setattr)rHattrvaluerrLrLrM __setattr__sz_list_attr_splat.__setattr__csttkrt|St|dkr0tdt|dkrJt|dSztfdd|DWStk rtdfYnXdS)Nrz;Trying to access %r attribute on an empty 'splattable' listr+csg|]}t|qSrLrrrrLrMrWsz5_list_attr_splat.__getattribute__..zYTrying to access %r attribute on a 'splattable' list, but list items have no %r attribute)dirr__getattribute__rAttributeErrorrYrG Exception)rHrrLrrMrs     z!_list_attr_splat.__getattribute__cCs.tdd|Ddkr"t|dSt|SdS)NcSsh|] }t|qSrL)typerrLrLrM !sz+_list_attr_splat.__dir__..r+r)rrrarLrLrM__dir__ s z_list_attr_splat.__dir__N)rrrrrrrLrLrLrMrGs rGz You are attempting to set `plot.legend.%s` on a plot that has zero legends added, this will have no effect. Before legend properties can be set, you must add a Legend explicitly, or call a glyph method with a legend parameter set. cseZdZfddZZS)rgcs$t|stt|t||Srs)rwarningswarn_LEGEND_EMPTY_WARNINGsuperr)rHrr __class__rLrMr-sz_legend_attr_splat.__setattr__)rrrr __classcell__rLrLrrMrg,srgcCst|dkrtdt|dkr4t|dkr4tdt|dkrTt|dkrTtd|r|d}t|trp|}qt|trt|d}qt|trt|trd|i}qtdn,d |krt|dkr|d }qtd n|}|S) zA Allow flexible selector syntax. Returns: dict r+z/select accepts at most ONE positional argument.rzMselect accepts EITHER a positional argument, OR keyword arguments (not both).zCselect requires EITHER a positional argument, OR keyword arguments.)namerz5selector must be a dictionary, string or plot object.rKzJwhen passing 'selector' keyword arg, not other keyword args may be present)r TypeErrorrSdictrr issubclassr))rIrJargrKrLrLrMrF2s*         rF)fr __future__rlogging getLoggerrrrtypingrrrZTListrZtyping_extensionsrZ core.enumsr r r r r Zcore.propertiesrrrrrrrrrrrrrrZcore.property_mixinsrrZ core.queryrZcore.validationrr Zcore.validation.errorsr!r"r#r$Zcore.validation.warningsr%r&r'r(modelr)Z util.stringr*r,r-r.Zaxesr/Zglyphsr0Zgridsr1Zlayoutsr2rangesr3r4r5r6rr7r8r9Zscalesr:r;r<r=sourcesr>r?r@rirArBrCZtilesrD__all__rErrrGrrgrFrLrLrLrMsN   D