Постоянные модуля 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 используется внутри для ускорения вычислений, когда маска не нужна.

numpy.ma.masked_print_options

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

Класс MaskedArray

class numpy.ma.MaskedArray [source]

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

Экземпляр MaskedArray можно представить как комбинацию нескольких элементов:

• Данные data, как обычный numpy.ndarray любой формы или типа данных (сами данные).
• Булевый массив mask с той же формой, что и данные, где значение True указывает, что соответствующий элемент данных недопустим. Специальное значение nomask также допустимо для массивов без именованных полей и указывает, что данные не недопустимы.
• Значение заполнения fill_value, которое может использоваться для замены недопустимых элементов для получения стандартного numpy.ndarray.

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

MaskedArray.data

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

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

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

MaskedArray.mask

Возвращает базу маску, как массив с той же формой и структурой, что и данные, но где все поля атомарно являются булевыми. Значение True указывает на недопустимый элемент.

MaskedArray.recordmask

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

>>> x = 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

Возвращает значение, используемое для заполнения недопустимых элементов маскированного массива. Значение является скаляром (если у массива нет именованных полей), или 0-мерным массивом с тем же dtype, что и маскированный массив, если у него есть именованные поля.

Значение заполнения по умолчанию зависит от типа данных массива:

Тип данных	Значение по умолчанию
bool	True
int	999999
float	1.e20
complex	1.e20+0j
object	‘?’
string	‘N/A’

MaskedArray.baseclass

Возвращает класс базовых данных.

>>> x =  ma.array(np.matrix([[1, 2], [3, 4]]), mask=[[0, 0], [1, 0]])
>>> x.baseclass
<class 'numpy.matrixlib.defmatrix.matrix'>

MaskedArray.sharedmask

Возвращает, разделена ли маска массива между несколькими массивами. Если это так, любые изменения в маске одного массива будут распространяться на другие.

MaskedArray.hardmask

Возвращает, является ли маска жесткой (True) или мягкой (False). При жесткой маске замаскированные записи нельзя размаскировать.

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

Методы MaskedArray

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

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

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

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

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

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

Вычисления

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

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

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

Арифметика:

Арифметические операции на месте:

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

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

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

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

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

Методы

Обработка маски

Следующие методы можно использовать для доступа к информации о маске или для изменения маски.

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

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