altair.Column

class altair.Column(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)

Column Schema 包装器。

参数：

shorthandstr, dict, Sequence[str], RepeatRef

字段、聚合和类型的简写形式

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 (None)

另请参阅： aggregate 文档。

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

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

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

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

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

默认值： "all"。

bandPositionfloat

堆叠、分箱、时间单位或条带（band）比例尺上的相对位置。例如，如果设置为 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

编码字段的排序顺序。

对于连续字段（定量或时间），sort 可以是 "ascending"（升序）或 "descending"（降序）。

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

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

• 一个 sort field definition 用于按另一个字段排序。

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

• null 表示不排序。

默认值： "ascending"

注意： null 不支持用于 row 和 column。

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’]

时间字段的时间单位（例如 year、yearmonth、month、hours），或被转换为有序型的时间字段。

默认值： undefined (None)

另请参阅： timeUnit 文档。

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，则将使用轴/头部/图例的标题。

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

编码字段或常量值（datum）的测量类型（"quantitative"（定量）、"temporal"（时间）、"ordinal"（有序）或 "nominal"（名义））。也可以是 "geojson" 类型，用于编码 ‘geoshape’。

Vega-Lite 在许多情况下会自动推断数据类型，如下所述。但是，如果满足以下条件之一，则字段需要指定类型：(1) 字段不是名义型，且字段编码没有指定的 aggregate（除了 argmin 和 argmax）、bin、比例尺类型、自定义 sort 顺序，或 timeUnit；或 (2) 您希望对使用 bin 或 timeUnit 的字段使用有序比例尺。

默认值

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

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

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

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

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

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

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

• 如果 datum 是 a date time object，则为 "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__(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])	在此对象 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 验证属性。

属性

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