bounds

배열의 최솟값과 최댓값

구문

[minA,maxA] = bounds(A)

[minA,maxA] = bounds(A,"all")

[minA,maxA] = bounds(A,dim)

[minA,maxA] = bounds(A,vecdim)

[minA,maxA] = bounds(___,missingflag)

설명

[minA,maxA] = bounds(A)는 배열의 최솟값 minA와 최댓값 maxA를 반환합니다. minA는 min(A)와 같고 maxA는 max(A)와 같습니다.

[minA,maxA] = bounds(A,"all")은 A의 모든 요소에 대해 최솟값과 최댓값을 구합니다.

[minA,maxA] = bounds(A,dim)은 A의 차원 dim을 따라 동작합니다. 예를 들어, A가 행렬이면 bounds(A,2)는 각 행의 최솟값과 최댓값을 포함한 열 벡터 minA와 maxA를 반환합니다.

[minA,maxA] = bounds(A,vecdim)은 벡터 vecdim에 지정된 차원을 기준으로 최솟값과 최댓값을 구합니다. 예를 들어, A가 행렬인 경우 bounds(A,[1 2])는 차원 1과 2로 정의된 배열 슬라이스에 행렬의 모든 요소가 포함되어 있으므로 A의 모든 요소 중 최솟값과 최댓값을 반환합니다.

[minA,maxA] = bounds(___,missingflag)는 위에 열거된 구문에 대해 A의 누락값을 생략할지 또는 포함할지 여부를 지정합니다. 예를 들어, bounds(A,"missingflag")는 최솟값과 최댓값을 구할 때 모든 누락값을 포함합니다. 기본적으로 bounds는 누락값을 생략합니다.

예제

벡터의 최솟값과 최댓값

벡터의 최솟값과 최댓값을 동시에 구합니다.

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

minA = 
-16

maxA = 
10

행렬 행의 최솟값과 최댓값

행렬의 각 행에서 최솟값과 최댓값을 구합니다.

A = magic(4)

A = 4×4

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

[minA,maxA] = bounds(A,2)

minA = 4×1

     2
     5
     6
     1

maxA = 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];
[minA1,maxA1] = bounds(A,[1 2]);
minA1

minA1 = 
minA1(:,:,1) =

    -2


minA1(:,:,2) =

    -5


minA1(:,:,3) =

    -3

maxA1

maxA1 = 
maxA1(:,:,1) =

     4


maxA1(:,:,2) =

    13


maxA1(:,:,3) =

     8

배열의 모든 차원에 대해 경계값을 계산하려면 벡터 차원 인수에 각 차원을 지정하거나 "all" 옵션을 사용할 수 있습니다.

[minA2,maxA2] = bounds(A,[1 2 3])

minA2 = 
-5

maxA2 = 
13

[minAall,maxAall] = bounds(A,"all")

minAall = 
-5

maxAall = 
13

누락값을 포함한 경계값

NaN 값이 포함된 행렬을 만듭니다.

A = [2 NaN 6 -5; 0 3 NaN 9]

A = 2×4

     2   NaN     6    -5
     0     3   NaN     9

NaN 값을 포함하여 행렬의 최솟값과 최댓값을 구합니다. NaN 값이 포함된 행렬 열의 경우 최솟값과 최댓값은 NaN입니다.

[minA,maxA] = bounds(A,"includenan")

minA = 1×4

     0   NaN   NaN    -5

maxA = 1×4

     2   NaN   NaN     9

입력 인수

A — 입력 배열

벡터 | 행렬 | 다차원 배열 | 테이블 | 타임테이블

입력 배열로, 벡터, 행렬, 다차원 배열, table형 또는 timetable형으로 지정됩니다.

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | categorical | datetime | duration | table | timetable
복소수 지원 여부: 예

dim — 연산을 수행할 차원

양의 정수 스칼라

연산을 수행할 차원으로, 양의 정수 스칼라로 지정됩니다. 차원을 지정하지 않을 경우, 디폴트 값은 크기가 1이 아닌 첫 번째 배열 차원이 됩니다.

m×n 입력 행렬 A가 있다고 가정합니다.

• bounds(A,1)은 A의 각 열의 최솟값과 최댓값을 구하고, 두 개의 1×n 행 벡터를 반환합니다.

  

• bounds(A,2)는 A의 각 행의 최솟값과 최댓값을 구하고, 두 개의 m×1 열 벡터를 반환합니다.

  

vecdim — 차원의 벡터

양의 정수로 구성된 벡터

차원의 벡터로, 양의 정수로 구성된 벡터로 지정됩니다. 각 요소는 입력 배열의 차원을 나타냅니다. 지정된 연산 차원의 출력값의 길이는 1이고, 다른 모든 차원의 길이는 변경되지 않습니다.

2×3×3 입력 배열 A가 있다고 가정하겠습니다. [minA,maxA] = bounds(A,[1 2])는 minA와 maxA 모두에 대해 1×1×3 배열을 반환합니다. minA와 maxA의 요소들은 각각 A의 대응하는 페이지에 있는 최솟값과 최댓값입니다.

missingflag — 누락값 조건

"omitmissing" (디폴트 값) | "omitnan" | "omitnat" | "omitundefined" | "includemissing" | "includenan" | "includenat" | "includeundefined"

누락값 조건으로, 다음 표에 있는 값 중 하나로 지정됩니다.

값	입력 데이터형	설명
"omitmissing"	지원되는 모든 데이터형	입력 배열의 누락값을 무시하고, 더 적은 수의 점을 대상으로 최솟값과 최댓값을 구합니다. 연산 차원의 모든 요소가 누락된 경우 minA와 maxA의 대응하는 요소가 누락됩니다.
"omitnan"	double, single, duration
"omitnat"	datetime
"omitundefined"	categorical
"includemissing"	지원되는 모든 데이터형	최솟값과 최댓값을 구할 때 입력 배열의 누락값을 포함합니다. 연산 차원의 요소가 하나라도 누락값인 경우 minA와 maxA의 대응하는 요소도 누락값입니다.
"includenan"	double, single, duration
"includenat"	datetime
"includeundefined"	categorical

출력 인수

minA — 최솟값

벡터 | 행렬 | 다차원 배열 | 테이블

최솟값으로, 벡터, 행렬, 다차원 배열 또는 테이블로 반환됩니다.

maxA — 최댓값

벡터 | 행렬 | 다차원 배열 | 테이블

최댓값으로, 벡터, 행렬, 다차원 배열 또는 테이블로 지정됩니다.

확장 기능

tall형 배열

메모리에 담을 수 없을 정도로 많은 행을 가진 배열을 계산할 수 있습니다.

bounds 함수는 tall형 배열을 완전히 지원합니다. 자세한 내용은 tall형 배열 항목을 참조하십시오.

C/C++ 코드 생성
MATLAB® Coder™를 사용하여 C 코드나 C++ 코드를 생성할 수 있습니다.

스레드 기반 환경

MATLAB®의 backgroundPool을 사용해 백그라운드에서 코드를 실행하거나 Parallel Computing Toolbox™의 ThreadPool을 사용해 코드 실행 속도를 높일 수 있습니다.

이 함수는 스레드 기반 환경을 완전히 지원합니다. 자세한 내용은 스레드 기반 환경에서 MATLAB 함수 실행하기 항목을 참조하십시오.

GPU 배열

Parallel Computing Toolbox™를 사용해 GPU(그래픽스 처리 장치)에서 실행하여 코드 실행 속도를 높일 수 있습니다.

bounds 함수는 GPU 배열을 완전히 지원합니다. GPU에서 이 함수를 실행하려면 입력 데이터를 gpuArray (Parallel Computing Toolbox)로 지정하십시오. 자세한 내용은 GPU에서 MATLAB 함수 실행하기 (Parallel Computing Toolbox) 항목을 참조하십시오.

분산 배열

Parallel Computing Toolbox™를 사용하여 대규모 배열을 클러스터의 결합된 메모리에 걸쳐 분할할 수 있습니다.

이 함수는 분산 배열을 완전히 지원합니다. 자세한 내용은 분산 배열을 사용하여 MATLAB 함수 실행 (Parallel Computing Toolbox) 항목을 참조하십시오.

버전 내역

R2017a에 개발됨

R2023a: 누락값 조건 지정

최솟값과 최댓값을 구할 때 "omitmissing" 또는 "includemissing" 옵션을 사용하여 입력 배열의 누락값을 생략하거나 포함합니다. 이전에는 "omitnan", "includenan", "omitnat", "includenat", "omitundefined" 및 "includeundefined"로 입력 배열의 데이터형에 한정된 누락값 조건을 지정했습니다.

R2023a: 테이블 및 타임테이블에 대해 직접 계산 수행

bounds 함수는 테이블이나 타임테이블 내의 변수에 액세스하기 위한 인덱싱 없이 이러한 모든 변수에 대해 계산을 수행할 수 있습니다. 모든 변수는 계산을 지원하는 데이터형을 가져야 합니다. 자세한 내용은 테이블 및 타임테이블에 대해 직접 계산 항목을 참조하십시오.

R2018b: 여러 차원에 대해 연산 수행

한 번에 입력 배열의 여러 차원에 대해 연산을 수행합니다. 연산 차원으로 구성된 벡터를 지정하거나, 모든 배열 차원에 대해 연산을 수행하도록 "all" 옵션을 지정하십시오.

참고 항목

min | max