pandas.Series.map

Series.map(arg, na_action=None)[source]

Применяет отображение к значениям Series в соответствии с входным соответствием или функцией.

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

Параметры

arg:функция, подкласс collections.abc.Mapping или Series

Соответствие отображения.

na_action:{None, ‘ignore’}, по умолчанию None

Если ‘ignore’, пропускает значения NaN, не передавая их в соответствие отображения.

Возвращает

Series

Индекс совпадает с вызывающим объектом.

См. также

Series.apply

Для применения более сложных функций к Series.

DataFrame.apply

Применить функцию по строкам/столбцам.

DataFrame.applymap

Применить функцию к каждому элементу всего DataFrame.

Примечания

Когда arg является словарем, значения в Series, которые отсутствуют в словаре (в качестве ключей), преобразуются в NaN. Однако, если словарь является подклассом dict, который определяет __missing__ (т.е. предоставляет метод для значений по умолчанию), то используется это значение по умолчанию, а не NaN.

Примеры

>>> s = pd.Series(['cat', 'dog', np.nan, 'rabbit'])
>>> s
0      cat
1      dog
2      NaN
3   rabbit
dtype: object

map принимает словарь или Series. Значения, которые не найдены в dict, преобразуются в NaN, если у словаря нет значения по умолчанию (например, defaultdict):

>>> s.map({'cat': 'kitten', 'dog': 'puppy'})
0   kitten
1    puppy
2      NaN
3      NaN
dtype: object

Он также принимает функцию:

>>> s.map('I am a {}'.format)
0       I am a cat
1       I am a dog
2       I am a nan
3    I am a rabbit
dtype: object

Чтобы избежать применения функции к пропущенным значениям (и сохранить их как NaN) можно использовать na_action='ignore':

>>> s.map('I am a {}'.format, na_action='ignore')
0     I am a cat
1     I am a dog
2            NaN
3  I am a rabbit
dtype: object