numpy.recarray.flags

recarray.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.