网络层 - Flatten

Flatten

Flatten层将输入“压平”，即把多维的输入一维化，常用在从卷积层到全连接层的过渡。

构造器

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

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

TSP.layers.Flatten();

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

[方法一] 直接添加Flatten层

TSP.layers.Flatten();

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

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

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

参数列表

参数名标签	类型	简介	具体用法细节和例子
shape	Int[]	输出的形状，网络模型相关系数	例如，shape: 100 表示输出是一个向量，1维长度100
paging	Bool	是否使用分页，paging详细解释	当全链接层太长时，使用分页方式来显示Dense层，true 使用分页；false[默认值] 不使用分页
segmentLength	Int	每页的结点数量，只有在paging是true时生效	200[默认值] 表示每页200个节点
segmentIndex	Int	分页第一次渲染显示的下标，只有在paging是true时生效	0[默认值]
overview	Bool	设置text角度overview详细解释	false[默认值]
name	String	层的命名	name: “layerName” 在顺序模型中，建议添加，以便从模型中获取层对象在函数式模型中，必须给每个层添加 name 属性，且添加的名称 name 的值需要和预训练网络中对应层的名称相同
color	Color Format	层的颜色	Flatten默认颜色是 #dfe2fe
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的形状为1维 1️⃣

本层输出Tensor的形状，例如outputShape = [ 1000 ] 表示经过此层处理后，有1000个1维输出

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

.neuralValue : Float[]

本层层间输出值数组。

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

.name : String

本层的自定义名称。

创建后即可取到。

.layerType : String

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

创建后即可取到。

方法

.apply( previous_layer ) : void

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

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

详情参见构建图结构。

.openLayer() : void

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

详情参见网络层状态。

.closeLayer() : void

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

详情参见网络层状态。

使用样例

声明一个Flatten的实例

let flattenLayer = new TSP.layers.Flatten( {

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

} );

什么时候用

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

框架名称	对应框架中新建对象代码段
Keras	keras.layers.Flatten(data_format=None)
TensorFlow	tf.layers.flatten( inputs, name=None )
TensorFlow.js	tf.layers.flatten (config)

源码

tensorspace/src/layer/intermediate/Flatten.js