Spec-Zone.ru › NumPy 1.19

numpy.ndarray.flags

атрибут

ndarray.flags

Информация о структуре хранения данных массива.

Примечания

К объекту flags можно получить доступ, как к словарю (как в a.flags['WRITEABLE']), или используя имена атрибутов в нижнем регистре (как в a.flags.writeable). Короткое имя флага поддерживается только при доступе по ключу словаря.

Только флаги WRITEBACKIFCOPY, UPDATEIFCOPY, WRITEABLE и ALIGNED могут быть изменены пользователем путём прямого присваивания атрибуту или элементу словаря, или вызовом ndarray.setflags.

Флаги массива не могут быть установлены произвольно:

  • UPDATEIFCOPY может быть установлен только False.
  • WRITEBACKIFCOPY может быть установлен только False.
  • ALIGNED может быть установлен только True если данные действительно выровнены.
  • WRITEABLE может быть установлен только True если массив владеет своей памятью или конечный владелец памяти предоставляет интерфейс записи или представляет собой строку.

Массивы могут быть одновременно C-стилевыми и Fortran-стилевыми.

Даже для непрерывных массивов шаг для данного измерения arr.strides[dim] может быть произвольным, если arr.shape[dim] == 1 или массив не имеет элементов. Не всегда верно, что self.strides[-1] == self.itemsize для непрерывных массивов C-стиля или self.strides[0] == self.itemsize для непрерывных массивов Fortran-стиля.

Атрибуты
C_CONTIGUOUS (C)

Данные находятся в одном непрерывном сегменте C-стиля.

F_CONTIGUOUS (F)

Данные находятся в одном непрерывном сегменте Fortran-стиля.

OWNDATA (O)

Массив владеет используемой памятью или заимствует её от другого объекта.

WRITEABLE (W)

Область данных может быть записана. Установка в значение False блокирует данные, делая их только для чтения. Вид (срез и т. д.) наследует WRITEABLE от базового массива во время создания, но вид записываемого массива может быть заблокирован, в то время как базовый массив остается записываемым. (Обратное неверно, так как вид заблокированного массива не может быть сделан записываемым. Однако в настоящее время блокировка базового объекта не блокирует какие-либо представления, которые уже ссылаются на него, поэтому в этом случае можно изменить содержимое заблокированного массива с помощью ранее созданного записываемого вида.) Попытка изменить не записываемый массив вызывает исключение RuntimeError.

ALIGNED (A)

Данные и все элементы должным образом выровнены для аппаратного обеспечения.

WRITEBACKIFCOPY (X)

Этот массив является копией некоторого другого массива. Функция C-API PyArray_ResolveWritebackIfCopy должна быть вызвана перед освобождением, чтобы базовый массив был обновлён содержимым этого массива.

UPDATEIFCOPY (U)

(Устарело, используйте WRITEBACKIFCOPY) Этот массив является копией некоторого другого массива. При освобождении этого массива базовый массив будет обновлён содержимым этого массива.

FNC

F_CONTIGUOUS и не C_CONTIGUOUS.

FORC

F_CONTIGUOUS или C_CONTIGUOUS (тест на один сегмент).

BEHAVED (B)

ALIGNED и WRITEABLE.

CARRAY (CA)

BEHAVED и C_CONTIGUOUS.

FARRAY (FA)

BEHAVED и F_CONTIGUOUS и не C_CONTIGUOUS.

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

Spec-Zone.ru

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