gather

GPU からの Statistics and Machine Learning Toolbox オブジェクトのプロパティの収集

ページ内をすべて折りたたむ

    構文

    gatheredObj = gather(obj)
    [gatheredObj1,gatheredObj2,...,gatheredObjn] = gather(obj1,obj2,...,objn)

    説明

    gatheredObj = gather(obj) は、入力オブジェクト obj のすべてのプロパティを収集し、収集されたオブジェクト gatheredObj を返します。出力オブジェクトのすべてのプロパティは、ローカル ワークスペースに格納されます。

    gather を使用して、GPU 配列として格納されたデータを使用して当てはめられたオブジェクトから、ローカル ワークスペースに格納されたプロパティをもつ Statistics and Machine Learning Toolbox™ オブジェクトを作成します。GPU 配列の詳細については、gpuArray (Parallel Computing Toolbox) を参照してください。GPU の使用には、Parallel Computing Toolbox™ およびサポートされている GPU デバイスが必要です。サポートされているデバイスの詳細については、GPU 計算の要件 (Parallel Computing Toolbox)を参照してください。

    例

    [gatheredObj1,gatheredObj2,...,gatheredObjn] = gather(obj1,obj2,...,objn) は、複数のオブジェクト obj1,obj2,...,objn のプロパティを収集し、対応する収集オブジェクト gatheredObj1,gatheredObj2,...,gatheredObjn を返します。入力引数と出力引数の数は一致しなければなりません。

    例

    例

    すべて折りたたむ

    この例では次を使用します。

    ライブ スクリプトを開く

    GPU 配列データで当てはめられた線形回帰モデルのプロパティを収集します。

    carsmall データ セットを読み込みます。車両の 3 つのパフォーマンス メトリクスを格納する数値行列として X を作成します。ガロンあたりの走行マイル数を格納する数値ベクトルとして Y を作成します。

    load carsmall
X = [Weight,Horsepower,Acceleration];
Y = MPG;

    予測子 X および応答 Y をgpuArray (Parallel Computing Toolbox)オブジェクトに変換します。

    X = gpuArray(X);
Y = gpuArray(Y);

    fitlm を使用して、線形回帰モデル mdl を当てはめます。 

    mdl = fitlm(X,Y);

    mdl の係数を表示し、推定された係数値が GPU 配列であるかどうかを判定します。

    mdl.Coefficients
    ans=4×4 table
                    Estimate        SE          tStat        pValue  
                   __________    _________    _________    __________

    (Intercept)        47.977       3.8785        12.37    4.8957e-21
    x1             -0.0065416    0.0011274      -5.8023    9.8742e-08
    x2              -0.042943     0.024313      -1.7663       0.08078
    x3              -0.011583      0.19333    -0.059913       0.95236


    isgpuarray(mdl.Coefficients.Estimate)
    ans = logical
   1

    線形回帰モデルのプロパティを収集します。 

    gatheredMdl = gather(mdl);

    gatheredMdl の係数を表示し、推定された係数値が GPU 配列であるかどうかを判定します。

    gatheredMdl.Coefficients
    ans=4×4 table
                    Estimate        SE          tStat        pValue  
                   __________    _________    _________    __________

    (Intercept)        47.977       3.8785        12.37    4.8957e-21
    x1             -0.0065416    0.0011274      -5.8023    9.8742e-08
    x2              -0.042943     0.024313      -1.7663       0.08078
    x3              -0.011583      0.19333    -0.059913       0.95236


    isgpuarray(gatheredMdl.Coefficients.Estimate)
    ans = logical
   0

    この例では次を使用します。

    ライブ スクリプトを開く

    線形回帰モデルと k 最近傍分類器のプロパティを収集します。どちらのモデルも GPU 配列データを使用して当てはめられています。

    carsmall データ セットを読み込みます。車両の 3 つのパフォーマンス メトリクスを格納する数値行列として X を作成し、予測子 X を gpuArray オブジェクトに変換します。

    load carsmall
X = [Weight,Horsepower,Acceleration];
X = gpuArray(X);

    MPG (ガロンあたりの走行マイル数) の線形回帰モデルを予測子 X の関数として当てはめます。

    mdlLinear = fitlm(X,MPG);

    3 最近傍分類器を予測子 X とクラス Cylinders を使用して学習させます。非カテゴリカル予測子データを標準化します。

    mdlKNN = fitcknn(X,Cylinders,'NumNeighbors',3,'Standardize',1);

    mdLinear モデルと mdlKNN モデルのプロパティを収集します。

    [gMdlLinear,gMdlKNN] = gather(mdlLinear,mdlKNN);

    回帰モデル mdlLinear に対するダービン・ワトソン検定の p 値が GPU 配列であるかどうかを判定します。

    isgpuarray(dwtest(mdlLinear))
    ans = logical
   1

    収集した回帰モデル gMdlLinear に対するダービン・ワトソン検定の p 値が GPU 配列であるかどうかを判定します。

    isgpuarray(dwtest(gMdlLinear))
    ans = logical
   0

    分類器 mdlKNN の再代入損失が GPU 配列であるかどうかを判定します。

    isgpuarray(resubLoss(mdlKNN))
    ans = logical
   1

    収集した分類器 gMdlKNN の再代入損失が GPU 配列であるかどうかを判定します。

    isgpuarray(resubLoss(gMdlKNN))
    ans = logical
   1

    入力引数

    すべて折りたたむ

    GPU 配列または gpuArray オブジェクトを使用して当てはめられたオブジェクト。回帰モデル オブジェクト、分類モデル オブジェクト、確率分布オブジェクト、cvpartition オブジェクト、または gpuArray (Parallel Computing Toolbox) オブジェクトを指定します。gpuArray オブジェクトは GPU に格納されている配列を表します。

    gather がサポートする Statistics and Machine Learning Toolbox オブジェクトの詳細については、サポートされている回帰モデル、サポートされている分類モデル、およびサポートされている確率分布オブジェクトを参照してください。

    詳細

    すべて折りたたむ

    ヒント

    • GPU 配列は収集にコストがかかる場合があり、GPU 配列をサポートしない関数で結果を使用する必要がない限り、通常は必要ありません。GPU 配列を受け入れる Statistics and Machine Learning Toolbox の関数の完全な一覧については、関数リスト (GPU 配列) を参照してください。

    • gather は、分散配列や対話型分散配列、tall 配列など他のデータ型にも呼び出すことができます。データ型が収集をサポートしていない場合、gather は無効です。

    拡張機能

    すべて展開する

    バージョン履歴

    R2020b で導入

    すべて展開する

    参考

    (Parallel Computing Toolbox) | (Parallel Computing Toolbox) | | | | | | | | | | | | | | |

    トピック