realsqrt

非負の実数配列の平方根

構文

Y = realsqrt(X)

説明

Y = realsqrt(X) は、配列 X の各要素の平方根を返します。Y のサイズは、X と同じサイズです。

負の数および複素数の場合に、エラー メッセージを返すのではなく複素数の結果を返すようにするには、sqrt を代わりに使用します。

X が table または timetable の場合、Y は table または timetable です。 (R2023a 以降)

例

行列要素の平方根

正の実数値の 4 行 4 列の行列を作成します。

X = magic(4)

X = 4×4

    16     2     3    13
     5    11    10     8
     9     7     6    12
     4    14    15     1

X の各要素の平方根を計算します。

Y = realsqrt(X)

Y = 4×4

    4.0000    1.4142    1.7321    3.6056
    2.2361    3.3166    3.1623    2.8284
    3.0000    2.6458    2.4495    3.4641
    2.0000    3.7417    3.8730    1.0000

入力引数

X — 入力

スカラー | ベクトル | 行列 | 多次元配列 | table | timetable

入力。スカラー、ベクトル、行列、多次元配列、table または timetable として指定します。X の値は非負の実数でなければなりません。

データ型: single | double | table | timetable

拡張機能

tall 配列

メモリの許容量を超えるような多数の行を含む配列を計算します。

realsqrt 関数は tall 配列を完全にサポートしています。詳細については、tall 配列を参照してください。

C/C++ コード生成
MATLAB® Coder™ を使用して C および C++ コードを生成します。

GPU コード生成
GPU Coder™ を使用して NVIDIA® GPU のための CUDA® コードを生成します。

スレッドベースの環境

MATLAB® の backgroundPool を使用してバックグラウンドでコードを実行するか、Parallel Computing Toolbox™ の ThreadPool を使用してコードを高速化します。

realsqrt 関数はスレッドベースの環境を完全にサポートしています。詳細については、スレッドベースの環境での MATLAB 関数の実行を参照してください。

GPU 配列

Parallel Computing Toolbox™ を使用してグラフィックス処理装置 (GPU) 上で実行することにより、コードを高速化します。

realsqrt 関数は、GPU 配列を完全にサポートします。GPU 上で関数を実行するには、入力データを gpuArray (Parallel Computing Toolbox) として指定します。詳細については、GPU での MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

分散配列

Parallel Computing Toolbox™ を使用して、クラスターの結合メモリ上で大きなアレイを分割します。

realsqrt 関数は分散配列を完全にサポートしています。詳細については、分散配列を使用した MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

バージョン履歴

R2006a より前に導入

R2023a: table および timetable で直接計算を実行

関数 realsqrt は、table または timetable 内のすべての変数に対して、それらの変数にアクセスするためのインデックス付けを行うことなく計算できます。すべての変数のデータ型で計算がサポートされている必要があります。詳細については、table および timetable での直接計算を参照してください。

参考

reallog | realpow | sqrt | sqrtm