Función Tensorflow.js tf.conv1d()

Introducción: Tensorflow.js es una biblioteca de código abierto desarrollada por Google para ejecutar modelos de aprendizaje automático, así como redes neuronales de aprendizaje profundo en el entorno del navegador o del Node.

La función .conv1d() se usa para determinar una convolución 1D sobre el tensor de entrada indicado.

Sintaxis:

tf.conv1d(x, filter, stride, pad, dataFormat?, dilation?, dimRoundingMode?)

Parámetros:

• x: El tensor de entrada indicado que es de rango 3 o bien de rango 2 y de forma: [lote, altura, ancho, canales]. Además, en caso de que el rango sea 2, entonces se presume el lote de tamaño 1. Puede ser del tipo tf.Tensor2D, tf.Tensor3D, TypedArray o Array.
• filter: El tensor de filtro indicado de rango 3 y forma: [filterHeight, filterWidth, depth]. Puede ser de tipo tf.Tensor3D, TypedArray o Array.
• zancadas: el número indicado de tomas con la ayuda de las cuales el filtro indicado se desplaza a la derecha en cada paso. Es de tipo número.
• pad: el tipo de algoritmo indicado para el relleno. Puede ser de tipo válido, mismo, número o conv_util.ExplicitPadding.
  1. Aquí, para mismo y zancada 1, la salida tendría el mismo tamaño que la entrada, independientemente del tamaño del filtro.
  2. Para ‘válido’, la salida será más pequeña que la entrada en caso de que el tamaño del filtro sea mayor que 1*1×1.
• dataFormat: La string electiva indicada de «NWC» o «NCW». El valor predeterminado es «NWC», la información se mantiene en la secuencia de [lote, en_ancho, en_canales]. Además, actualmente solo se prefiere «NWC». Es opcional y es del tipo ‘NWC’ o ‘NCW’.
• dilataciones: Las tasas de dilatación indicadas donde los valores de entrada se muestrean en convolución atrosa. El valor predeterminado es 1. Y en caso de que sea mayor que 1, entonces el paso debe ser 1. Es opcional y es de tipo número.
• dimRoundingMode: una string establecida de ‘techo’, ‘redondo’ o ‘piso’. En caso de que no se proporcione ningún valor, el valor predeterminado se trunca. Es opcional y es de tipo techo, redondo o suelo.

Valor devuelto: Devuelve tf.Tensor2D o tf.Tensor3D.

Ejemplo 1:

// Importing the tensorflow.js library
import * as tf from "@tensorflow/tfjs"
  
// Defining input tensor
const x = tf.tensor3d([1, 2, 3, 4], [2, 2, 1]);
  
// Defining filter tensor
const y = tf.tensor3d([1, 1, 0, 4], [1, 1, 4]);
  
// Calling conv1d() method
const result = tf.conv1d(x, y, 2, 'valid');
  
// Printing output
result.print();

Producción:

Tensor
    [ [[1, 1, 0, 4 ],],

      [[3, 3, 0, 12],]]

Ejemplo 2:

// Importing the tensorflow.js library
import * as tf from "@tensorflow/tfjs"
  
// Calling conv1d() method with 
// all its parameters
tf.tensor3d([1.1, 2.2, 3.3, 4.4], [2, 2, 1]).conv1d(
 tf.tensor3d([1.3, 1.2, null, -4], [1, 1, 4]),
             2, 0, 'NWC', 1, 'ceil').print();

Producción:

Tensor
    [[[1.4299999, 1.3200001, 0, -4.4000001 ],
      [0        , 0        , 0, 0          ]],

     [[4.29     , 3.96     , 0, -13.1999998],
      [0        , 0        , 0, 0          ]]]

Referencia: https://js.tensorflow.org/api/latest/#conv1d