altair.Row

class altair.Row(shorthand=Undefined, aggregate=Undefined, align=Undefined, bandPosition=Undefined, bin=Undefined, center=Undefined, field=Undefined, header=Undefined, sort=Undefined, spacing=Undefined, timeUnit=Undefined, title=Undefined, type=Undefined, **kwds)

Row 模式封装。

参数:

shorthandstr, dict, Sequence[str], RepeatRef

field、aggregate 和 type 的简写

aggregatedict, Aggregate, ArgmaxDef, ArgminDef, NonArgAggregateOp, Literal[‘average’, ‘count’, ‘distinct’, ‘max’, ‘mean’, ‘median’, ‘min’, ‘missing’, ‘product’, ‘q1’, ‘q3’, ‘ci0’, ‘ci1’, ‘stderr’, ‘stdev’, ‘stdevp’, ‘sum’, ‘valid’, ‘values’, ‘variance’, ‘variancep’, ‘exponential’, ‘exponentialb’]

字段的聚合函数（例如，"mean", "sum", "median", "min", "max", "count"）。

默认值: undefined (无)

另请参阅: aggregate 文档。

alignLayoutAlign, Literal[‘all’, ‘each’, ‘none’]

应用于行/列分面子图的对齐方式。支持的字符串值有 "all", "each" 和 "none"。

• 对于 "none"，将使用流式布局，其中相邻子视图简单地一个接一个放置。

• 对于 "each"，子视图将对齐成一个整洁的网格结构，但每行或每列的大小可能不同。

• 对于 "all"，子视图将对齐，并且每行或每列的大小将根据观察到的最大尺寸相同。此属性的字符串值将应用于网格行和列。

默认值: "all"。

bandPositionfloat

堆叠、分箱、时间单位或带状比例尺的带上的相对位置。例如，如果设置为 0，标记将位于带的起始位置；如果设置为 0.5，则位于带的中间位置。

binbool, dict, BinParams, None

用于对 quantitative 字段进行分箱的标志，定义分箱参数的对象，或指示 x 或 y 通道的数据在导入 Vega-Lite 之前已经分箱 ("binned")。

• 如果为 true，将应用默认的分箱参数。

• 如果为 "binned"，这表示 x (或 y) 通道的数据已经分箱。您可以将箱起始字段映射到 x (或 y)，将箱结束字段映射到 x2 (或 y2)。比例尺和坐标轴将格式化得类似于 Vega-Lite 中的分箱。要根据分箱步长调整坐标轴刻度，您还可以设置坐标轴的 tickMinStep 属性。

默认值: false

另请参阅: bin 文档。

centerbool

布尔标志，指示分面子视图是否应相对于其各自的行或列居中。

默认值: false

fieldstr, dict, Field, FieldName, RepeatRef

必需。一个字符串，定义从中提取数据值的字段名称；或者一个对象，定义来自 repeat 运算符的迭代值。

另请参阅: field 文档。

注意: 1) 点 (.) 和方括号 ([ 和 ]) 可用于访问嵌套对象（例如，"field": "foo.bar" 和 "field": "foo['bar']"）。如果字段名称包含点或方括号但不是嵌套的，您可以使用 \\ 来转义点和方括号（例如，"a\\.b" 和 "a\\[0\\]"）。有关转义的更多详细信息，请参阅 field 文档。2) 如果 aggregate 为 count，则不需要 field。

headerdict, Header, None

定义分面头部属性的对象。

sortdict, Sequence[str], Sequence[bool], Sequence[float], SortArray, SortOrder, EncodingSortField, Sequence[dict, DateTime], Literal[‘ascending’, ‘descending’], None

编码字段的排序顺序。

对于连续字段（quantitative 或 temporal），sort 可以是 "ascending" 或 "descending"。

对于离散字段，sort 可以是以下之一：

• "ascending" 或 "descending" – 用于按值在 JavaScript 中的自然顺序排序。

• 按另一个字段排序的排序字段定义。

• 指定字段值首选顺序的数组。在这种情况下，排序顺序将遵循数组中的值，后跟任何未指定值按其原始顺序排列。对于离散时间字段，排序数组中的值可以是日期时间定义对象。此外，对于时间单位 "month" 和 "day"，值可以是月份或日期名称（不区分大小写）或其 3 个字母的缩写（例如 "Mon", "Tue"）。

• null 表示不排序。

默认值: "ascending"

注意: row 和 column 不支持 null。

spacingfloat

分面子视图之间的像素间距。

默认值: 取决于视图合成配置的 "spacing" 属性（默认为 20）

timeUnitdict, TimeUnit, MultiTimeUnit, BinnedTimeUnit, SingleTimeUnit, TimeUnitParams, UtcMultiTimeUnit, UtcSingleTimeUnit, LocalMultiTimeUnit, LocalSingleTimeUnit, Literal[‘binnedutcyear’, ‘binnedutcyearquarter’, ‘binnedutcyearquartermonth’, ‘binnedutcyearmonth’, ‘binnedutcyearmonthdate’, ‘binnedutcyearmonthdatehours’, ‘binnedutcyearmonthdatehoursminutes’, ‘binnedutcyearmonthdatehoursminutesseconds’, ‘binnedutcyearweek’, ‘binnedutcyearweekday’, ‘binnedutcyearweekdayhours’, ‘binnedutcyearweekdayhoursminutes’, ‘binnedutcyearweekdayhoursminutesseconds’, ‘binnedutcyeardayofyear’, ‘binnedyear’, ‘binnedyearquarter’, ‘binnedyearquartermonth’, ‘binnedyearmonth’, ‘binnedyearmonthdate’, ‘binnedyearmonthdatehours’, ‘binnedyearmonthdatehoursminutes’, ‘binnedyearmonthdatehoursminutesseconds’, ‘binnedyearweek’, ‘binnedyearweekday’, ‘binnedyearweekdayhours’, ‘binnedyearweekdayhoursminutes’, ‘binnedyearweekdayhoursminutesseconds’, ‘binnedyeardayofyear’, ‘utcyear’, ‘utcquarter’, ‘utcmonth’, ‘utcweek’, ‘utcday’, ‘utcdayofyear’, ‘utcdate’, ‘utchours’, ‘utcminutes’, ‘utcseconds’, ‘utcmilliseconds’, ‘year’, ‘quarter’, ‘month’, ‘week’, ‘day’, ‘dayofyear’, ‘date’, ‘hours’, ‘minutes’, ‘seconds’, ‘milliseconds’, ‘utcyearquarter’, ‘utcyearquartermonth’, ‘utcyearmonth’, ‘utcyearmonthdate’, ‘utcyearmonthdatehours’, ‘utcyearmonthdatehoursminutes’, ‘utcyearmonthdatehoursminutesseconds’, ‘utcyearweek’, ‘utcyearweekday’, ‘utcyearweekdayhours’, ‘utcyearweekdayhoursminutes’, ‘utcyearweekdayhoursminutesseconds’, ‘utcyeardayofyear’, ‘utcquartermonth’, ‘utcmonthdate’, ‘utcmonthdatehours’, ‘utcmonthdatehoursminutes’, ‘utcmonthdatehoursminutesseconds’, ‘utcweekday’, ‘utcweekdayhours’, ‘utcweekdayhoursminutes’, ‘utcweekdayhoursminutesseconds’, ‘utcdayhours’, ‘utcdayhoursminutes’, ‘utcdayhoursminutesseconds’, ‘utchoursminutes’, ‘utchoursminutesseconds’, ‘utcminutesseconds’, ‘utcsecondsmilliseconds’, ‘yearquarter’, ‘yearquartermonth’, ‘yearmonth’, ‘yearmonthdate’, ‘yearmonthdatehours’, ‘yearmonthdatehoursminutes’, ‘yearmonthdatehoursminutesseconds’, ‘yearweek’, ‘yearweekday’, ‘yearweekdayhours’, ‘yearweekdayhoursminutes’, ‘yearweekdayhoursminutesseconds’, ‘yeardayofyear’, ‘quartermonth’, ‘monthdate’, ‘monthdatehours’, ‘monthdatehoursminutes’, ‘monthdatehoursminutesseconds’, ‘weekday’, ‘weekdayhours’, ‘weekdayhoursminutes’, ‘weekdayhoursminutesseconds’, ‘dayhours’, ‘dayhoursminutes’, ‘dayhoursminutesseconds’, ‘hoursminutes’, ‘hoursminutesseconds’, ‘minutesseconds’, ‘secondsmilliseconds’]

temporal 字段的时间单位（例如 year, yearmonth, month, hours）。或被强制转换为 ordinal 类型的 temporal 字段。

默认值: undefined (无)

另请参阅: timeUnit 文档。

titlestr, Text, Sequence[str], None

字段的标题。如果为 null，则标题将被移除。

默认值: 从字段名称和转换函数（aggregate, bin 和 timeUnit）派生。如果字段具有聚合函数，该函数将作为标题的一部分显示（例如 "Sum of Profit"）。如果字段已分箱或应用了时间单位，则应用的函数会显示在括号中（例如 "Profit (binned)", "Transaction Date (year-month)"）。否则，标题只是字段名称。

注意:

1) 您可以通过在 config 中提供 fieldTitle 属性或通过编译函数的选项中的 fieldTitle 函数来自定义默认字段标题格式。

2) 如果字段定义的 title 和坐标轴、头部或图例的 title 都已定义，则使用坐标轴/头部/图例的标题。

typeStandardType, Literal[‘quantitative’, ‘ordinal’, ‘temporal’, ‘nominal’]

编码字段或常量值（datum）的测量类型（"quantitative"、"temporal"、"ordinal" 或 "nominal"）。它也可以是用于编码‘geoshape’ 的 "geojson" 类型。

在许多情况下，Vega-Lite 会自动推断数据类型，如下所述。但是，在以下情况下，字段需要指定类型：(1) 字段不是 nominal 类型，并且字段编码没有指定 aggregate（argmin 和 argmax 除外）、bin、比例尺类型、自定义 sort 顺序，也没有 timeUnit；或者 (2) 如果您希望将 ordinal 比例尺用于带有 bin 或 timeUnit 的字段。

默认值

1) 对于数据 field，默认数据类型是 "nominal"，除非字段编码具有满足以下条件的 aggregate、channel、bin、比例尺类型、sort 或 timeUnit：

• 如果 (1) 编码字段包含 bin 或 aggregate （"argmin" 和 "argmax" 除外），(2) 编码通道是 latitude 或 longitude 通道，或 (3) 如果指定的比例尺类型是定量比例尺，则默认类型为 "quantitative"。

• 如果 (1) 编码字段包含 timeUnit，或 (2) 指定的比例尺类型是 time 或 utc 比例尺，则默认类型为 "temporal"。

• 如果 (1) 编码字段包含自定义排序顺序，(2) 指定的比例尺类型是 ordinal/point/band 比例尺，或 (3) 编码通道是 order，则默认类型为 "ordinal"。

2. 对于数据域中的常量值（datum）

• 如果 datum 是数字，则为 "quantitative"

• 如果 datum 是字符串，则为 "nominal"

• 如果 datum 是日期时间对象，则为 "temporal"

注意

• 数据 type 描述的是数据的语义，而不是原始数据类型（数字、字符串等）。同一种原始数据类型可以有不同的测量类型。例如，数字数据可以表示 quantitative、ordinal 或 nominal 数据。

• temporal 字段的数据值可以是日期时间字符串（例如 "2015-03-07 12:32:17", "17:01", "2015-03-16", "2015"）或时间戳数字（例如 1552199579097）。

• 与 bin 一起使用时，type 属性可以是 "quantitative"（用于线性分箱比例尺）或“ordinal”（用于 ordinal 分箱比例尺）。

• 与 timeUnit 一起使用时，type 属性可以是 "temporal"（默认，用于 temporal 比例尺）或“ordinal”（用于 ordinal 比例尺）。

• 与 aggregate 一起使用时，type 属性指的是聚合后的数据类型。例如，我们可以使用 {"aggregate": "distinct", "field": "cat"} 计算 categorical 字段 "cat" 的 distinct 计数。聚合输出的 "type" 是 "quantitative"。

• 辅助通道（例如 x2, y2, xError, yError）没有 type 属性，因为它们的类型必须与其主要通道（例如 x, y）完全相同。

另请参阅: type 文档。

__init__(shorthand=Undefined, aggregate=Undefined, align=Undefined, bandPosition=Undefined, bin=Undefined, center=Undefined, field=Undefined, header=Undefined, sort=Undefined, spacing=Undefined, timeUnit=Undefined, title=Undefined, type=Undefined, **kwds)

方法

__init__([shorthand, aggregate, align, ...])
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])	在根模式的上下文中根据属性模式验证属性。

属性

aggregate	Aggregate 模式封装。
align	Align 模式封装。
bandPosition	堆叠、分箱、时间单位或带状比例尺的带上的相对位置。
bin	BinParams 模式封装。
center	布尔标志，指示分面子视图是否应相对于其各自的行或列居中。
field	Field 模式封装。
header	Header 模式封装。
sort	Sort 模式封装。
spacing	分面子视图之间的像素间距。
timeUnit	TimeUnit 模式封装。
title	TitleParams 模式封装。
type	Type 模式封装。