Main Content

network

Create custom shallow neural network

Syntax

net = network
net = network(numInputs,numLayers,biasConnect,inputConnect,layerConnect,outputConnect)

To Get Help

Type help network/network.

Tip

To learn how to create a deep learning network, see dlnetwork.

Description

network creates new custom networks. It is used to create networks that are then customized by functions such as feedforwardnet and narxnet.

net = network without arguments returns a new neural network with no inputs, layers or outputs.

net = network(numInputs,numLayers,biasConnect,inputConnect,layerConnect,outputConnect) takes these optional arguments (shown with default values):

numInputs

Number of inputs, 0

numLayers

Number of layers, 0

biasConnect

numLayers-by-1 Boolean vector, zeros

inputConnect

numLayers-by-numInputs Boolean matrix, zeros

layerConnect

numLayers-by-numLayers Boolean matrix, zeros

outputConnect

1-by-numLayers Boolean vector, zeros

and returns

net

New network with the given property values

Properties

Architecture Properties

net.numInputs

0 or a positive integer

Number of inputs.

net.numLayers

0 or a positive integer

Number of layers.

net.biasConnect

numLayer-by-1 Boolean vector

If net.biasConnect(i) is 1, then layer i has a bias, and net.biases{i} is a structure describing that bias.

net.inputConnect

numLayer-by-numInputs Boolean vector

If net.inputConnect(i,j) is 1, then layer i has a weight coming from input j, and net.inputWeights{i,j} is a structure describing that weight.

net.layerConnect

numLayer-by-numLayers Boolean vector

If net.layerConnect(i,j) is 1, then layer i has a weight coming from layer j, and net.layerWeights{i,j} is a structure describing that weight.

net.outputConnect

1-by-numLayers Boolean vector

If net.outputConnect(i) is 1, then the network has an output from layer i, and net.outputs{i} is a structure describing that output.

net.numOutputs

0 or a positive integer (read only)

Number of network outputs according to net.outputConnect.

net.numInputDelays

0 or a positive integer (read only)

Maximum input delay according to all net.inputWeights{i,j}.delays.

net.numLayerDelays

0 or a positive number (read only)

Maximum layer delay according to all net.layerWeights{i,j}.delays.

Subobject Structure Properties

net.inputs

numInputs-by-1 cell array

net.inputs{i} is a structure defining input i.

net.layers

numLayers-by-1 cell array

net.layers{i} is a structure defining layer i.

net.biases

numLayers-by-1 cell array

If net.biasConnect(i) is 1, then net.biases{i} is a structure defining the bias for layer i.

net.inputWeights

numLayers-by-numInputs cell array

If net.inputConnect(i,j) is 1, then net.inputWeights{i,j} is a structure defining the weight to layer i from input j.

net.layerWeights

numLayers-by-numLayers cell array

If net.layerConnect(i,j) is 1, then net.layerWeights{i,j} is a structure defining the weight to layer i from layer j.

net.outputs

1-by-numLayers cell array

If net.outputConnect(i) is 1, then net.outputs{i} is a structure defining the network output from layer i.

Function Properties

net.adaptFcn

Name of a network adaption function or ''

net.initFcn

Name of a network initialization function or ''

net.performFcn

Name of a network performance function or ''

net.trainFcn

Name of a network training function or ''

Parameter Properties

net.adaptParam

Network adaption parameters

net.initParam

Network initialization parameters

net.performParam

Network performance parameters

net.trainParam

Network training parameters

Weight and Bias Value Properties

net.IW

numLayers-by-numInputs cell array of input weight values

net.LW

numLayers-by-numLayers cell array of layer weight values

net.b

numLayers-by-1 cell array of bias values

Other Properties

net.userdata

Structure you can use to store useful values

Examples

Create Network with One Input and Two Layers

This example shows how to create a network without any inputs and layers, and then set its numbers of inputs and layers to 1 and 2 respectively.

net = network
net.numInputs = 1
net.numLayers = 2

Alternatively, you can create the same network with one line of code.

net = network(1,2)

Create Feedforward Network and View Properties

This example shows how to create a one-input, two-layer, feedforward network. Only the first layer has a bias. An input weight connects to layer 1 from input 1. A layer weight connects to layer 2 from layer 1. Layer 2 is a network output and has a target.

net = network(1,2,[1;0],[1; 0],[0 0; 1 0],[0 1])

You can view the network subobjects with the following code.

net.inputs{1}
net.layers{1}, net.layers{2}
net.biases{1}
net.inputWeights{1,1}, net.layerWeights{2,1}
net.outputs{2}

You can alter the properties of any of the network subobjects. This code changes the transfer functions of both layers:

net.layers{1}.transferFcn = 'tansig';
net.layers{2}.transferFcn = 'logsig';

You can view the weights for the connection from the first input to the first layer as follows. The weights for a connection from an input to a layer are stored in net.IW. If the values are not yet set, these result is empty.

net.IW{1,1}

You can view the weights for the connection from the first layer to the second layer as follows. Weights for a connection from a layer to a layer are stored in net.LW. Again, if the values are not yet set, the result is empty.

net.LW{2,1}

You can view the bias values for the first layer as follows.

net.b{1}

To change the number of elements in input 1 to 2, set each element’s range:

net.inputs{1}.range = [0 1; -1 1];

After training your network, you can use sim to simulate the network. For example, simulate the network for a two-element input vector.

p = [0.5; -0.1];
y = sim(net,p)

Version History

Introduced before R2006a