permute

배열 차원 치환

구문

B = permute(A,dimorder)

설명

B = permute(A,dimorder)는 배열의 차원을 벡터 dimorder에 지정된 순서대로 재배열합니다. 예를 들어, permute(A,[2 1])은 행렬 A의 행 차원과 열 차원을 서로 바꿉니다. 일반적으로 출력 배열의 i번째 차원은 입력 배열의 차원 dimorder(i)입니다.

예제

3차원 배열

3×4×2 배열을 만들고, 첫 번째와 세 번째 차원을 서로 치환하여 2×4×3 배열이 되도록 합니다.

rng default
A = rand(3,4,2)

A = 
A(:,:,1) =

    0.8147    0.9134    0.2785    0.9649
    0.9058    0.6324    0.5469    0.1576
    0.1270    0.0975    0.9575    0.9706


A(:,:,2) =

    0.9572    0.1419    0.7922    0.0357
    0.4854    0.4218    0.9595    0.8491
    0.8003    0.9157    0.6557    0.9340

B = permute(A,[3 2 1])

B = 
B(:,:,1) =

    0.8147    0.9134    0.2785    0.9649
    0.9572    0.1419    0.7922    0.0357


B(:,:,2) =

    0.9058    0.6324    0.5469    0.1576
    0.4854    0.4218    0.9595    0.8491


B(:,:,3) =

    0.1270    0.0975    0.9575    0.9706
    0.8003    0.9157    0.6557    0.9340

szB = size(B)

szB = 1×3

     2     4     3

입력 인수

A — 입력 배열

벡터 | 행렬 | 다차원 배열

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

dimorder — 차원 순서

행 벡터

차원 순서로, 입력 배열의 차원을 나타내는 고유한 양의 정수 요소로 구성된 행 벡터로 지정됩니다.

확장 기능

tall형 배열

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

이 함수는 tall형 배열을 지원하지만 다음과 같은 제한 사항이 있습니다.

tall 차원(첫 번째 차원)을 치환하는 것은 지원되지 않습니다.

자세한 내용은 메모리에 담을 수 없는 큰 데이터를 위한 tall형 배열 항목을 참조하십시오.

C/C++ 코드 생성

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

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

• dimorder는 고정된 크기의 행 벡터여야 합니다.

• B가 이종 셀형 배열인 경우 dimorder는 상수여야 합니다. 이종 셀형 배열에 대해 자세히 알아보려면 Code Generation for Cell Arrays (MATLAB Coder) 항목을 참조하십시오.

스레드 기반 환경

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

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

GPU 배열

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

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

분산 배열

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

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

버전 내역

R2006a 이전에 개발됨

R2025a: 코드 생성 지원

이 함수에 대한 C/C++ 코드를 생성할 수 있습니다.

R2019b: 정수가 아닌 차원 순서 인수나 복소수 차원 순서 인수로 인한 오류 발생

R2019b부터는 dimorder의 값이 정수가 아니거나 복소수 값인 경우 구문 permute(A,dimorder)가 오류를 생성합니다. 이러한 값 대신 dimorder에 대해 양의 실수형 정수 값을 지정하십시오.

참고 항목

ipermute | reshape | shiftdim | transpose