bokeh.transform#

用于应用客户端计算的辅助函数，例如对数据字段或ColumnDataSource表达式进行转换。

cumsum(field_name: str, include_zero: bool = False) → Expr[source]#

创建一个DataSpec字典来为ColumnDataSource生成一个CumSum表达式。

Parameters:

  • field_name (str) – 用于配置 CumSum 的字段名称

  • include_zero (bool, optional) – 是否在总和中包含零 (默认值: False)

示例

p.wedge(start_angle=cumsum('angle', include_zero=True),
        end_angle=cumsum('angle'),
        ...)

将生成一个CumSum表达式，用于对数据源的"angle"列进行求和。对于start_angle值，累积和将从零值开始。对于end_angle，不会添加初始的零值（即和将从第一个角度值开始，并包括最后一个）。

dodge(field_name: str, value: float, range: Range | None = None) → Field[source]#

创建一个DataSpec字典，该字典将客户端的Dodge转换应用于ColumnDataSource列。

Parameters:

  • field_name (str) – 用于配置 DataSpec 的字段名称

  • value (float) – 添加到列数据的固定偏移量

  • range (Range, optional) – 一个范围，用于在必要时计算合成坐标，例如当列数据是分类数据时使用FactorRange（默认值：None）

Returns:

字段

eqhist_cmap(field_name: str, palette: Sequence[ColorLike], low: float, high: float, low_color: ColorLike | None = None, high_color: ColorLike | None = None, nan_color: ColorLike = 'gray') → Field[source]#

创建一个DataSpec字典，该字典将客户端的EqHistColorMapper转换应用于ColumnDataSource列。

Parameters:

  • field_name (str) – 用于配置 DataSpec 的字段名称

  • 调色板 (序列[颜色]) – 用于颜色映射的颜色列表

  • 低 (float) – 映射到调色板的范围的最小值。低于此值的值将被限制为 low。

  • 高 (float) – 映射到调色板的范围的最大值。超过此值的值将被限制为 high。

  • low_color (color, optional) – 如果数据低于low值时使用的颜色。如果为None，则低于low的值将映射到调色板中的第一个颜色。（默认值：None）

  • high_color (color, optional) – 如果数据高于high值时使用的颜色。如果为None，则高于high的值将映射到调色板中的最后一个颜色。（默认值：None）

  • nan_color (color, optional) – 当从列映射数据不成功时使用的默认颜色（默认值：“gray”）

factor_cmap(field_name: str, palette: Sequence[ColorLike], factors: Factors, start: float = 0, end: float | None = None, nan_color: ColorLike = 'gray') → Field[source]#

创建一个DataSpec字典，该字典将客户端的CategoricalColorMapper转换应用于ColumnDataSource列。

Parameters:

  • field_name (str) – 用于配置 DataSpec 的字段名称

  • 调色板 (序列[颜色]) – 用于颜色映射的颜色列表

  • factors (seq) – 与调色板对应的分类因子序列

  • 开始 (int, 可选) – 当列数据具有多个级别的因子时应用的起始切片索引。（默认值：0）

  • end (int, optional) – 当列数据具有多个级别的因子时，应用的结束切片索引。（默认值：None）

  • nan_color (color, optional) – 当从列映射数据不成功时使用的默认颜色（默认值：“gray”）

Returns:

字段

factor_hatch(field_name: str, patterns: Sequence[str], factors: Factors, start: float = 0, end: float | None = None) → Field[source]#

创建一个DataSpec字典，该字典将客户端的CategoricalPatternMapper转换应用于ColumnDataSource列。

Parameters:

  • field_name (str) – 用于配置 DataSpec 的字段名称

  • patterns (seq[string]) – 用于映射的填充图案列表

  • factors (seq) – 与调色板对应的分类因子序列

  • 开始 (int, 可选) – 当列数据具有多个级别的因子时应用的起始切片索引。（默认值：0）

  • end (int, optional) – 当列数据具有多个级别的因子时，应用的结束切片索引。（默认值：None）

Returns:

字段

在版本1.1.1中添加

factor_mark(field_name: str, markers: Sequence[str], factors: Factors, start: float = 0, end: float | None = None) → Field[source]#

创建一个DataSpec字典，该字典将客户端的CategoricalMarkerMapper转换应用于ColumnDataSource列。

注意

此变换主要仅对scatter有用，它可以通过字形类型进行参数化。

Parameters:

  • field_name (str) – 用于配置 DataSpec 的字段名称

  • markers (seq[string]) – 用于映射的标记列表

  • factors (seq) – 与调色板对应的分类因子序列

  • 开始 (int, 可选) – 当列数据具有多个级别的因子时应用的起始切片索引。（默认值：0）

  • end (int, optional) – 当列数据具有多个级别的因子时，应用的结束切片索引。（默认值：None）

Returns:

字段

jitter(field_name: str, width: float, mean: float = 0, distribution: JitterRandomDistributionType = 'uniform', range: Range | None = None) → Field[source]#

创建一个DataSpec字典，该字典将客户端的Jitter转换应用于ColumnDataSource列。

Parameters:

  • field_name (str) – 用于配置 DataSpec 的字段名称

  • width (float) – 要应用的随机分布的宽度

  • mean (float, optional) – 要应用的偏移量（默认值：0）

  • 分布 (str, 可选) – "uniform" 或 "normal" (默认: "uniform")

  • range (Range, optional) – 一个范围，用于在必要时计算合成坐标，例如当列数据是分类数据时使用FactorRange（默认值：None）

Returns:

字段

linear_cmap(field_name: str, palette: Sequence[ColorLike], low: float, high: float, low_color: ColorLike | None = None, high_color: ColorLike | None = None, nan_color: ColorLike = 'gray') → Field[source]#

创建一个DataSpec字典，该字典将客户端的LinearColorMapper转换应用于ColumnDataSource列。

Parameters:

  • field_name (str) – 用于配置 DataSpec 的字段名称

  • 调色板 (序列[颜色]) – 用于颜色映射的颜色列表

  • 低 (float) – 映射到调色板的范围的最小值。低于此值的值将被限制为 low。

  • 高 (float) – 映射到调色板的范围的最大值。超过此值的值将被限制为 high。

  • low_color (color, optional) – 如果数据低于low值时使用的颜色。如果为None，则低于low的值将映射到调色板中的第一个颜色。（默认值：None）

  • high_color (color, optional) – 如果数据高于high值时使用的颜色。如果为None，则高于high的值将映射到调色板中的最后一个颜色。（默认值：None）

  • nan_color (color, optional) – 当从列映射数据不成功时使用的默认颜色（默认值：“gray”）

log_cmap(field_name: str, palette: Sequence[ColorLike], low: float, high: float, low_color: ColorLike | None = None, high_color: ColorLike | None = None, nan_color: ColorLike = 'gray') → Field[source]#

创建一个DataSpec字典，该字典将客户端的LogColorMapper转换应用于ColumnDataSource列。

Parameters:

  • field_name (str) – 用于配置 DataSpec 的字段名称

  • 调色板 (序列[颜色]) – 用于颜色映射的颜色列表

  • 低 (float) – 映射到调色板的范围的最小值。低于此值的值将被限制为 low。

  • 高 (float) – 映射到调色板的范围的最大值。超过此值的值将被限制为 high。

  • low_color (color, optional) – 如果数据低于low值时使用的颜色。如果为None，则低于low的值将映射到调色板中的第一个颜色。（默认值：None）

  • high_color (color, optional) – 如果数据高于high值时使用的颜色。如果为None，则高于high的值将映射到调色板中的最后一个颜色。（默认值：None）

  • nan_color (color, optional) – 当从列映射数据不成功时使用的默认颜色（默认值：“gray”）

stack(*fields: str) → Expr[源代码]#

创建一个 DataSpec 字典来生成一个 Stack 表达式 用于 ColumnDataSource。

示例

p.vbar(bottom=stack("sales", "marketing"), ...

将生成一个Stack，它汇总数据源的"sales"和"marketing"列，并将这些值用作VBar的top坐标。

transform(field_name: str, transform: Transform) → Field[source]#

创建一个DataSpec字典，该字典将任意客户端的Transform应用于ColumnDataSource列。

Parameters:

  • field_name (str) – 用于配置 DataSpec 的字段名称

  • transform (Transform) – 应用于该字段的转换

Returns:

字段