polars.datatypes.Struct

class polars.datatypes.Struct(
    fields: Sequence[Field] | SchemaDict,
)

Составной тип Struct.

Параметры:

fields

Поля, из которых состоит структура. Может быть последовательностью объектов Field или отображением имен столбцов на типы данных.

Примеры

Инициализация с помощью словаря:

>>> dtype = pl.Struct({"a": pl.Int8, "b": pl.List(pl.String)})
>>> dtype
Struct({'a': Int8, 'b': List(String)})

Инициализация с помощью списка объектов Field:

>>> dtype = pl.Struct([pl.Field("a", pl.Int8), pl.Field("b", pl.List(pl.String))])
>>> dtype
Struct({'a': Int8, 'b': List(String)})

При инициализации Series Polars может вывести тип данных struct из данных.

>>> s = pl.Series([{"a": 1, "b": ["x", "y"]}, {"a": 2, "b": ["z"]}])
>>> s
shape: (2,)
Series: '' [struct[2]]
[
        {1,["x", "y"]}
        {2,["z"]}
]
>>> s.dtype
Struct({'a': Int64, 'b': List(String)})

__init__(
    fields: Sequence[Field] | SchemaDict,
) → None

Методы

__init__(fields)
base_type()	Возвращает фундаментальный (корневой) класс этого типа данных.
from_python(py_type)	Возвращает тип данных Polars, соответствующий заданному типу Python.
is_(other)	Проверяет, совпадает ли этот тип данных с другим типом данных.
is_decimal()	Проверяет, является ли тип данных десятичным.
is_extension()	Проверяет, является ли тип данных типом расширения.
is_float()	Проверяет, является ли тип данных типом с плавающей точкой.
is_integer()	Проверяет, является ли тип данных целочисленным.
is_nested()	Проверяет, является ли тип данных вложенным.
is_numeric()	Проверяет, является ли тип данных числовым.
is_object()	Проверяет, является ли тип данных объектным.
is_signed_integer()	Проверяет, является ли тип данных целочисленным типом со знаком.
is_temporal()	Проверяет, является ли тип данных временным.
is_unsigned_integer()	Проверяет, является ли тип данных целочисленным типом без знака.
to_dtype_expr()	Возвращает DataTypeExpr со статическим DataType.
to_python()	Возвращает тип Python, соответствующий этому типу данных Polars.
to_schema()	Возвращает тип данных Struct в виде словаря схемы.

Атрибуты

fields