power, .^

固定小数点の要素単位のべき乗

構文

C = A.^B

C = power(A, B)

説明

C = A.^B は A の各要素に対して、B の対応するべき乗を計算します。

C = power(A, B) は A.^B を計算するための代替方法です。

例

行列の各要素のスカラーべき乗計算

固定小数点の行列を作成し、スカラーのべき乗を計算します。

A = fi([1, 3; 4, 2])

A = 
     1     3
     4     2

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 16
        FractionLength: 12

C = A.^3

C = 
     1    27
    64     8

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 48
        FractionLength: 36

入力引数

A — ベース

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

基数。スカラー、ベクトル、行列または多次元配列として指定します。入力 A および B は、同じサイズであるか、または互換性のあるサイズ (たとえば、A が M 行 N 列の行列で、B がスカラーまたは 1 行 N 列の行ベクトルである) をもっていなければなりません。

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | fi
複素数のサポート: あり

B — 指数

スカラー

指数。非負の実数の整数値スカラーとして指定されます。

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | fi

出力引数

C — べき乗

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

べき乗。入力 A と同じ次元をもつ配列として返されます。A にローカル fimath オブジェクトがある場合は、出力の C にも同じローカル fimath オブジェクトがあります。配列のべき乗演算は、必ず既定の fimath 設定を使用して実行されます。

拡張機能

C/C++ コード生成

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

使用に関するメモと制限:

• 指数 B が変数である場合、制御側 fimath の ProductMode プロパティは SpecifyPrecision でなければなりません。

HDL コード生成

HDL Coder™ を使用して FPGA 設計および ASIC 設計のための VHDL、Verilog および SystemVerilog のコードを生成します。

どちらの入力もスカラーでなければならず、また指数の入力 B は整数の定数でなければなりません。

バージョン履歴

R2010a で導入

R2021a: power, .^ への fi 入力で数値の精度と生成コードの効率が向上

Fixed-Point Designer™ で、関数 power への固定小数点入力について、シミュレーションと生成コードにおける数値の精度が向上しました。さらに、生成コードの効率も向上しています。

参考

power | mpower