numpy.ma.empty#

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

傳回一個具有給定形狀和類型的新陣列，但不初始化條目。

參數:
shapeint 或整數元組

空陣列的形狀，例如，(2, 3) 或 2。

dtype資料類型，選用

陣列所需的輸出資料類型，例如 numpy.int8。預設值為 numpy.float64。

order{‘C’, ‘F’}, 選用, 預設值: ‘C’

是否以 row-major (C 風格) 或 column-major (Fortran 風格) 順序儲存多維資料在記憶體中。

device字串，選用

要將建立的陣列放置在哪個裝置上。預設值：None。僅用於陣列 API 互操作性，因此如果傳遞，則必須為 "cpu"。

在版本 2.0.0 中新增。

like類陣列，選用

參考物件，允許建立非 NumPy 陣列的陣列。如果作為 like 傳入的類陣列支援 __array_function__ 協議，則結果將由其定義。在這種情況下，它確保建立一個與透過此參數傳入的物件相容的陣列物件。

在版本 1.20.0 中新增。

傳回值:
outMaskedArray

具有給定形狀、dtype 和順序的未初始化（任意）資料的陣列。物件陣列將初始化為 None。

另請參閱

empty_like

傳回一個具有與輸入相同形狀和類型的空陣列。

ones

傳回一個將值設定為一的新陣列。

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
在此頁面上