diag

대각 행렬을 생성하거나 행렬의 대각선 요소 가져오기

페이지 내 모두 축소

구문

D = diag(v)

D = diag(v,k)

x = diag(A)

x = diag(A,k)

설명

예제

D = diag(v)는 주대각선에 벡터v의 요소를 가진 정사각 대각 행렬을 반환합니다.

예제

D = diag(v,k)는k번째 대각선에 벡터v의 요소를 배치합니다.k=0은 주대각선을 나타내고k>0은 주대각선 위쪽이고k<0은 주대각선 아래쪽입니다.

예제

x = diag(A)는A의 주대각선 요소로 구성된 열 벡터를 반환합니다.

예제

x = diag(A,k)는A의k번째 대각선 요소로 구성된 열 벡터를 반환합니다.

예제

모두 축소

대각 행렬 생성

라이브 스크립트 열기

1×5 벡터를 생성합니다.

v = [2 1 -1 -2 -5];

diag를 사용하여 주대각선에v요소를 가진 행렬을 만듭니다.

D = diag(v)

D =5×52 0 0 0 0 0 1 0 0 0 0 0 -1 0 0 0 0 0 -2 0 0 0 0 0 -5

첫 번째 상부 대각선(k=1)에v의 요소를 가지는 행렬을 만듭니다.

D1 =诊断接头(v, 1)

D1 =6×60 2 0 0 0 0 0 0 1 0 0 0 0 0 0 -1 0 0 0 0 0 0 -2 0 0 0 0 0 0 -5 0 0 0 0 0 0

그 결과로 6×6 행렬이 생성됩니다. 입력값으로 길이가n인 벡터를 지정하는 경우diag는 크기가n+abs(k)인 정사각 행렬을 반환합니다.

대각선 요소 가져오기

라이브 스크립트 열기

6×6 확률 행렬의 주대각선 요소를 가져옵니다.

A = randi(10,6)

A =6×69 3 10 8 7 8 10 6 5 10 8 1 2 10 9 7 8 3 10 10 2 1 4 1 7 2 5 9 7 1 1 10 10 10 2 9

x = diag(A)

x =6×19 6 9 1 7 9

A의 첫 번째 하부대각선(k=-1)상의 요소를 가져옵니다. 그 결과로 주대각선보다 요소가 한 개 더 적어집니다.

x1 = diag(A,-1)

x1 =5×110 10 2 9 2

diag를 두 번 호출하면 원본 행렬의 대각선 요소로 구성된 대각 행렬이 반환됩니다.

A1 = diag(diag(A))

A1 =6×69 0 0 0 0 0 0 6 0 0 0 0 0 0 9 0 0 0 0 0 0 1 0 0 0 0 0 0 7 0 0 0 0 0 0 9

입력 인수

모두 축소

`v`—대각선 요소
벡터

대각선 요소로, 벡터로 지정됩니다.v가N개 요소를 가진 벡터인 경우diag(v,k)는 차수N+abs(k)의 정사각 행렬입니다.

diag([])는 빈 행렬[]을 반환합니다.

`A`—입력 행렬
행렬

입력 행렬입니다.ndims(A) > 2인 경우diag는 오류를 반환합니다.

diag([])는 빈 행렬[]을 반환합니다.

`k`—대각선 번호
정수

대각선 번호로, 정수로 지정됩니다.k=0은 주대각선을 나타내고k>0은 주대각선 위쪽이고k<0은 주대각선 아래쪽입니다.

m×n 행렬의 경우k는 범위 $(- m + 1) \leq k \leq (n - 1) .$ 내에 있습니다.

팁

행렬의trace는sum(diag(A))와 동일합니다.

확장 기능

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

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

k를 제공할 경우 그 값은 실수형 정수 스칼라 값이어야 합니다.
가변 길이 벡터(1×: 또는 :×1)인 가변 크기 입력값에 대해diag는다음과같이동작합니다。
- 입력값을 벡터로 취급
- 지정한 대각선을 따라 입력 벡터가 있는 행렬 반환
가변 길이 벡터가 아닌 가변 크기 입력값에 대해diag는다음과같이동작합니다。
- 입력값을 행렬로 취급
- 런타임에 입력값으로 벡터를 받을 수 없음
- 가변 길이 벡터 반환
입력값이 가변 크기(:m×:n)이고 런타임에 0×0 형태인 경우 출력값은 0×0이 아니라 0×1입니다. 하지만 입력값에 크기가 0×0인 상수가 포함되어 있으면 출력값은[]입니다.
가변 길이 벡터(1×: 또는 :×1)가 아닌 가변 크기 입력값의 경우diag는 입력값을 대각 벡터를 추출할 행렬로 취급합니다. 입력 배열이 런타임에 벡터인 경우에도 이와 같이 동작합니다.diag가1×: 또는 :×1이 아닌 가변 크기 입력값으로 행렬을 만들도록 하려면 다음을 사용하십시오.
- diag(x)대신diag(x(:))
- diag(x,k)대신diag(x(:),k)
Variable-Sizing Restrictions for Code Generation of Toolbox Functions(MATLAB Coder)항목을참조하십시오。

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

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

k를 제공할 경우 그 값은 실수형 정수 스칼라 값이어야 합니다.
가변 길이 벡터(1×: 또는 :×1)인 가변 크기 입력값에 대해diag는다음과같이동작합니다。
- 입력값을 벡터로 취급
- 지정한 대각선을 따라 입력 벡터가 있는 행렬 반환
가변 길이 벡터가 아닌 가변 크기 입력값에 대해diag는다음과같이동작합니다。
- 입력값을 행렬로 취급
- 런타임에 입력값으로 벡터를 받을 수 없음
- 가변 길이 벡터 반환
입력값이 가변 크기(:m×:n)이고 런타임에 0×0 형태인 경우 출력값은 0×0이 아니라 0×1입니다. 하지만 입력값에 크기가 0×0인 상수가 포함되어 있으면 출력값은[]입니다.
가변 길이 벡터(1×: 또는 :×1)가 아닌 가변 크기 입력값의 경우diag는 입력값을 대각 벡터를 추출할 행렬로 취급합니다. 입력 배열이 런타임에 벡터인 경우에도 이와 같이 동작합니다.diag가1×: 또는 :×1이 아닌 가변 크기 입력값으로 행렬을 만들도록 하려면 다음을 사용하십시오.
- diag(x)대신diag(x(:))
- diag(x,k)대신diag(x(:),k)