polars.DataFrame.show

DataFrame.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

Количество строк для отображения. Если передано отрицательное значение, вернуть все строки, кроме последних abs(n). Если передано None, вернуть все строки.

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

См. также

head

Примеры

>>> df = pl.DataFrame(
...     {
...         "foo": [1, 2, 3, 4, 5],
...         "bar": [6, 7, 8, 9, 10],
...         "ham": ["a", "b", "c", "d", "e"],
...     }
... )
>>> df.show(3)
shape: (3, 3)
┌─────┬─────┬─────┐
│ foo ┆ bar ┆ ham │
│ --- ┆ --- ┆ --- │
│ i64 ┆ i64 ┆ str │
╞═════╪═════╪═════╡
│ 1   ┆ 6   ┆ a   │
│ 2   ┆ 7   ┆ b   │
│ 3   ┆ 8   ┆ c   │
└─────┴─────┴─────┘

Передайте отрицательное значение, чтобы получить все строки except последние abs(n).

>>> df.show(-3)
shape: (2, 3)
┌─────┬─────┬─────┐
│ foo ┆ bar ┆ ham │
│ --- ┆ --- ┆ --- │
│ i64 ┆ i64 ┆ str │
╞═════╪═════╪═════╡
│ 1   ┆ 6   ┆ a   │
│ 2   ┆ 7   ┆ b   │
└─────┴─────┴─────┘