Опция display.width

Опция display.width определяет максимальное количество символов в строке вывода для объектов DataFrame и Series. Если общая ширина данных превышает это значение, Pandas автоматически сворачивает отображение, чтобы данные поместились в одну строку. По умолчанию опция имеет значение None, что позволяет Pandas определять ширину вывода автоматически на основе размера терминала. Опция доступна для чтения и изменения с помощью функций get_option и set_option.

Изменение этой опции позволяет контролировать форматирование вывода данных, особенно при работе с широкими таблицами или в средах, где автоматическое определение ширины недоступно, например, при сохранении логов или выводе в файлы.

Синтаксис

# Получение текущей ширины
pd.get_option('display.width')

# Установка новой ширины
pd.set_option('display.width', value)

# Сброс до значения по умолчанию
pd.reset_option('display.width')

Пример

Давайте посмотрим текущее значение опции:

import pandas as pd

res = pd.get_option('display.width')
print(res)

Результат выполнения кода:

"None"

Значение None означает, что Pandas автоматически определяет ширину терминала.

Пример

Установим фиксированную ширину и посмотрим, как это влияет на отображение широкой таблицы:

import pandas as pd

pd.set_option('display.width', 40)

df = pd.DataFrame({
	'a': [1, 2, 3, 4, 5],
	'b': [10, 20, 30, 40, 50],
	'c': [100, 200, 300, 400, 500],
	'd': [1000, 2000, 3000, 4000, 5000]
})
print(df)

Результат выполнения кода:

"   a   b	c	 d
0  1  10  100  1000
1  2  20  200  2000
2  3  30  300  3000
3  4  40  400  4000
4  5  50  500  5000"

При ширине 40 символов таблица выводится полностью, так как ширина данных меньше установленного значения.

Пример

Теперь установим очень маленькую ширину и посмотрим на эффект сворачивания:

import pandas as pd

pd.set_option('display.width', 20)

df = pd.DataFrame({
	'a': [1, 2, 3, 4, 5],
	'b': [10, 20, 30, 40, 50],
	'c': [100, 200, 300, 400, 500],
	'd': [1000, 2000, 3000, 4000, 5000]
})
print(df)

Результат выполнения кода:

"	 a   b   c	 d
0	1  10 100  1000
1	2  20 200  2000
2	3  30 300  3000
3	4  40 400  4000
4	5  50 500  5000"

При ширине 20 символов Pandas автоматически сворачивает вывод, чтобы данные поместились в одну строку. Каждая строка представляет собой одну запись таблицы.

Пример

Сбросим опцию до значения по умолчанию:

import pandas as pd

pd.set_option('display.width', 40)
print('Before reset:', pd.get_option('display.width'))

pd.reset_option('display.width')
print('After reset:', pd.get_option('display.width'))

Результат выполнения кода:

"Before reset: 40
After reset: None"

После сброса опция возвращается в состояние автоматического определения ширины.

Смотрите также

функция set_option,
которая устанавливает значения опций
функция get_option,
которая возвращает текущие значения опций
функция reset_option,
которая сбрасывает опции к значениям по умолчанию
опция display.max_rows,
которая управляет максимальным количеством отображаемых строк