bokeh.models.grids

Bokehブロック上にグリッド線を表示するためのガイドレンダラー。

class Grid(*args, **kwargs)[ソース]

ベースクラス: bokeh.models.renderers.GuideRenderer

提供された位置に水平または垂直な格子線が表示されます。 Ticker それがそうです。

axis

属性タイプ: Instance () Axis

それにポタポタの軸を委任しなければならない.スクロールバー属性がNoneである場合、グリッドは、指定された軸上のスクロールバーを使用してグリッド線を描画する位置を計算する。そうでなければ、それの自動受信機は無ではなく、それはどんな軸よりも優先されるだろう。

band_fill_alpha

属性タイプ: Percent

格子線間の交互帯域のパッドAlpha.

band_fill_color

属性タイプ: Color

格子線間の交互帯領域の充填色。

band_hatch_alpha

属性タイプ: Percent

格子線間に交互にバンドの影Alphaを持つ.

band_hatch_color

属性タイプ: Color

格子線の間に交互についている影の色。

band_hatch_extra

property type: Dict ( String , Instance ( Texture ) )

格子線間の交互の帯状パターンの追加陰影。

band_hatch_pattern

属性タイプ: String

格子線間に交互にバンドの充填パターンがある.

band_hatch_scale

属性タイプ: Size

格子線間の交互帯域の充填割合.

band_hatch_weight

属性タイプ: Size

格子線の間に交互に帯域を持つ映像線の重みがある.

bounds

property type: Either ( Auto , Tuple ( Float , Float ) )

レンダリングされたグリッド線の境界。デフォルトの場合、グリッドは、境界を要求するために対応する軸を探索する。見つからなければ、メッシュは可視範囲全体を覆うだろう。

dimension

属性タイプ: Int

軸メッシュ線はどのサイズと交差するか.X軸は次元0(垂直格子線),y軸は次元1(水平格子線)である.

grid_line_alpha

属性タイプ: Percent

格子線のAlpha線です

grid_line_cap

属性タイプ: Enum () LineCap

格子線の線帽子。

grid_line_color

属性タイプ: Color

格子線の線の色。

grid_line_dash

属性タイプ: DashPattern

格子線の線分。

grid_line_dash_offset

属性タイプ: Int

格子線の線分がずれている.

grid_line_join

属性タイプ: Enum () LineJoin

グリッド線の線がつながっている。

grid_line_width

属性タイプ: Float

グリッド線の線が広い。

js_event_callbacks

property type: Dict ( String , List ( Instance ( CustomJS ) ) )

イベント名のリストへのマッピング CustomJS 返電します。

通常,この属性を直接修正すべきではなく,使用すべきである Model.js_on_event 方法:

callback = CustomJS(code="console.log('tap event occurred')")
plot.js_on_event('tap', callback)
js_property_callbacks

property type: Dict ( String , List ( Instance ( CustomJS ) ) )

属性名のリストへのマッピング CustomJS コールバックは、文書作成時にBoehJS端に設定されます。

通常,この属性を直接修正すべきではなく,使用すべきである Model.js_on_change 方法:

callback = CustomJS(code="console.log('stuff')")
plot.x_range.js_on_change('start', callback)
level

属性タイプ: Enum () RenderLevel

レンダラを描画するレベルを指定します。

minor_grid_line_alpha

属性タイプ: Percent

サブグリッド線のAlpha線です

minor_grid_line_cap

属性タイプ: Enum () LineCap

次のグリッド線のワイヤキャップ。

minor_grid_line_color

属性タイプ: Color

サブグリッド線の線の色。

minor_grid_line_dash

属性タイプ: DashPattern

二次格子線の線分。

minor_grid_line_dash_offset

属性タイプ: Int

サブグリッド線の線分オフセット。

minor_grid_line_join

属性タイプ: Enum () LineJoin

サブグリッド線の線が接続されています。

minor_grid_line_width

属性タイプ: Float

サブグリッド線の線幅。

name

属性タイプ: String

このモデルのユーザが提供する任意の名前.

文書を検索して特定のBokehモデルを検索する際には,この名前が有用である可能性がある.

>>> plot.circle([1,2,3], [4,5,6], name="temp")
>>> plot.select(name="temp")
[GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]

注釈

提供された任意の名前に対して一意保証または他の条件を強制的に実行することはなく、Bokehもいかなる理由でもその名前を直接使用することはない。

subscribed_events

属性タイプ: List () String

Pythonは購読しているイベントリストをコールバックします。このモデルに対して、これはBokehJSからPythonに返されるイベントのセットです。

tags

属性タイプ: List () Any

このモデルに付加されるユーザが提供する任意の値のオプションリスト。

特定のBokehモデルを検索するために文書を検索する際に、このデータは有用である可能性がある:

>>> r = plot.circle([1,2,3], [4,5,6])
>>> r.tags = ["foo", 10]
>>> plot.select(tags=['foo', 10])
[GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]

あるいは必要なメタデータをアクセス可能なモデルに付加する便利な方法でしかありません CustomJS ダイヤルして待つ.

注釈

提供されたいかなるラベルに対しても一意保証または他の条件を強制的に実行することはなく、Bokehもいかなる理由でもこれらのラベルを直接使用することはない。

ticker

属性タイプ: Instance () Ticker

格子線の位置を計算するためのTicker.

visible

属性タイプ: Bool

レンダラが見えるかどうか。

x_range_name

属性タイプ: String

描画上に字形が表示されている場合には、画面位置の特定(命名)x範囲を計算するために使用される。設定されていない場合は、デフォルトのx範囲を使用します。

y_range_name

属性タイプ: String

描画上にフォントを提示する際には、画面位置の特定(命名)y範囲を計算するために使用される。設定されていない場合は、デフォルトのy範囲を使用します。

apply_theme(property_values)

アプリケーションのセットは、デフォルト値のテーマ値ではなく使用されるが、アプリケーションセット値はカバーされない。

入力された辞書はそのまま保持し,他の事例と共有してメモリを節約することができる(したがって呼び出し方和 HasProps インスタンスはそれを修正すべきである).

パラメータ

property_values (dict) -- デフォルト値の代わりにテーマ値を使用します

戻り値

なし

classmethod dataspecs()

全員の名前を集める DataSpec 属性です。

この方法は いつも クラス階層構造を遍歴し,任意の親クラスで定義された属性を含む.

戻り値

名前または名前 DataSpec 特性

戻り値の型

set[str]

classmethod dataspecs_with_props()

辞書を集めて全員の名前をマッピングします DataSpec 属性は関連する属性に付加される.

この方法は いつも クラス階層構造を遍歴し,任意の親クラスで定義された属性を含む.

戻り値

名前と名前のマッピング DataSpec 特性

戻り値の型

dict[str, DataSpec]

equals(other)

モデルの構造は平等である.

パラメータ

other (HasProps) -- 比較するもう一つの例は

戻り値

属性が構造的に等しいならばTrue,そうでなければFalseとなる.

2つのBokehモデル属性をJavaScriptを用いてリンクする.

これは、CustomJSコールバックを追加して、1つのBokehモデル属性が値を変更するときに別のBokehモデル属性を更新するプロセスを簡略化することができる便利な方法である。

パラメータ
  • attr (str) -- このモデル上のBokeh属性の名前

  • other (Model) -- Self.attrにリンクされたBokehモデル

  • other_attr (str) -- 上の属性 other リンクがつながっている

  • attr_selector (Union[int, str]) -- 購読可能表中の項目をリンクするためのインデックス attr

バージョン1.1での追加

例外

ValueError --

サンプル

このコードには js_link

select.js_link('value', plot, 'sizing_mode')

以下と同等である.

from bokeh.models import CustomJS
select.js_on_change('value',
    CustomJS(args=dict(other=plot),
             code="other.sizing_mode = this.value"
    )
)

また,範囲スライダの左側をattr_selectorを用いて描画のx_rangeに付加する:

range_slider.js_link('value', plot.x_range, 'start', attr_selector=0)

これは以下のようなものです

from bokeh.models import CustomJS
range_slider.js_on_change('value',
    CustomJS(args=dict(other=plot.x_range),
             code="other.start = this.value[0]"
    )
)
js_on_change(event, *callbacks)

付加する. CustomJS 任意のBoehJSモデルイベントのコールバック.

BokehJS側では,モデル属性の変更イベントの形式は "change:property_name" それがそうです。便宜上,このメソッドに渡されるイベント名もモデル上の属性の名前であれば, "change:" 自動:

# these two are equivalent
source.js_on_change('data', callback)
source.js_on_change('change:data', callback)

しかし,属性変更イベントに加えて,他のタイプのイベントに応答することも可能である.例えば、データがストリーミングされる限り ColumnDataSource 使用、使用 "stream" 源上の事件:

source.js_on_change('streaming', callback)
layout(side, plot)
classmethod lookup(name)

見つかる PropertyDescriptor クラス上のBokeh属性に対して,属性名を与える.

パラメータ

name (str) -- 検索する属性の名前

戻り値

名前の属性の記述子 name

戻り値の型

PropertyDescriptor

on_change(attr, *callbacks)

このオブジェクトには,以下の場合にトリガするコールバックを追加する. attr 変化する。

パラメータ
  • attr (str) -- このオブジェクトの属性名

  • *callbacks (callable) -- 登録するコールバック関数

戻り値

なし

例:

widget.on_change('value', callback1, callback2, ..., callback_n)
classmethod properties(with_bases=True)

このような上の属性名を収集する.

この方法は (オプション) クラス階層構造を遍歴し,任意の親クラスで定義された属性を含む.

パラメータ

with_bases (bool, optional) -- 結果に親クラスで定義された属性が含まれているかどうか.(デフォルト値:TRUE)

戻り値

属性名

戻り値の型

set[str]

classmethod properties_containers()

このようなすべてのコンテナ属性の名前を収集する.

この方法は いつも クラス階層構造を遍歴し,任意の親クラスで定義された属性を含む.

戻り値

容器属性名

戻り値の型

set[str]

classmethod properties_with_refs()

このクラスにも引用されているすべての属性の名前を収集する.

この方法は いつも クラス階層構造を遍歴し,任意の親クラスで定義された属性を含む.

戻り値

引用の属性を持つ名前

戻り値の型

set[str]

properties_with_values(include_defaults: bool = True) → Dict[str, Any]

属性名をその値にマッピングした辞書を収集する.

この方法は いつも クラス階層構造を遍歴し,任意の親クラスで定義された属性を含む.

直列化不可能な属性をスキップし、属性値は、一般に属性から読み出される値とはやや異なる可能性がある“直列化”フォーマットを採用し、この方法は、オブジェクトインスタンスを可逆的に再構成するために必要な情報を返すことを目的とする。

パラメータ

include_defaults (bool, optional) -- オブジェクト作成以来明示的に設定されていない属性が含まれているかどうか。(デフォルト値:TRUE)

戻り値

属性名からその値へのマッピング

戻り値の型

dict

query_properties_with_values(query, include_defaults=True)

クエリの属性値 HasProps 述語を持つインスタンス.

パラメータ
  • query (callable) -- 属性記述子を受け取ってTrueまたはFalseの呼び出し可能関数を返す

  • include_defaults (bool, optional) -- ユーザが明示的に設定していない属性(デフォルト値:true)が含まれているかどうか

戻り値

適合属性の属性名と値のマッピング

戻り値の型

dict

references()

すべてに戻る Models この対象は引用されている.

remove_on_change(attr, *callbacks)

この対象からコールバックを削除する

select(selector)

このオブジェクトおよびそのすべての参照において、所与のセレクタに一致するオブジェクトがクエリされる。

パラメータ

selector (JSON-like) --

戻り値

配列番号. [模型]

select_one(selector)

このオブジェクトおよびそのすべての参照において、所与のセレクタに一致するオブジェクトがクエリされる。複数のオブジェクトが見つかれば,エラーを引き起こす.単一のマッチングオブジェクトを返し、何も見つからない場合は、NONEを返す:パラメータセレクタ::タイプセレクタ:JSONに類似している

戻り値

模型

set_from_json(name, json, models=None, setter=None)

JSONからこのオブジェクトの属性値を設定する.

パラメータ
  • name -- (Str):設定する属性の名前

  • json -- (json-value):設定する属性の値

  • models (dict or None, optional) -- モデルIDからモデルへのマッピング(デフォルト値:なし)更新する属性も参照する値を持つ場合には,このオプションが必要となる.

  • setter (ClientSession or ServerSession or None, optional) -- これはBokehアプリケーションの“ブーメラン”の更新を阻止するためのものです。Bokehサーバアプリケーションのコンテキストでは,入力された属性更新は,更新を実行するセッションを用いてアノテーションを行う.この値は、更新によってトリガされた任意の後続の変更通知によって伝播される。セッションは、イベント設定器自身と比較し、自身からの任意の更新を抑制することができる。

戻り値

なし

set_select(selector, updates)

指定された属性/値を有する所与のセレクタに一致するオブジェクトが更新される。

パラメータ
  • selector (JSON-like) --

  • updates (dict) --

戻り値

なし

themed_values()

すべてのテーマが提供するカバーを得る。

結果は属性名から値までの辞書形式で返されるか,または None 主題がこのインスタンスの任意の値をカバーしていない場合。

戻り値

DICTやNONE

to_json(include_defaults)

この対象属性を返す辞書は,“JSONタイプ”(文字列,数字,ブール値,無,辞書,リスト)のみを含む.

他のオブジェクトへの参照は“refs”(オブジェクトIDとタイプ情報のみ)に系列化されるため,逆直列化プログラムはそれらの他のオブジェクトの完全な属性を単独で持つ必要がある.

対応のない from_json() 逆直列化オブジェクトは、通常、文書コンテキストで行われるからである(文書は引用を解析できるので)。

ほとんどの場合、文書全体を直列化して逆直列化することが望ましい。

パラメータ

include_defaults (bool) -- デフォルト値から変更されていない属性が含まれているかどうか

to_json_string(include_defaults)

このオブジェクト属性をコードするJSON文字列を返す.

他のオブジェクトへの参照は参照(オブジェクトIDとタイプ情報のみ)に系列化されるため,逆直列化プログラムはそれらの他のオブジェクトの完全な属性を単独で持つ必要がある.

対応のない from_json_string() 逆直列化オブジェクトは、通常、文書コンテキストで行われるからである(文書は引用を解析できるので)。

ほとんどの場合、文書全体を直列化して逆直列化することが望ましい。

パラメータ

include_defaults (bool) -- デフォルト値から変更されていない属性が含まれているかどうか

trigger(attr, old, new, hint=None, setter=None)
unapply_theme()

すべてのトピック値を削除し、デフォルト値を復元します。

戻り値

なし

update(**kwargs)

与えられたキーワードパラメータに基づいてオブジェクトの属性を更新する.

戻り値

なし

サンプル

以下の内容は等価である.

from bokeh.models import Range1d

r = Range1d

# set properties individually:
r.start = 10
r.end = 20

# update properties together:
r.update(start=10, end=20)
update_from_json(json_attributes, models=None, setter=None)

JSON属性辞書から対象の属性を更新する.

パラメータ
  • json_attributes -- (json-dict):更新する属性と値

  • models (dict or None, optional) -- モデルIDからモデルへのマッピング(デフォルト値:なし)更新する属性も参照する値を持つ場合には,このオプションが必要となる.

  • setter (ClientSession or ServerSession or None, optional) -- これはBokehアプリケーションの“ブーメラン”の更新を阻止するためのものです。Bokehサーバアプリケーションのコンテキストでは,入力された属性更新は,更新を実行するセッションを用いてアノテーションを行う.この値は、更新によってトリガされた任意の後続の変更通知によって伝播される。セッションは、イベント設定器自身と比較し、自身からの任意の更新を抑制することができる。

戻り値

なし

property document

♪the Document このモデルは添付されています None

property struct

このモデルのBokehプロトコル“構造”,すなわち以下の形式の辞書:

{
    'type' : << view model name >>
    'id'   : << unique model id >>
}

他にもあるかもしれません subtype フィールド(このモデルがサブタイプである場合)。

JSON Prototype
{
  "axis": null,
  "band_fill_alpha": 0,
  "band_fill_color": null,
  "band_hatch_alpha": 1.0,
  "band_hatch_color": "black",
  "band_hatch_extra": {},
  "band_hatch_pattern": null,
  "band_hatch_scale": 12.0,
  "band_hatch_weight": 1.0,
  "bounds": "auto",
  "dimension": 0,
  "grid_line_alpha": 1.0,
  "grid_line_cap": "butt",
  "grid_line_color": "#e5e5e5",
  "grid_line_dash": [],
  "grid_line_dash_offset": 0,
  "grid_line_join": "bevel",
  "grid_line_width": 1,
  "id": "12530",
  "js_event_callbacks": {},
  "js_property_callbacks": {},
  "level": "underlay",
  "minor_grid_line_alpha": 1.0,
  "minor_grid_line_cap": "butt",
  "minor_grid_line_color": null,
  "minor_grid_line_dash": [],
  "minor_grid_line_dash_offset": 0,
  "minor_grid_line_join": "bevel",
  "minor_grid_line_width": 1,
  "name": null,
  "subscribed_events": [],
  "tags": [],
  "ticker": null,
  "visible": true,
  "x_range_name": "default",
  "y_range_name": "default"
}