numpy.matrix.setflags#

方法

matrix.setflags(write=None, align=None, uic=None)#

分别设置数组标志 WRITEABLE、ALIGNED、WRITEBACKIFCOPY。

这些布尔值标志影响 numpy 如何解释 a 使用的内存区域(参见下面的注释)。ALIGNED 标志只能设置为 True,如果数据实际上是根据类型对齐的。WRITEBACKIFCOPY 标志永远不能设置为 True。WRITEABLE 标志只能设置为 True,如果数组拥有自己的内存,或者内存的最终所有者公开了一个可写的缓冲区接口,或者是一个字符串。(字符串的例外是为了使反序列化能够在不复制内存的情况下完成。)

参数:
write可选,布尔值

描述 a 是否可以写入。

align可选,布尔值

描述 a 是否为其类型正确对齐。

uic可选,布尔值

描述 a 是否是另一个“基础”数组的副本。

注释

数组标志提供有关用于数组的内存区域如何解释的信息。共有 7 个布尔值标志,其中只有 3 个可以由用户更改:WRITEBACKIFCOPY、WRITEABLE 和 ALIGNED。

WRITEABLE (W) 数据区域可以写入;

ALIGNED (A) 数据和步长对于硬件来说是适当地对齐的(由编译器决定);

WRITEBACKIFCOPY (X) 此数组是另一个数组(由 .base 引用)的副本。当 C-API 函数 PyArray_ResolveWritebackIfCopy 被调用时,基础数组将使用此数组的内容进行更新。

所有标志可以使用单个(大写)字母以及完整名称来访问。

示例

>>> import numpy as np
>>> y = np.array([[3, 1, 7],
...               [2, 0, 0],
...               [8, 5, 9]])
>>> y
array([[3, 1, 7],
       [2, 0, 0],
       [8, 5, 9]])
>>> y.flags
  C_CONTIGUOUS : True
  F_CONTIGUOUS : False
  OWNDATA : True
  WRITEABLE : True
  ALIGNED : True
  WRITEBACKIFCOPY : False
>>> y.setflags(write=0, align=0)
>>> y.flags
  C_CONTIGUOUS : True
  F_CONTIGUOUS : False
  OWNDATA : True
  WRITEABLE : False
  ALIGNED : False
  WRITEBACKIFCOPY : False
>>> y.setflags(uic=1)
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
ValueError: cannot set WRITEBACKIFCOPY flag to True