Python numpy dtype.metadata用法及代码示例

本文简要介绍 python 语言中 numpy.dtype.metadata 的用法。

用法:

dtype.metadata

None 或元数据的只读字典(mappingproxy)。

元数据字段可以在数据类型创建时使用任何字典进行设置。 NumPy 目前没有统一的方法来传播元数据；尽管某些数组操作会保留它，但不能保证其他操作也会保留它。

警告

尽管在某些项目中使用过，但该函数长期以来一直没有记录，并且没有得到很好的支持。元数据传播的某些方面预计会在未来发生变化。

例子：

>>> dt = np.dtype(float, metadata={"key": "value"})
>>> dt.metadata["key"]
'value'
>>> arr = np.array([1, 2, 3], dtype=dt)
>>> arr.dtype.metadata
mappingproxy({'key': 'value'})

添加具有相同数据类型的数组当前会保留元数据：

>>> (arr + arr).dtype.metadata
mappingproxy({'key': 'value'})

但如果数组具有不同的 dtype 元数据，则可能会删除元数据：

>>> dt2 = np.dtype(float, metadata={"key2": "value2"})
>>> arr2 = np.array([3, 2, 1], dtype=dt2)
>>> (arr + arr2).dtype.metadata is None
True  # The metadata field is cleared so None is returned