网络层 - Reshape

Reshape

Reshape 为工厂对象，根据参数 targetShape 形状创建相对应的对象。在构造对象的时候可以使用 shape 替代 targetShape

如果输入为1维，例如 targetShape=[100]，那么创建TSP.layers.Reshape1d，输出为1维；

如果输入为2维，例如 targetShape=[24, 24]，那么创建TSP.layers.Reshape2d，输出为2维；

如果输入为3维，例如 targetShape=[32, 32, 180]，那么创建TSP.layers.Reshape3d，输出为3维；

构造器

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

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

TSP.layers.Reshape()

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

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

TSP.layers.Reshape( { targetShape : Int[] } )

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

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

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

参数列表

参数名标签	类型	简介	具体用法细节和例子
targetShape	Int[]	输出的形状，网络模型相关系数	例如，targetShape = [24, 24] 表示把输入转换成 24*24 的矩阵
shape	Int[]	输出的形状，网络模型相关系数	使用方法与 targetShape 相同
name	String	层的命名	name: “layerName” 在顺序模型中，建议添加，以便从模型中获取层对象在函数式模型中，必须给每个层添加 name 属性，且添加的名称 name 的值需要和预训练网络中对应层的名称相同
color	Color Format	层的颜色	Reshape 默认颜色是浅紫色 #A287F4
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

本层的类型，返回值有三种可能：若 targetShape 长度为1，返回字符串 Reshape1d；若 targetShape 长度为2，返回字符串 Reshape2d；若 targetShape 长度为3，返回字符串 Reshape3d；

创建后即可取到。

方法

.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 reshape = new TSP.layers.Reshape( {

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

} );

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

let reshape = new TSP.layers.Reshape( {

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

} );

什么时候用

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

框架名称	对应框架中新建对象代码段
Keras	keras.layers.Reshape(target_shape)
TensorFlow	tf.reshape( tensor, shape )
TensorFlow.js	tf.layers.reshape({targetShape: [2, 6]})

源码

tensorspace/src/layer/intermediate/Reshape.js