padarray

배열 채우기

구문

B = padarray(A,padsize)

B = padarray(A,padsize,padval)

B = padarray(___,direction)

설명

B = padarray(A,padsize)는 배열 A를 padsize로 지정된 각 차원의 채우기 개수로 채웁니다. padarray 함수는 숫자형 또는 논리형 영상은 값 0으로 채우고 범주 영상은 범주 <undefined>로 채웁니다. 기본적으로 paddarray는 각 차원의 첫 번째 요소 앞과 마지막 요소 뒤에 채우기를 추가합니다.

B = padarray(A,padsize,padval)은 배열 A를 채웁니다. 여기서 padval은 채울 요소에 사용할 상수 값 또는 배열 요소를 복제할 방법을 지정합니다.

B = padarray(___,direction)은 direction으로 지정된 방향으로 A를 채웁니다.

예제

2차원 배열과 3차원 배열에 채우기 추가

벡터 시작 부분 채우기

9를 채우기 값으로 사용하여 벡터 시작 부분에 3요소 채우기를 추가합니다.

A = [ 1 2 3 4 ]

A = 1×4

     1     2     3     4

B = padarray(A,3,9,'pre')

B = 4×4

     9     9     9     9
     9     9     9     9
     9     9     9     9
     1     2     3     4

2차원 배열의 각 차원 채우기

배열의 첫 번째 차원 끝에 3요소 채우기를 추가하고, 두 번째 차원 끝에 2요소 채우기를 추가합니다. 각 차원의 마지막 배열 요소의 값을 채우기 값으로 사용합니다.

A = [ 1 2; 3 4 ]

A = 2×2

     1     2
     3     4

B = padarray(A,[3 2],'replicate','post')

B = 5×4

     1     2     2     2
     3     4     4     4
     3     4     4     4
     3     4     4     4
     3     4     4     4

3차원 배열의 각 차원 채우기

3차원 배열의 각 차원에 3요소 채우기를 추가합니다. 각 채우기 요소에는 값 0이 들어 있습니다.

먼저, 3차원 배열을 만듭니다.

A = [1 2; 3 4];
B = [5 6; 7 8];
C = cat(3,A,B)

C = 
C(:,:,1) =

     1     2
     3     4


C(:,:,2) =

     5     6
     7     8

3차원 배열을 채웁니다.

D = padarray(C,[3 3],0,'both')

D = 
D(:,:,1) =

     0     0     0     0     0     0     0     0
     0     0     0     0     0     0     0     0
     0     0     0     0     0     0     0     0
     0     0     0     1     2     0     0     0
     0     0     0     3     4     0     0     0
     0     0     0     0     0     0     0     0
     0     0     0     0     0     0     0     0
     0     0     0     0     0     0     0     0


D(:,:,2) =

     0     0     0     0     0     0     0     0
     0     0     0     0     0     0     0     0
     0     0     0     0     0     0     0     0
     0     0     0     5     6     0     0     0
     0     0     0     7     8     0     0     0
     0     0     0     0     0     0     0     0
     0     0     0     0     0     0     0     0
     0     0     0     0     0     0     0     0

입력 인수

A — 채울 배열

숫자형 배열 | 논리형 배열 | categorical형 배열

채울 배열로, 임의 차원의 숫자형, 논리형 또는 categorical형 배열로 지정됩니다.

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

padsize — 채우기 개수

음이 아닌 정수로 구성된 벡터

각 차원에 추가할 채우기 개수로, 음이 아닌 정수로 구성된 벡터로 지정됩니다. 예를 들어, padsize 값 [2 3]은 첫 번째 차원을 따라 2요소 채우기를, 두 번째 차원을 따라 3요소 채우기를 추가합니다.

데이터형: double

padval — 채우기 값

0 | 숫자형 스칼라 | "circular" | "replicate" | "symmetric" | string형 스칼라 | 문자형 벡터 | missing

채우기 값으로, 숫자형 스칼라, string형 스칼라 또는 문자형 벡터로 지정됩니다.

다음 표에서는 숫자형 및 논리형 영상에 대한 채우기 옵션을 보여줍니다. 숫자형 및 논리형 영상의 디폴트 채우기 값은 0입니다.

숫자형 및 논리형 영상에 대한 채우기 값

값	설명	예
숫자형 스칼라 X	배열의 경계 밖에 있는 입력 배열 값에 값 X가 할당됩니다. 채우기 옵션이 지정되지 않으면, 디폴트 값은 0입니다.	$$\left[\begin{array}{ccc}3& 1& 4\\ 1& 5& 9\\ 2& 6& 5\end{array}\right]\to \left[\begin{array}{ccccccc}2& 2& 2& 2& 2& 2& 2\\ 2& 2& 2& 2& 2& 2& 2\\ 2& 2& 3& 1& 4& 2& 2\\ 2& 2& 1& 5& 9& 2& 2\\ 2& 2& 2& 6& 5& 2& 2\\ 2& 2& 2& 2& 2& 2& 2\\ 2& 2& 2& 2& 2& 2& 2\end{array}\right]$$
"symmetric"	배열의 경계 밖에 있는 입력 배열 값은 배열 테두리를 기준으로 배열을 대칭 복사하여 계산됩니다.	$$\left[\begin{array}{ccc}3& 1& 4\\ 1& 5& 9\\ 2& 6& 5\end{array}\right]\to \left[\begin{array}{ccccccc}5& 1& 1& 5& 9& 9& 5\\ 1& 3& 3& 1& 4& 4& 1\\ 1& 3& 3& 1& 4& 4& 1\\ 5& 1& 1& 5& 9& 9& 5\\ 6& 2& 2& 6& 5& 5& 6\\ 6& 2& 2& 6& 5& 5& 6\\ 5& 1& 1& 5& 9& 9& 5\end{array}\right]$$
"replicate"	배열의 경계 밖에 있는 입력 배열 값은 가장 가까운 배열 테두리 값과 같은 것으로 간주됩니다.	$$\left[\begin{array}{ccc}3& 1& 4\\ 1& 5& 9\\ 2& 6& 5\end{array}\right]\to \left[\begin{array}{ccccccc}3& 3& 3& 1& 4& 4& 4\\ 3& 3& 3& 1& 4& 4& 4\\ 3& 3& 3& 1& 4& 4& 4\\ 1& 1& 1& 5& 9& 9& 9\\ 2& 2& 2& 6& 5& 5& 5\\ 2& 2& 2& 6& 5& 5& 5\\ 2& 2& 2& 6& 5& 5& 5\end{array}\right]$$
"circular"	배열의 경계 밖에 있는 입력 배열 값은 묵시적으로 입력 배열을 주기적이라고 간주하여 계산됩니다.	$$\left[\begin{array}{ccc}3& 1& 4\\ 1& 5& 9\\ 2& 6& 5\end{array}\right]\to \left[\begin{array}{ccccccc}5& 9& 1& 5& 9& 1& 5\\ 6& 5& 2& 6& 5& 2& 6\\ 1& 4& 3& 1& 4& 3& 1\\ 5& 9& 1& 5& 9& 1& 5\\ 6& 5& 2& 6& 5& 2& 6\\ 1& 4& 3& 1& 4& 3& 1\\ 5& 9& 1& 5& 9& 1& 5\end{array}\right]$$

다음 표에서는 범주 영상에 대한 채우기 옵션을 보여줍니다. 범주 영상의 디폴트 채우기 값은 missing입니다.

범주 영상에 대한 채우기 값

값	설명
string형 스칼라 또는 문자형 벡터	지정된 범주의 요소로 채웁니다. string형 또는 문자형 벡터는 영상의 유효한 범주에 해당해야 합니다.
missing	<undefined> 범주로 채웁니다. 자세한 내용은 missing 항목을 참조하십시오.
"symmetric"	배열의 경계 밖에 있는 입력 배열 값은 배열 테두리를 기준으로 배열을 대칭 복사하여 계산됩니다.
"replicate"	배열의 경계 밖에 있는 입력 배열 값은 가장 가까운 배열 테두리 값과 같은 것으로 간주됩니다.
"circular"	배열의 경계 밖에 있는 입력 배열 값은 묵시적으로 입력 배열을 주기적이라고 간주하여 계산됩니다.

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

direction — 배열을 채울 방향

"both" (디폴트 값) | "post" | "pre"

각 차원을 따라 배열을 채울 방향으로, 다음 값 중 하나로 지정됩니다.

값	의미
"both"	각 차원을 따라 첫 번째 배열 요소 앞과 마지막 배열 요소 뒤에서 채우기를 수행합니다.
"post"	각 차원을 따라 마지막 배열 요소 뒤에서 채우기를 수행합니다.
"pre"	각 차원을 따라 첫 번째 배열 요소 앞에서 채우기를 수행합니다.

데이터형: char | string

출력 인수

B — 채워진 배열

숫자형 배열 | 논리형 배열 | categorical형 배열

채워진 배열로, A와 데이터형이 같은 배열로 반환됩니다.

확장 기능

C/C++ 코드 생성

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

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

• padarray 함수는 C 및 C++ 코드 생성을 지원합니다(MATLAB^® Coder™가 필요함). 자세한 내용은 Code Generation for Image Processing 항목을 참조하십시오.

• 데이터형이 categorical형인 입력 배열은 지원되지 않습니다.

• 코드를 생성할 때 padarray는 최대 3차원 입력값만 지원합니다.

• 입력 인수 padval과 direction은 컴파일타임 상수여야 합니다.

GPU 코드 생성

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

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

• 데이터형이 categorical형인 입력 배열은 지원되지 않습니다.

• 코드를 생성할 때 padarray는 최대 3차원 입력값만 지원합니다.

• 입력 인수 padval과 direction은 컴파일타임 상수여야 합니다.

GPU 배열

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

이 함수는 GPU 배열을 완전히 지원합니다. 자세한 내용은 GPU를 사용한 영상 처리 항목을 참조하십시오.

버전 내역

R2006a 이전에 개발됨

참고 항목

circshift | imfilter | paddata

도움말 항목

• imfilter 경계선 채우기 옵션