This example shows how to configure the Fixed-Point Converter app to use a custom plot function to compare the behavior of the generated fixed-point code against the behavior of the original floating-point MATLAB® code.
By default, when the Log inputs and outputs for comparison plots option is enabled, the conversion process uses a time series based plotting function to show the floating-point and fixed-point results and the difference between them. However, during fixed-point conversion you might want to visualize the numerical differences in a view that is more suitable for your application domain. This example shows how to customize plotting and produce scatter plots at the test numerics step of the fixed-point conversion.
This example requires the following products:
Create a local working folder, for example,
Change to the
At the MATLAB command line, enter:
cd(fullfile(docroot, 'toolbox', 'fixpoint', 'examples'))
filterData.mat files to your local working
It is a best practice is to create a separate test script to do pre- and post-processing, such as:
Setting up input values.
Outputting test results.
For more information, see Create a Test File.
|Function code||Entry-point MATLAB function|
|Test file||MATLAB script that tests |
|Plotting function||Custom plot function|
|MAT-file||Data to filter.|
Navigate to the folder that contains the files for this example.
On the MATLAB Toolstrip Apps tab, under Code Generation, click the app icon.
To add the entry-point function
the project, browse to the file
then click Open.
By default, the app saves information and settings for this
project in the current folder in a file named
Click Next to go to the Define Input Types step.
The app screens
myFilter.m for code violations
and fixed-point conversion readiness issues. The app does not find
On the Define Input Types page,
myFilterTest as a test file, browse to
and then click Open.
Click Autodefine Input Types.
The app determines from the test file that the input type of
Click Next to go to the Convert to Fixed Point step.
The app generates an instrumented MEX function for your entry-point MATLAB function. The app displays compiled information for variables in your code. For more information, see View and Modify Variable Information.
To open the settings dialog box, click the Settings arrow .
Verify that Default word length is set to
Under Advanced, set
Under Plotting and Reporting, set
Custom plot function to
Click the Analyze arrow . Verify that the test file is
The test file,
myFilterTest, runs and the
app displays simulation minimum and maximum ranges on the Variables tab.
Using the simulation range data, the software proposes fixed-point
types for each variable based on the default type proposal settings,
and displays them in the Proposed Type column.
To convert the floating-point algorithm to fixed point, click Convert.
The software validates the proposed types and generates a fixed-point version of the entry-point function.
Click Test arrow , select Log inputs and outputs for comparison plots, and then click Test.
The app runs the test file that you used to define input types to test the
fixed-point MATLAB code. Because you selected to log inputs and outputs for
comparison plots and to use the custom plotting function,
plotDiff.m, for these plots, the app uses this
function to generate the comparison plot. The plot shows that the
fixed-point results do not closely match the floating-point results.
In the settings, increase the DefaultWordLength to
then convert to fixed point again.
The app converts
myFilter.m to fixed point
and proposes fixed-point data types using the new default word length.
Run the test numerics step again.
The increased word length improves the results. This time, the plot shows that the fixed-point results match the floating-point results.