eye

단위 행렬(Identity Matrix)

구문

I = eye

I = eye(n)

I = eye(n,m)

I = eye(sz)

I = eye(___,typename)

I = eye(___,like=p)

설명

I = eye는 스칼라 1을 반환합니다.

I = eye(n)은 주대각선상의 요소가 1이며, 그 외 나머지 요소가 0으로 구성된 n×n 크기의 단위 행렬을 반환합니다.

I = eye(n,m)은 주대각선상의 요소가 1이며, 그 외 나머지 요소가 0으로 구성된 n×m 크기의 행렬을 반환합니다.

I = eye(sz)는 주대각선상의 요소가 1이며, 그 외 나머지 요소가 0으로 구성된 배열을 반환합니다. sz는 size(I)를 정의하는 크기 벡터입니다. 예를 들어, eye([2,3])은 주대각선상의 요소가 1이며 그 외 나머지 요소가 0으로 구성된 2×3 크기의 배열을 반환합니다.

I = eye(___,typename)은 위에 열거된 구문에 I의 데이터형(클래스)도 지정합니다. 예를 들어, eye(5,"int8")은 8비트 정수로 구성된 5×5 단위 행렬을 반환합니다.

I = eye(___,like=p)는 I가 숫자형 변수 p와 동일한 데이터형, 희소성, 실수/복소수 여부를 갖도록 지정합니다.

예제

정사각 단위 행렬

4×4 단위 행렬을 만듭니다.

I = eye(4)

I = 4×4

     1     0     0     0
     0     1     0     0
     0     0     1     0
     0     0     0     1

사각 행렬

2×3 단위 행렬을 만듭니다.

I = eye(2,3)

I = 2×3

     1     0     0
     0     1     0

단위 벡터

3×1 단위 벡터를 만듭니다.

sz = [3,1];
I = eye(sz)

I = 3×1

     1
     0
     0

디폴트 형식이 아닌 숫자 데이터형

32비트 부호 없는 정수를 요소로 가지는 3×3 단위 행렬을 만듭니다.

I = eye(3,"uint32")

I = 3×3 uint32 matrix

   1   0   0
   0   1   0
   0   0   1

class(I)

ans = 
'uint32'

복소 단위 행렬

요소의 값이 기존 배열과 같은 복소수인, 2×2 단위 행렬을 만듭니다.

복소수 벡터를 정의합니다.

p = [1+2i 3i];

p와 같은 복소 단위 행렬을 만듭니다.

I = eye(2,like=p)

I = 2×2 complex

   1.0000 + 0.0000i   0.0000 + 0.0000i
   0.0000 + 0.0000i   1.0000 + 0.0000i

희소 단위 행렬

5×5 희소 행렬을 정의합니다.

p = sparse(5,5,pi);

P와 같은 5×5 희소 단위 행렬을 만듭니다.

I = eye(5,like=p)

I = 5×5 sparse double matrix (5 nonzeros)
   (1,1)        1
   (2,2)        1
   (3,3)        1
   (4,4)        1
   (5,5)        1

크기와 숫자 데이터형을 기존 배열과 동일하게 정의

2×2 단정밀도 행렬을 정의합니다.

p = single([1 3; 2 4]);

크기와 데이터형이 p와 동일한 단위 행렬을 만듭니다.

I = eye(size(p),like=p)

I = 2×2 single matrix

     1     0
     0     1

class(I)

ans = 
'single'

입력 인수

n — I의 첫 번째 차원 크기

정수 값

I의 첫 번째 차원 크기로, 정수 값으로 지정됩니다.

• n이 유일한 정수 입력 인수인 경우, I는 n×n 크기의 정사각 단위 행렬이 됩니다.

• n이 0이면 I는 빈 행렬이 됩니다.

• n이 음수이면 0으로 처리됩니다.

데이터형: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

m — I의 두 번째 차원 크기

정수 값

I의 두 번째 차원 크기로, 정수 값으로 지정됩니다.

• m이 0이면 I는 빈 행렬이 됩니다.

• m이 음수인 경우, 두 번째 차원 크기는 0으로 처리됩니다.

데이터형: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

sz — I의 크기

두 개 이하의 정수 값으로 구성된 행 벡터

I의 크기로, 두 개 이하의 정수 값으로 구성된 행 벡터로 지정됩니다.

• sz의 요소가 0인 경우, I는 빈 행렬이 됩니다.

• sz의 요소가 음수인 경우, 요소는 0으로 처리됩니다.

예: sz = [2 3]은 I를 2×3 행렬로 정의합니다.

데이터형: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

typename — 출력값 클래스

"double" (디폴트 값) | "single" | "logical" | "int8" | "uint8" | ...

출력값 클래스로, "double", "single", "logical", "int8", "uint8", "int16", "uint16", "int32", "uint32", "int64" 또는 "uint64"로 지정됩니다.

p — 프로토타입

숫자형 변수

프로토타입으로, 숫자형 변수로 지정됩니다.

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

출력 인수

I — 단위 행렬(Identity Matrix)

스칼라 | 행렬

단위 행렬로, 스칼라 또는 행렬로 반환됩니다.

확장 기능

C/C++ 코드 생성

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

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

• typename은 MATLAB^® 내장 숫자형이어야 합니다. 다른 클래스의 경우 정적 eye 메서드를 불러오지 않습니다. 예를 들어, eye(m, n, 'myclass')는 myclass.eye(m,n)을 불러오지 않습니다.

• 크기 인수는 고정된 크기를 가져야 합니다.

GPU 코드 생성

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

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

• typename은 MATLAB 내장 숫자형이어야 합니다. 다른 클래스의 경우 정적 eye 메서드를 불러오지 않습니다. 예를 들어, eye(m, n, 'myclass')는 myclass.eye(m,n)을 불러오지 않습니다.

• 크기 인수는 고정된 크기를 가져야 합니다.

스레드 기반 환경

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

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

GPU 배열

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

eye 함수는 GPU 배열 입력값을 지원하지만 다음과 같은 사용법 관련 참고 및 제한 사항이 있습니다.

• typename을 'gpuArray'로 지정할 수 있습니다. typename을 'gpuArray'로 지정하는 경우 배열의 디폴트 기본 유형은 double입니다.

  기본 유형 datatype을 갖는 GPU 배열을 만들려면 typename 앞에 추가 인수로 기본 유형을 지정하십시오. 예를 들어, I = eye(3,datatype,'gpuArray')는 기본 유형 datatype을 사용하는 3×3 GPU 단위 행렬을 만듭니다.

  기본 유형 datatype은 다음 옵션 중 하나로 지정할 수 있습니다.

  • 'double'

  • 'single'

  • 'logical'

  • 'int8'

  • 'uint8'

  • 'int16'

  • 'uint16'

  • 'int32'

  • 'uint32'

  • 'int64'

  • 'uint64'

• 숫자형 변수 p를 gpuArray로 지정할 수도 있습니다.

  p를 gpuArray로 지정하는 경우 반환되는 배열의 기본 유형은 p와 같습니다.

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

분산 배열

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

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

• typename을 'codistributed' 또는 'distributed'로 지정할 수 있습니다. typename을 'codistributed' 또는 'distributed'로 지정하면 반환된 배열의 디폴트 기본 유형은 double입니다.

  기본 유형 datatype을 갖는 분산 배열 또는 공동분산 배열을 만들려면 typename 앞에 추가 인수로 기본 유형을 지정하십시오. 예를 들어, I = eye(3,datatype,'distributed')는 기본 유형 datatype을 사용하는 3×3 분산 단위 행렬을 만듭니다.

  기본 유형 datatype은 다음 옵션 중 하나로 지정할 수 있습니다.

  • 'double'

  • 'single'

  • 'logical'

  • 'int8'

  • 'uint8'

  • 'int16'

  • 'uint16'

  • 'int32'

  • 'uint32'

  • 'int64'

  • 'uint64'

• 또한 p를 codistributed 또는 distributed 배열로 지정할 수도 있습니다.

  p를 codistributed 또는 distributed 배열로 지정하는 경우 반환되는 배열의 기본 유형은 p와 같습니다.

• 추가적인 codistributed 구문을 보려면 eye (codistributed) (Parallel Computing Toolbox) 함수를 참조하십시오.

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

버전 내역

R2006a 이전에 개발됨

참고 항목

speye | ones | zeros

도움말 항목

• 배열 생성 함수에 대한 클래스 지원