Spec-Zone.ru › NumPy 1.12

numpy.ndarray.flags

ndarray.flags

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

Примечания

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

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

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

  • UPDATEIFCOPY может быть установлен только 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) Данные и все элементы правильно выровнены для оборудования.
UPDATEIFCOPY (U) Этот массив является копией другого массива. Когда этот массив удаляется, базовый массив будет обновлен содержимым этого массива.
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.

© 2008–2016 NumPy Developers
Licensed under the NumPy License.
https://docs.scipy.org/doc/numpy-1.10.1/reference/generated/numpy.ndarray.flags.html

Spec-Zone.ru

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