shiftdim

배열 차원 이동

구문

B = shiftdim(A,n)

B = shiftdim(A)

[B,m] = shiftdim(A)

설명

B = shiftdim(A,n)은 배열 A의 차원을 n개 자리만큼 이동시킵니다. shiftdim은 n이 양의 정수이면 차원을 왼쪽으로 이동시키고 n이 음의 정수이면 오른쪽으로 이동시킵니다. 예를 들어, A가 2×3×4 배열이면 shiftdim(A,2)는 4×2×3 배열을 반환합니다.

B = shiftdim(A)는 A와 요소가 동일한 배열을 반환하는데 길이가 1인 선행 차원을 제거한 상태로 반환합니다.

[B,m] = shiftdim(A)는 제거된 길이가 1인 차원 수도 반환합니다.

예제

4차원 배열

4×2×3×5 배열을 만듭니다. 차원을 왼쪽으로 2개 자리만큼 이동시켜 처음 2개의 길이가 마지막 2개의 차원으로 순환되도록 합니다.

A = rand(4,2,3,5);
B = shiftdim(A,2);
size(B)

ans = 1×4

     3     5     4     2

차원을 오른쪽으로 2개 자리만큼 이동시켜 길이가 1인 선행 차원 2개를 생성합니다. 오른쪽으로 이동시키면 차원의 길이가 순환되지 않습니다.

C = shiftdim(A,-2); 
size(C)

ans = 1×6

     1     1     4     2     3     5

배열 차원 이동하기

배열의 차원을 이동시킵니다.

5차원 배열 A를 계산하고 길이가 1인 선행 차원을 제거합니다. shiftdim 함수는 2개의 차원만큼 이동시키고 3차원 배열 B를 반환합니다.

A = rand(1,1,3,2,4);
[B,nshifts] = shiftdim(A);
nshifts

nshifts = 
2

size(B)

ans = 1×3

     3     2     4

B의 차원을 왼쪽으로 두 번 이동시킵니다.

C = shiftdim(B,2);
size(C)

ans = 1×3

     4     3     2

C의 차원을 오른쪽으로 한 번 이동시킵니다.

D = shiftdim(C,-1); 
size(D)

ans = 1×4

     1     4     3     2

입력 인수

A — 입력 배열

벡터 | 행렬 | 다차원 배열

입력 배열로, 벡터, 행렬, 다차원 배열 중 하나로 지정됩니다.

n — 자리의 개수

정수

이동시킬 차원 자리의 개수로, 정수로 지정됩니다. n이 양수인 경우 shiftdim은 차원을 왼쪽으로 이동시키고 선행 차원을 끝으로 순환시킵니다. n이 음수인 경우, shiftdim은 차원을 오른쪽으로 이동시키고 추가적인 선행 차원을 길이 1로 채웁니다.

출력 인수

B — 출력 배열

벡터 | 행렬 | 다차원 배열

출력 배열로, 벡터, 행렬 또는 다차원 배열로 지정됩니다.

m — 제거된 차원 수

음이 아닌 정수

제거된 차원 수로, 음이 아닌 정수로 지정됩니다. shiftdim은 길이가 1인 선행 차원만 제거합니다.

확장 기능

C/C++ 코드 생성

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

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

• 입력 배열 A는 셀형 배열일 수 없습니다.

• 입력 인수 n이 사용될 경우, 이 인수는 코드 생성 시 상수여야 합니다.

• 입력 인수 n을 지정하지 않을 경우 코드 생성기는 A에서 가변 크기이거나 1보다 큰 고정 크기를 갖는 첫 번째 차원을 식별합니다. 이 차원이 코드 생성 시점에 가변 크기이고 런타임에 1인 경우, 런타임 오류가 발생할 수 있습니다.

• n이 양수이고 A의 마지막 차원이 코드 생성 시에 가변 크기이면, 이 차원은 런타임에 크기가 1일 수 없습니다.

GPU 코드 생성

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

C/C++ 코드 생성 섹션의 사용법 관련 참고 및 제한 사항을 참조하십시오. GPU 코드 생성에도 동일한 사용법 관련 참고 및 제한 사항이 적용됩니다.

스레드 기반 환경

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

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

GPU 배열

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

shiftdim 함수는 GPU 배열을 완전히 지원합니다. GPU에서 이 함수를 실행하려면 입력 데이터를 gpuArray (Parallel Computing Toolbox)로 지정하십시오. 자세한 내용은 GPU에서 MATLAB 함수 실행하기 (Parallel Computing Toolbox) 항목을 참조하십시오.

분산 배열

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

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

버전 내역

R2006a 이전에 개발됨

참고 항목

circshift | reshape | squeeze | permute