altair.Scale

class altair.Scale(align=Undefined, base=Undefined, bins=Undefined, clamp=Undefined, constant=Undefined, domain=Undefined, domainMax=Undefined, domainMid=Undefined, domainMin=Undefined, domainRaw=Undefined, exponent=Undefined, interpolate=Undefined, nice=Undefined, padding=Undefined, paddingInner=Undefined, paddingOuter=Undefined, range=Undefined, rangeMax=Undefined, rangeMin=Undefined, reverse=Undefined, round=Undefined, scheme=Undefined, type=Undefined, zero=Undefined, **kwds)

缩放架构包装器。

Parameters:

aligndict, float, ExprRef

步幅在量程内的对齐方式。

该值必须在范围 [0,1] 内。值 0.5 表示步骤应位于范围内的中心。值 0 或 1 可用于将带移动到一侧，比如将其位置靠近一个坐标轴。

默认值： 0.5

basedict, float, ExprRef

对数基数的 log 缩放（默认 10）。

binsdict, Sequence[float], ScaleBins, ScaleBinParams

可以将区间边界以显式数组或区间规格对象的形式提供给比例尺。合法值为：

• 一个 数组 字面量的区间边界值。例如，[0, 5, 10, 15, 20]。该数组必须同时包含起始和结束边界。前面的例子使用五个值来表示总共四个区间： [0-5), [5-10), [10-15), [15-20]。数组字面量可以包括信号引用作为元素。

• A bin specification object that indicates the bin 步长 size, and optionally the 起始 and 结束 boundaries.

• 一个在刻度域上使用的箱子边界数组。如果提供，坐标轴和图例将使用箱子边界来决定刻度标记和文本标签的选择。

clampbool, dict, ExprRef

如果 true，超出数据域的值将被限制在最小或最大范围值

默认值： 来源于 比例配置 的 clamp (true 默认)。

constantdict, float, ExprRef

一个常量，用于确定symlog函数在零附近的斜率。仅用于symlog尺度。

默认值： 1

domaindict, ExprRef, Literal[‘unaggregated’], DomainUnionWith, ParameterExtent, Sequence[str, bool, dict, float, ExprRef, DateTime, None]

以常量值或由参数驱动的动态值的形式自定义域值。

1) 常量 domain 对于 定量 字段可以取以下形式：

• 一个包含最小值和最大值的两个元素数组。要创建一个发散尺度，可以将这个两个元素数组与 domainMid 属性结合使用。

• 一个具有两个以上条目的数组，用于 分段定量尺度。

• 一个字符串值 "unaggregated"，如果输入字段是聚合的，表示域应该包含聚合之前的原始数据值。

2) 常量 domain 对于 时间 字段可以是一个包含最小值和最大值的二元数组，以时间戳或 DateTime 定义对象 的形式表示。

3) 常量 domain 对于 有序 和 名义 字段可以是一个列出有效输入值的数组。

4) 要将指定的常量域与字段的值合并（并）， domain 可以是一个具有 unionWith 属性的对象，该属性指定要合并的常量域。例如， domain: {unionWith: [0, 100]} 用于定量尺度意味着该尺度域始终包括 [0, 100]，但会包括超出 [0, 100] 的其他值。

5) 域还可以接受一个定义字段或参数编码的对象，交互式地确定 规模域。

domainMaxdict, float, ExprRef, DateTime

设置刻度域中的最大值，覆盖domain属性。此属性仅用于具有连续域的刻度。

domainMiddict, float, ExprRef

将一个中间值插入到两个元素的域中。中间值必须位于域的最小值和最大值之间。此属性对于设置发散色标的中点非常有用。domainMid属性仅用于支持连续分段域的尺度。

domainMindict, float, ExprRef, DateTime

设置刻度域中的最小值，覆盖域属性。该属性仅用于具有连续域的刻度。

domainRawdict, ExprRef

一个用于原始值数组的表达式，如果不为null，则直接覆盖domain属性。这对于支持交互操作如平移或缩放一个比例非常有用。比例可以最初使用数据驱动的域来确定，然后通过设置rawDomain值来响应用户输入进行修改。

exponentdict, float, ExprRef

指数 pow 规模。

interpolatedict, ExprRef, ScaleInterpolateEnum, ScaleInterpolateParams, Literal[‘rgb’, ‘lab’, ‘hcl’, ‘hsl’, ‘hsl-long’, ‘hcl-long’, ‘cubehelix’, ‘cubehelix-long’]

范围值的插值方法。默认情况下，使用一种通用插值器来处理数字、日期、字符串和颜色（在HCL空间中）。对于颜色范围，此属性允许在替代颜色空间中进行插值。合法的值包括 rgb、hsl、hsl-long、lab、hcl、hcl-long、cubehelix 和 cubehelix-long（‘-long’变体在极坐标空间中使用较长的路径）。如果是对象值，此属性接受一个具有字符串值的 type 属性和一个适用于 rgb 和 cubehelix 插值器的可选数值 gamma 属性。更多信息，见d3-interpolate documentation。

• 默认值： hcl

nicebool, dict, float, ExprRef, TimeInterval, TimeIntervalStep, Literal[‘millisecond’, ‘second’, ‘minute’, ‘hour’, ‘day’, ‘week’, ‘month’, ‘year’]

扩展域，使其在漂亮的圆值上开始和结束。该方法通常修改尺度的域，并可能仅将边界扩展到最近的圆值。平滑处理对于从数据计算出的域非常有用，并且可能会不规则。例如，对于域[0.201479…, 0.996679…]，一个合理的域可能是[0.2, 1.0]。

对于线性等定量刻度，nice 可以是一个布尔标志或一个数字。如果 nice 是一个数字，它将表示所需的刻度数。这允许对用于扩展边界的步长进行更大的控制，确保返回的刻度将完全覆盖该领域。

对于具有时间和UTC尺度的时间字段，nice值可以是一个字符串，指示所需的时间间隔。合法的值包括"millisecond"、"second"、"minute"、"hour"、"day"、"week"、"month"和"year"。另外，time和utc尺度可以接受一个对象值的间隔说明符，形式为{"interval": "month", "step": 3}，其中包括所需的间隔步骤数。在这里，域会在季度（1月、4月、7月、10月）边界上对齐。

默认值: true 针对没有明确域边界的未分箱 定量 字段; false 否则。

paddingdict, float, ExprRef

对于 `continuous `__ 比例尺，扩展比例尺域以适应每个比例尺范围内指定的像素数量。该参数必须表示像素，以便按预期功能运行。填充调整在所有其他调整之前执行，包括 zero、 nice、 domainMin 和 domainMax 属性的影响。

对于 `band `__ 规模，设置 paddingInner 和 paddingOuter 为相同值的快捷方式。

对于 `point `__ 比例， 是 paddingOuter 的别名。

默认值： 对于 连续 量表，源自 scale config 的 continuousPadding。对于 带状和点状 量表，请参见 paddingInner 和 paddingOuter。默认情况下，Vega-Lite 设置填充，使得 宽度/高度 = 唯一值的数量 * 步长。

paddingInnerdict, float, ExprRef

每个带状尺度的带步内边距（间距），作为步长的一个分数。该值必须在[0,1]范围内。

对于点数比例，这个属性是无效的，因为点数比例没有内部带宽（只有带之间的步长）。

默认值：源自比例配置的bandPaddingInner。

paddingOuterdict, float, ExprRef

带状和点尺度范围两端的外部填充（间隔），作为步长的一个分数。此值必须位于范围 [0,1] 内。

默认值：源自比例配置的bandPaddingOuter用于带状比例，和pointPadding用于点比例。默认情况下，Vega-Lite设置的外部填充使得宽度/高度 = 唯一值数量 * 步长。

rangedict, RangeEnum, FieldRange, Sequence[str, dict, float, Sequence[float], ExprRef], Literal[‘width’, ‘height’, ‘symbol’, ‘category’, ‘ordinal’, ‘ramp’, ‘diverging’, ‘heatmap’]

比例尺的范围。选项之一：

• 一个字符串，表示一个 预定义的命名尺度范围（例如，示例，"symbol"，或 "diverging"）。

• 对于 连续刻度，两个元素的数组表示最小值和最大值，或者一个包含多个条目的数组用于指定 分段刻度。

• 对于 discrete 和 discretizing 尺度，一个期望输出值的数组或一个具有 field 属性的对象，表示范围值。例如，如果一个字段 color 包含 CSS 颜色名称，我们可以将 range 设置为 {field: "color"}.

注意：

1) 对于颜色刻度，您还可以指定一个颜色 方案 而不是 范围。

2) 任何直接指定的 range 对于 x 和 y 通道将被忽略。范围可以通过视图的相应 size (width 和 height) 自定义。

rangeMaxstr, dict, float, ExprRef

设置刻度范围中的最大值，覆盖range属性或默认范围。此属性仅适用于具有连续范围的刻度。

rangeMinstr, dict, float, ExprRef

设置刻度范围中的最小值，覆盖range属性或默认范围。此属性仅用于具有连续范围的刻度。

reversebool, dict, ExprRef

如果为真，反转刻度范围的顺序。 默认值： false。

roundbool, dict, ExprRef

如果 true，将数字输出值四舍五入为整数。这对于对齐到像素网格很有帮助。

默认值： false.

schemedict, ExprRef, 周期性的, 发散, 分类的, ColorScheme, SchemeParams, SequentialMultiHue, SequentialSingleHue, Literal[‘accent’, ‘category10’, ‘category20’, ‘category20b’, ‘category20c’, ‘dark2’, ‘paired’, ‘pastel1’, ‘pastel2’, ‘set1’, ‘set2’, ‘set3’, ‘tableau10’, ‘tableau20’, ‘blueorange’, ‘blueorange-3’, ‘blueorange-4’, ‘blueorange-5’, ‘blueorange-6’, ‘blueorange-7’, ‘blueorange-8’, ‘blueorange-9’, ‘blueorange-10’, ‘blueorange-11’, ‘brownbluegreen’, ‘brownbluegreen-3’, ‘brownbluegreen-4’, ‘brownbluegreen-5’, ‘brownbluegreen-6’, ‘brownbluegreen-7’, ‘brownbluegreen-8’, ‘brownbluegreen-9’, ‘brownbluegreen-10’, ‘brownbluegreen-11’, ‘purplegreen’, ‘purplegreen-3’, ‘purplegreen-4’, ‘purplegreen-5’, ‘purplegreen-6’, ‘purplegreen-7’, ‘purplegreen-8’, ‘purplegreen-9’, ‘purplegreen-10’, ‘purplegreen-11’, ‘pinkyellowgreen’, ‘pinkyellowgreen-3’, ‘pinkyellowgreen-4’, ‘pinkyellowgreen-5’, ‘pinkyellowgreen-6’, ‘pinkyellowgreen-7’, ‘pinkyellowgreen-8’, ‘pinkyellowgreen-9’, ‘pinkyellowgreen-10’, ‘pinkyellowgreen-11’, ‘purpleorange’, ‘purpleorange-3’, ‘purpleorange-4’, ‘purpleorange-5’, ‘purpleorange-6’, ‘purpleorange-7’, ‘purpleorange-8’, ‘purpleorange-9’, ‘purpleorange-10’, ‘purpleorange-11’, ‘redblue’, ‘redblue-3’, ‘redblue-4’, ‘redblue-5’, ‘redblue-6’, ‘redblue-7’, ‘redblue-8’, ‘redblue-9’, ‘redblue-10’, ‘redblue-11’, ‘redgrey’, ‘redgrey-3’, ‘redgrey-4’, ‘redgrey-5’, ‘redgrey-6’, ‘redgrey-7’, ‘redgrey-8’, ‘redgrey-9’, ‘redgrey-10’, ‘redgrey-11’, ‘redyellowblue’, ‘redyellowblue-3’, ‘redyellowblue-4’, ‘redyellowblue-5’, ‘redyellowblue-6’, ‘redyellowblue-7’, ‘redyellowblue-8’, ‘redyellowblue-9’, ‘redyellowblue-10’, ‘redyellowblue-11’, ‘redyellowgreen’, ‘redyellowgreen-3’, ‘redyellowgreen-4’, ‘redyellowgreen-5’, ‘redyellowgreen-6’, ‘redyellowgreen-7’, ‘redyellowgreen-8’, ‘redyellowgreen-9’, ‘redyellowgreen-10’, ‘redyellowgreen-11’, ‘spectral’, ‘spectral-3’, ‘spectral-4’, ‘spectral-5’, ‘spectral-6’, ‘spectral-7’, ‘spectral-8’, ‘spectral-9’, ‘spectral-10’, ‘spectral-11’, ‘blues’, ‘tealblues’, ‘teals’, ‘greens’, ‘browns’, ‘greys’, ‘purples’, ‘warmgreys’, ‘reds’, ‘oranges’, ‘rainbow’, ‘sinebow’, ‘turbo’, ‘viridis’, ‘inferno’, ‘magma’, ‘plasma’, ‘cividis’, ‘bluegreen’, ‘bluegreen-3’, ‘bluegreen-4’, ‘bluegreen-5’, ‘bluegreen-6’, ‘bluegreen-7’, ‘bluegreen-8’, ‘bluegreen-9’, ‘bluepurple’, ‘bluepurple-3’, ‘bluepurple-4’, ‘bluepurple-5’, ‘bluepurple-6’, ‘bluepurple-7’, ‘bluepurple-8’, ‘bluepurple-9’, ‘goldgreen’, ‘goldgreen-3’, ‘goldgreen-4’, ‘goldgreen-5’, ‘goldgreen-6’, ‘goldgreen-7’, ‘goldgreen-8’, ‘goldgreen-9’, ‘goldorange’, ‘goldorange-3’, ‘goldorange-4’, ‘goldorange-5’, ‘goldorange-6’, ‘goldorange-7’, ‘goldorange-8’, ‘goldorange-9’, ‘goldred’, ‘goldred-3’, ‘goldred-4’, ‘goldred-5’, ‘goldred-6’, ‘goldred-7’, ‘goldred-8’, ‘goldred-9’, ‘greenblue’, ‘greenblue-3’, ‘greenblue-4’, ‘greenblue-5’, ‘greenblue-6’, ‘greenblue-7’, ‘greenblue-8’, ‘greenblue-9’, ‘orangered’, ‘orangered-3’, ‘orangered-4’, ‘orangered-5’, ‘orangered-6’, ‘orangered-7’, ‘orangered-8’, ‘orangered-9’, ‘purplebluegreen’, ‘purplebluegreen-3’, ‘purplebluegreen-4’, ‘purplebluegreen-5’, ‘purplebluegreen-6’, ‘purplebluegreen-7’, ‘purplebluegreen-8’, ‘purplebluegreen-9’, ‘purpleblue’, ‘purpleblue-3’, ‘purpleblue-4’, ‘purpleblue-5’, ‘purpleblue-6’, ‘purpleblue-7’, ‘purpleblue-8’, ‘purpleblue-9’, ‘purplered’, ‘purplered-3’, ‘purplered-4’, ‘purplered-5’, ‘purplered-6’, ‘purplered-7’, ‘purplered-8’, ‘purplered-9’, ‘redpurple’, ‘redpurple-3’, ‘redpurple-4’, ‘redpurple-5’, ‘redpurple-6’, ‘redpurple-7’, ‘redpurple-8’, ‘redpurple-9’, ‘yellowgreenblue’, ‘yellowgreenblue-3’, ‘yellowgreenblue-4’, ‘yellowgreenblue-5’, ‘yellowgreenblue-6’, ‘yellowgreenblue-7’, ‘yellowgreenblue-8’, ‘yellowgreenblue-9’, ‘yellowgreen’, ‘yellowgreen-3’, ‘yellowgreen-4’, ‘yellowgreen-5’, ‘yellowgreen-6’, ‘yellowgreen-7’, ‘yellowgreen-8’, ‘yellowgreen-9’, ‘yelloworangebrown’, ‘yelloworangebrown-3’, ‘yelloworangebrown-4’, ‘yelloworangebrown-5’, ‘yelloworangebrown-6’, ‘yelloworangebrown-7’, ‘yelloworangebrown-8’, ‘yelloworangebrown-9’, ‘yelloworangered’, ‘yelloworangered-3’, ‘yelloworangered-4’, ‘yelloworangered-5’, ‘yelloworangered-6’, ‘yelloworangered-7’, ‘yelloworangered-8’, ‘yelloworangered-9’, ‘darkblue’, ‘darkblue-3’, ‘darkblue-4’, ‘darkblue-5’, ‘darkblue-6’, ‘darkblue-7’, ‘darkblue-8’, ‘darkblue-9’, ‘darkgold’, ‘darkgold-3’, ‘darkgold-4’, ‘darkgold-5’, ‘darkgold-6’, ‘darkgold-7’, ‘darkgold-8’, ‘darkgold-9’, ‘darkgreen’, ‘darkgreen-3’, ‘darkgreen-4’, ‘darkgreen-5’, ‘darkgreen-6’, ‘darkgreen-7’, ‘darkgreen-8’, ‘darkgreen-9’, ‘darkmulti’, ‘darkmulti-3’, ‘darkmulti-4’, ‘darkmulti-5’, ‘darkmulti-6’, ‘darkmulti-7’, ‘darkmulti-8’, ‘darkmulti-9’, ‘darkred’, ‘darkred-3’, ‘darkred-4’, ‘darkred-5’, ‘darkred-6’, ‘darkred-7’, ‘darkred-8’, ‘darkred-9’, ‘lightgreyred’, ‘lightgreyred-3’, ‘lightgreyred-4’, ‘lightgreyred-5’, ‘lightgreyred-6’, ‘lightgreyred-7’, ‘lightgreyred-8’, ‘lightgreyred-9’, ‘lightgreyteal’, ‘lightgreyteal-3’, ‘lightgreyteal-4’, ‘lightgreyteal-5’, ‘lightgreyteal-6’, ‘lightgreyteal-7’, ‘lightgreyteal-8’, ‘lightgreyteal-9’, ‘lightmulti’, ‘lightmulti-3’, ‘lightmulti-4’, ‘lightmulti-5’, ‘lightmulti-6’, ‘lightmulti-7’, ‘lightmulti-8’, ‘lightmulti-9’, ‘lightorange’, ‘lightorange-3’, ‘lightorange-4’, ‘lightorange-5’, ‘lightorange-6’, ‘lightorange-7’, ‘lightorange-8’, ‘lightorange-9’, ‘lighttealblue’, ‘lighttealblue-3’, ‘lighttealblue-4’, ‘lighttealblue-5’, ‘lighttealblue-6’, ‘lighttealblue-7’, ‘lighttealblue-8’, ‘lighttealblue-9’]

一个表示颜色方案名称的字符串（例如，"category10"或"blues"）或一个方案参数对象。

离散颜色方案可以与 discrete 或 discretizing 轴一起使用。
连续颜色方案旨在与颜色轴一起使用。

要设置自定义方案，请设置值列表 作为比例范围。

有关支持的方案的完整列表，请参阅Vega Scheme参考。

typeScaleType, Literal[‘linear’, ‘log’, ‘pow’, ‘sqrt’, ‘symlog’, ‘identity’, ‘sequential’, ‘time’, ‘utc’, ‘quantile’, ‘quantize’, ‘threshold’, ‘bin-ordinal’, ‘ordinal’, ‘point’, ‘band’]

比例尺的类型。Vega-Lite 支持以下类别的比例尺类型：

1) 连续比例尺 – 将连续域映射到连续输出范围 (“线性”, “幂”, “平方根”, “对称对数”, “对数”, “时间”, “协调世界时”。

2) 离散尺度 – 将离散域映射到离散（“序数”）或连续 （“带” 和 “点”）输出范围。

3) 离散化尺度 – 将连续域映射到离散输出范围 “区间顺序”, “分位数”, “量化” 和 “阈值”.

默认值： 请查看规模类型表。

zerobool, dict, ExprRef

如果 true, 确保在刻度域中包含零基线值。

默认值： true 如果定量字段未被分箱且未提供自定义 domain；否则 false。

注意： Log、time 和 utc scales 不支持 zero。

__init__(align=Undefined, base=Undefined, bins=Undefined, clamp=Undefined, constant=Undefined, domain=Undefined, domainMax=Undefined, domainMid=Undefined, domainMin=Undefined, domainRaw=Undefined, exponent=Undefined, interpolate=Undefined, nice=Undefined, padding=Undefined, paddingInner=Undefined, paddingOuter=Undefined, range=Undefined, rangeMax=Undefined, rangeMin=Undefined, reverse=Undefined, round=Undefined, scheme=Undefined, type=Undefined, zero=Undefined, **kwds)

方法

__init__([align, base, bins, clamp, ...])
copy([深度, 忽略])	返回对象的副本。
from_dict(dct[, validate])	从字典表示构造类。
from_json(json_string[, validate])	从有效的 JSON 字符串实例化对象。
resolve_references([schema])	解析此对象的架构或根架构中的引用。
to_dict([validate, ignore, context])	返回对象的字典表示。
to_json([validate, indent, sort_keys, ...])	以字符串形式输出该对象的 JSON 表示。
validate(instance[, schema])	在rootschema的上下文中验证实例是否符合类模式。
validate_property(name, value[, schema])	在根架构的上下文中，根据属性架构验证一个属性。