numpy.lib.npyio.NpzFile

classnumpy.lib.npyio.NpzFile(fid)[source]

Объект, подобный словарю, с отложенной загрузкой файлов в архиве zip, предоставленном при создании.

NpzFile используется для загрузки файлов в формате архива данных NumPy .npz. Предполагается, что файлы в архиве имеют расширение .npy, другие файлы игнорируются.

Массивы и строковые данные файлов загружаются лениво при доступе по индексу, используя obj['key'] или по имени атрибута, используя obj.f.key. Список всех файлов (без расширения .npy) можно получить с помощью obj.files, а сам объект ZipFile — с помощью obj.zip.

Параметры:

fidfile, str, или pathlib.Path

Архив zip для открытия. Это либо объект типа «поток файла», либо строка с путем к архиву.

own_fidbool, необязательно

Следует ли объекту NpzFile закрывать дескриптор файла. Требуется, чтобы fid был объектом типа «поток файла».

Примеры

>>> from tempfile import TemporaryFile
>>> outfile = TemporaryFile()
>>> x = np.arange(10)
>>> y = np.sin(x)
>>> np.savez(outfile, x=x, y=y)
>>> _ = outfile.seek(0)

>>> npz = np.load(outfile)
>>> isinstance(npz, np.lib.npyio.NpzFile)
True
>>> npz
NpzFile 'object' with keys: x, y
>>> sorted(npz.files)
['x', 'y']
>>> npz['x']  # getitem access
array([0, 1, 2, 3, 4, 5, 6, 7, 8, 9])
>>> npz.f.x  # attribute lookup
array([0, 1, 2, 3, 4, 5, 6, 7, 8, 9])

Атрибуты:

filesсписок строк

Список всех файлов в архиве с расширением .npy.

zipэкземпляр ZipFile

Объект ZipFile, инициализированный архивом zip.

fэкземпляр BagObj

Объект, к которому можно обращаться по атрибутам, как альтернатива доступу по индексу к экземпляру NpzFile.

allow_picklebool, необязательно

Разрешить загрузку закодированных данных. Значение по умолчанию: False

Изменено в версии 1.16.3: По умолчанию установлено значение False в ответ на CVE-2019-6446.

pickle_kwargsсловарь, необязательно

Дополнительные ключевые аргументы для передачи в pickle.load. Они полезны только при загрузке массивов объектов, сохраненных в Python 2 при использовании Python 3.

max_header_sizeint, необязательно

Максимально допустимый размер заголовка. Большие заголовки могут быть небезопасны для загрузки и поэтому требуют явного указания большего значения. См. ast.literal_eval для получения подробной информации. Этот параметр игнорируется при передаче allow_pickle. В этом случае файл по определению является надёжным, и ограничение не требуется.

Методы

close()	Закрыть файл.
get(key[, default])	D.get(k,[,d]) возвращает D[k], если k в D, иначе d.
items()	D.items() возвращает объект, подобный множеству, предоставляющий представление элементов.
keys()	D.keys() возвращает объект, подобный множеству, предоставляющий представление ключей.
values()	D.values() возвращает объект, подобный множеству, предоставляющий представление значений.