Tensorflow.js tf.avgPool3d()用法及代碼示例

Tensorflow.js是Google開發的開源庫，用於在瀏覽器或節點環境中運行機器學習模型和深度學習神經網絡。

tf.avgPool3d()函數用於計算3D平均池。

用法:

tf.avgPool3d(x, filterSize, strides, pad, 
                  dimRoundingMode?, dataFormat?)

參數：此函數接受如下所示的參數：

• x:指定的輸入張量為等級5或等級4。
• filterSize:這指定filterDepth，filterHeight，filterWidth。如果指定的filterSize是單個數字，則filterWidth == filterHeight == filterDepth。
• strides:指定池的跨步：[strideDepth，strideHeight，strideWidth]。如果指定的步幅是單個數字，則strideWidth == strideHeight == strideDepth。
• pad:這指定了填充算法的類型。
• dimRoundingMode:這是可選的。這指定了以下字符串：‘ceil’，“ round”，‘floor’。如果未提供任何內容，則它將默認將其值截斷。
• dataFormat:這是可選的。這指定輸出和輸入數據的數據格式。

返回值：它返回張量元素的3D平均合並。

以下示例說明了avgPool3d()函數的用法。

範例1：

// Importing the tensorflow.js library
import * as tf from "@tensorflow/tfjs"
  
// Initializing a tensor of some elements
let geek = tf.tensor5d([10, 11, 12, 13, 14, 15, 16, 17],
                       [1, 2, 2, 2, 1]);
  
// Calling the .avgPool3d() function over
// the above tensor as its parameter
let outcome = tf.avgPool3d(geek, 2, 1, 'valid');
  
//Printing the result.
outcome.print();

輸出：

Tensor
     [ [ [ [[13.5],]]]]

範例2：

// Importing the tensorflow.js library
import * as tf from "@tensorflow/tfjs"
  
// Initializing a tensor of some elements
let geek = tf.tensor5d([51, 52, 53, 54], [2, 1, 1, 1, 2]);
  
// Calling the .avgPool3d() function and
 // printing the result.
tf.avgPool3d(geek, 1, 2, 'valid').print();

輸出：

Tensor
  [ [ [ [[51, 52],]]],

    [ [ [[53, 54],]]]]

Referenec：https://js.tensorflow.org/api/3.6.0/#avgPool3d