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

sub2ind

첨자를 선형 인덱스로 변환

구문

ind = sub2ind(sz,row,col)

ind = sub2ind(sz,I1,I2,...,In)

설명

ind = sub2ind(sz,row,col)은 row, col에 지정된 행과 열 첨자에 대응하는 선형 인덱스 ind를 크기가 sz인 행렬에 대해 반환합니다. 여기서 sz는 요소를 2개 가진 벡터로, sz(1)은 행 개수를 지정하고 sz(2)는 열 개수를 지정합니다.

ind = sub2ind(sz,I1,I2,...,In)은 n개의 배열 I1,I2,...,In에 지정된 다차원 첨자에 대응하는 선형 인덱스 ind를 크기가 sz인 다차원 배열에 대해 반환합니다. 여기서 sz는 각 배열의 차원 크기를 지정하는 n개의 요소로 이루어진 벡터입니다.

예제

첨자를 행렬에 대한 선형 인덱스로 변환하기

첨자(위치 기준 인덱싱)에서 3×3 행렬에 대한 선형 인덱스로의 매핑은 다음과 같이 나타낼 수 있습니다.

3×3 행렬의 행 첨자와 열 첨자를 지정합니다. 첨자를 선형 인덱스로 변환합니다.

row = [1 2 3 1];
col = [2 2 2 3];
sz = [3 3];
ind = sub2ind(sz,row,col)

ind = 1×4

     4     5     6     7

3차원 배열의 첨자를 선형 인덱스로 변환하기

2×2×2 배열의 첨자를 선형 인덱스로 매핑하면 다음과 같습니다.

2×2×2 배열의 행 첨자, 열 첨자, 페이지 첨자를 지정합니다. 첨자를 선형 인덱스로 변환합니다.

I1 = [1 2 1 2];
I2 = [2 2 1 1];
I3 = [1 1 2 2];
sz = [2 2 2];
ind = sub2ind(sz,I1,I2,I3)

ind = 1×4

     3     4     5     6

3차원 배열의 요소에 액세스하기

3차원 배열의 첨자 인덱스를 하나의 선형 인덱스로 변환합니다.

배열을 만들고 (2,1,2) 위치의 요소에 대응하는 선형 인덱스를 찾습니다.

A = rand(3,4,2);
linearInd = sub2ind(size(A),2,1,2)

linearInd = 14

두 인덱스 형태가 모두 동일한 요소를 나타내는지 확인합니다.

A(2,1,2)

ans = 0.4854

A(14)

ans = 0.4854

입력 인수

sz — 배열의 크기

양의 정수로 구성된 벡터

배열의 크기로, 양의 정수로 구성된 벡터로 지정됩니다. 이 벡터의 요소는 각각 대응하는 차원의 크기를 나타냅니다. 예를 들어, [2 3 4]는 2×3×4 배열을 정의합니다.

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

row — 행 첨자

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

행 첨자로, 스칼라, 벡터, 행렬 또는 다차원 배열로 지정됩니다. row와 col은 크기가 같은 배열이거나, 둘 중 하나가 스칼라일 수 있습니다.

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

col — 열 첨자

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

열 첨자로, 스칼라, 벡터, 행렬 또는 다차원 배열로 지정됩니다. row와 col은 크기가 같은 배열이거나, 둘 중 하나가 스칼라일 수 있습니다.

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

I1,I2,...,In — 다차원 첨자

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

다차원 첨자로, 스칼라, 벡터, 행렬 또는 다차원 배열로 지정됩니다. I1,I2,…,In은 크기가 같은 배열이거나, 둘 중 하나가 스칼라일 수 있습니다.

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

출력 인수

ind — 선형 인덱스

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

선형 인덱스로, 스칼라, 벡터, 행렬 또는 다차원 배열로 반환됩니다.

• 첨자 입력값의 크기가 모두 같으면 ind도 같은 크기를 갖게 됩니다.

• 첨자 입력값이 스칼라와 배열의 혼합인 경우, ind는 스칼라가 아닌 쪽의 첨자 입력값이 갖는 크기를 가집니다.

데이터형: double

알고리즘

배열 A의 경우, ind = sub2ind(size(A),I1,…,In)이면 모든 k에 대해 A(ind(k)) = A(I1(k),…,In(k))입니다.

확장 기능

tall형 배열

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

이 함수는 tall형 배열을 완전히 지원합니다. 자세한 내용은 tall형 배열 항목을 참조하십시오.

C/C++ 코드 생성

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

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

• 첫 번째 인수는 유효한 크기 벡터여야 합니다. 코드 생성 시 요소가 intmax보다 많은 배열에 대해서는 크기 벡터가 지원되지 않습니다.

• 생성된 코드는 NaN 입력값을 범위를 벗어난 것으로 처리하고 런타임 오류를 발생시킵니다.

• Variable-Sizing Restrictions for Code Generation of Toolbox Functions (MATLAB Coder) 항목을 참조하십시오.

GPU 코드 생성

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

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

• 첫 번째 인수는 유효한 크기 벡터여야 합니다. 코드 생성 시 요소가 intmax보다 많은 배열에 대해서는 크기 벡터가 지원되지 않습니다.

스레드 기반 환경

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

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

GPU 배열

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

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

분산 배열

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

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

버전 내역

R2006a 이전에 개발됨

R2024a: sub2ind가 첨자 입력값에 스칼라와 벡터의 혼합을 허용함

이제 sub2ind가 스칼라 확장을 활용하고 첨자 입력값에 스칼라와 벡터의 혼합을 허용합니다. 예를 들어, sub2ind(sz,[1 2 3],2)는 이제 sub2ind(sz,[1 2 3],[2 2 2])와 동일합니다. 이전에는 첨자 입력값의 크기가 같아야 했습니다.

참고 항목

ind2sub | find | size

도움말 항목

• 배열 인덱싱
• 다차원 배열