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

bounds

最小要素と最大要素

構文

[S,L] = bounds(A)

[S,L] = bounds(A,'all')

[S,L] = bounds(A,dim)

[S,L] = bounds(A,vecdim)

[S,L] = bounds(___,nanflag)

説明

[S,L] = bounds(A) は、配列の最小要素 S と最大要素 L を返します。S は min(A) と等価で、L は max(A) と等価です。

[S,L] = bounds(A,'all') は、A のすべての要素から最小値と最大値を計算します。

[S,L] = bounds(A,dim) は、A の次元 dim に沿って処理します。たとえば、A が行列の場合、bounds(A,2) は各行の最小要素と最大要素を含む列ベクトル S と L を返します。

[S,L] = bounds(A,vecdim) は、ベクトル vecdim で指定された次元に基づいて最小値と最大値を計算します。たとえば、A が行列の場合、bounds(A,[1 2]) は A のすべての要素の最小値と最大値を返します。行列のすべての要素が、次元 1 と次元 2 で定義された配列スライスに含まれるためです。

[S,L] = bounds(___,nanflag) は、最小要素と最大要素を求めるときに NaN 値を含めるか除外するかを指定します。bounds(A,'omitnan') は NaN 値を無視します。A のいずれかの要素が NaN である場合、bounds(A,'includenan') は S と L の両方に対して NaN を返します。既定の動作は、'omitnan' です。

例

ベクトルの最小要素と最大要素

ベクトルの最小値と最大値を同時に計算します。

A = [2 4 -1 10 6 3 0 -16];
[S,L] = bounds(A)

S = -16

L = 10

行列の行の最小要素と最大要素

行列の各行の最小要素と最大要素を計算します。

A = magic(4)

A = 4×4

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

[S,L] = bounds(A,2)

S = 4×1

     2
     5
     6
     1

L = 4×1

    16
    11
    12
    15

配列ページの範囲

3 次元配列を作成して、各ページのデータ (行および列) の最小値と最大値を計算します。

A(:,:,1) = [2 4; -2 1];
A(:,:,2) = [9 13; -5 7];
A(:,:,3) = [4 4; 8 -3];
[S1,L1] = bounds(A,[1 2]);
S1

S1 = 
S1(:,:,1) =

    -2


S1(:,:,2) =

    -5


S1(:,:,3) =

    -3

L1

L1 = 
L1(:,:,1) =

     4


L1(:,:,2) =

    13


L1(:,:,3) =

     8

配列のすべての次元の範囲を計算するには、ベクトルの次元引数で各次元を指定することも、'all' オプションを使用することもできます。

[S2,L2] = bounds(A,[1 2 3])

S2 = -5

L2 = 13

[Sall,Lall] = bounds(A,'all')

Sall = -5

Lall = 13

NaN 値を含むベクトル

NaN 要素を無視する場合と、含めた場合のそれぞれについて、ベクトルの最大値と最小値を計算します。

ベクトルの最大値と最小値を計算するときに、NaN 値を無視します。これは既定の設定です。

A = [2 NaN 6 -5 0 NaN 10];
[S,L] = bounds(A)

S = -5

L = 10

'includenan' オプションを使用して NaN 値を含めます。これにより、bounds は A の最大値と最小値の両方に NaN を返します。

[S,L] = bounds(A,'includenan')

S = NaN

L = NaN

入力引数

A — 入力配列

ベクトル | 行列 | 多次元配列

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

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

dim — 演算の対象の次元

正の整数スカラー

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

行列 A を考えます。

• bounds(A,1) は各列の最小値と最大値を計算します。

  

• bounds(A,2) は各行の最小値と最大値を計算します。

  

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

vecdim — 次元のベクトル

正の整数のベクトル

次元のベクトル。正の整数のベクトルとして指定します。各要素は入力配列の次元を表します。指定された操作次元の出力の長さは 1 で、その他は同じままです。

2 x 3 x 3 の入力配列 A を考えます。この場合、[S,L] = bounds(A,[1 2]) は S と L の両方に 1 x 1 x 3 の配列を返します。S と L の要素は、それぞれ A の対応するページの最小値と最大値です。

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

nanflag — NaN の条件

'omitnan' (既定値) | 'includenan'

NaN の条件。次の値のいずれかとして指定します。

• 'omitnan' — 入力にあるすべての NaN 値を無視します。入力に NaN 値のみが含まれる場合、bounds は S と L の両方に対して NaN を返します。

• 'includenan' — NaN 値を含めます。入力のいずれかの要素が NaN である場合、bounds は S と L の両方に NaN を返します。

出力引数

S — 最小要素

ベクトル | 行列 | 多次元配列

最小要素。ベクトル、行列または多次元配列として指定します。

L — 最大要素

ベクトル | 行列 | 多次元配列

最大要素。ベクトル、行列または多次元配列として指定します。

拡張機能

tall 配列

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

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

GPU 配列

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

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

分散配列

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

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

参考

max | min

R2017a で導入