min

배열의 최솟값 요소

구문

M = min(A)

M = min(A,[],"all")

M = min(A,[],dim)

M = min(A,[],vecdim)

M = min(A,[],___,missingflag)

[M,I] = min(___)

[M,I] = min(A,[],___,"linear")

C = min(A,B)

C = min(A,B,missingflag)

___ = min(___,"ComparisonMethod",method)

설명

M = min(A)는 배열의 최솟값 요소를 반환합니다.

• A가 벡터인 경우 min(A)는 A의 최솟값을 반환합니다.

• A가 행렬인 경우 min(A)는 A의 각 열의 최솟값이 포함된 행 벡터입니다.

• A가 다차원 배열인 경우 min(A)는 A에서 크기가 1이 아닌 첫 번째 차원을 따라 연산을 수행하며, 요소를 벡터로 취급합니다. 이 차원에서 M의 크기는 1이 되고, 다른 모든 차원의 크기는 A와 동일하게 유지됩니다. A가 첫 번째 차원 길이가 0인 빈 배열인 경우 M은 A와 동일한 크기의 빈 배열입니다.

• A가 테이블 또는 타임테이블인 경우 min(A)는 각 변수의 최솟값을 포함하는 한 행 크기의 테이블을 반환합니다. (R2023a 이후)

M = min(A,[],"all")은 A의 모든 요소에 대한 최솟값을 반환합니다.

M = min(A,[],dim)은 차원 dim에서 최솟값 요소를 반환합니다. 예를 들어, A가 행렬인 경우 min(A,[],2)는 각 행의 최솟값이 포함된 열 벡터를 반환합니다.

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

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

[M,I] = min(___)은 A의 최솟값 중 첫 번째로 나온 값에 대응하는 연산 차원에 대한 인덱스도 반환합니다.

[M,I] = min(A,[],___,"linear")는 A의 최솟값에 대응하는 A에 대한 선형 인덱스도 반환합니다.

C = min(A,B)는 A와 B의 요소를 비교해 작은 요소를 반환값으로 포함시켜 배열로 반환합니다.

C = min(A,B,missingflag)는 누락값을 취급하는 방식도 정의합니다.

___ = min(___,"ComparisonMethod",method)는 위에 열거된 구문에 대해 요소를 비교하는 방식을 선택 사항으로 지정합니다. 예를 들어, 벡터 A = [-1 2 -9]의 경우 구문 min(A,[],"ComparisonMethod","abs")는 A의 요소를 절댓값을 기준으로 비교하여 최솟값 -1을 반환합니다.

예제

벡터에서 가장 작은 요소

벡터를 만든 다음, 벡터에서 가장 작은 요소를 구합니다.

A = [23 42 37 15 52];
M = min(A)

M = 
15

복소수 벡터에서 가장 작은 요소

복소수 벡터를 만든 다음, 이 벡터에서 가장 작은 요소(즉, 최소 크기를 갖는 요소)를 구합니다.

A = [-2+2i 4+i -1-3i];
min(A)

ans = 
-2.0000 + 2.0000i

각 행렬 열에서 가장 작은 요소

행렬을 만든 다음, 각 열에서 가장 작은 요소를 구합니다.

A = [2 8 4; 7 3 9]

A = 2×3

     2     8     4
     7     3     9

M = min(A)

M = 1×3

     2     3     4

각 행렬 행에서 가장 작은 요소

행렬을 만든 다음, 각 행에서 가장 작은 요소를 구합니다.

A = [1.7 1.2 1.5; 1.3 1.6 1.99]

A = 2×3

    1.7000    1.2000    1.5000
    1.3000    1.6000    1.9900

M = min(A,[],2)

M = 2×1

    1.2000
    1.3000

배열 페이지의 최솟값

3차원 배열을 만들고 데이터의 각 페이지(행과 열)에 대한 최솟값을 구합니다.

A(:,:,1) = [2 4; -2 1];
A(:,:,2) = [9 13; -5 7];
A(:,:,3) = [4 4; 8 -3];
M1 = min(A,[],[1 2])

M1 = 
M1(:,:,1) =

    -2


M1(:,:,2) =

    -5


M1(:,:,3) =

    -3

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

M2 = min(A,[],[1 2 3])

M2 = 
-5

Mall = min(A,[],"all")

Mall = 
-5

누락값을 포함한 가장 작은 요소

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

A = [1.77 -0.005 3.98 -2.95; NaN 0.34 NaN 0.19]

A = 2×4

    1.7700   -0.0050    3.9800   -2.9500
       NaN    0.3400       NaN    0.1900

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

M = min(A,[],"includemissing")

M = 1×4

       NaN   -0.0050       NaN   -2.9500

가장 작은 요소 인덱스

행렬 A를 만든 다음, 각 열의 가장 작은 요소뿐 아니라 이 요소가 표시되는 A의 행 인덱스를 구합니다.

A = [1 9 -2; 8 4 -5]

A = 2×3

     1     9    -2
     8     4    -5

[M,I] = min(A)

M = 1×3

     1     4    -5

I = 1×3

     1     2     2

선형 인덱스 반환하기

행렬 A를 만들고 각 행의 최솟값을 행렬 M에 반환합니다. M = A(I)를 만족하는 선형 인덱스 I도 반환하려면 "linear" 옵션을 사용하십시오.

A = [1 2 3; 4 5 6]

A = 2×3

     1     2     3
     4     5     6

[M,I] = min(A,[],2,"linear")

M = 2×1

     1
     4

I = 2×1

     1
     2

minvals = A(I)

minvals = 2×1

     1
     4

가장 작은 요소 비교

행렬을 만든 다음, 각 요소와 스칼라를 비교하여 가장 작은 값을 반환합니다.

A = [1 7 3; 6 2 9]

A = 2×3

     1     7     3
     6     2     9

B = 5;
C = min(A,B)

C = 2×3

     1     5     3
     5     2     5

입력 인수

A — 입력 배열

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

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

• A가 복소수이면 min(A)는 최소 크기를 갖는 복소수를 반환합니다. 최소 크기가 같은 경우 min(A)는 최소 크기와 가장 작은 위상각을 갖는 값을 반환합니다.

• A가 스칼라이면 min(A)는 A를 반환합니다.

• A가 0×0 크기의 빈 배열이면 min(A)도 0×0의 빈 배열이 됩니다.

A의 유형이 categorical형이면 서수형이어야 합니다.

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

dim — 연산을 수행할 차원

양의 정수 스칼라

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

차원 dim은 길이가 1로 줄어드는 차원을 나타냅니다. size(M,dim)은 1이 되고, size(A,dim)이 0이 아닌 다른 차원의 크기는 변경되지 않습니다. size(A,dim)이 0일 경우 min(A,dim)은 A와 크기가 동일한 빈 배열을 반환합니다.

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

• min(A,[],1)은 A의 각 열에서 요소들의 최솟값을 구하고, 1×n 행 벡터를 반환합니다.

  

• min(A,[],2)는 A의 각 행에서 요소들의 최솟값을 구하고, m×1 열 벡터를 반환합니다.

  

vecdim — 차원의 벡터

양의 정수로 구성된 벡터

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

2×3×3 입력 배열 A가 있다고 가정하겠습니다. 이때 min(A,[],[1 2])는 A의 각 페이지에서 얻은 최솟값을 요소로 갖는 1×1×3 배열을 반환합니다.

missingflag — 누락값 조건

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

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

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

B — 추가 입력 배열

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

추가 입력 배열로, 스칼라, 벡터, 행렬, 다차원 배열, 테이블 또는 타임테이블로 지정됩니다. 입력 인수 A와 B는 동일한 크기이거나 호환되는 크기를 가져야 합니다. 후자의 예로는 A가 M×N 행렬이고 B가 스칼라이거나 1×N 행 벡터인 경우를 들 수 있습니다. 자세한 내용은 기본 연산에 대해 호환되는 배열 크기 항목을 참조하십시오.

• A와 B가 둘 다 배열인 경우 어느 하나가 double형이 아니라면 이 둘은 동일한 데이터형이어야 합니다. 둘 중 하나가 double형인 경우 다른 배열의 데이터형은 single형, duration형, 임의의 정수형 중 하나일 수 있습니다.

• A와 B가 순서형 categorical형 배열인 경우 A와 B는 동일한 순서로 된 동일한 범주 집합을 가져야 합니다.

• A 또는 B가 테이블 또는 타임테이블인 경우 다른 입력값은 배열, 테이블 또는 타임테이블일 수 있습니다.

B의 유형이 categorical형이면 순서형이어야 합니다.

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

method — 비교 방법

"auto" (디폴트 값) | "real" | "abs"

숫자형 입력값에 대한 비교 방법으로, 다음 값 중 하나로 지정됩니다.

• "auto" — 숫자형 입력 배열 A에 대해 A가 실수일 때 real(A)를 사용하고 A가 복소수일 때 abs(A)를 사용하여 요소를 비교합니다.

• "real" — 숫자형 입력 배열 A에 대해 A가 실수 또는 복소수일 때 real(A)를 사용하여 요소를 비교합니다. A에 실수부가 동일한 요소가 있는 경우, imag(A)를 사용하여 우선 순위를 결정합니다.

• "abs" — 숫자형 입력 배열 A에 대해 A가 실수 또는 복소수일 때 abs(A)를 사용하여 요소를 비교합니다. A에 크기가 동일한 요소가 있는 경우, 구간 (-π,π]에서의 angle(A)를 사용하여 우선 순위를 결정합니다.

출력 인수

M — 최솟값

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

최솟값으로, 스칼라, 벡터, 행렬, 다차원 배열 또는 테이블로 반환됩니다. size(M,dim)은 1이 되고, size(A,dim)이 0이 아닌 경우 다른 모든 차원의 크기는 A에서 대응하는 차원의 크기와 같게 됩니다. size(A,dim)이 0일 경우 M은 A와 크기가 동일한 빈 배열입니다.

I — 인덱스

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

인덱스로, 스칼라, 벡터, 행렬, 다차원 배열 또는 테이블로 반환됩니다. I는 첫 번째 출력값과 크기가 동일합니다.

"linear"가 지정되지 않은 경우 I는 연산 차원에 대한 인덱스입니다. "linear"가 지정된 경우 I는 최솟값에 대응하는 A의 선형 인덱스를 포함합니다.

가장 작은 요소가 두 개 이상 있는 경우 I는 첫 번째 값에 대한 인덱스를 포함합니다.

C — A 또는 B의 최소 요소

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

A 또는 B의 최소 요소로, 스칼라, 벡터, 행렬, 다차원 배열, 테이블 또는 타임테이블로 반환됩니다. C의 크기는 A와 B의 차원의 묵시적 확장(Implicit Expansion)에 의해 결정됩니다. 자세한 내용은 기본 연산에 대해 호환되는 배열 크기 항목을 참조하십시오.

C의 데이터형은 A와 B의 데이터형에 따라 달라집니다.

• A와 B의 데이터형이 동일한 경우 C는 A와 B의 데이터형과 일치합니다.

• A 또는 B 중 하나가 single형인 경우 C는 single형입니다.

• A와 B 중 하나는 정수 데이터형이고 다른 하나는 double형 스칼라인 경우 C는 정수 데이터형이 됩니다.

• A 또는 B가 테이블 또는 타임테이블인 경우 C는 테이블 또는 타임테이블입니다.

확장 기능

tall형 배열

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

min 함수는 tall형 배열을 지원하지만 다음과 같은 사용법 관련 참고 및 제한 사항이 있습니다.

• tall형 테이블 형식 입력값에는 인덱스 출력값이 지원되지 않습니다.

자세한 내용은 tall형 배열 항목을 참조하십시오.

C/C++ 코드 생성

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

사용법 관련 참고 및 제한 사항:

• 런타임에 빈 배열을 두 번째 인수로 사용하려면, 코드 생성 시 고정 크기의 0×0 배열을 지정해야 합니다.

• 인수 dim, vecdim, missingflag, method가 사용될 경우, 이러한 인수는 코드 생성 시 상수여야 합니다.

• dim 인수를 지정하지 않을 경우 코드 생성기는 A에서 가변 크기이거나 크기가 1이 아닌 첫 번째 차원을 따라 연산을 수행합니다.

• 입력 인수 A에 대해 다음이 적용됩니다.

  • 입력값이 가변 크기 배열인 경우, 런타임 시 연산을 수행할 차원의 길이는 0이 아니어야 합니다.

  • 생성된 코드에서 입력 배열은 모든 요소의 허수부 값이 0이더라도 복소수로 유지됩니다. 이러한 경우, 생성된 코드의 결과는 MATLAB에서 생성된 결과와 다를 수 있습니다. Code Generation for Complex Data with Zero-Valued Imaginary Parts (MATLAB Coder) 항목을 참조하십시오.

GPU 코드 생성

GPU Coder™를 사용하여 NVIDIA® GPU용 CUDA® 코드를 생성할 수 있습니다.

사용법 관련 참고 및 제한 사항:

• 런타임에 빈 배열을 두 번째 인수로 사용하려면, 코드 생성 시 고정 크기의 0×0 배열을 지정해야 합니다.

• 인수 dim, vecdim, missingflag, method가 사용될 경우, 이러한 인수는 코드 생성 시 상수여야 합니다.

• 입력 인수 A에 대해 다음이 적용됩니다.

  • 차원을 지정하지 않을 경우 코드 생성기는 입력 배열에서 가변 크기이거나 크기가 1이 아닌 첫 번째 차원을 따라 연산을 수행합니다. 이 차원이 코드 생성 시점에 가변 크기이고 런타임에 1인 경우, 런타임 오류가 발생할 수 있습니다. 이 오류를 피하려면 차원을 지정하십시오.

• A가 복소수이고 A의 모든 요소의 허수부가 0인 경우 MATLAB^®은 min(A)를 호출하기 전에 A를 real(A)로 변환할 수 있습니다. 이 경우, MATLAB은 요소를 real(A)와 비교하지만, 생성된 코드는 요소를 abs(A)와 비교합니다. 생성된 코드가 MATLAB과 일치하도록 하려면 min(real(A)) 또는 min(A,'ComparisonMethod','real')을 사용하십시오. Code Generation for Complex Data with Zero-Valued Imaginary Parts (MATLAB Coder) 항목을 참조하십시오.

HDL 코드 생성

HDL Coder™를 사용하여 FPGA 및 ASIC 설계를 위한 VHDL, Verilog 및 SystemVerilog 코드를 생성할 수 있습니다.

사용법 관련 참고 및 제한 사항:

• 3차원 이상의 행렬 입력값은 지원되지 않습니다.

• 복소수 데이터형의 입력값은 지원되지 않습니다.

• 입력 행렬 또는 벡터는 크기가 같아야 합니다.

스레드 기반 환경

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

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

GPU 배열

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

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

분산 배열

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

사용법 관련 참고 및 제한 사항:

• 분산 테이블 형식 입력값에는 인덱스 출력값이 지원되지 않습니다.

자세한 내용은 분산 배열을 사용하여 MATLAB 함수 실행 (Parallel Computing Toolbox) 항목을 참조하십시오.

버전 내역

R2006a 이전에 개발됨

R2024b: 두 번째 입력 배열을 문자형 배열로 지정하는 것은 지원되지 않음

두 번째 입력 배열을 문자형 배열로 지정하면 오류가 반환됩니다. 이 변경 사항은 누락값 조건과 같이 문자형 벡터로 지정할 수 있는 다른 인수와의 혼동을 최소화합니다. 이전 기능을 유지하려면 두 번째 입력 배열을 double형으로 변환하면 됩니다(예: min(A,double(B),"includenan")).

R2023b: 두 번째 입력 배열을 문자형 배열로 지정하는 것은 지원되지 않음

두 번째 입력 배열을 문자형 배열로 지정하면 경고가 표시되며 향후 릴리스에서는 오류로 간주됩니다. 이 변경 사항은 누락값 조건과 같이 문자형 벡터로 지정할 수 있는 다른 인수와의 혼동을 최소화합니다. 이전 기능을 유지하려면 두 번째 입력 배열을 double형으로 변환하면 됩니다(예: min(A,double(B),"includenan")).

R2023a: 누락값 조건 지정

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

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

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

R2021b: 비교 방법 지정

ComparisonMethod 파라미터를 사용하여 입력값의 최솟값을 결정하는 방법으로 실수 값 방법 또는 절댓값 방법을 지정합니다.

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

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

참고 항목

함수

• mink | bounds | max | mean | median | sort | islocalmin | clip

도움말 항목

• 배열 인덱싱