altair.StrokeDashDatum#
- class altair.StrokeDashDatum(datum, bandPosition=Undefined, condition=Undefined, title=Undefined, type=Undefined, **kwds)#
StrokeDashDatum schema 包装器。
- 参数:
- bandPosition浮点数
堆叠、分箱、时间单位或带状比例尺上带状的相对位置。例如,如果设置为
0
,标记将位于带状的起始位置;如果设置为0.5
,则位于带状的中间位置。- condition字典,
ConditionalValueDefnumberArrayExprRef
,ConditionalParameterValueDefnumberArrayExprRef
,ConditionalPredicateValueDefnumberArrayExprRef
, 序列[字典,ConditionalValueDefnumberArrayExprRef
,ConditionalParameterValueDefnumberArrayExprRef
,ConditionalPredicateValueDefnumberArrayExprRef
] 一个或多个值定义,带有参数或测试谓词。
注意:字段定义的
condition
属性只能包含条件值定义,因为 Vega-Lite 每个编码通道最多只允许一个编码字段。- datum字符串, 布尔值, 字典, 浮点数,
ExprRef
,DateTime
,RepeatRef
,PrimitiveValue
, 无 数据域中的一个常量值。
- title字符串,
Text
, 字符串序列, 无 字段的标题。如果为
null
,标题将被移除。默认值:从字段的名称和转换函数(
aggregate
、bin
和timeUnit
)派生而来。如果字段有聚合函数,函数会显示为标题的一部分(例如,"Sum of Profit"
)。如果字段经过分箱或应用了时间单位,应用的函数会显示在括号中(例如,"Profit (binned)"
,"Transaction Date (year-month)"
)。否则,标题就是简单的字段名称。注释:
1) 你可以通过在配置中提供 fieldTitle 属性,或通过编译函数的选项提供fieldTitle 函数来自定义默认的字段标题格式。
2) 如果同时定义了字段定义的
title
和坐标轴、头部或图例的title
,则使用坐标轴/头部/图例的标题。- type
Type
, Literal[‘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
,默认数据类型是"nominal"
,除非字段编码有满足以下条件的aggregate
、channel
、bin
、比例尺类型、sort
或timeUnit
。"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
一个或多个值定义,带有 [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html)。
datum
数据域中的一个常量值。
title
TitleParams schema 包装器。
type
Type schema 包装器。