polars.LazyFrame.show

LazyFrame.show(
    limit: int | None = 5,
    *,
    ascii_tables: bool | None = None,
    decimal_separator: str | None = None,
    thousands_separator: str | bool | None = None,
    float_precision: int | None = None,
    fmt_float: FloatFmt | None = None,
    fmt_str_lengths: int | None = None,
    fmt_table_cell_list_len: int | None = None,
    tbl_cell_alignment: Alignment | None = None,
    tbl_cell_numeric_alignment: Alignment | None = None,
    tbl_cols: int | None = None,
    tbl_column_data_type_inline: bool | None = None,
    tbl_dataframe_shape_below: bool | None = None,
    tbl_formatting: TableFormatNames | None = None,
    tbl_hide_column_data_types: bool | None = None,
    tbl_hide_column_names: bool | None = None,
    tbl_hide_dtype_separator: bool | None = None,
    tbl_hide_dataframe_shape: bool | None = None,
    tbl_width_chars: int | None = None,
    trim_decimal_zeros: bool | None = True,
) → None

Показать первые n строк.

Параметры:

limitint

Количество строк для отображения. Если передано значение None, вызывается ValueError. Это сделано для соответствия сигнатуре DataFrame.show().

ascii_tablesbool

Использовать символы ASCII для отображения границ таблицы. Установите False, чтобы вернуться к стилю форматирования UTF8_FULL_CONDENSED по умолчанию. Дополнительные сведения см. в разделе Config.set_ascii_tables().

decimal_separatorstr

Задать символ-разделитель десятичной части. Дополнительные сведения см. в разделе Config.set_decimal_separator().

thousands_separatorstr, bool

Задать символ-разделитель групп разрядов. Дополнительные сведения см. в разделе Config.set_thousands_separator().

float_precisionint

Количество знаков после запятой для отображения значений с плавающей точкой. Дополнительные сведения см. в разделе Config.set_float_precision().

fmt_float{“mixed”, “full”}

Управлять отображением значений с плавающей точкой. Дополнительные сведения см. в разделе Config.set_fmt_float(). Поддерживаемые параметры:

• “mixed”: ограничивать количество знаков после запятой и использовать научную нотацию для больших/малых значений.
• “full”: выводить значение с плавающей точкой с полной точностью.

fmt_str_lengthsint

Количество символов для отображения строковых значений. Дополнительные сведения см. в разделе Config.set_fmt_str_lengths().

fmt_table_cell_list_lenint

Количество элементов для отображения значений типа List. Дополнительные сведения см. в разделе Config.set_fmt_table_cell_list_len().

tbl_cell_alignmentstr

Задать выравнивание ячеек таблицы. Дополнительные сведения см. в разделе Config.set_tbl_cell_alignment(). Поддерживаемые параметры:

• “LEFT”: по левому краю
• “CENTER”: по центру
• “RIGHT”: по правому краю

tbl_cell_numeric_alignmentstr

Задать выравнивание ячеек таблицы для числовых столбцов. Дополнительные сведения см. в разделе Config.set_tbl_cell_numeric_alignment(). Поддерживаемые параметры:

• “LEFT”: по левому краю
• “CENTER”: по центру
• “RIGHT”: по правому краю

tbl_colsint

Количество столбцов для отображения. Дополнительные сведения см. в разделе Config.set_tbl_cols().

tbl_column_data_type_inlinebool

Размещать тип данных в одной строке с именем столбца (справа, в скобках). Дополнительные сведения см. в разделе Config.set_tbl_column_data_type_inline().

tbl_dataframe_shape_belowbool

Показывать сведения о форме DataFrame под данными при отображении таблиц. Дополнительные сведения см. в разделе Config.set_tbl_dataframe_shape_below().

tbl_formattingstr

Задать стиль форматирования таблицы. Дополнительные сведения см. в разделе Config.set_tbl_formatting(). Поддерживаемые параметры:

• “ASCII_FULL”: ASCII, все границы и линии, включая разделители строк.
• “ASCII_FULL_CONDENSED”: то же, что ASCII_FULL, но с уменьшенным интервалом между строками.
• “ASCII_NO_BORDERS”: ASCII, без границ.
• “ASCII_BORDERS_ONLY”: ASCII, только границы.
• “ASCII_BORDERS_ONLY_CONDENSED”: ASCII, только границы, уменьшенный интервал между строками.
• “ASCII_HORIZONTAL_ONLY”: ASCII, только горизонтальные линии.
• “ASCII_MARKDOWN”: формат Markdown (многоточия ASCII для усечённых значений).
• “MARKDOWN”: формат Markdown (многоточия UTF-8 для усечённых значений).
• “UTF8_FULL”: UTF-8, все границы и линии, включая разделители строк.
• “UTF8_FULL_CONDENSED”: то же, что UTF8_FULL, но с уменьшенным интервалом между строками.
• “UTF8_NO_BORDERS”: UTF-8, без границ.
• “UTF8_BORDERS_ONLY”: UTF-8, только границы.
• “UTF8_HORIZONTAL_ONLY”: UTF-8, только горизонтальные линии.
• “NOTHING”: без границ и других линий.

tbl_hide_column_data_typesbool

Скрыть типы данных столбцов таблицы (i64, f64, str и т. д.). Дополнительные сведения см. в разделе Config.set_tbl_hide_column_data_types().

tbl_hide_column_namesbool

Скрыть имена столбцов таблицы. Дополнительные сведения см. в разделе Config.set_tbl_hide_column_names().

tbl_hide_dtype_separatorbool

Скрыть разделитель «—» между именами столбцов и типами столбцов. Дополнительные сведения см. в разделе Config.set_tbl_hide_dtype_separator().

tbl_hide_dataframe_shapebool

Скрыть сведения о форме DataFrame при отображении таблиц. Дополнительные сведения см. в разделе Config.set_tbl_hide_dataframe_shape().

tbl_width_charsint

Задать максимальную ширину таблицы в символах. Дополнительные сведения см. в разделе Config.set_tbl_width_chars().

trim_decimal_zerosbool

Удалять завершающие нули из значений типа Decimal. Дополнительные сведения см. в разделе Config.set_trim_decimal_zeros().

Предупреждение

• Этот метод не сохраняет ленивость фрейма и выполнит collect конечного результата. Эта операция потенциально может быть затратной.

Примеры

>>> lf = pl.LazyFrame(
...     {
...         "a": [1, 2, 3, 4, 5, 6],
...         "b": [7, 8, 9, 10, 11, 12],
...     }
... )
>>> lf.show()
shape: (5, 2)
┌─────┬─────┐
│ a   ┆ b   │
│ --- ┆ --- │
│ i64 ┆ i64 │
╞═════╪═════╡
│ 1   ┆ 7   │
│ 2   ┆ 8   │
│ 3   ┆ 9   │
│ 4   ┆ 10  │
│ 5   ┆ 11  │
└─────┴─────┘
>>> lf.show(2)
shape: (2, 2)
┌─────┬─────┐
│ a   ┆ b   │
│ --- ┆ --- │
│ i64 ┆ i64 │
╞═════╪═════╡
│ 1   ┆ 7   │
│ 2   ┆ 8   │
└─────┴─────┘