numpy.dtype.metadata#

attribute

dtype.metadata#

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

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

警告

虽然在某些项目中使用,但此功能长期以来没有文档记录,并且没有得到很好的支持. 元数据传播的某些方面预计将来会发生变化.

示例

>>> import numpy as np
>>> 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)
>>> print((arr + arr2).dtype.metadata)
{'key': 'value'}