pandas.Series.replace
-
Series.replace(to_replace=None, value=None, inplace=False, limit=None, regex=False, method='pad', axis=None)[source] -
Замена значений, заданных в ‘to_replace’, на ‘value’.
Параметры: to_replace : str, regex, список, словарь, Series, числовое значение или None
-
str или regex:
- str: строка, точно совпадающая с
to_replaceбудет заменена наvalue - regex: регулярные выражения, соответствующие
to_replaceбудут заменены наvalue
- str: строка, точно совпадающая с
-
список строк, регулярных выражений или числовых значений:
- Во-первых, если
to_replaceиvalueявляются списками, то их длина должна быть одинаковой. - Во-вторых, если
regex=True, тогда все строки в обоих списках будут интерпретироваться как регулярные выражения, в противном случае они будут соответствовать напрямую. Это не так важно дляvalue, так как существует всего несколько возможных подстановочных регулярных выражений, которые можно использовать. - Правила для строк и регулярных выражений применяются аналогично.
- Во-первых, если
-
словарь:
- Вложенные словари, например, {‘a’: {‘b’: nan}}, читаются следующим образом: ищите в столбце ‘a’ значение ‘b’ и замените его на nan. Можно также вкладывать регулярные выражения. Обратите внимание, что имена столбцов (ключи словаря верхнего уровня во вложенном словаре) не могут быть регулярными выражениями.
- Ключи сопоставляются с именами столбцов, а значения — со значениями подстановки. Вы можете рассматривать это как специальный случай передачи двух списков, за исключением того, что вы указываете столбец для поиска.
-
None:
- Это означает, что аргумент
regexдолжен быть строкой, скомпилированным регулярным выражением или списком, словарем, массивом ndarray или Series таких элементов. ЕслиvalueтакжеNone, то это должен быть вложенный словарь илиSeries.
- Это означает, что аргумент
Примеры каждого из этих вариантов приведены в разделе примеров.
value : скалярное значение, словарь, список, строка, регулярное выражение, по умолчанию None
Значение для заполнения пропусков (например, 0), альтернативно, словарь значений, определяющий, какое значение использовать для каждого столбца (столбцы, не указанные в словаре, не будут заполнены). Допускаются также регулярные выражения, строки и списки или словари таких объектов.
inplace : boolean, по умолчанию False
Если True, то в месте. Примечание: это изменит любые другие представления этого объекта (например, столбец из DataFrame). Возвращает вызывающий объект, если это True.
limit : целое число, по умолчанию None
Максимальный размер пробела для заполнения вперед или назад
regex : bool или те же типы, что и
to_replace, по умолчанию FalseУказывает, следует ли интерпретировать
to_replaceи/илиvalueкак регулярные выражения. Если этоTrue, тоto_replaceдолжен быть строкой. В противном случаеto_replaceдолжен бытьNone, потому что этот параметр будет интерпретироваться как регулярное выражение или список, словарь или массив регулярных выражений.method : строка, необязательно, {‘pad’, ‘ffill’, ‘bfill’}
Метод, используемый при замене, когда
to_replaceявляетсяlist.Возвращает: filled : NDFrame
Возможные исключения: AssertionError
- Если
regexне являетсяboolиto_replaceне являетсяNone.
TypeError
- Если
to_replaceявляетсяdictиvalueне являетсяlist,dict,ndarray, илиSeries - Если
to_replaceявляетсяNoneиregexне может быть скомпилировано в регулярное выражение или является списком, словарем, массивом ndarray или Series.
ValueError
- Если
to_replaceиvalueявляютсяlistилиndarray, но они не имеют одинаковой длины.
См. также
NDFrame.reindex,NDFrame.asfreq,NDFrame.fillnaПримечания
- Подстановка регулярных выражений выполняется внутри с помощью
re.sub. Правила подстановки дляre.subтакие же. - Регулярные выражения будут подставляться только в строки, а это означает, что вы не можете, например, предоставить регулярное выражение, соответствующее числам с плавающей точкой, и ожидать, что столбцы в вашей таблице с числовым типом данных будут сопоставлены. Однако, если эти числа с плавающей точкой являются строками, то вы можете это сделать.
- У этого метода очень много параметров. Вам рекомендуется экспериментировать и играть с этим методом, чтобы получить интуицию о том, как он работает.
-
© 2008–2012, AQR Capital Management, LLC, Lambda Foundry, Inc. and PyData Development Team
Licensed under the 3-clause BSD License.
https://pandas.pydata.org/pandas-docs/version/0.22.0/generated/pandas.Series.replace.html