网络层 - UpSampling2d

UpSampling2d

使用UpSampling2d构造一个上采样层，也称图像插值（interpolating）。

构造器

基于 TensorSpace 模型是否在初始化之前载入了预训练的模型，有不同的配置方法。查看网络层配置文档了解网络层配置基本规则。

〔情况一〕如果 TensorSpace 模型在初始化之前已经载入了预训练的模型，那么不需要在 Layer 中配置网络模型相关系数。

TSP.layers.UpSampling2d();

〔情况二〕如果 TensorSpace 模型在初始化之前未载入预训练的模型，那么需要配置必要的网络模型相关系数。

[方法一] 使用 size 参数进行构造

TSP.layers.UpSampling2d( { size: [ Float, Float ] } );

[方法二] 使用 shape 参数进行构造

TSP.layers.UpSampling2d( { shape : [ Int, Int, Int ] } );

图1 - Upsampling2d层示意图（左：收缩 | 右：展开）

参数列表

参数名标签	类型	简介	具体用法细节和例子
size	Float[]	行和列的上采样因子，网络模型相关系数	例如，size: [ 1.5, 2 ] 表示行变成原来的1.5倍，列尺寸变为原来的2倍
shape	Int[]	当前层的输出形状，网络模型相关系数	例如，shape: [ 28, 28, 6 ] 则表示输出为6个特征图，每幅图大小28*28，dataFormat默认通道值在最后
name	String	层的命名	name: “layerName” 在顺序模型中，建议添加，以便从模型中获取层对象在函数式模型中，必须给每个层添加 name 属性，且添加的名称 name 的值需要和预训练网络中对应层的名称相同
color	Color Format	层的颜色	UpSampling2d默认颜色是青色 #30e3ca
closeButton	Dict	层关闭按钮外观控制列表，查看详情	display: Bool. true [默认值] 显示按钮, false 隐藏按钮 ratio: Int 为正常大小的几倍，默认为1倍，例如，当ratio设为2时，关闭按钮为正常大小的2倍大
initStatus	String	本层初始化状态，查看详情	close[默认值] : 收缩 open：展开
animeTime	Int	张开和伸缩的速度	例如2000就是2秒，如果在layer中配置animeTime属性将会覆盖model中的animeTime。

属性

.inputShape : Int[]

本层输入Tensor的形状，dataFormat默认通道值在最后，例如inputShape = [ 28, 28, 3 ] 表示输入为3个特征图，每个图大小为28*28。

在 model.init() 后才可拿到数据，否则为undefined。

.outputShape : Int[]

本层输出Tensor的形状为3维 3️⃣

dataFormat默认通道值在最后，例如outputShape = [ 32, 32, 4 ] 表示经过此层处理后，有4个特征图，每个图大小为32*32。

在 model.init() 后才可拿到数据，否则为undefined。

.neuralValue : Float[]

本层层间输出值数组。

载入模型，在 model.predict() 后才可以拿到数据，否则为undefined。

.name : String

本层的自定义名称。

创建后即可取到。

.layerType : String

本层的类型，返回一个定值，字符串UpSampling2d。

创建后即可取到。

方法

.apply( previous_layer ) : void

将此层连接到 previous_layer 上，previous_layer 即此层的上一层。

此方法可用于构建函数模型图结构。

详情参见构建图结构。

.openLayer() : void

展开 Layer，如果 Layer 已经处于 “open” 状态，Layer 将会保持 “open” 状态。

详情参见网络层状态。

.closeLayer() : void

闭合 Layer，如果 Layer 已经处于 “close” 状态，Layer 将会保持 “close” 状态。

详情参见网络层状态。

使用样例

如果 TensorSpace 模型在初始化之前已经载入了预训练的模型，那么不需要在 Layer 中配置网络模型相关系数。

let upSamplingLayer = new TSP.layers.UpSampling2d( {

    // 建议配置，当使用 TensorSpace 函数模型时，为必要配置。
    name: "upSampling2d1",
    // 可选配置。
    animeTime: 4000,
    initStatus: "open"

} );

如果 TensorSpace 模型在初始化之前未载入预训练的模型，那么需要配置必要的网络模型相关系数。

let upSamplingLayer = new TSP.layers.UpSampling2d( {

    // 必要网络模型相关系数配置。
    size: [1.5, 2],
    // 建议配置，当使用 TensorSpace 函数模型时，为必要配置。
    name: "upSampling2d2",
    // 可选配置。
    animeTime: 4000,
    initStatus: "open"

} );

什么时候用

如果你熟悉Keras | TensorFlow | tfjs 框架，构建模型时使用了上采样层Upsampling2d（下表列出了可能的使用情景）。一一对应的，在TensorSpace中，使用本API。

框架名称	对应框架中新建对象代码段
Keras	keras.layers.UpSampling2D(size=(2,2))
TensorFlow	tf.keras.layers.UpSampling2D
TensorFlow.js	tf.layers.upSampling2d (config)

源码

tensorspace/src/layer/intermediate/UpSampling2d.js