Spec-Zone.ru › NumPy 1.14

numpy.in1d

numpy.in1d(ar1, ar2, assume_unique=False, invert=False) [source]

Проверка, присутствует ли каждый элемент одномерного массива также во втором массиве.

Возвращает булевый массив той же длины, что и ar1, равный True, если элемент из ar1 находится в ar2, и False в противном случае.

Для нового кода рекомендуется использовать isin вместо in1d.

Параметры:

ar1 : (M,) array_like

Входной массив.

ar2 : array_like

Значения, с которыми необходимо сравнить каждый элемент ar1.

assume_unique : bool, optional

Если True, оба входных массива предполагаются уникальными, что может ускорить вычисление. По умолчанию False.

invert : bool, optional

Если True, значения в возвращаемом массиве инвертируются (то есть False, если элемент из ar1 находится в ar2, и True в противном случае). По умолчанию False. np.in1d(a, b, invert=True) эквивалентно (но быстрее), чем np.invert(in1d(a, b)).

Введено в версии 1.8.0.

Возвращает:

in1d : (M,) ndarray, bool

Значения ar1[in1d] находятся в ar2.

См. также

isin
Версия этой функции, сохраняющая форму ar1.
numpy.lib.arraysetops
Модуль с рядом других функций для выполнения операций над множествами в массивах.

Примечания

in1d можно рассматривать как элементную функцию, аналогичную ключевому слову python in, для одномерных последовательностей. in1d(a, b) примерно эквивалентно np.array([item in b for item in a]). Однако эта идея терпит неудачу, если ar2 является множеством или похожим (непоследовательным) контейнером: поскольку ar2 преобразуется в массив, в таких случаях asarray(ar2) является массивом объектов, а не ожидаемого массива содержащихся значений.

Введено в версии 1.4.0.

Примеры

>>> test = np.array([0, 1, 2, 5, 0])
>>> states = [0, 2]
>>> mask = np.in1d(test, states)
>>> mask
array([ True, False,  True, False,  True])
>>> test[mask]
array([0, 2, 0])
>>> mask = np.in1d(test, states, invert=True)
>>> mask
array([False,  True, False,  True, False])
>>> test[mask]
array([1, 5])

© 2005–2019 NumPy Developers
Licensed under the 3-clause BSD License.
https://docs.scipy.org/doc/numpy-1.14.5/reference/generated/numpy.in1d.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API