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'})

Но если массивы имеют разные метаданные типа данных, метаданные могут быть удалены:

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