Постоянные модуля numpy.ma

Помимо класса MaskedArray, модуль numpy.ma определяет несколько констант.

numpy.ma.masked

Константа masked является специальным случаем MaskedArray с типом данных float и нулевой формой. Она используется для проверки, замаскирован ли конкретный элемент массива, или для маскирования одного или нескольких элементов массива:

>>> x = ma.array([1, 2, 3], mask=[0, 1, 0])
>>> x[1] is ma.masked
True
>>> x[-1] = ma.masked
>>> x
masked_array(data=[1, --, --],
             mask=[False,  True,  True],
       fill_value=999999)

numpy.ma.nomask: Значение, указывающее, что массив не содержит недопустимых элементов. nomask используется во внутренних вычислениях для ускорения, когда маска не требуется. Внутренне он представлен как np.False_.

numpy.ma.masked_print_options: Строка, используемая вместо отсутствующих данных при выводе массива. По умолчанию эта строка равна '--'.

Класс MaskedArray

class numpy.ma.MaskedArray [source]

Подкласс ndarray, предназначенный для работы с числовыми массивами, содержащими пропущенные данные.

Объект MaskedArray можно рассматривать как комбинацию нескольких элементов:

The data, as a regular numpy.ndarray of any shape or datatype (the data).
A boolean mask with the same shape as the data, where a True value indicates that the corresponding element of the data is invalid. The special value nomask is also acceptable for arrays without named fields, and indicates that no data is invalid.
A fill_value, a value that may be used to replace the invalid entries in order to return a standard numpy.ndarray.

Атрибуты и свойства массивных массивов

См. также

Атрибуты массивов

MaskedArray.data

Возвращает данные, как представление массива с маской.

Если данные представляют собой подкласс numpy.ndarray, он возвращается как таковой.

>>> x = np.ma.array(np.matrix([[1, 2], [3, 4]]), mask=[[0, 1], [1, 0]])
>>> x.data
matrix([[1, 2],
        [3, 4]])

Тип данных можно получить через атрибут baseclass.

MaskedArray.mask: Текущая маска.

MaskedArray.recordmask

Получить или установить маску массива, если он не имеет именованных полей. Для структурированных массивов возвращает массив булевых значений, где элементы равны True , если все поля замаскированы, False в противном случае:

>>> x = np.ma.array([(1, 1), (2, 2), (3, 3), (4, 4), (5, 5)],
...         mask=[(0, 0), (1, 0), (1, 1), (0, 1), (0, 0)],
...        dtype=[('a', int), ('b', int)])
>>> x.recordmask
array([False, False,  True, False, False])

MaskedArray.fill_value

Значение заполнения массива с маской — скаляр. При установке значение None установит значение по умолчанию, соответствующее типу данных.

Примеры

>>> for dt in [np.int32, np.int64, np.float64, np.complex128]:
...     np.ma.array([0, 1], dtype=dt).get_fill_value()
...
999999
999999
1e+20
(1e+20+0j)

>>> x = np.ma.array([0, 1.], fill_value=-np.inf)
>>> x.fill_value
-inf
>>> x.fill_value = np.pi
>>> x.fill_value
3.1415926535897931 # may vary

Сброс к значению по умолчанию:

>>> x.fill_value = None
>>> x.fill_value
1e+20

MaskedArray.baseclass: Класс базового данных (только для чтения).

MaskedArray.sharedmask: Статус совместного использования маски (только для чтения).

MaskedArray.hardmask: Жесткость маски

Так как MaskedArray является подклассом ndarray, массив с маской также наследует все атрибуты и свойства экземпляра ndarray.

`MaskedArray.base`	Базовый объект, если память взята из другого объекта.
`MaskedArray.ctypes`	Объект для упрощения взаимодействия массива с модулем ctypes.
`MaskedArray.dtype`	Тип данных элементов массива.
`MaskedArray.flags`	Информация о расположении памяти массива.
`MaskedArray.itemsize`	Длина одного элемента массива в байтах.
`MaskedArray.nbytes`	Общее количество байтов, занимаемых элементами массива.
`MaskedArray.ndim`	Количество измерений массива.
`MaskedArray.shape`	Кортеж измерений массива.
`MaskedArray.size`	Количество элементов в массиве.
`MaskedArray.strides`	Кортеж байтов, которые нужно пропустить в каждом измерении при обходе массива.
`MaskedArray.imag`	Мнимая часть маскированного массива.

`MaskedArray.real`	Вещественная часть маскированного массива.
`MaskedArray.flat`	Возвращает итератор в плоском формате, или устанавливает плоскую версию self в значение.
`MaskedArray.__array_priority__`

Методы MaskedArray

См. также

Методы массивов

Преобразование

`MaskedArray.__float__`(self)	Преобразование в тип float.
`MaskedArray.__int__`(self)	Преобразование в тип int.
`MaskedArray.view`(self[, dtype, type, fill_value])	Возвращает представление данных MaskedArray.
`MaskedArray.astype`(dtype[, order, casting, …])	Копия массива, преобразованная к указанному типу.
`MaskedArray.byteswap`([inplace])	Перестановка байтов элементов массива
`MaskedArray.compressed`(self)	Возвращает все немаскированные данные как массив 1D.
`MaskedArray.filled`(self[, fill_value])	Возвращает копию self, с замененными значениями маски на заданное значение.
`MaskedArray.tofile`(self, fid[, sep, format])	Сохранение MaskedArray в файл в двоичном формате.
`MaskedArray.toflex`(self)	Преобразование MaskedArray в массив гибкого типа.
`MaskedArray.tolist`(self[, fill_value])	Возвращает часть данных MaskedArray в виде иерархического списка Python.

`MaskedArray.torecords`(self)	Преобразует массив с пропусками в массив гибкого типа.
`MaskedArray.tostring`(self[, fill_value, order])	Псевдоним совместимости для `tobytes`, с абсолютно таким же поведением.
`MaskedArray.tobytes`(self[, fill_value, order])	Возвращает данные массива в виде строки, содержащей сырые байты массива.

Изменение формы

Для reshape, resize и transpose единственный кортеж аргумент может быть заменён на n целые числа, которые будут интерпретированы как n-кортеж.

`MaskedArray.flatten`([order])	Возвращает копию массива, сжатого в одном измерении.
`MaskedArray.ravel`(self[, order])	Возвращает 1D версию self в виде представления.
`MaskedArray.reshape`(self, \s, \\*kwargs)	Придает новый вид массиву без изменения его данных.
`MaskedArray.resize`(self, newshape[, …])
`MaskedArray.squeeze`([axis])	Удаляет одномерные элементы из формы `a`.
`MaskedArray.swapaxes`(axis1, axis2)	Возвращает представление массива с переставленными `axis1` и `axis2`.
`MaskedArray.transpose`(*axes)	Возвращает представление массива с переставленными осями.
`MaskedArray.T`

Выборка и преобразование элементов

Для методов массива, принимающих параметр axis, значение по умолчанию равно None. Если ось равна None, то массив обрабатывается как одномерный. Любое другое значение для axis обозначает измерение, вдоль которого должно выполняться операция.

`MaskedArray.argmax`(self[, axis, fill_value, out])	Возвращает массив индексов максимальных значений по заданной оси.
`MaskedArray.argmin`(self[, axis, fill_value, out])	Возвращает массив индексов минимальных значений по заданной оси.
`MaskedArray.argsort`(self[, axis, kind, …])	Возвращает массив индексов, сортирующих массив по указанной оси.
`MaskedArray.choose`(choices[, out, mode])	Использует массив индексов для построения нового массива из набора выборов.
`MaskedArray.compress`(self, condition[, …])	Возвращает `a`, где условие является `True`.
`MaskedArray.diagonal`([offset, axis1, axis2])	Возвращает указанные диагонали.
`MaskedArray.fill`(value)	Заполняет массив скалярным значением.
`MaskedArray.item`(*args)	Копирует элемент массива в стандартный скалярный тип Python и возвращает его.
`MaskedArray.nonzero`(self)	Возвращает индексы немаскированных элементов, которые не равны нулю.
`MaskedArray.put`(self, indices, values[, mode])	Устанавливает значения в указанных позициях по индексам.

`MaskedArray.repeat`(repeats[, axis])	Повторяет элементы массива.
`MaskedArray.searchsorted`(v[, side, sorter])	Находит индексы, где элементы v должны быть вставлены в массив a, чтобы сохранить порядок.
`MaskedArray.sort`(self[, axis, kind, order, …])	Сортирует массив на месте.
`MaskedArray.take`(self, indices[, axis, out, …])

Сериализация и копирование

`MaskedArray.copy`([order])	Возвращает копию массива.
`MaskedArray.dump`(file)	Сохраняет сериализованную копию массива в указанный файл.
`MaskedArray.dumps`()	Возвращает сериализованную копию массива в виде строки.

Вычисления

`MaskedArray.all`(self[, axis, out, keepdims])	Возвращает True, если все элементы равны True.
`MaskedArray.anom`(self[, axis, dtype])	Вычисляет аномалии (отклонения от арифметического среднего) по заданной оси.
`MaskedArray.any`(self[, axis, out, keepdims])	Возвращает True, если любой из элементов `a` равен True.
`MaskedArray.clip`([min, max, out])	Возвращает массив, значения которого ограничены `[min, max]`.
`MaskedArray.conj`()	Комплексно сопрягает все элементы.
`MaskedArray.conjugate`()	Возвращает комплексно сопряжённое значение, поэлементно.
`MaskedArray.cumprod`(self[, axis, dtype, out])	Возвращает кумулятивное произведение элементов массива по заданной оси.
`MaskedArray.cumsum`(self[, axis, dtype, out])	Возвращает кумулятивную сумму элементов массива по заданной оси.
`MaskedArray.max`(self[, axis, out, …])	Возвращает максимальное значение по заданной оси.
`MaskedArray.mean`(self[, axis, dtype, out, …])	Возвращает среднее значение элементов массива по заданной оси.

`MaskedArray.min`(self[, axis, out, …])	Возвращает минимальное значение по заданной оси.
`MaskedArray.prod`(self[, axis, dtype, out, …])	Возвращает произведение элементов массива по заданной оси.
`MaskedArray.product`(self[, axis, dtype, …])	Возвращает произведение элементов массива по заданной оси.
`MaskedArray.ptp`(self[, axis, out, …])	Возвращает (максимум - минимум) по заданному измерению (т.е.
`MaskedArray.round`(self[, decimals, out])	Возвращает каждый элемент, округлённый до заданного числа десятичных знаков.
`MaskedArray.std`(self[, axis, dtype, out, …])	Возвращает стандартное отклонение элементов массива по заданной оси.
`MaskedArray.sum`(self[, axis, dtype, out, …])	Возвращает сумму элементов массива по заданной оси.
`MaskedArray.trace`([offset, axis1, axis2, …])	Возвращает сумму по диагоналям массива.
`MaskedArray.var`(self[, axis, dtype, out, …])	Вычисляет дисперсию по заданной оси.

Арифметические и сравнительные операции

Операторы сравнения:

`MaskedArray.__lt__`(self, value, /)	Возвращает self<value.
`MaskedArray.__le__`(self, value, /)	Возвращает self<=value.
`MaskedArray.__gt__`(self, value, /)	Возвращает self>value.
`MaskedArray.__ge__`(self, value, /)	Возвращает self>=value.
`MaskedArray.__eq__`(self, other)	Проверяет, равны ли элементы other и self.
`MaskedArray.__ne__`(self, other)	Проверяет, не равны ли элементы other и self.

Логическое значение массива (`bool`):

MaskedArray.__bool__(self, /)

self != 0

Арифметика:

`MaskedArray.__abs__`(self)
`MaskedArray.__add__`(self, other)	Прибавить self к other и вернуть новую маску.
`MaskedArray.__radd__`(self, other)	Прибавить other к self и вернуть новую маску.
`MaskedArray.__sub__`(self, other)	Вычесть other из self и вернуть новую маску.
`MaskedArray.__rsub__`(self, other)	Вычесть self из other и вернуть новую маску.
`MaskedArray.__mul__`(self, other)	Умножить self на other и вернуть новую маску.
`MaskedArray.__rmul__`(self, other)	Умножить other на self и вернуть новую маску.
`MaskedArray.__div__`(self, other)	Разделить self на other и вернуть новую маску.
`MaskedArray.__truediv__`(self, other)	Разделить self на other и вернуть новую маску.
`MaskedArray.__rtruediv__`(self, other)	Разделить other на self и вернуть новую маску.

`MaskedArray.__floordiv__`(self, other)	Разделить other на self и вернуть новый массив с масками.
`MaskedArray.__rfloordiv__`(self, other)	Разделить self на other и вернуть новый массив с масками.
`MaskedArray.__mod__`(self, value, /)	Возвращает self%value.
`MaskedArray.__rmod__`(self, value, /)	Возвращает value%self.
`MaskedArray.__divmod__`(self, value, /)	Возвращает divmod(self, value).
`MaskedArray.__rdivmod__`(self, value, /)	Возвращает divmod(value, self).
`MaskedArray.__pow__`(self, other)	Возвести self в степень other, маскируя потенциальные NaN/бесконечности.
`MaskedArray.__rpow__`(self, other)	Возвести other в степень self, маскируя потенциальные NaN/бесконечности.
`MaskedArray.__lshift__`(self, value, /)	Возвращает self<<value.
`MaskedArray.__rlshift__`(self, value, /)	Возвращает value<<self.

`MaskedArray.__rshift__`(self, value, /)	Возвращает self>>value.
`MaskedArray.__rrshift__`(self, value, /)	Возвращает value>>self.
`MaskedArray.__and__`(self, value, /)	Возвращает self&value.
`MaskedArray.__rand__`(self, value, /)	Возвращает value&self.
`MaskedArray.__or__`(self, value, /)	Возвращает self\|value.
`MaskedArray.__ror__`(self, value, /)	Возвращает value\|self.
`MaskedArray.__xor__`(self, value, /)	Возвращает self^value.
`MaskedArray.__rxor__`(self, value, /)	Возвращает value^self.

Арифметика, по месту:

`MaskedArray.__iadd__`(self, other)	Добавить other к self на месте.
`MaskedArray.__isub__`(self, other)	Вычесть other из self на месте.
`MaskedArray.__imul__`(self, other)	Умножить self на other на месте.
`MaskedArray.__idiv__`(self, other)	Разделить self на other на месте.
`MaskedArray.__itruediv__`(self, other)	Разделить self на other с плавающей точкой на месте.
`MaskedArray.__ifloordiv__`(self, other)	Целочисленное деление self на other на месте.
`MaskedArray.__imod__`(self, value, /)	Возвращает self%=value.
`MaskedArray.__ipow__`(self, other)	Возвести self в степень other на месте.
`MaskedArray.__ilshift__`(self, value, /)	Возвращает self<<=value.
`MaskedArray.__irshift__`(self, value, /)	Возвращает self>>=value.

`MaskedArray.__iand__`(self, value, /)	Возвращает self&=value.
`MaskedArray.__ior__`(self, value, /)	Возвращает self\|=value.
`MaskedArray.__ixor__`(self, value, /)	Возвращает self^=value.

Представление

`MaskedArray.__repr__`(self)	Буквальное строковое представление.
`MaskedArray.__str__`(self)	Возвращает str(self).
`MaskedArray.ids`(self)	Возвращает адреса областей данных и маски.
`MaskedArray.iscontiguous`(self)	Возвращает булево значение, указывающее, являются ли данные непрерывными.

Специальные методы

Для функций стандартной библиотеки:

`MaskedArray.__copy__`()	Используется, если для массива вызывается `copy.copy`.
`MaskedArray.__deepcopy__`(self[, memo])	Используется, если для массива вызывается `copy.deepcopy`.
`MaskedArray.__getstate__`(self)	Возвращает внутреннее состояние маскированного массива для целей сериализации.
`MaskedArray.__reduce__`(self)	Возвращает тройку для сериализации MaskedArray.
`MaskedArray.__setstate__`(self, state)	Восстанавливает внутреннее состояние маскированного массива для целей сериализации.

Базовая настройка:

`MaskedArray.__new__`(cls[, data, mask, …])	Создает новый маскированный массив с нуля.
`MaskedArray.__array__`()	Возвращает либо новую ссылку на self, если dtype не задан, либо новый массив заданного типа данных, если dtype отличается от текущего типа данных массива.
`MaskedArray.__array_wrap__`(self, obj[, context])	Специальный обработчик для ufunc.

Настройка контейнера: (см. Индексирование)

`MaskedArray.__len__`(self, /)	Возвращает длину self.
`MaskedArray.__getitem__`(self, indx)	x.__getitem__(y) <==> x[y]
`MaskedArray.__setitem__`(self, indx, value)	x.__setitem__(i, y) <==> x[i]=y
`MaskedArray.__delitem__`(self, key, /)	Удалить self[key].
`MaskedArray.__contains__`(self, key, /)	Возвращает key в self.

Specific methods

Handling the mask

Following methods can be used to access mask information or manipulate the mask.

`MaskedArray.__setmask__`(self, mask[, copy])	Установить маску.
`MaskedArray.harden_mask`(self)	Зафиксировать маску как жёсткую.
`MaskedArray.soften_mask`(self)	Зафиксировать маску как мягкую.
`MaskedArray.unshare_mask`(self)	Скопировать маску и установить флаг sharedmask в False.
`MaskedArray.shrink_mask`(self)	Сжать маску до nomask, когда это возможно.

Обработка значения заполнения

`MaskedArray.get_fill_value`(self)	Значение заполнения маскированного массива — скаляр.
`MaskedArray.set_fill_value`(self[, value])

Подсчёт отсутствующих элементов

MaskedArray.count(self[, axis, keepdims])

Подсчёт элементов, не помеченных как маскированные, в массиве вдоль заданной оси.

© 2005–2020 NumPy Developers
Licensed under the 3-clause BSD License.
https://numpy.org/doc/1.19/reference/maskedarray.baseclass.html

Постоянные модуля numpy.ma

Класс MaskedArray

Атрибуты и свойства массивных массивов

Примеры

Методы MaskedArray

Преобразование

Изменение формы

Выборка и преобразование элементов

Сериализация и копирование

Вычисления

Арифметические и сравнительные операции

Операторы сравнения:

Логическое значение массива (bool):

Арифметика:

Арифметика, по месту:

Представление

Специальные методы

Specific methods

Handling the mask

Обработка значения заполнения

Подсчёт отсутствующих элементов

Логическое значение массива (`bool`):