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형 배열

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

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

C/C++ 코드 생성

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

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

• 입력 벡터 sz, row, col은 유한한 정수 값만 포함할 수 있습니다.

• 입력 벡터 sz는 코드 생성 시 고정 크기여야 합니다.

• 코드 생성 시 배열의 최대 요소 개수는 코드 생성기와 타깃 하드웨어에 의해 제한됩니다. Array Size Restrictions for Code Generation (MATLAB Coder) 항목을 참조하십시오. 요소가 최대 요소 개수보다 많은 배열에 대해서는 크기 벡터 sz가 지원되지 않습니다.

GPU 코드 생성

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

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

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

스레드 기반 환경

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

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

GPU 배열

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

sub2ind 함수는 GPU 배열을 완전히 지원합니다. GPU에서 이 함수를 실행하려면 입력 데이터를 gpuArray (Parallel Computing Toolbox)로 지정하십시오. 자세한 내용은 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

도움말 항목

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