Функция reset_option

Функция reset_option из модуля pd.options применяется для сброса настроек Pandas к стандартным значениям. Первым параметром передаётся строка с именем опции или список строк. Если указана несуществующая опция, функция возбуждает исключение KeyError.

Синтаксис

pd.reset_option(pat)

Параметр pat может быть строкой с именем опции (например, display.max_rows) или списком строк. Также поддерживаются регулярные выражения для сброса нескольких опций одновременно.

Пример

Давайте изменим максимальное количество строк для вывода и сбросим его обратно к значению по умолчанию:

import pandas as pd

# Устанавливаем новое значение
pd.set_option('display.max_rows', 10)
print(pd.get_option('display.max_rows'))

# Сбрасываем к значению по умолчанию
pd.reset_option('display.max_rows')
print(pd.get_option('display.max_rows'))

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

10
60

Пример

Давайте сбросим несколько опций одновременно, передав их в виде списка:

import pandas as pd

# Изменяем несколько опций
pd.set_option('display.max_rows', 5)
pd.set_option('display.max_columns', 10)
pd.set_option('display.precision', 2)

print(pd.get_option('display.max_rows'))
print(pd.get_option('display.max_columns'))
print(pd.get_option('display.precision'))

# Сбрасываем все три опции
pd.reset_option(['display.max_rows', 'display.max_columns', 'display.precision'])

print(pd.get_option('display.max_rows'))
print(pd.get_option('display.max_columns'))
print(pd.get_option('display.precision'))

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

Пример

Давайте используем регулярное выражение для сброса всех опций, связанных с отображением таблиц:

import pandas as pd

# Изменяем несколько опций отображения
pd.set_option('display.max_rows', 5)
pd.set_option('display.max_columns', 5)
pd.set_option('display.width', 50)

print(pd.get_option('display.max_rows'))
print(pd.get_option('display.max_columns'))
print(pd.get_option('display.width'))

# Сбрасываем все опции, начинающиеся с 'display.'
pd.reset_option('^display\..+')

print(pd.get_option('display.max_rows'))
print(pd.get_option('display.max_columns'))
print(pd.get_option('display.width'))

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

Пример

Давайте попробуем сбросить несуществующую опцию и увидим ошибку:

import pandas as pd

try:
	pd.reset_option('display.non_existent')
except KeyError as e:
	print(e)

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

"No such keys(s): 'display.non_existent'"

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

функция set_option,
которая устанавливает значения опций
функция get_option,
которая возвращает текущие значения опций
функция option_context,
которая временно изменяет опции в контексте
функция describe_option,
которая выводит описание опции