altair.LatitudeDatum#
- class altair.LatitudeDatum(datum, bandPosition=Undefined, title=Undefined, type=Undefined, **kwds)#
LatitudeDatum 模式包装器。
- 参数:
- 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 函数的选项提供 fieldTitle 函数来定制默认字段标题格式。
2) 如果同时定义了字段定义的
title
和坐标轴、标题或图例的title
,将使用坐标轴/标题/图例的标题。- type
Type
, Literal[‘quantitative’, ‘ordinal’, ‘temporal’, ‘nominal’, ‘geojson’] 编码字段或常量值(
datum
)的测量类型("quantitative"
(定量)、"temporal"
(时态)、"ordinal"
(有序)或"nominal"
(名义))。对于编码 ‘geoshape’,它也可以是"geojson"
类型。Vega-Lite 在许多情况下会自动推断数据类型,如下所述。但是,对于字段,
type
是必需的,如果:(1) 字段不是名义类型,且字段编码没有指定aggregate
(除了argmin
和argmax
)、bin
、比例尺类型、自定义sort
顺序或timeUnit
,或者 (2) 如果你想对带有bin
或timeUnit
的字段使用有序比例尺。默认值
1) 对于数据
field
,"nominal"
(名义)是默认数据类型,除非字段编码具有满足以下条件的aggregate
(聚合)、channel
(通道)、bin
(分箱)、比例尺类型、自定义sort
(排序)顺序或timeUnit
(时间单位),或者 (2) 如果你想对带有bin
或timeUnit
的字段使用有序比例尺。如果 (1) 编码字段包含
bin
或aggregate
(除了"argmin"
和"argmax"
),(2) 编码通道是latitude
或longitude
通道,或者 (3) 如果指定的比例尺类型是定量比例尺,则默认类型为"quantitative"
(定量)。如果 (1) 编码字段包含
timeUnit
,或者 (2) 指定的比例尺类型是时间或 utc 比例尺,则默认类型为"temporal"
(时态)。如果 (1) 编码字段包含自定义排序顺序,(2) 指定的比例尺类型是有序/点/带宽比例尺,或者 (3) 编码通道是
order
,则默认类型为"ordinal"
(有序)。
对于数据域中的常量值(
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"
的去重计数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])在此对象的模式或根模式上下文中解析引用。
to_dict
([validate, ignore, context])返回对象的字典表示。
to_json
([validate, indent, sort_keys, ...])将此对象的 JSON 表示作为字符串发出。
validate
(instance[, schema])在根模式上下文中根据类模式验证实例。
validate_property
(name, value[, schema])在根模式上下文中根据属性模式验证属性。
属性
bandPosition
堆叠、分箱、时间单位或带宽比例尺上某个带宽的相对位置。
datum
数据域中的一个常量值。
title
TitleParams 模式包装器。
type
Type 模式包装器。