speye

희소 단위 행렬

구문

S = speye

S = speye(n)

S = speye(n,m)

S = speye(sz)

S = speye(___,typename)

설명

S = speye는 희소 형식 스칼라 1을 반환합니다.

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

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

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

S = speye(___,typename)은 지정된 데이터형의 희소 행렬을 반환합니다. 이전 구문에 나와 있는 입력 인수 조합 중 하나와 더불어 데이터형을 지정합니다. (R2025a 이후)

예제

정사각 희소 단위 행렬

1000×1000 정사각 희소 단위 행렬을 만들고 희소성 패턴을 확인합니다.

I = speye(1000);
spy(I)

결과는 sparse(eye(1000))과 동일하지만, 이 후자의 경우 희소 저장 형식으로 변환하기 전에 전체 표현을 위한 임시 저장공간이 필요합니다.

사각 희소 단위 행렬

400×800 희소 단위 행렬을 만들고 0이 아닌 요소의 패턴을 확인합니다.

S = speye(400,800);
spy(S)

이 명령은 speye([400 800])과 동일합니다.

입력 인수

n, m — 차원 크기

음이 아닌 정수 스칼라

차원 크기로, 음이 아닌 정수 스칼라로 지정됩니다.

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

• n 또는 m이 0이면 S는 빈 행렬이 됩니다.

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

예: speye(4)는 4×4 단위 행렬을 만듭니다.

예: speye(3,6)은 3×6 단위 행렬을 만듭니다.

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

typename — 출력 데이터형

"double" (디폴트 값) | "single" | "logical"

R2025a 이후

출력 데이터형으로, "double", "single" 또는 "logical"로 지정됩니다.

sz — 차원 크기

요소를 2개 가진 행 벡터

차원 크기로, 요소를 2개 가진 행 벡터로 지정됩니다. 행 벡터의 형식은 [numRows numCols]입니다.

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

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

예: speye([4 5])는 4×5 행렬을 만들며, speye(4,5)와 동일합니다.

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

출력 인수

S — 출력 행렬

희소 행렬

출력 행렬로, 희소 단위 행렬로 반환됩니다.

확장 기능

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

스레드 기반 환경

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

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

GPU 배열

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

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

• 이 함수를 GPU에서 실행하여 gpuArray 출력값을 얻으려면 다음 구문 중 하나를 사용하십시오.

  • S = gpuArray.speye.

  • S = gpuArray.speye(n).

  • S = gpuArray.speye(n,m).

  • S = gpuArray.speye(sz).

  • S = gpuArray.speye(___,typename). 여기서 typename은 이전 구문 중 하나에 나와 있는 입력 인수 조합과 더불어 데이터형을 지정합니다. (R2025a 이후)

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

분산 배열

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

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

버전 내역

R2006a 이전에 개발됨

R2025a: 단정밀도 희소 행렬 생성

typename 인수를 "double", "single" 또는 "logical"로 지정하여 출력 데이터형을 지정할 수 있습니다.

참고 항목

함수

• spalloc | spones | spdiags | sprand | sprandn | eye