genFunction

(To be removed) Generate MATLAB function for simulating shallow neural network

genFunction will be removed in a future release. For more information, see Transition Legacy Neural Network Code to dlnetwork Workflows.

For advice on updating your code, see Version History.

Syntax

genFunction(net,pathname)

genFunction(___,'MatrixOnly','yes')

genFunction(___,'ShowLinks','no')

Description

This function generates a MATLAB^® function for simulating a shallow neural network. genFunction does not support deep learning networks such as convolutional or LSTM networks. For more information on code generation for deep learning, see Generate Code and Deploy Deep Neural Networks.

genFunction(net,pathname) generates a complete stand-alone MATLAB function for simulating a neural network including all settings, weight and bias values, module functions, and calculations in one file. The result is a standalone MATLAB function file. You can also use this function with MATLAB Compiler™ and MATLAB Coder™ tools.

genFunction(___,'MatrixOnly','yes') overrides the default cell/matrix notation and instead generates a function that uses only matrix arguments compatible with MATLAB Coder tools. For static networks, the matrix columns are interpreted as independent samples. For dynamic networks, the matrix columns are interpreted as a series of time steps. The default value is 'no'.

genFunction(___,'ShowLinks','no') disables the default behavior of displaying links to generated help and source code. The default is 'yes'.

Examples

Create Functions from Static Neural Network

This example shows how to create a MATLAB function and a MEX-function from a static neural network.

First, train a static network and calculate its outputs for the training data.

[x,t] = bodyfat_dataset;
bodyfatNet = feedforwardnet(10);
bodyfatNet = train(bodyfatNet,x,t);
y = bodyfatNet(x);

Next, generate and test a MATLAB function. Then the new function is compiled to a shared/dynamically linked library with mcc.

genFunction(bodyfatNet,'bodyfatFcn');
y2 = bodyfatFcn(x);
accuracy2 = max(abs(y-y2))
mcc -W lib:libBodyfat -T link:lib bodyfatFcn

Next, generate another version of the MATLAB function that supports only matrix arguments (no cell arrays), and test the function. Use the MATLAB Coder tool codegen to generate a MEX-function, which is also tested.

genFunction(bodyfatNet,'bodyfatFcn','MatrixOnly','yes');
y3 = bodyfatFcn(x);
accuracy3 = max(abs(y-y3))
 
x1Type = coder.typeof(double(0),[13 Inf]); % Coder type of input 1
codegen bodyfatFcn.m -config:mex -o bodyfatCodeGen -args {x1Type}
y4 = bodyfatodeGen(x);
accuracy4 = max(abs(y-y4))

Input Arguments

net — neural network

network object

Neural network, specified as a network object.

Example: net = feedforwardnet(10);

pathname — location and name of generated function file

character string

Location and name of generated function file, specified as a character string. If you do not specify a file name extension of .m, it is automatically appended. If you do not specify a path to the file, the default location is the current working folder.

Example: 'myFcn.m'

Data Types: char

Extended Capabilities

C/C++ Code Generation

Generate C and C++ code using MATLAB® Coder™.

Usage notes and limitations:

• You can use genFunction in the Deep Learning Toolbox™ to generate a standalone MATLAB function for a trained neural network. You can generate C/C++ code from this standalone MATLAB function. To generate Simulink^® blocks, use the gensim function.

Version History

Introduced in R2013b

R2026a: genFunction will be removed

genFunction will be removed in a future release.

To learn more about Simulink and code generation for neural networks, see these examples and topics:

• List of Deep Learning Layer Blocks and Subsystems

• Implement Unsupported Deep Learning Layer Blocks

• Time Series Prediction in Simulink Using Deep Learning Network

• Acceleration for Simulink Deep Learning Models

• Code Generation for Deep Learning Networks

For more information, see Transition Legacy Neural Network Code to dlnetwork Workflows.