numpy.ma.empty#
- ma.empty(shape, dtype=float, order='C', *, device=None, like=None) = <numpy.ma.core._convert2ma object>#
返回给定形状和类型的新数组,而不初始化条目.
- 参数:
- shapeint 或 int 元组
空数组的形状,例如,
(2, 3)或2.- dtypedata-type,可选
数组所需的输出数据类型,例如
numpy.int8.默认为numpy.float64.- order{‘C’, ‘F’},可选,默认值:’C’
是以行优先(C 风格)还是列优先(Fortran 风格)顺序在内存中存储多维数据.
- devicestr, optional
放置创建的数组的设备.默认值:
None.仅用于 Array-API 互操作性,因此如果传递,则必须为"cpu".在 2.0.0 版本加入.
- likearray_like, optional
参考对象以允许创建非NumPy数组的数组. 如果作为
like传入的类数组支持__array_function__协议,则结果将由它定义. 在这种情况下,它可以确保创建与通过此参数传入的数组对象兼容的数组对象.在 1.20.0 版本加入.
- 返回:
- outMaskedArray
具有给定形状,dtype 和顺序的未初始化(任意)数据的数组.对象数组将初始化为 None.
参见
empty_like返回一个具有输入形状和类型的空数组.
ones返回一个将所有值设置为 1 的新数组.
zeros返回一个将所有值设置为零的新数组.
full返回一个给定形状并用指定值填充的新数组.
注释
与其他数组创建函数(例如
zeros,ones, full )不同,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