altair.LongitudeDatum#
- class altair.LongitudeDatum(datum, bandPosition=Undefined, title=Undefined, type=Undefined, **kwds)#
LongitudeDatum schema 包装器。
- 参数:
- bandPositionfloat
堆叠式、分箱式、时间单位式或带状比例尺上带的相对位置。例如,如果设置为
0
,标记将定位在带的起始处;如果设置为0.5
,标记将定位在带的中间。- datumstr, bool, dict, float,
ExprRef
,DateTime
,RepeatRef
,PrimitiveValue
, None 数据域中的常量值。
- titlestr,
Text
, Sequence[str], None 字段的标题。如果为
null
,则删除标题。默认值:派生自字段的名称和转换函数(
aggregate
,bin
和timeUnit
)。如果字段具有聚合函数,则函数会作为标题的一部分显示(例如,"Sum of Profit"
)。如果字段经过分箱或应用了时间单位,则应用的函数会显示在括号中(例如,"Profit (binned)"
,"Transaction Date (year-month)"
)。否则,标题就是字段名称。注意:
1) 您可以通过在 config 中提供 fieldTitle 属性或通过 compile function 的 options 提供 fieldTitle 函数来自定义默认字段标题格式。
2) 如果同时定义了字段定义中的
title
和轴、头部或图例的title
,则使用轴/头部/图例的标题。- type
Type
, Literal[‘quantitative’, ‘ordinal’, ‘temporal’, ‘nominal’, ‘geojson’] 编码字段或常量值 (
datum
) 的测量类型("quantitative"
,"temporal"
,"ordinal"
, 或"nominal"
)。也可以是"geojson"
类型,用于编码 ‘geoshape’。Vega-Lite 在许多情况下会自动推断数据类型,如下所述。但是,如果字段满足以下条件之一,则需要指定类型:(1) 字段不是 nominal 类型,且字段编码未指定
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
描述的是数据的语义,而不是原始数据类型(数字、字符串等)。相同的原始数据类型可以具有不同类型的测量。例如,数字数据可以表示定量、有序或名义数据。temporal 字段的数据值可以是日期时间字符串(例如,
"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"}
计算 categorical 字段"cat"
的 distinct 计数。聚合输出的"type"
是"quantitative"
。辅助通道(例如,
x2
,y2
,xError
,yError
)没有type
属性,因为它们必须与它们的主通道(例如,x
,y
)具有完全相同的类型。
另请参阅: type 文档。
- __init__(datum, bandPosition=Undefined, title=Undefined, type=Undefined, **kwds)#
方法
__init__
(datum[, bandPosition, title, type])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])在 rootschema 的上下文中,根据类的 schema 验证实例。
validate_property
(name, value[, schema])在 rootschema 的上下文中,根据属性 schema 验证属性。
属性
bandPosition
堆叠式、分箱式、时间单位式或带状比例尺上带的相对位置。
datum
数据域中的常量值。
title
TitleParams schema 包装器。
type
Type schema 包装器。