concatenationLayer

R2026b

결합 계층

설명

결합 계층은 입력값을 받아서 지정된 차원을 따라 결합합니다. 입력값은 결합 차원을 제외한 모든 차원에서 크기가 동일해야 합니다.

계층을 만들 때 계층의 입력값의 개수를 지정합니다. 입력값은 'in1','in2',...,'inN'과 같은 이름을 갖습니다. 여기서 N은 입력값의 개수입니다. 입력값 이름은 connectLayers 또는 disconnectLayers를 사용하여 계층을 연결하거나 연결을 끊을 때 사용합니다.

생성

구문

layer = concatenationLayer(dim,numInputs)

layer = concatenationLayer(dim,numInputs,Name=name)

설명

layer = concatenationLayer(dim,numInputs)는 지정된 차원 dim을 따라 numInputs개의 입력값을 결합하는 결합 계층을 만듭니다. 이 함수는 Dim 속성과 NumInputs 속성도 설정합니다.

layer = concatenationLayer(dim,numInputs,Name=name)은 계층 이름도 지정합니다.

입력 인수

dim — 결합 차원

양의 정수

결합 차원으로, 양의 정수로 지정됩니다.

R2026a 이전: 계층은 채널 및 공간 차원에 대해서만 결합을 지원합니다.

이 인수는 Dim 속성을 설정합니다.

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

numInputs — 입력값의 개수

양의 정수

계층에 대한 입력값의 개수로, 2보다 크거나 같은 양의 정수로 지정됩니다.

입력값은 'in1', 'in2' 그리고 'inN'과 같은 이름을 갖습니다. 여기서 N은 입력값의 개수입니다. 예를 들어, 입력값의 개수가 3인 경우 입력값은 'in1', 'in2', 'in3'이라는 이름을 갖습니다. 입력값 이름은 connectLayers 함수 또는 disconnectLayers 함수를 사용하여 계층을 연결하거나 연결을 끊을 때 사용합니다.

이 인수는 NumInputs 속성을 설정합니다.

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

name — 계층 이름

"" (디폴트 값) | 문자형 벡터 | string형 스칼라

계층 이름으로, 문자형 벡터 또는 string형 스칼라로 지정됩니다. Layer 배열 입력에 대해 trainnet 및 dlnetwork 함수는 이름이 지정되지 않은 계층에 자동으로 이름을 할당합니다.

이 인수는 Name 속성을 설정합니다.

데이터형: char | string

속성

결합

Dim — 결합 차원

양의 정수

이 속성은 객체 생성 후에는 읽기 전용입니다. 이 속성을 설정하려면 ConcatenationLayer 객체를 만들 때 대응되는 위치 입력값 인수를 사용하십시오.

결합 차원으로, 양의 정수로 지정됩니다.

R2026a 이전: 계층은 채널 및 공간 차원에 대해서만 결합을 지원합니다.

데이터형: double

계층

Name — 계층 이름

'' (디폴트 값) | 문자형 벡터

계층 이름으로, 문자형 벡터로 지정됩니다. Layer 배열 입력값에 대해 trainnet 및 dlnetwork 함수는 이름이 지정되지 않은 계층에 자동으로 이름을 할당합니다.

데이터형: char

NumInputs — 입력값의 개수

양의 정수

이 속성은 객체 생성 후에는 읽기 전용입니다. 이 속성을 설정하려면 ConcatenationLayer 객체를 만들 때 대응되는 위치 입력값 인수를 사용하십시오.

계층에 대한 입력값의 개수로, 2보다 크거나 같은 양의 정수로 표현됩니다.

입력값은 'in1', 'in2' 그리고 'inN'과 같은 이름을 갖습니다. 여기서 N은 입력값의 개수입니다. 예를 들어, 입력값의 개수가 3인 경우 입력값은 'in1', 'in2', 'in3'이라는 이름을 갖습니다. 입력값 이름은 connectLayers 함수 또는 disconnectLayers 함수를 사용하여 계층을 연결하거나 연결을 끊을 때 사용합니다.

데이터형: double

InputNames — 입력값 이름

읽기 전용: {'in1','in2',…,'inN'} (디폴트 값)

읽기 전용 속성입니다.

입력값 이름으로, {'in1','in2',...,'inN'}으로 표현됩니다. 여기서 N은 계층의 입력값 개수입니다.

데이터형: cell

NumOutputs — 출력값 개수

읽기 전용: 1 (디폴트 값)

읽기 전용 속성입니다.

계층의 출력값 개수로, 1로 표현됩니다. 이 계층은 단일 출력값만 가집니다.

데이터형: double

OutputNames — 출력 이름

읽기 전용: {'out'} (디폴트 값)

읽기 전용 속성입니다.

출력값 이름으로, {'out'}으로 표현됩니다. 이 계층은 단일 출력값만 가집니다.

예제

결합 계층을 만들고 연결하기

네 번째(채널) 차원을 따라 두 개의 입력값을 결합하는 결합 계층을 만듭니다. 결합 계층의 이름을 'concat'로 지정합니다.

concat = concatenationLayer(4,2,'Name','concat')

concat = 
  ConcatenationLayer with properties:

          Name: 'concat'
           Dim: 4
     NumInputs: 2
    InputNames: {'in1'  'in2'}

2개의 ReLU 계층을 만들어서 결합 계층에 연결합니다. 결합 계층은 ReLU 계층의 출력값을 결합합니다.

relu_1 = reluLayer('Name','relu_1');
relu_2 = reluLayer('Name','relu_2');

net = dlnetwork;
net = addLayers(net, relu_1);
net = addLayers(net, relu_2);
net = addLayers(net, concat);

net = connectLayers(net, 'relu_1', 'concat/in1');
net = connectLayers(net, 'relu_2', 'concat/in2');
plot(net)

알고리즘

계층 입력 형식 및 출력 형식

계층 배열 또는 계층 그래프의 계층 대부분은 뒤에 오는 계층에 데이터를 전달할 때 형식이 지정된 dlarray 객체로 전달합니다. dlarray 객체의 형식은 문자들로 구성된 문자열로, 각 문자는 데이터의 대응되는 차원을 설명합니다. 형식은 다음 문자 중 하나 이상으로 구성됩니다.

• "S" — 공간

• "C" — 채널

• "B" — 배치

• "T" — 시간

• "U" — 지정되지 않음

4차원 배열로 표현되는 2차원 영상 데이터를 예로 들면 처음 2개 차원은 영상의 공간 차원, 3번째 차원은 영상의 채널, 4번째 차원은 배치 차원에 대응되며, "SSCB"(공간, 공간, 채널, 배치) 형식으로 설명할 수 있습니다.

다음 경우와 같은 자동 미분 워크플로에서 이러한 dlarray 객체와 상호 작용할 수 있습니다.

• 사용자 지정 계층 개발

• functionLayer 객체 사용

• dlnetwork 객체에 forward 함수 및 predict 함수 사용

ConcatenationLayer 객체는 모든 형식의 입력 데이터를 지원합니다 (R2026a 이후). 출력 형식은 입력 형식과 일치합니다. 각 입력값은 동일한 형식의 데이터를 가져야 합니다.

R2026a 이전: 계층은 "S"(공간) 및 "C"(채널) 차원에 대해서만 결합을 지원합니다.

복소수

ConcatenationLayer 객체는 복소수 값 입력과 출력을 지원합니다 (R2024a 이후). 계층은 기본 연산을 실수 값 입력에서와 동일하게 복소수 값 입력에 적용하며 가능한 경우 복소수 값 데이터를 출력합니다.

확장 기능

C/C++ 코드 생성

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

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

코드 생성 시 채널(C) 차원을 가진 dlarray 객체를 이 계층에 입력값으로 전달해야 합니다. 예를 들어, 코드 생성 시 "SSC" 또는 "SSCBT"와 같은 데이터 형식이 지원돱니다.

GPU 코드 생성

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

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

버전 내역

R2019a에 개발됨

R2026a: 임의의 차원에 대해 결합

ConcatenationLayer 객체는 임의의 차원의 데이터를 결합하는 것을 지원합니다.

R2024a: 복소수 값의 입력과 출력을 지원함

ConcatenationLayer 객체는 복소수 값 입력과 출력을 지원합니다. 계층은 기본 연산을 실수 값 입력에서와 동일하게 복소수 값 입력에 적용하며 가능한 경우 복소수 값 데이터를 출력합니다.

참고 항목

trainnet | trainingOptions | dlnetwork | additionLayer | connectLayers | disconnectLayers | exportNetworkToSimulink | Concatenation Layer

도움말 항목

• 딥러닝을 사용한 3차원 뇌종양 분할 (Image Processing Toolbox)
• 사전 훈련된 심층 신경망
• 딥러닝 계층 목록