pandas.Series.map

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

Преобразование значений Series в соответствии с заданным соответствием.

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

Параметры:	arg : function, dict, or Series Соответствие для преобразования. na_action : {None, ‘ignore’}, default 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 принимает словарь или функцию. Значения, которые не найдены в 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