concatenationLayer

Capa de concatenación

Descripción

Una capa de concatenación toma las entradas y las concatena en una dimensión especificada. Las entradas deben tener el mismo tamaño en todas las dimensiones, salvo en la dimensión de concatenación.

Especifique el número de entradas a la capa cuando la cree. Las entradas tienen los nombres 'in1','in2',...,'inN', donde N es el número de entradas. Use los nombres de entradas cuando conecte o desconecte la capa usando connectLayers o disconnectLayers.

Creación

Sintaxis

layer = concatenationLayer(dim,numInputs)

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

Descripción

layer = concatenationLayer(dim,numInputs) crea una capa de concatenación de concatena las entradas numInputs en una dimensión especificada (dim). Esta función también establece las propiedades Dim y NumInputs.

layer = concatenationLayer(dim,numInputs,'Name',name) también establece la propiedad Name.

Propiedades

Concatenación

Dim — Dimensión de concatenación

entero positivo

Dimensión de concatenación, especificada como un entero positivo. La capa solo admite la concatenación sobre las dimensiones de canal y espaciales.

Ejemplo: 4

Capa

Name — Nombre de la capa

'' (predeterminado) | vector de caracteres | escalar de cadena

Nombre de la capa, especificado como un vector de caracteres o un escalar de cadena. Para entradas en forma de arreglo Layer, las funciones trainnet y dlnetwork asignan automáticamente nombres a las capas sin nombre.

El objeto ConcatenationLayer almacena esta propiedad como un vector de caracteres.

Tipos de datos: char | string

NumInputs — Número de entradas

entero positivo

Número de entradas a la capa, especificado como un entero positivo mayor que o igual a 2.

Las entradas tienen los nombres 'in1','in2',...,'inN', donde N es NumInputs. Por ejemplo, si NumInputs es 3, las entradas tienen los nombres 'in1','in2' y 'in3'. Use los nombres de entradas cuando conecte o desconecte la capa usando las funciones connectLayers o disconnectLayers.

InputNames — Nombres de las entradas

{'in1','in2',…,'inN'} (predeterminado)

Los nombres de las entradas, especificados como {'in1','in2',...,'inN'}, donde N es el número de entradas de la capa.

Tipos de datos: cell

NumOutputs — Número de salidas

Solo lectura: 1 (predeterminado)

Esta propiedad o parámetro es de solo lectura.

Número de salidas de la capa, almacenado como 1. Esta capa solo tiene una salida.

Tipos de datos: double

OutputNames — Nombres de salida

Solo lectura: {'out'} (predeterminado)

Esta propiedad o parámetro es de solo lectura.

Nombres de salida, almacenados como {'out'}. Esta capa solo tiene una salida.

Tipos de datos: cell

Ejemplos

Crear y conectar una capa de concatenación

Cree una capa de concatenación para concatenar dos entradas en la cuarta dimensión (canales). Asigne el nombre 'concat' a la capa de concatenación.

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

concat = 
  ConcatenationLayer with properties:

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

Cree dos capas ReLU y conéctelas con la capa de concatenación. La capa de concatenación concatena las salidas de las capas 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)

Algoritmos

Formatos de entrada y salida de capa

Las capas en un arreglo de capas o en una gráfica de capas pasan datos a las capas posteriores como objetos dlarray con formato. El formato de un objeto dlarray es una cadena de caracteres, en la que cada carácter describe la dimensión correspondiente de los datos. El formato consta de uno o más de estos caracteres:

• "S": espacial

• "C": canal

• "B": lote

• "T": tiempo

• "U": sin especificar

Por ejemplo, puede describir los datos de imagen 2D que están representados como arreglo 4D, donde las dos primeras dimensiones corresponden a las dimensiones espaciales de las imágenes, la tercera dimensión corresponde a los canales de las imágenes y la cuarta dimensión corresponde a la dimensión de lote, como datos con formato "SSCB" (espacial, espacial, canal, lote).

Puede interactuar con estos objetos dlarray en flujos de trabajo de diferenciación automática, como aquellos para desarrollar una capa personalizada, usar un objeto functionLayer o usar las funciones forward y predict con objetos dlnetwork.

En esta tabla se muestran los formatos de entrada admitidos de objetos ConcatenationLayer y el formato de salida correspondiente. Si el software pasa la salida de la capa a una capa personalizada que no hereda de la clase nnet.layer.Formattable o a un objeto FunctionLayer con la propiedad Formattable establecida en 0 (false), la capa recibe un objeto dlarray sin formato con dimensiones ordenadas según los formatos de esta tabla. Los formatos incluidos en esta lista son únicamente un subconjunto. La capa puede ser compatible con formatos adicionales, como aquellos con dimensiones adicionales "S" (espacial) o "U" (sin especificar).

La capa solo admite la concatenación sobre las dimensiones "S" (espacial) y "C" (canal). El formato de salida coincide con el formato de entrada. Cada entrada debe tener datos con el mismo formato.

Formato de entrada	Formato de salida
"CB" (canal, lote)	"CB" (canal, lote)
"SCB" (espacial, canal, lote)	"SCB" (espacial, canal, lote)
"SSCB" (espacial, espacial, canal, lote)	"SSCB" (espacial, espacial, canal, lote)
"SSSCB" (espacial, espacial, espacial, canal, lote)	"SSSCB" (espacial, espacial, espacial, canal, lote)
"CBT" (canal, lote, tiempo)	"CBT" (canal, lote, tiempo)
"SCBT" (espacial, canal, lote, tiempo)	"SCBT" (espacial, canal, lote, tiempo)
"SSCBT" (espacial, espacial, canal, lote, tiempo)	"SSCBT" (espacial, espacial, canal, lote, tiempo)
"SSSCBT" (espacial, espacial, espacial, canal, lote, tiempo)	"SSSCBT" (espacial, espacial, espacial, canal, lote, tiempo)
"CU" (canal, sin especificar)	"CU" (canal, sin especificar)
"SC" (espacial, canal)	"SC" (espacial, canal)
"SSC" (espacial, espacial, canal)	"SSC" (espacial, espacial, canal)
"SSSC" (espacial, espacial, espacial, canal)	"SSSC" (espacial, espacial, espacial, canal)

En objetos dlnetwork, los objetos ConcatenationLayer también admiten estas combinaciones de formato de entrada y salida.

Formato de entrada	Formato de salida
"CT" (canal, tiempo)	"CT" (canal, tiempo)
"SCT" (espacial, canal, tiempo)	"SCT" (espacial, canal, tiempo)
"SSCT" (espacial, espacial, canal, tiempo)	"SSCT" (espacial, espacial, canal, tiempo)
"SSSCT" (espacial, espacial, espacial, canal, tiempo)	"SSSCT" (espacial, espacial, espacial, canal, tiempo)

Números complejos

Los objetos ConcatenationLayer admiten entradas y salidas de valores complejos. (desde R2024a) La capa aplica la misma operación subyacente a la entrada de valores complejos como lo hace en las entradas de valores reales y genera como salida los datos de valores complejos cuando procede.

Capacidades ampliadas

Generación de código C/C++

Genere código C y C++ mediante MATLAB® Coder™.

Notas y limitaciones de uso:

Para la generación de código, debe pasar un objeto dlarray con una dimensión de canal (C) como entrada a esta capa. Por ejemplo, la generación de código admite formatos de datos como SSC o SSCBT:

Generación de código de GPU

Genere código CUDA® para GPU NVIDIA® mediante GPU Coder™.

Consulte las notas de uso y las limitaciones de la sección Generación de código C/C++. Las mismas limitaciones se aplican a la generación de código GPU.

Historial de versiones

Introducido en R2019a

R2024a: Compatibilidad para entradas y salidas de valores complejos

Los objetos ConcatenationLayer admiten entradas y salidas de valores complejos. La capa aplica la misma operación subyacente a la entrada de valores complejos como lo hace en las entradas de valores reales y genera como salida los datos de valores complejos cuando procede.

Consulte también

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

Temas

• 3-D Brain Tumor Segmentation Using Deep Learning
• Redes neuronales profundas preentrenadas
• Lista de capas de deep learning