pandas.Series.map

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

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

Используется для замены каждого значения в Series другим значением, которое может быть получено из функции, dict или 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 или 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