クライアントにおいて、1つの範囲または空間から別の範囲または空間に値をマッピングするためのモデル。
マッパー(比例とは逆)が可逆的であると仮定することはできない。
CategoricalColorMapper
ベースクラス: bokeh.models.mappers.CategoricalMapper, bokeh.models.mappers.ColorMapper
bokeh.models.mappers.CategoricalMapper
bokeh.models.mappers.ColorMapper
カテゴリ因子を色にマッピングする.
このマッパーに渡されるが、係数リストにない値はマッピングされる nan_color それがそうです。
nan_color
end
属性タイプ: Int
Int
マッピング前にデータ因子に対して“スライス”の開始インデックスを行う.
例えば、データからカラーマッピングへのデータが2段階要素から構成されている場合、例えば ["2016", "sales"] そして ["2017", "marketing"] そして設定します end=1 カラーマッピングは、第1のサブファクタ(すなわち、本例では年ベース)のみに基づいて行われる。 "2016" あるいは…。 "2017" )
["2016", "sales"]
["2017", "marketing"]
end=1
"2016"
"2017"
もし None 次のような位置のすべてのサブ要因から来ています start この係数の末尾はカラーマッピングに用いられる.
None
start
factors
property type: Either ( Seq ( String ), Seq ( Tuple ( String , String ) ), Seq ( Tuple ( String , String , String ) ) )
Either
Seq
String
Tuple
ある目標範囲の一連の要素/クラスにマッピングする.例えば、以下の色マッパー:
mapper = CategoricalColorMapper(palette=["red", "blue"], factors=["foo", "bar"])
この因子をマッピングします "foo" 赤とこの要素になると "bar" 青になる。
"foo"
"bar"
js_event_callbacks
property type: Dict ( String , List ( Instance ( CustomJS ) ) )
Dict
List
Instance
CustomJS
イベント名のリストへのマッピング CustomJS 返電します。
通常,この属性を直接修正すべきではなく,使用すべきである Model.js_on_event 方法:
Model.js_on_event
callback = CustomJS(code="console.log('tap event occurred')") plot.js_on_event('tap', callback)
js_property_callbacks
属性名のリストへのマッピング CustomJS コールバックは、文書作成時にBoehJS端に設定されます。
通常,この属性を直接修正すべきではなく,使用すべきである Model.js_on_change 方法:
Model.js_on_change
callback = CustomJS(code="console.log('stuff')") plot.x_range.js_on_change('start', callback)
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もいかなる理由でもその名前を直接使用することはない。
属性タイプ: Color
Color
データはNaNや他のマッピング不可能な場合に使用する色である.(デフォルト値:“灰色”)
palette
属性タイプ: Seq () Color )
マッピング対象パレットのカラーシーケンスとして使用される。
この属性は、 String 表示されている任意のパレットの名前 bokeh.palettes それがそうです。
例えば、データからカラーマッピングへのデータが2段階要素から構成されている場合、例えば ["2016", "sales"] そして ["2016", "marketing"] そして設定します start=1 カラーマッピングは、第2のサブファクタ(すなわち、本例では部門ベース)にのみ基づいて実行される。 "sales" あるいは…。 "marketing" )
["2016", "marketing"]
start=1
"sales"
"marketing"
subscribed_events
属性タイプ: List () String )
Pythonは購読しているイベントリストをコールバックします。このモデルに対して、これはBokehJSからPythonに返されるイベントのセットです。
tags
属性タイプ: List () Any )
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もいかなる理由でもこれらのラベルを直接使用することはない。
apply_theme
アプリケーションのセットは、デフォルト値のテーマ値ではなく使用されるが、アプリケーションセット値はカバーされない。
入力された辞書はそのまま保持し,他の事例と共有してメモリを節約することができる(したがって呼び出し方和 HasProps インスタンスはそれを修正すべきである).
HasProps
property_values (dict) -- デフォルト値の代わりにテーマ値を使用します
なし
dataspecs
全員の名前を集める DataSpec 属性です。
DataSpec
この方法は いつも クラス階層構造を遍歴し,任意の親クラスで定義された属性を含む.
名前または名前 DataSpec 特性
set[str]
dataspecs_with_props
辞書を集めて全員の名前をマッピングします DataSpec 属性は関連する属性に付加される.
名前と名前のマッピング DataSpec 特性
dict[str, DataSpec]
equals
モデルの構造は平等である.
other (HasProps) -- 比較するもう一つの例は
属性が構造的に等しいならばTrue,そうでなければFalseとなる.
js_link
2つのBokehモデル属性をJavaScriptを用いてリンクする.
これは、CustomJSコールバックを追加して、1つのBokehモデル属性が値を変更するときに別のBokehモデル属性を更新するプロセスを簡略化することができる便利な方法である。
attr (str) -- このモデル上のBokeh属性の名前
other (Model) -- Self.attrにリンクされたBokehモデル
other_attr (str) -- 上の属性 other リンクがつながっている
other
attr_selector (Union[int, str]) -- 購読可能表中の項目をリンクするためのインデックス attr
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
付加する. CustomJS 任意のBoehJSモデルイベントのコールバック.
BokehJS側では,モデル属性の変更イベントの形式は "change:property_name" それがそうです。便宜上,このメソッドに渡されるイベント名もモデル上の属性の名前であれば, "change:" 自動:
"change:property_name"
"change:"
# these two are equivalent source.js_on_change('data', callback) source.js_on_change('change:data', callback)
しかし,属性変更イベントに加えて,他のタイプのイベントに応答することも可能である.例えば、データがストリーミングされる限り ColumnDataSource 使用、使用 "stream" 源上の事件:
ColumnDataSource
"stream"
source.js_on_change('streaming', callback)
layout
lookup
見つかる PropertyDescriptor クラス上のBokeh属性に対して,属性名を与える.
PropertyDescriptor
name (str) -- 検索する属性の名前
名前の属性の記述子 name
on_change
このオブジェクトには,以下の場合にトリガするコールバックを追加する. attr 変化する。
attr (str) -- このオブジェクトの属性名
*callbacks (callable) -- 登録するコールバック関数
例:
widget.on_change('value', callback1, callback2, ..., callback_n)
properties
このような上の属性名を収集する.
この方法は (オプション) クラス階層構造を遍歴し,任意の親クラスで定義された属性を含む.
with_bases (bool, optional) -- 結果に親クラスで定義された属性が含まれているかどうか.(デフォルト値:TRUE)
属性名
properties_containers
このようなすべてのコンテナ属性の名前を収集する.
容器属性名
properties_with_refs
このクラスにも引用されているすべての属性の名前を収集する.
引用の属性を持つ名前
properties_with_values
属性名をその値にマッピングした辞書を収集する.
直列化不可能な属性をスキップし、属性値は、一般に属性から読み出される値とはやや異なる可能性がある“直列化”フォーマットを採用し、この方法は、オブジェクトインスタンスを可逆的に再構成するために必要な情報を返すことを目的とする。
include_defaults (bool, optional) -- オブジェクト作成以来明示的に設定されていない属性が含まれているかどうか。(デフォルト値:TRUE)
属性名からその値へのマッピング
dict
query_properties_with_values
クエリの属性値 HasProps 述語を持つインスタンス.
query (callable) -- 属性記述子を受け取ってTrueまたはFalseの呼び出し可能関数を返す
include_defaults (bool, optional) -- ユーザが明示的に設定していない属性(デフォルト値:true)が含まれているかどうか
適合属性の属性名と値のマッピング
references
すべてに戻る Models この対象は引用されている.
Models
remove_on_change
この対象からコールバックを削除する
select
このオブジェクトおよびそのすべての参照において、所与のセレクタに一致するオブジェクトがクエリされる。
selector (JSON-like) --
配列番号. [模型]
select_one
このオブジェクトおよびそのすべての参照において、所与のセレクタに一致するオブジェクトがクエリされる。複数のオブジェクトが見つかれば,エラーを引き起こす.単一のマッチングオブジェクトを返し、何も見つからない場合は、NONEを返す:パラメータセレクタ::タイプセレクタ:JSONに類似している
模型
set_from_json
JSONからこのオブジェクトの属性値を設定する.
name -- (Str):設定する属性の名前
json -- (json-value):設定する属性の値
models (dict or None, optional) -- モデルIDからモデルへのマッピング(デフォルト値:なし)更新する属性も参照する値を持つ場合には,このオプションが必要となる.
setter (ClientSession or ServerSession or None, optional) -- これはBokehアプリケーションの“ブーメラン”の更新を阻止するためのものです。Bokehサーバアプリケーションのコンテキストでは,入力された属性更新は,更新を実行するセッションを用いてアノテーションを行う.この値は、更新によってトリガされた任意の後続の変更通知によって伝播される。セッションは、イベント設定器自身と比較し、自身からの任意の更新を抑制することができる。
set_select
指定された属性/値を有する所与のセレクタに一致するオブジェクトが更新される。
updates (dict) --
themed_values
すべてのテーマが提供するカバーを得る。
結果は属性名から値までの辞書形式で返されるか,または None 主題がこのインスタンスの任意の値をカバーしていない場合。
DICTやNONE
to_json
この対象属性を返す辞書は,“JSONタイプ”(文字列,数字,ブール値,無,辞書,リスト)のみを含む.
他のオブジェクトへの参照は“refs”(オブジェクトIDとタイプ情報のみ)に系列化されるため,逆直列化プログラムはそれらの他のオブジェクトの完全な属性を単独で持つ必要がある.
対応のない from_json() 逆直列化オブジェクトは、通常、文書コンテキストで行われるからである(文書は引用を解析できるので)。
from_json()
ほとんどの場合、文書全体を直列化して逆直列化することが望ましい。
include_defaults (bool) -- デフォルト値から変更されていない属性が含まれているかどうか
to_json_string
このオブジェクト属性をコードするJSON文字列を返す.
他のオブジェクトへの参照は参照(オブジェクトIDとタイプ情報のみ)に系列化されるため,逆直列化プログラムはそれらの他のオブジェクトの完全な属性を単独で持つ必要がある.
対応のない from_json_string() 逆直列化オブジェクトは、通常、文書コンテキストで行われるからである(文書は引用を解析できるので)。
from_json_string()
trigger
unapply_theme
すべてのトピック値を削除し、デフォルト値を復元します。
update
与えられたキーワードパラメータに基づいてオブジェクトの属性を更新する.
以下の内容は等価である.
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属性辞書から対象の属性を更新する.
json_attributes -- (json-dict):更新する属性と値
document
♪the Document このモデルは添付されています None )
Document
struct
このモデルのBokehプロトコル“構造”,すなわち以下の形式の辞書:
{ 'type' : << view model name >> 'id' : << unique model id >> }
他にもあるかもしれません subtype フィールド(このモデルがサブタイプである場合)。
{ "end": null, "factors": null, "id": "13118", "js_event_callbacks": {}, "js_property_callbacks": {}, "name": null, "nan_color": "gray", "palette": null, "start": 0, "subscribed_events": [], "tags": [] }
CategoricalMapper
ベースクラス: bokeh.models.mappers.Mapper
bokeh.models.mappers.Mapper
クラスファクタを他の値のマッパの基本クラスにマッピングする.
これは,Bokehモデルタイプの階層構造の組織を支援するための抽象基底クラスである. 単独インスタンス化は無駄である.
{ "end": null, "factors": null, "id": "13129", "js_event_callbacks": {}, "js_property_callbacks": {}, "name": null, "start": 0, "subscribed_events": [], "tags": [] }
CategoricalMarkerMapper
ベースクラス: bokeh.models.mappers.CategoricalMapper
カテゴリ要素をタグタイプにマッピングする.
このマッパーに渡されるが、係数リストにない値はマッピングされる default_value それがそうです。
default_value
このマッパーは主に Scatter タグタイプによってパラメータ化されたマークマーク記号.
Scatter
属性タイプ: MarkerType () MarkerType )
MarkerType
認識できない要素を入力してマッピングする際に用いるタグタイプ.
markers
属性タイプ: Seq () MarkerType () MarkerType ))
マッピング先として使用されるタグタイプシーケンス。
{ "default_value": "circle", "end": null, "factors": null, "id": "13138", "js_event_callbacks": {}, "js_property_callbacks": {}, "markers": null, "name": null, "start": 0, "subscribed_events": [], "tags": [] }
CategoricalPatternMapper
カテゴリ因子をパディングパターンにマッピングする.
バージョン1.1.1への追加
属性タイプ: HatchPatternType
HatchPatternType
認識できない因子を入力してマッピングする際に用いるパディングパターン.
patterns
属性タイプ: Seq () HatchPatternType )
{ "default_value": " ", "end": null, "factors": null, "id": "13149", "js_event_callbacks": {}, "js_property_callbacks": {}, "name": null, "patterns": null, "start": 0, "subscribed_events": [], "tags": [] }
ColorMapper
色マッパータイプの基本クラス。
{ "id": "13160", "js_event_callbacks": {}, "js_property_callbacks": {}, "name": null, "nan_color": "gray", "palette": null, "subscribed_events": [], "tags": [] }
ContinuousColorMapper
ベースクラス: bokeh.models.mappers.ColorMapper
連続カラーマッパータイプの基本クラス。
domain
property type: List ( Tuple ( Instance ( GlyphRenderer ), Either ( String , List ( String ) ) ) )
GlyphRenderer
その中からデータを集約してデータメトリックの字形レンダラの集合を作成する.空であれば,マッピングデータに変更する.
high
属性タイプ: Float
Float
パレットの範囲の最大値にマッピングします。この値よりも高い値はクランプされています high それがそうです。もし None この値はデータから推定される.
high_color
データが高ければ使用する色 high 値。なければ値が高い high パレットの最後の色にマッピングします。
low
パレットの範囲の最小値にマッピングする.この値以下の値はクランプされている low それがそうです。もし None この値はデータから推定される.
low_color
データが以下の値以下であれば、使用する色 low 値。なければ値が低い low パレット内の第1の色にマッピングする。
{ "domain": [], "high": null, "high_color": null, "id": "13168", "js_event_callbacks": {}, "js_property_callbacks": {}, "low": null, "low_color": null, "name": null, "nan_color": "gray", "palette": null, "subscribed_events": [], "tags": [] }
EqHistColorMapper
ベースクラス: bokeh.models.mappers.ContinuousColorMapper
bokeh.models.mappers.ContinuousColorMapper
bins
ヒストグラム箱数
{ "bins": 65536, "domain": [], "high": null, "high_color": null, "id": "13181", "js_event_callbacks": {}, "js_property_callbacks": {}, "low": null, "low_color": null, "name": null, "nan_color": "gray", "palette": null, "subscribed_events": [], "tags": [] }
LinearColorMapper
マッピング範囲内の数字 [low, high] 線形に一連の色(パレット)に変換する。
例えば範囲が [0,99] パレットは ['red', 'green', 'blue'] これらの値は以下のようにマッピングされる.
['red', 'green', 'blue']
x < 0 : 'red' # values < low are clamped 0 >= x < 33 : 'red' 33 >= x < 66 : 'green' 66 >= x < 99 : 'blue' 99 >= x : 'blue' # values > high are clamped
{ "domain": [], "high": null, "high_color": null, "id": "13195", "js_event_callbacks": {}, "js_property_callbacks": {}, "low": null, "low_color": null, "name": null, "nan_color": "gray", "palette": null, "subscribed_events": [], "tags": [] }
LogColorMapper
マッピング範囲内の数字 [low, high] 自然対数目盛り上の一連の色(パレット)に変換する。
例えば範囲が [0,25] パレットは ['red', 'green', 'blue'] これらの値は以下のようにマッピングされる.
x < 0 : 'red' # values < low are clamped 0 >= x < 2.72 : 'red' # math.e ** 1 2.72 >= x < 7.39 : 'green' # math.e ** 2 7.39 >= x < 20.09 : 'blue' # math.e ** 3 20.09 >= x : 'blue' # values > high are clamped
警告
♪the LogColorMapper スカラー値が非負値の画像にのみ適用する.
{ "domain": [], "high": null, "high_color": null, "id": "13208", "js_event_callbacks": {}, "js_property_callbacks": {}, "low": null, "low_color": null, "name": null, "nan_color": "gray", "palette": null, "subscribed_events": [], "tags": [] }
Mapper
ベースクラス: bokeh.models.transforms.Transform
bokeh.models.transforms.Transform
マッパーの基本クラスです
{ "id": "13221", "js_event_callbacks": {}, "js_property_callbacks": {}, "name": null, "subscribed_events": [], "tags": [] }