altair.StrokeWidthDatum#
- class altair.StrokeWidthDatum(datum, bandPosition=Undefined, condition=Undefined, title=Undefined, type=Undefined, **kwds)#
StrokeWidthDatum schema 包装器。
- 参数:
- bandPosition浮点数
在堆叠、分箱、时间单位或带状刻度的带上的相对位置。例如,设置为
0
时,标记将定位在带的开头;设置为0.5
时,定位在带的中间。- condition字典,
ConditionalValueDefnumberExprRef
,ConditionalParameterValueDefnumberExprRef
,ConditionalPredicateValueDefnumberExprRef
, 序列[字典,ConditionalValueDefnumberExprRef
,ConditionalParameterValueDefnumberExprRef
,ConditionalPredicateValueDefnumberExprRef
] 一个或多个值定义,带有 参数或测试谓词。
**注意:**字段定义的
condition
属性只能包含 条件值定义,因为 Vega-Lite 每个编码通道最多只允许一个编码字段。- datum字符串, 布尔值, 字典, 浮点数,
ExprRef
,DateTime
,RepeatRef
,PrimitiveValue
, 无 数据域中的常量值。
- title字符串,
Text
, 序列[字符串], 无 字段的标题。如果为
null
,则移除标题。**默认值:**派生自字段的名称和转换函数(
aggregate
、bin
和timeUnit
)。如果字段具有聚合函数,该函数将作为标题的一部分显示(例如,"Sum of Profit"
)。如果字段经过分箱或应用了时间单位,应用函数将显示在括号中(例如,"Profit (binned)"
、"Transaction Date (year-month)"
)。否则,标题仅为字段名称。注意:
1) 你可以通过在 config 或 通过 compile 函数选项 提供 fieldTitle 属性来自定义默认字段标题格式。
2) 如果字段定义的
title
和轴、标题栏或图例的title
都已定义,将使用轴/标题栏/图例的标题。- type
Type
, 文字值['quantitative', 'ordinal', 'temporal', 'nominal', 'geojson'] 编码字段或常量值(
datum
)的测量类型("quantitative"
、"temporal"
、"ordinal"
或"nominal"
)。对于编码 ‘geoshape’,它也可以是"geojson"
类型。Vega-Lite 在许多情况下会自动推断数据类型,如下所述。但是,如果字段满足以下条件,则需要指定类型:(1) 字段不是名义型的,并且字段编码没有指定
aggregate
(argmin
和argmax
除外)、bin
、刻度类型、自定义sort
顺序或timeUnit
;或者 (2) 如果你希望对具有bin
或timeUnit
的字段使用有序刻度。默认值
1) 对于数据
field
,除非字段编码具有满足以下条件的aggregate
、channel
、bin
、刻度类型、sort
或timeUnit
,否则"nominal"
是默认数据类型"quantitative"
是默认类型,如果 (1) 编码字段包含bin
或aggregate
("argmin"
和"argmax"
除外),(2) 编码通道是latitude
或longitude
通道,或者 (3) 指定的刻度类型是定量刻度。"temporal"
是默认类型,如果 (1) 编码字段包含timeUnit
,或者 (2) 指定的刻度类型是时间或 utc 刻度"ordinal"
是默认类型,如果 (1) 编码字段包含自定义排序顺序,(2) 指定的刻度类型是有序/点状/带状刻度,或者 (3) 编码通道是order
。
对于数据域中的常量值(
datum
)
如果 datum 是数字,则为
"quantitative"
如果 datum 是字符串,则为
"nominal"
如果 datum 是日期时间对象,则为
"temporal"
注意
数据
type
描述的是数据的语义,而不是基本数据类型(数字、字符串等)。相同的基础数据类型可以具有不同的测量类型。例如,数字数据可以表示定量、有序或名义数据。时间字段的数据值可以是日期时间字符串(例如,
"2015-03-07 12:32:17"
、"17:01"
、"2015-03-16"
、"2015"
)或时间戳数字(例如,1552199579097
)。与 bin 一起使用时,
type
属性可以是"quantitative"
(用于线性分箱刻度)或“ordinal”(用于有序分箱刻度)。与 timeUnit 一起使用时,
type
属性可以是"temporal"
(默认,用于时间刻度)或“ordinal”(用于有序刻度)。与 aggregate 一起使用时,
type
属性指的是聚合后的数据类型。例如,我们可以使用{"aggregate": "distinct", "field": "cat"}
计算分类字段"cat"
的去重计数。聚合输出的"type"
是"quantitative"
。次要通道(例如,
x2
、y2
、xError
、yError
)没有type
属性,因为它们必须与其主要通道(例如,x
、y
)具有完全相同的类型。
**另请参阅:** type 文档。
- __init__(datum, bandPosition=Undefined, condition=Undefined, title=Undefined, type=Undefined, **kwds)#
方法
__init__
(datum[, bandPosition, condition, ...])copy
([deep, ignore])返回对象的副本。
from_dict
(dct[, validate])从字典表示构造类。
from_json
(json_string[, validate])从有效的 JSON 字符串实例化对象。
resolve_references
([schema])在此对象的 schema 或根 schema 上下文中解析引用。
to_dict
([validate, ignore, context])返回对象的字典表示。
to_json
([validate, indent, sort_keys, ...])将此对象的 JSON 表示作为字符串输出。
validate
(instance[, schema])在根 schema 上下文中根据类 schema 验证实例。
validate_property
(name, value[, schema])在根 schema 上下文中根据属性 schema 验证属性。
属性
bandPosition
在堆叠、分箱、时间单位或带状刻度的带上的相对位置。
condition
一个或多个值定义,带有[参数或测试谓词](https://vega.github.io/vega-lite/docs/condition.html)。
datum
数据域中的常量值。
title
TitleParams schema 包装器。
type
Type schema 包装器。