ホーム › AI.MachineLearning.DirectML › DML_SCATTER_OPERATOR_DESC
DML_SCATTER_OPERATOR_DESC
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| InputTensor | DML_TENSOR_DESC* | 8/4 | +0 | +0 | 読み取り元のテンソルです。 |
| IndicesTensor | DML_TENSOR_DESC* | 8/4 | +8 | +4 | 出力テンソルに対するインデックスを格納するテンソルです。Sizes は、Axis を除くすべての次元で InputTensor.Sizes と一致していなければなりません。
|
| UpdatesTensor | DML_TENSOR_DESC* | 8/4 | +16 | +8 | 対応するインデックスの位置にある既存の入力値を置き換える、新しい値を格納するテンソルです。このテンソルの Sizes は IndicesTensor.Sizes と一致していなければなりません。DataType は InputTensor.DataType と一致していなければなりません。 |
| OutputTensor | DML_TENSOR_DESC* | 8/4 | +24 | +12 | 結果を書き込むテンソルです。このテンソルの Sizes と DataType は InputTensor と一致していなければなりません。 |
| Axis | DWORD | 4 | +32 | +16 | OutputTensor 内でのインデックス指定に使用する軸の次元です。範囲は [0, OutputTensor.DimensionCount) です。 |
公式ドキュメント
入力テンソル全体を出力にコピーし、選択されたインデックスの位置を updates テンソルの対応する値で上書きします。この演算子は、次の疑似コードの処理を実行します。
output = input
output[index[i, j, k, ...], j, k, ...] = updates[i, j, k, ...] // if axis == 0
output[i, index[i, j, k, ...], k, ...] = updates[i, j, k, ...] // if axis == 1
output[i, j, index[i, j, k, ...], ...] = updates[i, j, k, ...] // if axis == 2
...
2 つの出力要素のインデックスが重複する場合(これは無効です)、最後にどの書き込みが反映されるかは保証されません。
DML_SCATTER_OPERATOR_DESC は DML_GATHER_OPERATOR_DESC の逆の演算です。
解説(Remarks)
DML_SCATTER_OPERATOR_DESC は、DML_GATHER_ELEMENTS_OPERATOR_DESC の適切な対応物として、より適切な名前である DML_SCATTER_ELEMENTS_OPERATOR_DESC にエイリアスされています。これは、DML_SCATTER_OPERATOR_DESC が DML_GATHER_OPERATOR_DESC と実際には対称ではなかったためです。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// DML_SCATTER_OPERATOR_DESC (x64 40 / x86 20 バイト)
typedef struct DML_SCATTER_OPERATOR_DESC {
DML_TENSOR_DESC* InputTensor;
DML_TENSOR_DESC* IndicesTensor;
DML_TENSOR_DESC* UpdatesTensor;
DML_TENSOR_DESC* OutputTensor;
DWORD Axis;
} DML_SCATTER_OPERATOR_DESC;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DML_SCATTER_OPERATOR_DESC
{
public IntPtr InputTensor;
public IntPtr IndicesTensor;
public IntPtr UpdatesTensor;
public IntPtr OutputTensor;
public uint Axis;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DML_SCATTER_OPERATOR_DESC
Public InputTensor As IntPtr
Public IndicesTensor As IntPtr
Public UpdatesTensor As IntPtr
Public OutputTensor As IntPtr
Public Axis As UInteger
End Structureimport ctypes
from ctypes import wintypes
class DML_SCATTER_OPERATOR_DESC(ctypes.Structure):
_fields_ = [
("InputTensor", ctypes.c_void_p),
("IndicesTensor", ctypes.c_void_p),
("UpdatesTensor", ctypes.c_void_p),
("OutputTensor", ctypes.c_void_p),
("Axis", wintypes.DWORD),
]#[repr(C)]
pub struct DML_SCATTER_OPERATOR_DESC {
pub InputTensor: *mut core::ffi::c_void,
pub IndicesTensor: *mut core::ffi::c_void,
pub UpdatesTensor: *mut core::ffi::c_void,
pub OutputTensor: *mut core::ffi::c_void,
pub Axis: u32,
}import "golang.org/x/sys/windows"
type DML_SCATTER_OPERATOR_DESC struct {
InputTensor uintptr
IndicesTensor uintptr
UpdatesTensor uintptr
OutputTensor uintptr
Axis uint32
}type
DML_SCATTER_OPERATOR_DESC = record
InputTensor: Pointer;
IndicesTensor: Pointer;
UpdatesTensor: Pointer;
OutputTensor: Pointer;
Axis: DWORD;
end;const DML_SCATTER_OPERATOR_DESC = extern struct {
InputTensor: ?*anyopaque,
IndicesTensor: ?*anyopaque,
UpdatesTensor: ?*anyopaque,
OutputTensor: ?*anyopaque,
Axis: u32,
};type
DML_SCATTER_OPERATOR_DESC {.bycopy.} = object
InputTensor: pointer
IndicesTensor: pointer
UpdatesTensor: pointer
OutputTensor: pointer
Axis: uint32struct DML_SCATTER_OPERATOR_DESC
{
void* InputTensor;
void* IndicesTensor;
void* UpdatesTensor;
void* OutputTensor;
uint Axis;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; DML_SCATTER_OPERATOR_DESC サイズ: 20 バイト(x86)
dim st, 5 ; 4byte整数×5(構造体サイズ 20 / 4 切り上げ)
; InputTensor : DML_TENSOR_DESC* (+0, 4byte) varptr(st)+0 を基点に操作(4byte:入れ子/配列)
; IndicesTensor : DML_TENSOR_DESC* (+4, 4byte) varptr(st)+4 を基点に操作(4byte:入れ子/配列)
; UpdatesTensor : DML_TENSOR_DESC* (+8, 4byte) varptr(st)+8 を基点に操作(4byte:入れ子/配列)
; OutputTensor : DML_TENSOR_DESC* (+12, 4byte) varptr(st)+12 を基点に操作(4byte:入れ子/配列)
; Axis : DWORD (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DML_SCATTER_OPERATOR_DESC サイズ: 40 バイト(x64)
dim st, 10 ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; InputTensor : DML_TENSOR_DESC* (+0, 8byte) varptr(st)+0 を基点に操作(8byte:入れ子/配列)
; IndicesTensor : DML_TENSOR_DESC* (+8, 8byte) varptr(st)+8 を基点に操作(8byte:入れ子/配列)
; UpdatesTensor : DML_TENSOR_DESC* (+16, 8byte) varptr(st)+16 を基点に操作(8byte:入れ子/配列)
; OutputTensor : DML_TENSOR_DESC* (+24, 8byte) varptr(st)+24 を基点に操作(8byte:入れ子/配列)
; Axis : DWORD (+32, 4byte) st.8 = 値 / 値 = st.8 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global DML_SCATTER_OPERATOR_DESC
#field intptr InputTensor
#field intptr IndicesTensor
#field intptr UpdatesTensor
#field intptr OutputTensor
#field int Axis
#endstruct
stdim st, DML_SCATTER_OPERATOR_DESC ; NSTRUCT 変数を確保
st->Axis = 100
mes "Axis=" + st->Axis