張量形狀、儲存與 NumPy 差異

System.Numerics.Tensors 套件提供 Tensor<T>、TensorSpan<T> 和 ReadOnlyTensorSpan<T>,用於多維資料。 張量形狀描述邏輯維度;步幅描述了各維度上連續位置之間的元素距離。

此處描述的行為隨套件提供,並適用於其支援的所有目標框架。 更新套件可能會影響針對較早期 .NET 版本的應用程式。

這些類型與 NumPy 有許多相同的慣例,但兩者不能互相替代。 在移植演算法時,請考慮以下差異。

空形狀與類似純量的結果

當你從空形狀([])建立張量且沒有底層資料時,張量的形狀為 [0],且沒有元素。 在 NumPy 中,shape () 秩為零,包含一個純量元素。 特別地, np.empty(()) 分配一個未初始化值的標量;「空」並不代表它沒有元素。

相較之下,當你省略現有資料上的 tensor-span 建構函式中的長度時,建構函式會從所提供的陣列或 span 推斷出一維形狀。

當你壓縮一個形狀為 [1, 1]的張量時,結果會有形狀 [1],而不是 NumPy 的秩零形狀 ()。 兩個結果都包含一個元素,且可以作為純量廣播,但檢查階數、選擇軸或索引結果的程式碼必須考慮保留的維度。

當省略步幅時,任何包含零長度維度的形狀在每個維度中步幅為零。 其元素數量與所需儲存空間均為零,無論其他維度長度如何。 負長度仍無效。 明確指定的跨距仍必須符合版面配置驗證。

步幅與反轉數據

步幅必須為非負值。 NumPy 可以用負步幅表示反向視圖,例如 array[::-1]。

若要反轉第一個軸,則呼叫 0,並將維度設為 Tensor.ReverseDimension:

using System.Numerics.Tensors;

Tensor<int> source = Tensor.Create(new[] { 1, 2, 3, 4 }, new nint[] { 2, 2 });
Tensor<int> reversed = Tensor.ReverseDimension<int>(source.AsReadOnlyTensorSpan(), 0);

reversed 的邏輯元素為 [3, 4, 1, 2]。 會配置記憶體的多載版本會產生新的張量;這並非對原始儲存空間的負步幅視圖。

調整張量大小

Tensor.Resize 和 Tensor.ResizeTo 使用 default(T) 填充新增的邏輯元素。 例如,若你將 [1, 2] 擴增至五個 int 元素,結果包含 [1, 2, 0, 0, 0]。 NumPy np.resize 則會重複輸入並產生 [1, 2, 1, 2, 1]。

若目的位置較小,則該操作會捨棄超出目的位置邏輯元素計數的元素。 如果它較大,即使目的元素之間有空隙,操作也會初始化剩餘的邏輯目的元件。 邏輯目的地以外的儲存不包含在調整大小作業中。

Tensor.ResizeTo 以及串接到現有目的地的操作會拒絕包含多個邏輯元素的零步幅維度。 這樣的維度會導致多個輸出位置指向同一儲存空間,無法容納彼此不同的輸出值。 單一維度中的零步幅和空的目標不會造成這種衝突。

重疊的來源與目的地

不同的張量物件與跨度可以指同一陣列中重疊的區域。 支援的情況取決於操作方式與版面配置:

作業 支援的重疊
CopyTo 與 TryCopyTo 來源與目標密集且元素數量相等,或視圖完全相同。 密集複製使用重疊安全的區段複製。
FlattenTo 與 TryFlattenTo 密集的來源與目標範圍。
帶有目的地的元素間運算 輸入與輸出起始參考、長度與步幅相同,前提是視圖沒有重複的邏輯儲存位置。 每個輸入都會獨立檢查。
Tensor.ResizeTo 精簡的來源與目的地。 不支援的跨步重疊會被拒絕。
反轉至同一檢視 密集檢視可以就地反轉。 也支援無操作沖銷。

其他不支援的重疊配置會在操作寫入輸出前ArgumentException拋出錯誤。 僅靠稠密張量並不保證每個操作都支援:例如,複製作業支援移位的稠密目的地,但元素層操作則不支援。

當目標緩衝區空間不足時,TryCopyTo 和 TryFlattenTo 方法會回傳 false 而不複製。 TryCopyTo 對於不相容的來源與目的形狀,也會有回傳 false 。 對於具有足夠目的容量的相容形狀,這些方法仍可因不支援的重疊而擲回例外;Try 不會抑制無效配置例外。

例如,以下的跨步來源與稠密目標重疊:

int[] storage = { 1, 2, 3, 4, 5, 6 };
ReadOnlyTensorSpan<int> source = new(storage, new nint[] { 2, 2 }, new nint[] { 3, 1 });
TensorSpan<int> destination = new(storage, new nint[] { 2, 2 });

要從這個不支援的重疊版面配置複製,首先將快照擷取到獨立儲存體中:

int[] snapshot = new int[checked((int)source.FlattenedLength)];
source.FlattenTo(snapshot);
ReadOnlyTensorSpan<int> independentSource = new(snapshot, source.Lengths);
independentSource.CopyTo(destination);

快照包含 [1, 2, 4, 5]。 副本會將這些元素寫入目的地,且在讀取前不會更改原始值。

對於接受目標作為參數的逐元素運算,在寫入輸出前,為每個重疊的輸入分配一個獨立的結果張量或快照。 對於具有重複儲存位置的廣播目的地,則改用獨立輸出儲存;輸入快照並不代表目的地能儲存各自不同的值。

函式庫並不會隱含地分配全張量快照來支援任意重疊的布局。 不重疊的跨步複製不需要那種暫時儲存。

也請參閱