mean

固定小数点配列の平均値

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

構文

M = mean(A)
M = mean(A,dim)

説明

M = mean(A) は、大きさが 1 でない最初の次元に沿って実数値固定小数点配列 A の平均値を計算します。

例

M = mean(A,dim) は、次元 dim に沿って実数値固定小数点配列 A の平均値を計算します。dim は傾きが 2 のべき乗でバイアスが 0 の正の実数値整数でなければなりません。

固定小数点出力配列 M は固定小数点入力配列 A と同じ numerictype プロパティをもちます。

入力配列 A にローカル fimath がある場合、中間計算に使用されます。出力 M は常に既定の fimath に関連付けられています。

A が空の固定小数点配列 (値 = []) である場合、出力配列の値はゼロです。

例

例

すべて折りたたむ

行列を作成して各列の平均値を計算します。A は符号付き fi オブジェクトで、語長は 32 ビット、小数部の長さは最高精度の 28 ビットです。

A = fi([0 1 2; 3 4 5],1,32);
M = mean(A)
A = 

     0     1     2
     3     4     5

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 32
        FractionLength: 28

M = 

    1.5000    2.5000    3.5000

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 32
        FractionLength: 28

行列を作成して各行の平均値を計算します。A は符号付き fi オブジェクトで、語長は 32 ビット、小数部の長さは最高精度の 28 ビットです。

A = fi([0 1 2; 3 4 5],1,32)
M = mean(A,2)
A = 

     0     1     2
     3     4     5

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 32
        FractionLength: 28

M = 

     1
     4

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 32
        FractionLength: 28

入力引数

すべて折りたたむ

入力配列。ベクトル、行列または多次元配列として指定します。

  • A がスカラーの場合、mean(A) は A を返します。

  • A が空の固定小数点配列 (値 = []) である場合、出力配列の値はゼロです。

データ型: fi

動作する対象の次元。傾きが 2 のべき乗でバイアスが 0 の正の実数値整数スカラーとして指定します。値を指定しない場合、既定値は、サイズが 1 ではない最初の配列の次元です。

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

アルゴリズム

配列 A の mean を次元 dim 全体で計算するための一般方程式は、以下のとおりです。

sum(A,dim)/size(A,dim)

size(a,dim) は常に正の整数であるので、平均値を計算するためのこのアルゴリズムは size(A,dim) を小数部の長さが 0 の符号なし 32 ビット fi オブジェクトにキャストします (この fi オブジェクトを 'SizeA' と表します)。次に、以下の式に従って A の平均値を計算します。ここで、Tx は固定小数点入力配列 A の numerictype プロパティです。

c = Tx.divide(sum(A,dim), SizeA)

拡張機能

すべて展開する

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

バージョン履歴

R2010a で導入

参考

| |