coder.gpu.iterations

変数範囲ループの並列化を判定するための情報をコードジェネレーターに提供するプラグマ

構文

coder.gpu.iterations(AVG_NUM_ITER)

説明

coder.gpu.iterations(AVG_NUM_ITER) プラグマは、その直後の可変範囲 for ループの平均反復回数 (AVG_NUM_ITER) を指定するために使用できます。この値は、不完全なループでの並列化の判定に対してヒューリスティックな方法を提供するために使用されます。このプラグマは固定範囲 for ループには効果がありません。

これはコード生成関数です。MATLAB^® では効果がありません。

例

すべて折りたたむ

単純な入れ子にされたループでの `coder.gpu.iterations` の使用

この例では、coder.gpu.iterations プラグマを使用して、並列化の決定を行うためにコードジェネレーターで使用される情報を拡張する方法を説明します。

単純な入れ子にされたループが含まれる次の MATLAB エントリポイント関数 myFun について考えます。

function [a, c] = myFun(b, N1)

coder.gpu.kernelfun();
a = coder.nullcopy(zeros(1, N1));
c = coder.nullcopy(b);

for i = 1:N1             % Loop1
    a(i) = 1;
    
    for j = 1:20          % Loop2
        c(i,j) = 2 * b(i,j);
    end
end

end

この場合、Loop 1 は、コードジェネレーターによる外側のループ Loop 1 の並列化を妨げる不完全なループです。

coder.gpu.iterations プラグマを使用してエントリポイント関数を変更し、ループで実行する必要のある平均反復回数をコードジェネレーターに通知します。

function [a, c] = myFun(b, N1)

coder.gpu.kernelfun();
a = coder.nullcopy(zeros(1, N1));
c = coder.nullcopy(b);

coder.gpu.iterations(25); % AVG_NUM_ITER
for i = 1:N1             % Loop1
    a(i) = 1;
    
    for j = 1:20          % Loop2
        c(i,j) = 2 * b(i,j);
    end
end

end

N1 の値に関係なく、Loop 1 は AVG_NUM_ITER > 20 (Loop2 の範囲) の場合に並列化されます。