numpy.lib.format.write_array#

lib.format.write_array(fp, array, version=None, allow_pickle=True, pickle_kwargs=None)[source]#

Write an array to an NPY file, including a header.

If the array is neither C-contiguous nor Fortran-contiguous AND the file_like object is not a real file object, this function will have to copy data in memory.

Parameters
fpfile_like object

An open, writable file object, or similar object with a .write() method.

arrayndarray

The array to write to disk.

version(int, int) or None, optional

The version number of the format. None means use the oldest supported version that is able to store the data. Default: None

allow_picklebool, optional

Whether to allow writing pickled data. Default: True

pickle_kwargsdict, optional

Additional keyword arguments to pass to pickle.dump, excluding ‘protocol’. These are only useful when pickling objects in object arrays on Python 3 to Python 2 compatible format.

Raises
ValueError

If the array cannot be persisted. This includes the case of allow_pickle=False and array being an object array.

Various other errors

If the array contains Python objects as part of its dtype, the process of pickling them may raise various errors if the objects are not picklable.