ドキュメンテーション センター

  • 評価版
  • 製品アップデート

最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

構文

  • B = cumprod(A)
  • B = cumprod(A,dim)

説明

B = cumprod(A) は、累積積を含む、配列 A と同じサイズの配列を返します。

  • A がベクトルの場合、cumprod(A) は、A. の要素の累積積を含むベクトルを返します。

  • A が行列の場合、cumprod(A) は、A の各列の累積積を含む行列を返します。

  • A が多次元配列の場合、関数 cumprod(A) は、最初の大きさが 1 でない次元に沿って機能します。

B = cumprod(A,dim) は、次元 dim に沿って累積積を返します。たとえば、A が行列の場合、cumprod(A,2) は、各行の累積積を返します。

すべて展開する

ベクトルの累積積

1 から 5 までの整数の累積積を求めます。

A = [1:5];
B = cumprod(A)
B =

     1     2     6    24   120

B(2) は、A(1)A(2) の積です。一方、B(5) は、A(1) から A(5) までの要素の積です。

行列内の各列の累積積

要素が線形インデックスに対応している 3 行 3 列の行列を定義します。

A = [1 4 7; 2 5 8; 3 6 9]
A =

     1     4     7
     2     5     8
     3     6     9

A の列の累積積を求めます。

B = cumprod(A)
B =

     1     4     7
     2    20    56
     6   120   504

B(5) は、A(4)A(5) の積です。一方、B(9) は、A(7)A(8) および A(9) の積です。

行列内の各行の累積積

要素が線形インデックスに対応している 2 行 3 列の行列を定義します。

A = [1 3 5; 2 4 6]
A =

     1     3     5
     2     4     6

A の行の累積積を求めます。

B = cumprod(A,2)
B =

     1     3    15
     2     8    48

B(3) は、A(1)A(3) の積です。一方、B(5) は、A(1)A(3) および A(5) の積です。

double の出力をもつ論理入力

論理値の配列を作成します。

A = [true false true; true true false]
A =

     1     0     1
     1     1     0

A の行の累積積を求めます。

B = cumprod(A,2)
B =

     1     0     0
     1     1     0

出力は double です。

class(B)
ans =

double

入力引数

すべて展開する

A - 入力配列ベクトル | 行列 | 多次元配列

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

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

dim - 動作する対象の次元正の整数スカラー

動作する対象の次元。正の整数のスカラーとして指定します。値が指定されていない場合、既定値はサイズが 1 ではない最初の配列次元です。

2 次元の入力配列 A について考えます。

  • cumprod(A,1) は、A に沿って実行され、各列の累積積を返します。

  • cumprod(A,2) は、A の列に沿って実行され、各行の累積積を返します。

dimndims(A) より大きい場合、cumprodA を返します。

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

出力引数

すべて展開する

B - 累積積の配列ベクトル | 行列 | 多次元配列

累積積の配列。入力配列 A と同じサイズのベクトル、行列または多次元配列として返されます。

B のクラスは A のクラスと同じです。ただし、Alogical の場合、Bdouble です。

詳細

すべて展開する

最初の大きさが 1 でない次元

最初の大きさが 1 でない次元 (nonsingleton dimension) は、サイズが 1 に等しくない配列の最初の次元を表します。

たとえば、以下の場合です。

  • X が 1 行 n 列の行ベクトルの場合、2 番目の次元は X の最初の大きさが 1 でない次元になります。

  • X が 1 x 0 x n の空配列の場合、2 番目の次元は X の最初の大きさが 1 でない次元になります。

  • X が 1 x 1 x 3 の配列の場合、3 番目の次元は X の最初の大きさが 1 でない次元になります。

参考

| |

この情報は役に立ちましたか?