numpy.ma.empty#

ma.empty(shape, dtype=float, order='C', *, device=None, like=None) = <numpy.ma.core._convert2ma object>#

返回一个具有给定形状和类型的新数组,而不初始化条目.

参数:
shapeint 或 int 的元组

空数组的形状,例如 (2, 3)2.

dtype数据类型, 可选

数组所需的输出数据类型,例如 numpy.int8.默认是 numpy.float64.

order{‘C’, ‘F’}, 可选, 默认: ‘C’

是否将多维数据在内存中按行主序(C 风格)或列主序(Fortran 风格)存储.

devicestr, 可选

要放置创建数组的设备.默认值:None.仅用于数组API互操作性,因此如果传递,必须为``”cpu”``.

在 2.0.0 版本加入.

likearray_like, 可选

引用对象以允许创建不是 NumPy 数组的数组.如果作为 like 传递的类数组对象支持 __array_function__ 协议,结果将由它定义.在这种情况下,它确保创建一个与此参数传递的对象兼容的数组对象.

在 1.20.0 版本加入.

返回:
outMaskedArray

给定形状、数据类型和顺序的未初始化(任意)数据的数组.对象数组将被初始化为 None.

参见

empty_like

返回一个形状和类型与输入相同的空数组.

ones

返回一个新数组,将值设置为一.

zeros

返回一个将值设置为零的新数组.

full

返回一个给定形状并用值填充的新数组.

备注

与其他数组创建函数(例如 zerosonesfull)不同,`empty` 不会初始化数组的值,因此可能会稍微快一些.然而,新分配的数组中存储的值是任意的.为了确保可重复的行为,请在读取之前设置数组的每个元素.

示例

>>> import numpy as np
>>> np.empty([2, 2])
array([[ -9.74499359e+001,   6.69583040e-309],
       [  2.13182611e-314,   3.06959433e-309]])         #uninitialized
>>> np.empty([2, 2], dtype=int)
array([[-1073741821, -1067949133],
       [  496041986,    19249760]])                     #uninitialized