이 번역 페이지는 최신 내용을 담고 있지 않습니다. 최신 내용을 영문으로 보려면 여기를 클릭하십시오.

fitcknn

k-최근접이웃 분류기 피팅

구문

Mdl = fitcknn(Tbl,ResponseVarName)

Mdl = fitcknn(Tbl,formula)

Mdl = fitcknn(Tbl,Y)

Mdl = fitcknn(X,Y)

Mdl = fitcknn(___,Name,Value)

설명

Mdl = fitcknn(Tbl,ResponseVarName)은 테이블 Tbl에 포함된 입력 변수(예측 변수, 특징 또는 특성이라고도 함)와 출력값(응답 변수) Tbl.ResponseVarName을 기반으로 하여 k-최근접이웃 분류 모델을 반환합니다.

Mdl = fitcknn(Tbl,formula)는 테이블 Tbl에 포함된 입력 변수를 기반으로 하여 k-최근접이웃 분류 모델을 반환합니다. formula는 Tbl에 포함된 응답 변수와 예측 변수의 부분 집합에 대한 설명 모델입니다.

Mdl = fitcknn(Tbl,Y)는 테이블 Tbl에 포함된 예측 변수와 Y에 포함된 응답 변수 배열을 기반으로 하여 k-최근접이웃 분류 모델을 반환합니다.

Mdl = fitcknn(X,Y)는 예측 변수 데이터 X와 응답 변수 Y를 기반으로 하여 k-최근접이웃 분류 모델을 반환합니다.

Mdl = fitcknn(___,Name,Value)는 위에 열거된 구문 중 하나를 사용하여 하나 이상의 이름-값 쌍의 인수로 지정된 추가 옵션으로 모델을 피팅합니다. 예를 들어, 우선 순위 결정(Tie-Breaking) 알고리즘, 거리 측정법 또는 관측값 가중치를 지정할 수 있습니다.

예제

k-최근접이웃 분류기 훈련시키기

피셔(Fisher)의 붓꽃 데이터에 사용할 k-최근접이웃 분류기를 훈련시킵니다. 여기서 k는 예측 변수에 포함된 최근접이웃의 수로 5입니다.

피셔의 붓꽃 데이터를 불러옵니다.

load fisheriris
X = meas;
Y = species;

X는 150개 붓꽃에 대한 4개의 꽃잎 측정값을 포함하는 숫자형 행렬입니다. Y는 이에 대응되는 붓꽃 종을 포함하는 문자형 벡터로 구성된 셀형 배열입니다.

5-최근접이웃 분류기를 훈련시킵니다. 비범주형 예측 변수 데이터를 표준화합니다.

Mdl = fitcknn(X,Y,'NumNeighbors',5,'Standardize',1)

Mdl = 
  ClassificationKNN
             ResponseName: 'Y'
    CategoricalPredictors: []
               ClassNames: {'setosa'  'versicolor'  'virginica'}
           ScoreTransform: 'none'
          NumObservations: 150
                 Distance: 'euclidean'
             NumNeighbors: 5

Mdl은 훈련된 ClassificationKNN 분류기이며, 이에 대한 속성 중 일부는 명령 창에 표시됩니다.

Mdl의 속성에 액세스하려면 점 표기법을 사용하십시오.

Mdl.ClassNames

ans = 3x1 cell
    {'setosa'    }
    {'versicolor'}
    {'virginica' }

Mdl.Prior

ans = 1×3

    0.3333    0.3333    0.3333

Mdl.Prior는 fitcknn에서 'Prior' 이름-값 쌍의 인수를 사용하여 지정할 수 있는 클래스 사전 확률을 포함합니다. 클래스 사전 확률의 순서는 Mdl.ClassNames에 포함된 클래스의 순서와 일치합니다. 기본적으로, 사전 확률은 데이터에서 이러한 클래스가 나타날 각각의 상대 도수입니다.

훈련을 수행한 후 사전 확률을 재설정할 수도 있습니다. 예를 들어, 사전 확률을 각각 0.5, 0.2, 0.3으로 설정합니다.

Mdl.Prior = [0.5 0.2 0.3];

Mdl을 predict에 전달하여 새 측정값에 레이블을 지정하거나 crossval에 전달하여 분류기를 교차 검증할 수 있습니다.

민코프스키 측정법을 사용하여 k-최근접이웃 분류기 훈련시키기

피셔(Fisher)의 붓꽃 데이터 세트를 불러옵니다.

load fisheriris
X = meas;
Y = species;

X는 150개 붓꽃에 대한 4개의 꽃잎 측정값을 포함하는 숫자형 행렬입니다. Y는 이에 대응되는 붓꽃 종을 포함하는 문자형 벡터로 구성된 셀형 배열입니다.

민코프스키 측정법을 사용하여 3-최근접이웃 분류기를 훈련시킵니다. 민코프스키 측정법을 사용하려면 완전 탐색기를 사용해야 합니다. 비범주형 예측 변수 데이터는 표준화하는 것이 좋습니다.

Mdl = fitcknn(X,Y,'NumNeighbors',3,...
    'NSMethod','exhaustive','Distance','minkowski',...
    'Standardize',1);

Mdl은 ClassificationKNN 분류기입니다.

작업 공간 창에서 Mdl을 두 번 클릭하여 Mdl의 속성을 살펴볼 수 있습니다. 이렇게 하면 변수 편집기가 열립니다.

사용자 지정 거리 측정법을 사용하여 k-최근접이웃 분류기 훈련시키기

카이제곱 거리를 사용하여 k-최근접이웃 분류기를 훈련시킵니다.

피셔(Fisher)의 붓꽃 데이터 세트를 불러옵니다.

load fisheriris
X = meas;    % Predictors
Y = species; % Response

j차원 점 x와 z 간의 카이제곱 거리는 다음과 같습니다.

$$\chi (x,z)=\sqrt{{\displaystyle \sum _{j=1}^J{w}_j{(x_j-z_j)}^2}},$$

여기서 $$w_j$$는 차원 j와 연결된 가중치입니다.

카이제곱 거리 함수를 지정합니다. 거리 함수는 다음과 같아야 합니다.

• X의 한 행, 예를 들어, x와 행렬 Z를 받습니다.

• x를 Z의 각 행과 비교합니다.

• 길이가 $$n_z$$인 벡터 D를 반환합니다. 여기서 $$n_z$$는 Z의 행 개수입니다. D의 각 요소는 x에 대응하는 관측값과 Z의 각 행에 대응하는 관측값 간의 거리입니다.

chiSqrDist = @(x,Z,wt)sqrt(((x-Z).^2)*wt);

이 예제에서는 설명을 위해 임의의 가중치를 사용합니다.

3-최근접이웃 분류기를 훈련시킵니다. 비범주형 예측 변수 데이터는 표준화하는 것이 좋습니다.

k = 3;
w = [0.3; 0.3; 0.2; 0.2];
KNNMdl = fitcknn(X,Y,'Distance',@(x,Z)chiSqrDist(x,Z,w),...
    'NumNeighbors',k,'Standardize',1);

KNNMdl은 ClassificationKNN 분류기입니다.

디폴트 10겹 교차 검증을 사용하여 KNN 분류기를 교차 검증합니다. 분류 오차를 추정합니다.

rng(1); % For reproducibility
CVKNNMdl = crossval(KNNMdl);
classError = kfoldLoss(CVKNNMdl)

classError = 0.0600

CVKNNMdl은 ClassificationPartitionedModel 분류기입니다.

이 분류기를 다른 가중치 부여 방식을 사용하는 분류기와 비교합니다.

w2 = [0.2; 0.2; 0.3; 0.3];
CVKNNMdl2 = fitcknn(X,Y,'Distance',@(x,Z)chiSqrDist(x,Z,w2),...
    'NumNeighbors',k,'KFold',10,'Standardize',1);
classError2 = kfoldLoss(CVKNNMdl2)

classError2 = 0.0400

두 번째 가중치 부여 방식은 표본외 성능이 더 좋은 분류기를 생성합니다.

피팅된 KNN 분류기 최적화하기

이 예제에서는 fitcknn을 사용하여 자동으로 하이퍼파라미터를 최적화하는 방법을 보여줍니다. 이 예제에서는 피셔의 붓꽃 데이터를 사용합니다.

데이터를 불러옵니다.

load fisheriris
X = meas;
Y = species;

자동 하이퍼파라미터 최적화를 사용하여 5겹 교차 검증 손실을 최소화하는 하이퍼파라미터를 구합니다.

재현이 가능하도록 난수 시드값을 설정하고 'expected-improvement-plus' 획득 함수를 사용합니다.

rng(1)
Mdl = fitcknn(X,Y,'OptimizeHyperparameters','auto',...
    'HyperparameterOptimizationOptions',...
    struct('AcquisitionFunctionName','expected-improvement-plus'))

|====================================================================================================================|
| Iter | Eval   | Objective   | Objective   | BestSoFar   | BestSoFar   | NumNeighbors |     Distance |  Standardize |
|      | result |             | runtime     | (observed)  | (estim.)    |              |              |              |
|====================================================================================================================|
|    1 | Best   |        0.04 |      1.2547 |        0.04 |        0.04 |           13 |    minkowski |         true |
|    2 | Accept |     0.19333 |     0.41078 |        0.04 |    0.046097 |            1 |  correlation |         true |
|    3 | Accept |    0.053333 |     0.18147 |        0.04 |    0.047573 |           14 |    chebychev |         true |
|    4 | Accept |    0.046667 |     0.35049 |        0.04 |    0.041053 |            2 |    minkowski |        false |
|    5 | Accept |    0.053333 |     0.27065 |        0.04 |    0.046782 |            7 |    minkowski |         true |
|    6 | Accept |     0.10667 |     0.28853 |        0.04 |    0.046422 |            2 |  mahalanobis |        false |
|    7 | Accept |    0.093333 |      0.1309 |        0.04 |    0.040581 |           75 |    minkowski |        false |
|    8 | Accept |     0.15333 |     0.14487 |        0.04 |    0.040008 |           75 |    minkowski |         true |
|    9 | Best   |        0.02 |     0.10532 |        0.02 |     0.02001 |            4 |    minkowski |        false |
|   10 | Accept |    0.026667 |     0.27251 |        0.02 |    0.020012 |            8 |    minkowski |        false |
|   11 | Accept |     0.21333 |     0.12881 |        0.02 |    0.020008 |           69 |    chebychev |         true |
|   12 | Accept |    0.053333 |     0.28672 |        0.02 |    0.020009 |            5 |    chebychev |         true |
|   13 | Accept |    0.053333 |     0.28807 |        0.02 |    0.020009 |            1 |    chebychev |         true |
|   14 | Accept |    0.053333 |     0.61287 |        0.02 |    0.020008 |            5 |   seuclidean |        false |
|   15 | Accept |    0.053333 |     0.23874 |        0.02 |    0.020008 |           21 |   seuclidean |        false |
|   16 | Accept |    0.053333 |     0.12072 |        0.02 |    0.020009 |            1 |   seuclidean |        false |
|   17 | Accept |     0.15333 |      0.3363 |        0.02 |    0.020007 |           75 |   seuclidean |        false |
|   18 | Accept |        0.02 |     0.29285 |        0.02 |    0.019969 |            5 |    minkowski |        false |
|   19 | Accept |     0.33333 |     0.18787 |        0.02 |    0.019898 |            2 |     spearman |        false |
|   20 | Accept |     0.23333 |     0.31613 |        0.02 |    0.019888 |           71 |  mahalanobis |        false |
|====================================================================================================================|
| Iter | Eval   | Objective   | Objective   | BestSoFar   | BestSoFar   | NumNeighbors |     Distance |  Standardize |
|      | result |             | runtime     | (observed)  | (estim.)    |              |              |              |
|====================================================================================================================|
|   21 | Accept |    0.046667 |      0.1789 |        0.02 |    0.019895 |            1 |    cityblock |         true |
|   22 | Accept |    0.053333 |     0.31174 |        0.02 |    0.019892 |            6 |    cityblock |         true |
|   23 | Accept |        0.12 |     0.32709 |        0.02 |    0.019895 |           75 |    cityblock |         true |
|   24 | Accept |        0.06 |      0.2609 |        0.02 |    0.019903 |            2 |    cityblock |        false |
|   25 | Accept |    0.033333 |     0.15934 |        0.02 |    0.019899 |           17 |    cityblock |        false |
|   26 | Accept |        0.12 |     0.18831 |        0.02 |    0.019907 |           74 |    cityblock |        false |
|   27 | Accept |    0.033333 |     0.11622 |        0.02 |    0.019894 |            7 |    cityblock |        false |
|   28 | Accept |        0.02 |     0.15196 |        0.02 |    0.019897 |            1 |    chebychev |        false |
|   29 | Accept |        0.02 |     0.32439 |        0.02 |    0.019891 |            4 |    chebychev |        false |
|   30 | Accept |        0.08 |     0.24189 |        0.02 |    0.019891 |           28 |    chebychev |        false |

__________________________________________________________
Optimization completed.
MaxObjectiveEvaluations of 30 reached.
Total function evaluations: 30
Total elapsed time: 37.4867 seconds
Total objective function evaluation time: 8.48

Best observed feasible point:
    NumNeighbors    Distance     Standardize
    ____________    _________    ___________

         4          minkowski       false   

Observed objective function value = 0.02
Estimated objective function value = 0.020124
Function evaluation time = 0.10532

Best estimated feasible point (according to models):
    NumNeighbors    Distance     Standardize
    ____________    _________    ___________

         5          minkowski       false   

Estimated objective function value = 0.019891
Estimated function evaluation time = 0.24139

Mdl = 
  ClassificationKNN
                         ResponseName: 'Y'
                CategoricalPredictors: []
                           ClassNames: {'setosa'  'versicolor'  'virginica'}
                       ScoreTransform: 'none'
                      NumObservations: 150
    HyperparameterOptimizationResults: [1x1 BayesianOptimization]
                             Distance: 'minkowski'
                         NumNeighbors: 5

입력 인수

Tbl — 표본 데이터

table형

모델을 훈련시키는 데 사용되는 표본 데이터로, 테이블로 지정됩니다. Tbl의 각 행은 하나의 관측값에 대응되고, 각 열은 하나의 예측 변수에 대응됩니다. 선택적으로, Tbl은 응답 변수에 대해 하나의 추가 열을 포함할 수 있습니다. 문자형 벡터로 구성된 셀형 배열 이외의 셀형 배열과 다중 열 변수는 허용되지 않습니다.

• Tbl이 응답 변수를 포함하며 Tbl의 나머지 모든 변수를 예측 변수로 사용하려는 경우 ResponseVarName을 사용하여 응답 변수를 지정하십시오.

• Tbl이 응답 변수를 포함하며 Tbl의 나머지 변수 중 일부만 예측 변수로 사용하려는 경우 formula를 사용하여 공식을 지정하십시오.

• Tbl이 응답 변수를 포함하지 않는 경우 Y를 사용하여 응답 변수를 지정하십시오. 응답 변수의 길이와 Tbl의 행 개수는 동일해야 합니다.

ResponseVarName — 응답 변수 이름

Tbl에 포함된 변수 이름

응답 변수 이름으로, Tbl의 변수 이름으로 지정됩니다.

ResponseVarName은 문자형 벡터나 string형 스칼라로 지정해야 합니다. 예를 들어, 응답 변수 Y가 Tbl.Y로 저장된 경우 이를 "Y"로 지정하십시오. 이렇게 하지 않으면 모델을 훈련시킬 때 Y를 포함한 Tbl의 모든 열이 예측 변수로 처리됩니다.

응답 변수는 categorical형 배열, 문자형 배열, string형 배열, 논리형 벡터 또는 숫자형 벡터, 문자형 벡터로 구성된 셀형 배열이어야 합니다. Y가 문자형 배열인 경우, 응답 변수의 각 요소는 배열의 각 행에 대응되어야 합니다.

ClassNames 이름-값 인수를 사용하여 클래스의 순서를 지정하는 것이 좋습니다.

데이터형: char | string

formula — 응답 변수와 예측 변수의 부분 집합에 대한 설명 모델

문자형 벡터 | string형 스칼라

응답 변수, 그리고 예측 변수의 부분 집합에 대한 설명 모델로, "Y~x1+x2+x3" 형식의 문자형 벡터나 string형 스칼라로 지정됩니다. 이 형식에서 Y는 응답 변수를 나타내고, x1, x2, x3은 예측 변수를 나타냅니다.

Tbl의 일부 변수를 모델 훈련에 사용할 예측 변수로 지정하려면 식을 사용하십시오. 사용자가 식을 지정하면 Tbl의 변수 중 해당 formula에 표시되지 않은 변수는 사용되지 않습니다.

식에 포함되는 변수 이름은 Tbl에 포함된 변수 이름(Tbl.Properties.VariableNames)이면서 동시에 유효한 MATLAB^® 식별자여야 합니다. isvarname 함수를 사용하여 Tbl에 포함된 변수 이름을 확인할 수 있습니다. 변수 이름이 유효하지 않으면 matlab.lang.makeValidName 함수를 사용하여 변수 이름을 변환할 수 있습니다.

데이터형: char | string

Y — 클래스 레이블

categorical형 배열 | 문자형 배열 | string형 배열 | 논리형 벡터 | 숫자형 벡터 | 문자형 벡터로 구성된 셀형 배열

클래스 레이블로, categorical형 배열, 문자형 배열, string형 배열, 논리형 벡터, 숫자형 벡터 또는 문자형 벡터로 구성된 셀형 배열로 지정됩니다. Y의 각 행은 이에 대응되는 X 행의 분류를 나타냅니다.

Y의 NaN, ''(빈 문자형 벡터), ""(빈 string형), <missing>, <undefined> 값은 누락값으로 간주됩니다. 따라서 누락 응답 변수가 있는 관측값은 훈련에 사용하지 않습니다.

데이터형: categorical | char | string | logical | single | double | cell

X — 예측 변수 데이터

숫자형 행렬

예측 변수 데이터로, 숫자형 행렬로 지정됩니다.

각 행은 하나의 관측값(발생 건 또는 예라고도 함)에 대응되고, 각 열은 하나의 예측 변수(특징이라고도 함)에 대응됩니다.

Y의 길이와 X의 행 개수는 동일해야 합니다.

X에 나오는 순서로 예측 변수의 이름을 지정하려면 PredictorNames 이름-값 쌍의 인수를 사용하십시오.

데이터형: double | single

이름-값 인수

선택적 인수 쌍을 Name1=Value1,...,NameN=ValueN으로 지정합니다. 여기서 Name은 인수 이름이고 Value는 대응값입니다. 이름-값 인수는 다른 인수 뒤에 와야 하지만, 인수 쌍의 순서는 상관없습니다.

R2021a 이전 릴리스에서는 쉼표를 사용하여 각 이름과 값을 구분하고 Name을 따옴표로 묶으십시오.

예: 'NumNeighbors',3,'NSMethod','exhaustive','Distance','minkowski'는 최근접이웃 탐색 방법과 민코프스키 측정법을 사용하여 3-최근접이웃을 위한 분류기를 지정합니다.

참고

교차 검증 이름-값 인수는 'OptimizeHyperparameters' 이름-값 인수와 함께 사용할 수 없습니다. 'OptimizeHyperparameters'에 대한 교차 검증을 수정하려면 'HyperparameterOptimizationOptions' 이름-값 인수를 사용해야만 합니다.

모델의 파라미터

BreakTies — 우선 순위 결정(Tie-Breaking) 알고리즘

'smallest' (디폴트 값) | 'nearest' | 'random'

여러 클래스가 동일한 최소 비용을 갖는 경우 predict 방법이 사용하는 우선 순위 결정 알고리즘으로, 'BreakTies'와 함께 다음 중 하나가 쉼표로 구분되어 지정됩니다.

• 'smallest' — 동점인 그룹 중에서 가장 작은 인덱스를 사용합니다.

• 'nearest' — 동점인 그룹 중에서 최근접이웃을 갖는 클래스를 사용합니다.

• 'random' — 동점인 그룹 중에서 무작위로 하나를 선택하는 우선 순위 판별법을 사용합니다.

기본적으로, 총 k개 최근접이웃이 주어졌을 때 서로 같은 개수의 최근접이웃 점을 가지는 복수의 클래스가 존재하면 동순위(Tie)가 발생합니다.

예: 'BreakTies','nearest'

BucketSize — 노드에 포함된 데이터 점의 최대 개수

50 (디폴트 값) | 양의 정수 값

Kd-트리의 리프 노드에 포함된 데이터 점의 최대 개수로, 'BucketSize'와 함께 양의 정수 값이 쉼표로 구분되어 지정됩니다. 이 인수는 NSMethod가 'kdtree'인 경우에만 유효합니다.

예: 'BucketSize',40

데이터형: single | double

CategoricalPredictors — 범주형 예측 변수를 나타내는 플래그

[] | 'all'

범주형 예측 변수를 나타내는 플래그로, 'CategoricalPredictors'와 함께 다음 중 하나가 쉼표로 구분되어 지정됩니다.

• 'all' — 모든 예측 변수가 범주형 변수입니다.

• [] — 범주형 변수인 예측 변수가 없습니다.

fitcknn의 예측 변수 데이터는 모두 연속형이거나 모두 범주형이어야 합니다.

• 예측 변수 데이터가 테이블(Tbl) 내에 있는 경우, 변수가 논리형 벡터, categorical형 벡터, 문자형 배열, string형 배열 또는 문자형 벡터로 구성된 셀형 배열이면 fitcknn 함수는 그 변수를 범주형 변수라고 가정합니다. Tbl에 연속된 값과 범주형 값이 모두 포함된 경우, 'CategoricalPredictors'의 값을 지정해야 합니다. 그러면 fitcknn 함수가 모든 예측 변수를 연속형 변수로 처리할지 범주형 변수로 처리할지 결정할 수 있습니다.

• 예측 변수 데이터가 행렬(X)이면 fitcknn 함수는 모든 예측 변수를 연속형 변수라고 가정합니다. X에 포함된 모든 예측 변수를 범주형으로 식별하려면 'CategoricalPredictors'를 'all'로 지정하십시오.

CategoricalPredictors를 'all'로 설정할 경우 디폴트 Distance는 'hamming'입니다.

예: 'CategoricalPredictors','all'

ClassNames — 훈련에 사용할 클래스의 이름

categorical형 배열 | 문자형 배열 | string형 배열 | 논리형 벡터 | 숫자형 벡터 | 문자형 벡터로 구성된 셀형 배열

훈련에 사용할 클래스의 이름으로, categorical형 배열, 문자형 배열, string형 배열, 논리형 벡터 또는 숫자형 벡터, 문자형 벡터로 구성된 셀형 배열로 지정됩니다. ClassNames는 Tbl의 응답 변수 또는 Y와 같은 데이터형이어야 합니다.

ClassNames가 문자형 배열인 경우, 각 요소는 배열의 각 행에 대응되어야 합니다.

ClassNames를 사용하여 다음을 수행할 수 있습니다.

• 훈련 중의 클래스 순서를 지정합니다.

• 입력 인수 차원 또는 출력 인수 차원의 순서를 지정합니다. 이 순서는 클래스 순서와 일치합니다. 예를 들어, ClassNames를 사용하여 Cost 차원의 순서나 predict로 반환되는 분류 점수의 열 순서를 지정할 수 있습니다.

• 훈련에 사용할 클래스의 일부를 선택합니다. 예를 들어, Y에 포함된 모든 고유한 클래스 이름의 집합이 ["a","b","c"]라고 가정해 보겠습니다. 클래스 "a"와 "c"의 관측값만 사용하여 모델을 훈련시키려면 "ClassNames",["a","c"]를 지정하십시오.

ClassNames의 디폴트 값은 Tbl의 응답 변수 또는 Y에 포함된 모든 고유한 클래스 이름의 집합입니다.

예: "ClassNames",["b","g"]

데이터형: categorical | char | string | logical | single | double | cell

Cost — 오분류 비용

정사각 행렬 | 구조체

점의 오분류 비용으로, 'Cost'와 함께 다음 중 하나가 쉼표로 구분되어 지정됩니다.

• 정사각 행렬로, 여기서 Cost(i,j)는 특정 점에 대해 실제 클래스가 i인 경우 이 점을 j 클래스로 분류하는 비용입니다(즉, 행은 실제 클래스에 대응되고, 열은 예측 클래스에 대응됨). Cost의 대응 행과 대응 열에 대한 클래스 순서를 지정하려면 ClassNames 이름-값 쌍의 인수도 지정하십시오.

• 다음 두 개의 필드를 갖는 구조체 S: Y와 같은 유형의 변수로 그룹 이름을 포함하는 S.ClassNames와 비용 행렬을 포함하는 S.ClassificationCosts.

디폴트 값은 i~=j인 경우 Cost(i,j)=1이고, i=j인 경우 Cost(i,j)=0입니다.

데이터형: single | double | struct

Cov — 공분산 행렬

cov(X,'omitrows') (디폴트 값) | 스칼라 값으로 구성된 양의 정부호 행렬

공분산 행렬로, 'Cov'와 함께 마할라노비스 거리를 계산할 때의 공분산 행렬을 나타내는 스칼라 값으로 구성된 양의 정부호 행렬이 쉼표로 구분되어 지정됩니다. 이 인수는 'Distance'가 'mahalanobis'인 경우에만 유효합니다.

'Standardize'를 'Scale' 또는 'Cov'와 동시에 지정할 수 없습니다.

데이터형: single | double

Distance — 거리 측정법

'cityblock' | 'chebychev' | 'correlation' | 'cosine' | 'euclidean' | 'hamming' | 함수 핸들 | ...

거리 측정법으로, 'Distance'와 함께 유효한 거리 측정법 이름 또는 함수 핸들이 쉼표로 구분되어 지정됩니다. 허용되는 거리 측정법 이름은 선택한 이웃 탐색 방법에 따라 달라집니다(NSMethod 참조).

NSMethod	거리 측정법 이름
exhaustive	ExhaustiveSearcher의 모든 거리 측정법
kdtree	'cityblock', 'chebychev', 'euclidean' 또는 'minkowski'

다음 표에는 ExhaustiveSearcher의 유효한 거리 측정법이 나와 있습니다.

거리 측정법 이름	설명
'cityblock'	도시 블록 거리입니다.
'chebychev'	체비쇼프 거리(최대 좌표 차이)입니다.
'correlation'	1에서 관측값 간의 표본 선형 상관관계를 뺀 값입니다(일련의 값으로 처리됨).
'cosine'	1에서 관측값 간의 끼인각에 대한 코사인을 뺀 값입니다(벡터로 처리됨).
'euclidean'	유클리드 거리입니다.
'hamming'	해밍 거리로, 서로 다른 좌표의 백분율입니다.
'jaccard'	0이 아닌 두 좌표의 값이 서로 다른 비율인 자카드 계수를 1에서 뺀 값입니다.
'mahalanobis'	마할라노비스 거리로, 양의 정부호 공분산 행렬 C를 사용하여 계산됩니다. C의 디폴트 값은 X의 표본 공분산 행렬로, cov(X,'omitrows')로 계산됩니다. C에 다른 값을 지정하려면 'Cov' 이름-값 쌍의 인수를 사용하십시오.
'minkowski'	민코프스키 거리입니다. 디폴트 지수는 2입니다. 다른 지수를 지정하려면 'Exponent' 이름-값 쌍의 인수를 사용하십시오.
'seuclidean'	표준화된 유클리드 거리입니다. X와 쿼리 점 간의 각 좌표 차이는 스케일링됩니다. 즉, 스케일 값 S로 나누어집니다. S의 디폴트 값은 X에서 계산된 표준편차 S = std(X,'omitnan')입니다. S에 다른 값을 지정하려면 Scale 이름-값 쌍의 인수를 사용하십시오.
'spearman'	1에서 관측값 간 표본 스피어만의 순위 상관 계수를 뺀 값입니다(일련의 값으로 처리됨).
@distfun	거리 함수 핸들입니다. distfun의 형식은 다음과 같습니다 function D2 = distfun(ZI,ZJ) % calculation of distance ... 여기서 ZI는 X 또는 Y의 한 행을 포함하는 1×N 벡터입니다. ZJ는 X 또는 Y의 여러 행을 포함하는 M2×N 행렬입니다. D2는 거리로 구성된 M2×1 벡터이고, D2(k)는 관측값 ZI와 ZJ(k,:) 간의 거리입니다.

CategoricalPredictors를 'all'로 지정한 경우 디폴트 거리 측정법은 'hamming'입니다. 그렇지 않은 경우 디폴트 거리 측정법은 'euclidean'입니다.

Distance는 점 표기법을 사용하여 변경할 수 있습니다(예: mdl.Distance = newDistance).

NSMethod가 'kdtree'이면 점 표기법을 사용하여 측정법 'cityblock', 'chebychev', 'euclidean' 및 'minkowski'에 대해서만 Distance를 변경할 수 있습니다.

정의는 거리 측정법 항목을 참조하십시오.

예: 'Distance','minkowski'

데이터형: char | string | function_handle

DistanceWeight — 거리 가중치 함수

'equal' (디폴트 값) | 'inverse' | 'squaredinverse' | 함수 핸들

거리 가중치 함수로, 'DistanceWeight'와 함께 다음 표에 나와 있는 값 중 하나 또는 함수 핸들이 쉼표로 구분되어 지정됩니다.

값	설명
'equal'	가중치 없음
'inverse'	가중치: 1/거리
'squaredinverse'	가중치: 1/거리2
@fcn	fcn은 음이 아닌 거리로 구성된 행렬을 받아 음이 아닌 거리 가중치를 포함하는 동일한 크기의 행렬을 반환하는 함수입니다. 예를 들어, 'squaredinverse'는 @(d)d.^(-2)와 동일합니다.

예: 'DistanceWeight','inverse'

데이터형: char | string | function_handle

Exponent — 민코프스키 거리 지수

2 (디폴트 값) | 양의 스칼라 값

민코프스키 거리 지수로, 'Exponent'와 함께 양의 스칼라 값이 쉼표로 구분되어 지정됩니다. 이 인수는 'Distance'가 'minkowski'인 경우에만 유효합니다.

예: 'Exponent',3

데이터형: single | double

IncludeTies — 동순위 포함 플래그

false (디폴트 값) | true

동순위 포함 플래그로, 'IncludeTies'와 함께 k번째로 작은 거리와 거리 값이 같은 모든 이웃을 predict가 포함하는지 여부를 나타내는 논리값이 쉼표로 구분되어 지정됩니다. IncludeTies가 true인 경우 predict는 이러한 이웃을 모두 포함합니다. 그렇지 않은 경우 predict는 정확히 k개 이웃을 사용합니다.

예: 'IncludeTies',true

데이터형: logical

NSMethod — 최근접이웃 탐색 방법

'kdtree' | 'exhaustive'

최근접이웃 탐색 방법으로, 'NSMethod'와 함께 'kdtree' 또는 'exhaustive'가 쉼표로 구분되어 지정됩니다.

• 'kdtree' — Kd-트리를 생성하고 이를 사용하여 최근접이웃을 찾습니다. 'kdtree'는 거리 측정법이 다음 중 하나인 경우에만 유효합니다.

  • 'euclidean'

  • 'cityblock'

  • 'minkowski'

  • 'chebychev'

• 'exhaustive' — 완전 탐색 알고리즘을 사용합니다. 새 점 xnew의 클래스를 예측할 때 X의 모든 점에서 xnew까지의 거리 값을 계산하여 최근접이웃을 찾습니다.

X가 10개 이하의 열을 갖고 X가 희소 행렬이나 gpuArray가 아니며 거리 측정법이 'kdtree' 유형인 경우 디폴트 값은 'kdtree'이고 그렇지 않은 경우 'exhaustive'입니다.

예: 'NSMethod','exhaustive'

NumNeighbors — 찾을 최근접이웃의 개수

1 (디폴트 값) | 양의 정수 값

예측 시 각 점을 분류하기 위해 X에서 찾을 최근접이웃의 개수로, 'NumNeighbors'와 함께 양의 정수 값이 쉼표로 구분되어 지정됩니다.

예: 'NumNeighbors',3

데이터형: single | double

PredictorNames — 예측 변수 이름

고유한 이름으로 구성된 string형 배열 | 고유한 문자형 벡터로 구성된 셀형 배열

예측 변수 이름으로, 고유한 이름으로 구성된 string형 배열 또는 고유한 문자형 벡터로 구성된 셀형 배열로 지정됩니다. PredictorNames의 기능은 훈련 데이터를 어떤 방식으로 제공하느냐에 따라 달라집니다.

• X와 Y를 제공하는 경우, PredictorNames를 사용하여 X의 예측 변수에 이름을 할당할 수 있습니다.

  • PredictorNames의 이름의 순서는 X의 열 순서와 일치해야 합니다. 즉, PredictorNames{1}은 X(:,1)의 이름이고, PredictorNames{2}는 X(:,2)의 이름이 되는 식입니다. 또한, size(X,2)와 numel(PredictorNames)는 같아야 합니다.

  • 기본적으로 PredictorNames는 {'x1','x2',...}입니다.

• Tbl을 제공하는 경우, PredictorNames를 사용하여 훈련에 사용할 예측 변수를 선택할 수 있습니다. 즉, fitcknn 함수는 PredictorNames의 예측 변수와 이에 대한 응답 변수만을 훈련 중에 사용합니다.

  • PredictorNames는 Tbl.Properties.VariableNames의 부분 집합이어야 하므로 응답 변수의 이름은 포함할 수 없습니다.

  • 기본적으로, PredictorNames는 모든 예측 변수의 이름을 포함합니다.

  • PredictorNames와 formula 중 하나만 사용하여 훈련에 사용할 예측 변수를 지정하는 것이 좋습니다.

예: "PredictorNames",["SepalLength","SepalWidth","PetalLength","PetalWidth"]

데이터형: string | cell

Prior — 사전 확률

'empirical' (디폴트 값) | 'uniform' | 스칼라 값으로 구성된 벡터 | 구조체

각 클래스의 사전 확률로, 'Prior'와 함께 다음 표에 나와 있는 값이 쉼표로 구분되어 지정됩니다.

값	설명
'empirical'	클래스 사전 확률은 Y의 클래스 상대 도수입니다.
'uniform'	모든 클래스 사전 확률은 1/K와 같습니다. 여기서 K는 클래스 개수입니다.
숫자형 벡터	각 요소는 클래스 사전 확률입니다. Mdl.ClassNames에 따라 요소의 순서를 지정하거나 ClassNames 이름-값 쌍의 인수를 사용하여 순서를 지정합니다. 소프트웨어는 합이 1이 되도록 요소를 정규화합니다.
구조체	다음과 같은 두 개의 필드를 갖는 구조체 S입니다. S.ClassNames는 클래스 이름을 Y와 같은 유형의 변수로 포함합니다. S.ClassProbs는 대응되는 사전 확률로 구성된 벡터를 포함합니다. 소프트웨어는 합이 1이 되도록 요소를 정규화합니다.

Weights 및 Prior 모두에 대한 값을 설정하면 합이 각 클래스의 사전 확률 값이 되도록 가중치가 다시 정규화됩니다.

예: 'Prior','uniform'

데이터형: char | string | single | double | struct

ResponseName — 응답 변수 이름

"Y" (디폴트 값) | 문자형 벡터 | string형 스칼라

응답 변수 이름으로, 문자형 벡터 또는 string형 스칼라로 지정됩니다.

• Y를 제공하는 경우, ResponseName을 사용하여 응답 변수의 이름을 지정할 수 있습니다.

• ResponseVarName 또는 formula를 제공하는 경우에는 ResponseName을 사용할 수 없습니다.

예: "ResponseName","response"

데이터형: char | string

Scale — 거리 척도

std(X,'omitnan') (디폴트 값) | 음이 아닌 스칼라 값으로 구성된 벡터

거리 척도로, 'Scale'과 함께 X의 열 개수와 동일한 길이의, 음이 아닌 스칼라 값으로 구성된 벡터가 쉼표로 구분되어 지정됩니다. X와 쿼리 점 간의 각 좌표의 차이는 Scale의 대응되는 요소만큼 스케일링됩니다. 이 인수는 'Distance'가 'seuclidean'인 경우에만 유효합니다.

'Standardize'를 'Scale' 또는 'Cov'와 동시에 지정할 수 없습니다.

데이터형: single | double

ScoreTransform — 점수 변환 방식

"none" (디폴트 값) | "doublelogit" | "invlogit" | "ismax" | "logit" | 함수 핸들 | ...

점수 변환 방식으로, 문자형 벡터, string형 스칼라 또는 함수 핸들로 지정됩니다.

다음 표에는 사용 가능한 문자형 벡터와 string형 스칼라가 요약되어 있습니다.

값	설명
"doublelogit"	1/(1 + e–2x)
"invlogit"	log(x / (1 – x))
"ismax"	최대 점수를 갖는 클래스의 점수를 1로 설정하고, 다른 모든 클래스의 점수를 0으로 설정합니다.
"logit"	1/(1 + e–x)
"none" 또는 "identity"	x(변환 없음)
"sign"	x < 0의 경우 –1 x = 0의 경우 0 x > 0의 경우 1
"symmetric"	2x – 1
"symmetricismax"	최대 점수를 갖는 클래스의 점수를 1로 설정하고, 다른 모든 클래스의 점수를 -1로 설정합니다.
"symmetriclogit"	2/(1 + e–x) – 1

MATLAB 함수나 사용자가 직접 정의하는 함수의 경우, 이에 대한 함수 핸들을 점수 변환에 사용하십시오. 함수 핸들은 행렬(원래 점수)을 받아 동일한 크기의 행렬(변환된 점수)을 반환합니다.

예: "ScoreTransform","logit"

데이터형: char | string | function_handle

Standardize — 예측 변수를 표준화하는 플래그

false (디폴트 값) | true

예측 변수를 표준화하는 플래그로, 'Standardize'와 함께 true(1) 또는 false((0))가 쉼표로 구분되어 지정됩니다.

'Standardize',true를 설정하면 예측 변수 데이터의 각 열(X)이 열 평균과 표준편차를 기준으로 정규화됩니다.

범주형 예측 변수를 표준화하지 않으며, 모든 예측 변수가 범주형일 경우 오류를 발생시킵니다.

'Standardize',1을 'Scale' 또는 'Cov'와 동시에 지정할 수 없습니다.

예측 변수 데이터를 표준화하는 것이 좋습니다.

예: 'Standardize',true

데이터형: logical

Weights — 관측값 가중치

양수 값으로 구성된 숫자형 벡터 | Tbl에 포함된 변수 이름

관측값 가중치로, 'Weights'와 함께 양수 값으로 구성된 숫자형 벡터나 Tbl에 포함된 변수의 이름이 쉼표로 구분되어 지정됩니다. 소프트웨어는 X 또는 Tbl의 각 행에 있는 관측값에 이에 대응하는 Weights의 값을 함께 사용하여 가중치를 적용합니다. Weights의 크기는 X 또는 Tbl의 행 개수와 일치해야 합니다.

입력 데이터를 테이블 Tbl로 지정하는 경우, Weights는 Tbl에서 숫자형 벡터를 포함하는 변수의 이름일 수 있습니다. 이 경우, Weights를 문자형 벡터 또는 string형 스칼라로 지정해야 합니다. 예를 들어, 가중 벡터 W가 Tbl.W로 저장된 경우, 이를 'W'로 지정하십시오. 그렇지 않은 경우, 소프트웨어는 모델을 훈련시킬 때 W를 포함한 Tbl의 모든 열을 예측 변수 또는 응답 변수로 처리합니다.

소프트웨어는 Weights의 총합이 각 클래스의 사전 확률의 값이 되도록 정규화합니다.

기본적으로, Weights는 ones(n,1)입니다. 여기서 n은 X 또는 Tbl에 포함된 관측값 개수입니다.

데이터형: double | single | char | string

교차 검증 옵션

CrossVal — 교차 검증 플래그

'off' (디폴트 값) | 'on'

교차 검증 플래그로, 'Crossval'과 함께 'on' 또는 'off'가 쉼표로 구분되어 지정됩니다.

'on'을 지정하면 10겹 교차 검증을 구현합니다.

이 교차 검증 설정을 재정의하려면 CVPartition, Holdout, KFold, Leaveout 이름-값 쌍의 인수 중 하나를 사용하십시오. 교차 검증된 모델을 생성하려면 한 번에 하나의 교차 검증 이름-값 쌍의 인수만 사용해야 합니다.

또는, crossval 메서드를 사용하여 나중에 Mdl을 교차 검증하십시오.

예: 'Crossval','on'

CVPartition — 교차 검증 분할

[] (디폴트 값) | cvpartition 객체

교차 검증 분할로, 교차 검증의 유형과 훈련 세트 및 검증 세트의 인덱싱을 지정하는 cvpartition 객체로 지정됩니다.

교차 검증된 모델을 생성하려면 다음 4개의 이름-값 인수 중 하나만 지정할 수 있습니다. CVPartition, Holdout, KFold, Leaveout

예: cvp = cvpartition(500,KFold=5)를 사용하여 500개 관측값에 대한 5겹 교차 검증에 사용할 임의 분할을 생성한다고 가정하겠습니다. 그러면 CVPartition=cvp를 설정하여 교차 검증 분할을 지정할 수 있습니다.

Holdout — 홀드아웃 검증에 사용할 데이터의 비율

(0,1) 범위의 스칼라 값

홀드아웃 검증에 사용할 데이터의 비율로, 범위 [0,1] 내 스칼라 값으로 지정됩니다. Holdout=p를 지정하는 경우 소프트웨어는 다음 단계를 완료합니다.

1. 데이터의 p*100%를 무작위로 선택하여 검증 데이터용으로 남겨두고 나머지 데이터를 사용하여 모델을 훈련시킵니다.

2. 교차 검증된 모델의 Trained 속성에 훈련된 간소 모델을 저장합니다.

교차 검증된 모델을 생성하려면 다음 4개의 이름-값 인수 중 하나만 지정할 수 있습니다. CVPartition, Holdout, KFold, Leaveout

예: Holdout=0.1

데이터형: double | single

KFold — 겹의 개수

10 (디폴트 값) | 1보다 큰 양의 정수 값

교차 검증된 모델에 사용할 겹의 개수로, 1보다 큰 양의 정수 값으로 지정됩니다. KFold=k를 지정하는 경우 소프트웨어는 다음 단계를 완료합니다.

1. 데이터를 k개 세트로 임의로 분할합니다.

2. 각 세트마다 해당 세트를 검증 데이터로 남겨두고 나머지 k – 1개의 세트를 사용하여 모델을 훈련시킵니다.

3. 교차 검증된 모델의 Trained 속성에 k×1 셀형 벡터로 k개의 훈련된 간소 모델을 저장합니다.

교차 검증된 모델을 생성하려면 다음 4개의 이름-값 인수 중 하나만 지정할 수 있습니다. CVPartition, Holdout, KFold, Leaveout

예: KFold=5

데이터형: single | double

Leaveout — 리브-원-아웃(Leave-One-Out) 교차 검증 플래그

"off" (디폴트 값) | "on"

리브-원-아웃 교차 검증 플래그로, "on" 또는 "off"로 지정됩니다. Leaveout="on"을 지정하는 경우, n개(여기서 n은 모델의 NumObservations 속성에 지정된 관측값 중 누락된 관측값을 제외한 개수임)의 관측값 각각에 대해 소프트웨어가 다음 단계를 완료합니다.

1. 1개의 관측값을 검증 데이터로 남겨두고 나머지 n – 1개 관측값을 사용하여 모델을 훈련시킵니다.

2. 교차 검증된 모델의 Trained 속성에 n×1 셀형 벡터로 n개의 훈련된 간소 모델을 저장합니다.

교차 검증된 모델을 생성하려면 다음 4개의 이름-값 인수 중 하나만 지정할 수 있습니다. CVPartition, Holdout, KFold, Leaveout

예: Leaveout="on"

데이터형: char | string

하이퍼파라미터 최적화 옵션

OptimizeHyperparameters — 최적화할 모수

'none' (디폴트 값) | 'auto' | 'all' | 적합한 모수 이름으로 구성된 string형 배열 또는 셀형 배열 | optimizableVariable 객체로 구성된 벡터

최적화할 모수로, 'OptimizeHyperparameters'와 함께 다음 값 중 하나가 쉼표로 구분되어 지정됩니다.

• 'none' — 최적화하지 않습니다.

• 'auto' — {'Distance','NumNeighbors','Standardize'}를 사용합니다.

• 'all' — 모든 적합한 모수를 최적화합니다.

• 적합한 모수 이름으로 구성된 string형 배열 또는 셀형 배열.

• optimizableVariable 객체로 구성된 벡터. 일반적으로 hyperparameters의 출력값입니다.

최적화는 모수를 변경하여 fitcknn에 대한 교차 검증 손실(오차)을 최소화하려고 합니다. 이와는 다른 맥락의 교차 검증 손실에 대한 자세한 내용은 Classification Loss 항목을 참조하십시오. 교차 검증 유형과 최적화의 기타 측면을 제어하려면 HyperparameterOptimizationOptions 이름-값 쌍을 사용하십시오.

참고

OptimizeHyperparameters 값은 다른 이름-값 인수를 사용하여 지정하는 모든 값을 재정의합니다. 예를 들어 OptimizeHyperparameters를 "auto"로 설정하면 fitcknn 함수는 "auto" 옵션에 대응되는 하이퍼파라미터를 최적화하고 하이퍼파라미터에 대해 지정된 값을 모두 무시합니다.

fitcknn에 대한 적합한 모수는 다음과 같습니다.

• Distance — fitcknn이 'cityblock', 'chebychev', 'correlation', 'cosine', 'euclidean', 'hamming', 'jaccard', 'mahalanobis', 'minkowski', 'seuclidean', 'spearman' 중에서 탐색을 수행합니다.

• DistanceWeight — fitcknn이 'equal', 'inverse', 'squaredinverse' 중에서 탐색을 수행합니다.

• Exponent — fitcknn이 기본적으로 범위 [0.5,3]에서 양의 실수 값 중에서 탐색을 수행합니다.

• NumNeighbors — fitcknn이 기본적으로 범위 [1, max(2,round(NumObservations/2))]에서 로그 스케일링된 양의 정수 값 중에서 탐색을 수행합니다.

• Standardize — fitcknn이 값 'true'와 'false' 중에서 탐색을 수행합니다.

디폴트가 아닌 값을 가지는 optimizableVariable 객체로 구성된 벡터를 전달하여 디폴트가 아닌 모수를 설정합니다. 예를 들면 다음과 같습니다.

load fisheriris
params = hyperparameters('fitcknn',meas,species);
params(1).Range = [1,20];

params를 OptimizeHyperparameters의 값으로 전달합니다.

기본적으로, 반복 표시가 명령줄에 표시되고, 최적화에 지정된 하이퍼파라미터 개수에 따라 플롯이 표시됩니다. 최적화와 플롯에 대해 목적 함수는 오분류율입니다. 반복 표시를 제어하려면 HyperparameterOptimizationOptions 이름-값 인수에 대한 Verbose 필드를 설정하십시오. 플롯을 제어하려면 HyperparameterOptimizationOptions 이름-값 인수에 대한 ShowPlots 필드를 설정하십시오.

예제는 피팅된 KNN 분류기 최적화하기 항목을 참조하십시오.

예: 'auto'

HyperparameterOptimizationOptions — 최적화에 사용할 옵션

구조체

최적화에 사용할 옵션으로, 구조체로 지정됩니다. 이 인수는 OptimizeHyperparameters 이름-값 인수의 효과를 수정합니다. 이 구조체에 포함된 모든 필드는 선택 사항입니다.

필드 이름	값	디폴트 값
Optimizer	'bayesopt' — 베이즈 최적화를 사용합니다. 내부적으로 이 설정은 bayesopt를 호출합니다. 'gridsearch' — 차원당 NumGridDivisions개 값으로 그리드 탐색을 수행합니다. 'randomsearch' — MaxObjectiveEvaluations개 점 중에서 무작위로 탐색합니다. 'gridsearch'는 그리드에서 균등한 비복원추출을 사용하여 무작위 순서로 탐색을 수행합니다. 최적화를 수행한 후, 명령 sortrows(Mdl.HyperparameterOptimizationResults)를 사용하여 그리드순으로 정렬된 테이블을 얻을 수 있습니다.	'bayesopt'
AcquisitionFunctionName	'expected-improvement-per-second-plus' 'expected-improvement' 'expected-improvement-plus' 'expected-improvement-per-second' 'lower-confidence-bound' 'probability-of-improvement' 최적화는 목적 함수의 런타임에 종속적이기 때문에 이름에 per-second가 포함된 획득 함수는 재현 가능한 결과를 산출하지 않습니다. 이름에 plus가 포함된 획득 함수는 특정 영역을 과도하게 사용하게 될 경우 동작을 수정합니다. 자세한 내용은 획득 함수 유형 항목을 참조하십시오.	'expected-improvement-per-second-plus'
MaxObjectiveEvaluations	목적 함수 실행의 최대 횟수입니다.	'bayesopt' 및 'randomsearch'의 경우 30이고, 'gridsearch'의 경우 그리드 전체입니다.
MaxTime	시간 제한으로, 양의 실수형 스칼라로 지정됩니다. 시간 제한은 초 단위이며, tic과 toc으로 측정됩니다. MaxTime은 함수 계산을 중단시키지 않으므로 실행 시간은 MaxTime을 초과할 수 있습니다.	Inf
NumGridDivisions	'gridsearch'의 경우, 각 차원의 값 개수입니다. 이 값은 각 차원에 대한 값의 개수를 제공하는 양의 정수로 구성된 벡터 또는 모든 차원에 적용되는 스칼라일 수 있습니다. 이 필드는 범주형 변수의 경우 무시됩니다.	10
ShowPlots	플롯 표시 여부를 나타내는 논리값입니다. true인 경우, 이 필드는 반복 횟수에 대해 최선의 관측된 목적 함수 값을 플로팅합니다. 베이즈 최적화를 사용하는 경우(Optimizer가 'bayesopt'임), 이 필드는 최선의 추정된 목적 함수 값도 플로팅합니다. 최선의 관측된 목적 함수 값과 최선의 추정된 목적 함수 값은 각각 반복 표시의 BestSoFar (observed) 열과 BestSoFar (estim.) 열의 값에 대응됩니다. Mdl.HyperparameterOptimizationResults의 속성 ObjectiveMinimumTrace 및 EstimatedObjectiveMinimumTrace에서 이러한 값을 확인할 수 있습니다. 문제에 베이즈 최적화를 위한 하나 또는 두 개의 최적화 모수가 있는 경우, ShowPlots는 이 모수에 대해서도 목적 함수의 모델을 플로팅합니다.	true
SaveIntermediateResults	Optimizer가 'bayesopt'인 경우 결과를 저장할지 여부를 나타내는 논리값입니다. true인 경우, 이 필드는 각 반복마다 'BayesoptResults'라는 이름의 작업 공간 변수를 덮어씁니다. 변수는 BayesianOptimization 객체입니다.	false
Verbose	명령줄에 표시되는 내용: 0 — 반복 표시 안 함 1 — 반복 표시 2 — 추가 정보와 함께 반복 표시 자세한 내용은 bayesopt Verbose 이름-값 인수 및 예제 베이즈 최적화를 사용하여 분류기 피팅 최적화하기를 참조하십시오.	1
UseParallel	베이즈 최적화를 병렬로 실행할지 여부를 나타내는 논리값으로, Parallel Computing Toolbox™가 필요합니다. 병렬 시간 재현이 불가능하기 때문에, 병렬 베이즈 최적화에서 반드시 재현 가능한 결과를 산출하지는 않습니다. 자세한 내용은 Parallel Bayesian Optimization 항목을 참조하십시오.	false
Repartition	매 반복 시 교차 검증을 다시 분할할지 여부를 나타내는 논리값입니다. 이 필드의 값이 false인 경우, 최적화 함수는 최적화에 단일 분할을 사용합니다. true로 설정할 경우, 분할 잡음이 고려되므로 일반적으로 가장 견고한 결과가 제공됩니다. 그러나, true에서 좋은 결과를 생성하려면 적어도 두 배 더 많은 횟수의 함수 실행이 필요합니다.	false
다음과 같은 3개 옵션 중 하나만 사용합니다.
CVPartition	cvpartition으로 생성되는 cvpartition 객체	교차 검증 필드를 지정하지 않을 경우 'Kfold',5
Holdout	홀드아웃 비율을 나타내는 범위 (0,1) 내 스칼라
Kfold	1보다 큰 정수

예: 'HyperparameterOptimizationOptions',struct('MaxObjectiveEvaluations',60)

데이터형: struct

출력 인수

Mdl — 훈련된 k-최근접이웃 분류 모델

ClassificationKNN 모델 객체 | ClassificationPartitionedModel 교차 검증된 모델 객체

훈련된 k-최근접이웃 분류 모델로, ClassificationKNN 모델 객체 또는 ClassificationPartitionedModel 교차 검증된 모델 객체로 반환됩니다.

이름-값 쌍의 인수 KFold, Holdout, , CrossVal 또는 CVPartition 중 어느 하나라도 설정하면, Mdl은 ClassificationPartitionedModel 교차 검증된 모델 객체입니다. 그렇지 않은 경우 Mdl은 ClassificationKNN 모델 객체입니다.

Mdl의 속성을 참조하려면 점 표기법을 사용하십시오. 예를 들어, Mdl.Distance를 입력하여 명령 창에 거리 측정법을 표시할 수 있습니다.

세부 정보

예측

ClassificationKNN은 다음과 같은 절차를 사용하여 점 xnew의 분류를 예측합니다.

1. 훈련 세트 X에서 xnew에 가장 근접한 NumNeighbors개 점을 찾습니다.

2. 이 최근접 점에 대한 NumNeighbors개 응답 변수 값 Y를 찾습니다.

3. Y의 값 중에서 최대 사후 확률을 갖는 분류 레이블 ynew를 할당합니다.

자세한 내용은 predict 도움말 문서에서 Posterior Probability 항목을 참조하십시오.

팁

모델을 훈련시킨 후에는 새 데이터에 대한 레이블을 예측하는 C/C++ 코드를 생성할 수 있습니다. C/C++ 코드를 생성하려면 MATLAB Coder™가 필요합니다. 자세한 내용은 Introduction to Code Generation 항목을 참조하십시오.

알고리즘

• NaNs 또는 <undefined>는 누락 관측값을 나타냅니다. 다음은 데이터 세트 또는 가중치가 누락 관측값을 포함하는 경우 fitcknn의 동작에 대한 설명입니다.

  • Y의 값 또는 가중치가 누락된 경우 fitcknn은 Y와 가중치로부터 그러한 값을 제거하고, 데이터로부터 X의 대응하는 행을 제거합니다. 합이 1이 되도록 가중치를 다시 정규화합니다.

  • 예측 변수를 표준화하도록 지정하거나('Standardize',1) 표준화된 유클리드 거리를 스케일 없이 지정하면('Distance','seuclidean'), fitcknn은 평균과 표준편차를 계산하기 전에 개별 예측 변수에서 누락 관측값을 제거합니다. 다시 말해서, 각 예측 변수에 대해 'omitnan' 옵션을 사용하여 mean과 std를 구현합니다.

  • 공분산 행렬 없이 마할라노비스 거리('Distance','mahalanobis')를 지정할 경우 fitcknn은 하나 이상의 누락값을 포함하는 X의 행을 제거합니다. 다시 말해서, 예측 변수 행렬 X에 대해 'omitrows' 옵션을 사용하여 cov를 구현합니다.

• Cost, Prior 및 Weights 이름-값 인수를 지정할 경우 출력 모델 객체는 지정된 값을 각각 Cost, Prior 및 W 속성에 저장합니다. Cost 속성은 사용자가 지정한 비용 행렬을 그대로 저장합니다. Prior 속성과 W 속성은 각각 정규화한 후의 사전 확률 및 관측값 가중치를 저장합니다. 자세한 내용은 오분류 비용 행렬, 사전 확률 및 관측값 가중치 항목을 참조하십시오.

• 소프트웨어는 예측에 Cost 속성을 사용하지만, 훈련에는 이 속성을 사용하지 않습니다. 따라서 Cost는 읽기 전용이 아닙니다. 훈련된 모델을 만든 후에 점 표기법을 사용하여 속성값을 변경할 수 있습니다.

• 'Standardize',true를 설정했다고 가정하겠습니다.

  • Prior 또는 Weights 이름-값 쌍의 인수도 지정하면 fitcknn이 대응되는 가중 평균과 가중 표준편차를 사용하여 예측 변수를 표준화합니다. 특히, fitcknn은 다음을 사용하여 예측 변수 j를 표준화합니다.

    • $$x_j^{\ast }=\frac{x_j-{\mu }_j^{\ast }}{{\sigma }_j^{\ast }}.$$

      $${\mu }_j^{\ast }=\frac{1}{{\displaystyle \sum _k{w}_k}}{\displaystyle \sum _k{w}_k{x}_{jk}}.$$

      x_jk는 예측 변수 j(열)의 관측값 k(행)입니다.

      $${\left({\sigma }_j^{\ast }\right)}^2=\frac{{\displaystyle \sum _k{w}_k}}{{\left({\displaystyle \sum _k{w}_k}\right)}^2-{\displaystyle \sum _k{w}_k^2}}{\displaystyle \sum _k{w}_k{\left(x_{jk}-{\mu }_j^{\ast }\right)}^2}.$$

  • 'Distance','mahalanobis' 또는 'Distance','seuclidean'도 설정한 경우에는 Scale 또는 Cov를 지정할 수 없습니다. 그 대신 다음을 수행합니다.

    1. 각 예측 변수의 평균 및 표준편차를 계산

    2. 1단계의 결과를 사용하여 데이터를 표준화

    3. 각각의 디폴트 값을 사용하여 거리 모수 값을 계산

• Scale을 지정하고 Prior 또는 Weights를 지정하면 관측된 거리를 가중 표준편차만큼 스케일링합니다.

• Cov를 지정하고 Prior 또는 Weights를 지정하면 거리에 가중 공분산 행렬을 적용합니다. 다시 말해 다음과 같습니다.

  $$Cov=\frac{{\displaystyle \sum _k{w}_k}}{{\left({\displaystyle \sum _k{w}_k}\right)}^2-{\displaystyle \sum _k{w}_k^2}}{\displaystyle \sum _j{\displaystyle \sum }_k^{}{w}_k{\left(x_{jk}-{\mu }_j^{*}\right)}^{\prime }\left(x_j-{\mu }_j^{*}\right)}.$$

대안

fitcknn은 다중클래스 KNN 분류기를 훈련시킬 수 있지만, fitcecoc를 사용하여 다중클래스 학습 문제를 일련의 KNN 이진 학습기로 축소할 수 있습니다.

확장 기능

자동 병렬 지원

Parallel Computing Toolbox™를 사용해 자동 병렬 계산을 실행하여 코드 실행 속도를 높일 수 있습니다.

병렬 하이퍼파라미터 최적화를 수행하려면 fitcknn 함수에 대한 호출에 'HyperparameterOptimizationOptions', struct('UseParallel',true) 이름-값 인수를 사용하십시오.

병렬 하이퍼파라미터 최적화에 대한 자세한 내용은 Parallel Bayesian Optimization 항목을 참조하십시오.

병렬 연산에 대한 일반적인 내용은 자동 병렬 연산을 지원하는 MATLAB 함수 실행하기 (Parallel Computing Toolbox) 항목을 참조하십시오.

GPU 배열

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

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

• 기본적으로 fitcknn 함수는 gpuArray 입력 인수에 대해 최근접이웃 완전 탐색 알고리즘을 사용합니다.

• 이름-값 인수 'NSMethod'를 'kdtree'로 지정할 수 없습니다.

• 이름-값 인수 'Distance'를 함수 핸들로 지정할 수 없습니다.

• 이름-값 인수 'IncludeTies'를 true로 지정할 수 없습니다.

• fitcknn 함수는 다음 중 하나가 적용되는 경우 GPU에서 모델을 피팅합니다.

  • 입력 인수 X가 gpuArray 객체입니다

  • 입력 인수 Tbl이 gpuArray 예측 변수를 포함합니다

자세한 내용은 GPU에서 MATLAB 함수 실행하기 (Parallel Computing Toolbox) 항목을 참조하십시오.

버전 내역

R2014a에 개발됨

R2023b: OptimizeHyperparameters의 "auto" 옵션에 Standardize가 포함됨

R2023b부터, OptimizeHyperparameters 값을 "auto"로 지정하면 fitcknn 함수는 Standardize를 최적화 가능한 하이퍼파라미터로 포함합니다.

참고 항목

ClassificationKNN | ClassificationPartitionedModel | predict | templateKNN | fitcensemble | fitcecoc

도움말 항목

• KNN 분류기 생성하기
• KNN 분류기 수정하기
• 최근접이웃을 사용한 분류