Fixed-Point Tool
Convert a floating-point model to a fixed-point model
Open the Fixed-Point Tool
Simulink Toolstrip: On theAppstab, underCode Generation, click the app icon.
MATLAB command prompt: Enter
fxptdlg('system_name'), where'system_name'is the name of the model or system you want to convert, specified as a string.
Examples
Optimized Fixed-Point Conversion in the Fixed-Point Tool
This example shows how to use theOptimized Fixed-Point Conversionworkflow in theFixed-Point Tool. The model used in this example is a simple FIR filter modeled using floating-point data types. In this example, you specify known behavioral constraints for the output of the filter and optimize the fixed-point data types in theEmbedded Efficient Filtersubsystem.
Open themSimpleFIRmodel.
open_system('mSimpleFIR');
Inspect theEmbedded Efficient Filtersubsystem.
open_system('mSimpleFIR/Embedded Efficient Filter');
Known design minimum and maximum values are specified explicitly on blocks in the model, including on the inputs and outputs of theEmbedded Efficient Filtersubsystem.
Open the Fixed-Point Tool. On the Simulink®Appstab, underCode Generation, click the app icon.
To start the optimized fixed-point conversion workflow, selectOptimized Fixed-Point Conversion.
Select the subsystem that you want to analyze. UnderSystem Under Design (SUD), select theEmbedded Efficient Filtersubsystem.
Choose the range collection method to use. UnderRange Collection Mode, selectSimulation with derived ranges. During the range analysis step of optimization, the tool will combine ranges from simulation minimum and maximum values, design minimum and maximum values specified explicitly on blocks in the model, and derived minimum and maximum values that are computed through a static analysis that derived ranges for objects in the model.
SpecifySimulation Inputs. For this example, use the default model inputs for simulation.
Specify signal tolerances for logged signals. Set theAbsolute ToleranceandRelative Toleranceof theoutput_signal:1to0.01.
To prepare the model for fixed-point conversion, clickPrepare. The Fixed-Point Tool creates a backup version of the model and checks the model for comaptibility with the conversion process. For more about preparation checks, seeUse the Fixed-Point Tool to Prepare a System for Conversion.
Next, expand theSettingsbutton arrow to configure the settings to use for data type optimization. For this example, use the default settings.
To optimize data types in the model, clickOptimize Data Types.
在优化过程中,软件肛门yzes ranges of objects in your system under design. Optimization will take into account all specified behavioral constraints, including design minimum and maximum values and signal tolerances, to apply heterogeneous data types to your system while minimizing the objective function. For this example, the objective function is set to the defaultBit Width Sum, which instructs the optimization to minimize the sum of word lengths in the system under design.
During the optimization process, the software makes changes to several settings and model configuration parameters. These purpose of these changes include suppressing diagnostics, enabling logging with the Simulation Data Inspector, reducing the memory consumed by the result, ensuring validity of the model, accelerating the optimization process, and turning off data type override. For more information, seeModel Configuration Changes Made During Data Type Optimization. You can restore these diagnostics after the optimization is complete.
Details about the optimization process are printed to theOptimization Detailspane in the Fixed-Point Tool. You can pause or stop the optimization solver before the optimization search is complete by clickingStop.
When the optimization is complete, the Fixed-Point Tool displays a table that contains all of the solutions found during the optimization process.Solution 1in the table corresponds to the best solution found.
Solutions are ordered in the table based on theCost, which is defined by the objective function specified in theSettingsmenu. Feasible solutions that meet the defined behavioral constraints are marked with a pass status in the solutions table. Solutions that do not meet the behavioral constraints are marked with a fail status. This example uses tolerances on the output of the filter subsystem to define the desired behavior of the system. For more information about defining other types of behavioral constraints, seeSpecify Behavioral Constraints.
During the optimization process, the tool collects ranges and statistics for objects in your model. To explore these ranges, in theWorkflow Browserpane, selectBaselineRun.
TheResultsspreadsheet displays a summary of the statistics collected during the range collection phase of optimization, including simulation minimum and simulation maximum values. You can click on any result to view additional details in theResult Detailspane. TheVisualization of Simulation Datapane displays a summary of histograms of the bits used by each object in your model.
You can customize the information displayed in theResultsspreadsheet, or use theExploretab to sort and filter these results based on additional criteria. For more information, seeControl Views in the Fixed-Point Tool.
The best solution found during optimization,Solution 1, is automatically applied to the model. To compare this optimized solution to the baseline run, clickCompare. In theEmbedded Efficient Filtersubsystem, you can see the applied optimized fixed-point data types. When you clickComparefor a model that has logged signals, the tool opens theSimulation Data Inspector. In the Simulation Data Inspector, selectoutput_signalas the signal to compare. The plot of the plant output signal forSolution 1is within the specified tolerance band.
You can continue exploring other solutions by selecting a solution from the solutions table and clickingApply and Compare.
After optimizing data types in the Fixed-Point Tool, you can choose to export the optimization workflow steps to a MATLAB® script. This allows you to save the current optimization workflow steps and continue data type optimization usingfxpoptat the command line.
ClickExport Scriptto export a script namedfxpOptimizationOptionsto the current working directory.
After the conversion process, if you want to restore your model to its state at the start of the conversion process, clickRestore Original Model. Any changes made to your model after the preparation stage of conversion are removed.
Iterative Fixed-Point Conversion in the Fixed-Point Tool
This example shows how to use theIterative Fixed-Point Conversionworkflow in theFixed-Point Tool. The model used in this example is a simple FIR filter modeled using initial guesses for fixed-point data types. In this example, you specify known behavioral constraints for the output of the filter and improve the fixed-point data types in theEmbedded Efficient Filtersubsystem.
Open themSimpleFIR_fxpmodel.
open_system('mSimpleFIR_fxp');
Inspect theEmbedded Efficient Filtersubsystem.
open_system('mSimpleFIR_fxp/Embedded Efficient Filter');
Known design minimum and maximum values are specified explicitly on blocks in the model, including on the inputs and outputs of theEmbedded Efficient Filtersubsystem.
Open the Fixed-Point Tool. On the Simulink®Appstab, underCode Generation, click the app icon.
To start the optimized fixed-point conversion workflow, selectIterative Fixed-Point Conversion.
Select the subsystem that you want to analyze. UnderSystem Under Design (SUD), select theEmbedded Efficient Filtersubsystem.
Choose the range collection method to use. UnderRange Collection Mode, selectSimulation with derived ranges. During the range analysis step of optimization, the tool will combine ranges from simulation minimum and maximum values, design minimum and maximum values specified explicitly on blocks in the model, and derived minimum and maximum values that are computed through a static analysis that derived ranges for objects in the model.
SpecifySimulation Inputs. For this example, use the default model inputs for simulation.
Specify signal tolerances for logged signals. Set theAbsolute ToleranceandRelative Toleranceof theoutput_signal:1to0.01.
To prepare the model for fixed-point conversion, clickPrepare. The Fixed-Point Tool creates a backup version of the model and checks the model for comaptibility with the conversion process. For more about preparation checks, seeUse the Fixed-Point Tool to Prepare a System for Conversion.
Next, collect ranges. Expand theCollect Rangesbutton arrow and selectDouble precision. ClickCollect Rangesto start the range collection run.
When you selectDouble precision范围收集模式,工具模拟the system under design with data type override enabled. Data type override performs a global override of the fixed-point data types in the model, thereby avoiding quantization effects. This enables you to establish an ideal floating-point baseline for the behavior of your model.
The results of range collection are stored inBaselineRun. TheResultsspreadsheet displays a summary of the statistics collected during the range collection simulation, including the currently specified data types on the model (SpecifiedDT), simulation minimum, and simulation maximum values. The compiled data type (CompiledDT) column displays double for all objects in theEmbedded Efficient Filtersubsystem, indicating that data type override was applied during the range collection simulation.
You can click on any result to view additional details in theResult Detailspane. TheVisualization of Simulation Datapane displays a summary of histograms of the bits used by each object in your model. The simulation data shows that several objects in the model have potential underflows.
You can customize the information displayed in theResultsspreadsheet, or use theExploretab to sort and filter these results based on additional criteria. For more information, seeControl Views in the Fixed-Point Tool.
Next, expand theSettingsbutton arrow to configure the settings to use for data type proposals. SetProposetoWord Length.
To propose data types based on the ranges collected and the data type proposal settings specified, clickPropose Data Types. The tool uses all available range data to calculate data type proposals which can include design minimum or maximum values, simulation minimum or maximum values, and derived minimum or maximum values. Data types are proposed for all objects in the system under design whoseLock output data type setting against changes by the fixed-point toolsparameter is cleared.
To write the proposed data types to the model, clickApply Data Types. The tool updates theSpecifiedDTcolumn to show that the data types have been applied to the model.
Simulate the model using the applied fixed-point data types. Expand theSimulate with Embedded Typesbutton arrow and selectSpecified data types. Then clickSimulate with Embedded Types.
The Fixed-Point Tool simulates the model using the new fixed-point data types and logs minimum and maximum values and overflow data for all objects in the system under design. This information is stored in a new run namedEmbeddedRun. The icon next toEmbeddedRundisplays a pass status, indicating that all signals in the system under design meet the specified tolerances. TheVisualization of Simulation Datapane updates to display the newEmbeddedRundata.
To compare the ideal results stored inBaselineRunwith the newly applied fixed-point data types, selectEmbeddedRunfrom theRun to compare in SDIdrop down menu. Then clickCompare Resultsto open theSimulation Data Inspector.
In the Simulation Data Inspector, selectoutput_signalas the signal to compare.
The plot of the filter output signal forEmbeddedRunis within the specified tolerance band.
If the behavior of the converted system does not meet your requirements or if you wish to explore the effect of additional data type selections, you can propose new data types after applying new proposal settings. Continue iterating until you find settings for which the fixed-point behavior of the system is acceptable.
After the conversion process, if you want to restore your model to its state at the start of the conversion process, clickRestore Original Model. Any changes made to your model after the preparation stage of conversion are removed.
Range Collection in the Fixed-Point Tool
This example shows how to use theRange Collectionworkflow in theFixed-Point Tool. The model used in this example is a simple FIR filter modeled using fixed-point data types. In this example, you analyze the numerical behavior of the model to determine the source of overflow in theEmbedded Efficient Filtersubsystem.
Open themSimpleFIR_fxp_ovfmodel.
open_system('mSimpleFIR_fxp_ovf');
Inspect theEmbedded Efficient Filtersubsystem.
open_system('mSimpleFIR_fxp_ovf/Embedded Efficient Filter');
Known design minimum and maximum values are specified explicitly on blocks in the model, including on the inputs and outputs of theEmbedded Efficient Filtersubsystem.
Open the Fixed-Point Tool. On the Simulink®Appstab, underCode Generation, click the app icon.
To start the range collection workflow, selectRange Collection.
Select the subsystem that you want to analyze. UnderSystem Under Design (SUD), select theEmbedded Efficient Filtersubsystem.
Choose the range collection method to use. UnderRange Collection Mode, selectSimulation with derived ranges. During range collection, the tool will combine ranges from simulation minimum and maximum values, design minimum and maximum values specified explicitly on blocks in the model, and derived minimum and maximum values that are computed through a static analysis that derived ranges for objects in the model.
SpecifySimulation Inputs. For this example, use the default model inputs for simulation.
Specify signal tolerances for logged signals. Set theAbsolute ToleranceandRelative Toleranceof theoutput_signal:1to0.01.
Next, expand theCollect Rangesbutton arrow to configure the settings to use for range collection. SelectDouble precisionto temporarily override data types in the model with doubles during the baseline range collection run. ClickCollect Ranges.
The results of the range collection run are stored inBaselineRun. TheResultsspreadsheet displays a summary of the statistics collected during the range collection, including the currently specified data types on the model (SpecifiedDT), simulation minimum, and simulation maximum values. The compiled data type (CompiledDT) column displays double for all objects in theEmbedded Efficient Filtersubsystem, indicating that data type override was applied during the range collection simulation.
You can click on any result to view additional details in theResult Detailspane. TheVisualization of Simulation Datapane displays a summary of histograms of the bits used by each object in your model.
You can customize the information displayed in theResultsspreadsheet, or use theExploretab to sort and filter these results based on additional criteria. For more information, seeControl Views in the Fixed-Point Tool.
Next, simulate the model using the fixed-point data types currently specified on the model. Expand theSettingsbutton arrow and selectSpecified data types, then clickSimulate with Embedded Types.
The Fixed-Point Tool stores the results of the simulation inEmbeddedRun.
The icon next toEmbeddedRundisplays a fail status, indicating that one or more signals do not meet the specified tolerances. The results for theProductblock indicate that there is an issue with this result. TheResult Detailspane shows that the block overflowed 1670 times, indicating a poor choice of word length.
To compare the ideal results stored inBaselineRunwith the fixed-point results, selectEmbeddedRunfrom theRun to compare in SDIdrop down menu. Then clickCompare Resultsto open theSimulation Data Inspector. In the Simulation Data Inspector, selectoutput_signalas the signal to compare.
Related Examples
Parameters
System Under Design (SUD)— System or subsystem to analyze or convert
current system (default)
System or subsystem to analyze or convert to fixed-point. You can select individual subsystems in your model one at a time to facilitate debugging by isolating the source of numerical issues, or you can choose the top-level model.
For more information on converting systems containing particular modeling constructs, see:
Range Collection Mode— How the tool collects ranges for objects in your system
Simulation ranges(default) |Derived ranges|Simulation with derived ranges
How the tool collects ranges for objects in your system, specified as one of the following:
Simulation ranges— Collect ranges through simulation. To collect and merge the ranges of multiple simulation runs, specifySimulation Inputs. Data type proposals are as good as the test bench provided.
Derived ranges— Collect ranges through a static analysis that derives the ranges, also known asrange analysisorderived range analysis. Ranges collected using this option are based only on design ranges specified on the model. This option typically delivers more conservative data type proposals. For more information, seeHow Range Analysis Works.
Simulation with derived ranges— Collect ranges through simulation and derived range analysis and combine the results. Proposed data types are based on the union of simulation and derived ranges. This option provides the most comprehensive range information.
For more information, seeChoosing a Range Collection Method.
Simulation Inputs— Inputs for simulations
使用默认模型的输入(default) |Simulink.SimulationInputobject
Inputs for simulations, specified as aSimulink.SimulationInputobject.
If you choose theRange Collection Modeto beSimulation rangesorSimulation with derived ranges, you can choose to specify additional simulation inputs to improve the accuracy of the collected ranges and data type proposals. During the range collection simulation, theFixed-Point Toolcaptures the minimum and maximum values from each specified simulation scenario. If theSimulink.SimulationInputobject that you select contains more than one simulation scenario, theFixed-Point Toolproposes data types based on the merged ranges from all simulation scenarios.
A comprehensive set of input signals that exercise the full range of your design will result in more accurate data type proposals for your system. For an example, seePropose Data Types For Merged Simulation Ranges.
Signal Tolerances— Tolerances for signals in your model that have signal logging enabled
absolute tolerance | relative tolerance | time tolerance
确定的数值行为新的fixed-point implementation is acceptable, you can define tolerances for individual signals in your model that have logging enabled. You can specify any of the following types of tolerances:
Absolute Tolerance— Absolute value of the maximum acceptable difference between the original signal and the signal in the converted design.
Relative Tolerance— Maximum relative difference, specified as a percentage, between the original output and the output of the new design. For example, a value of
1e-2indicates a maximum difference of one percent between the original values and the signal values of the converted design.Time Tolerance (seconds)— Time interval in which the maximum and minimum values define the upper and lower values to compare against.
In theOptimized Fixed-Point Conversionworkflow, you must specify at least one behavioral constraint in order to optimize data types. Signal tolerances are one type of behavioral constraint that you can specify.
In theIterative Fixed-Point Conversionworkflow, signal tolerances are not required to propose data types, but are required for the tool to determine whether the embedded run is within tolerance.
In theRange Collectionworkflow, signal tolerances are not required to collect ranges, but are required for the tool to determine whether the ranges collected are within tolerance.
For more information, seeSpecify Behavioral ConstraintsandTolerance Computation.
Collect Ranges— Collect ranges
Use current settings(default) |Double precision|Single precision|Scaled double precision
Collect ranges for objects in your model using:
Use current settings— Use the current data type override set on the model.Double precision— Override data types in the model with doubles.Single precision— Override data types in the model with singles.Scaled double precision— Override data types in the model with scaled doubles.
Ranges collected depend on theRange Collection Modeand anySimulation Inputsspecified.
For more information, seeFixed-Point Instrumentation and Data Type OverrideandUse Custom Data Type Override Settings for Range Collection.
Settings— Data typing options
Allowable Wordlengths|Max Iterations|Propose|Propose signedness|Verify using| ...
Data typing options available in theSettingsmenu depend on the workflow chosen.
Optimized Fixed-Point Conversion Workflow Options
| Option | Description |
|---|---|
Allowable Wordlengths |
Word lengths that can be used in your optimized system under design. The final result of the optimization uses word lengths in the intersection of the |
Max Iterations |
Maximum number of iterations to perform, specified as a scalar integer. The optimization process iterates through different solutions until it finds an ideal solution, reaches the maximum number of iterations, or reaches another stopping criteria. |
Max Time (sec) |
Maximum amount of time for the optimization to run, specified in seconds as a scalar number. The optimization runs until it reaches the time specified, an ideal solution, or another stopping criteria. |
Patience (iterations) |
Maximum number of iterations where no new best solution is found, specified as a scalar integer. The optimization continues as long as the algorithm continues to find new best solutions. |
Safety Margin (%) |
A safety margin, specified as a positive scalar value, indicating the percentage increase in the bounds of the collected range. The safety margin is applied to the union of all collected ranges. |
Objective Function |
Objective function to use during the optimization search. The optimization algorithm seeks to minimize an objective function while meeting the specified behavioral constraints.
Note To use |
Perform Neighborhood Search |
Whether to perform a neighborhood search for the optimized solution. Disabling this option can increase the speed of the optimization process, but also increases the chances of finding a less ideal solution. |
Use Parallel |
Whether to run iterations of the optimization in parallel. Running the iterations in parallel requires a Parallel Computing Toolbox™ license. If you do not have a Parallel Computing Toolbox license, or if you do no enable this option, the iterations run in serial. |
Iterative Fixed-Point Conversion Workflow Options
| Option | Description |
|---|---|
Propose |
Whether to propose fraction lengths or word lengths for objects in the system under design.
|
Propose signedness |
Whether to use the collected range information to propose signedness. |
Safety margin for simulation min/max (%) |
Specify a safety margin to apply to collected simulation ranges. TheFixed-Point Toolwill add the specified amount to the collected ranges and base proposals on this larger range. |
Convert double/single/half types |
Whether to generate data type proposals for objects that currently specify a double, single, or half-precision data type. |
Convert inherited types |
Whether to generate data type proposals for results that currently specify an inherited data type. |
Default word length |
Default word length to use for data type proposals, specified as a scalar integer. This setting is enabled only when the |
Default fraction length |
Default fraction length to use for data type proposals, specified as a scalar integer. This setting is enabled only when the |
Range Collection Workflow Options
| Option | Description |
|---|---|
Verify using |
Data type override settings to use for embedded simulation.
|
Limitations
Some blocks do not support fixed-point data types and can result in an error during fixed-point conversion. SeeBlocks That Do Not Support Fixed-Point Data Types.
Some modeling constructs may cause data type propagation issues. See模型可能会导致Data Type Propagation Errors.
If your model contains a MATLAB Function block, use only supported modeling constructs for successful conversion. SeeMATLAB Language Features Supported for Automated Fixed-Point Conversion.
Tips
For best practices and recommendations, seeBest Practices for Fixed-Point Conversion Workflow.
To customize views in theFixed-Point Tool, seeControl Views in the Fixed-Point Tool.
For help troubleshooting the optimization workflow, seeData Type Optimization Not Successful.
See Also
fxptdlg|DataTypeWorkflow.Converter|fxpopt|Optimize Fixed-Point Data Types for a System|The Command-Line Interface for the Fixed-Point Tool
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select:.
Selectweb siteYou can also select a web site from the following list:
Americas
- América Latina(Español)
- Canada(English)
- United States(English)
Europe
- Belgium(English)
- Denmark(English)
- Deutschland(Deutsch)
- España(Español)
- Finland(English)
- France(Français)
- Ireland(English)
- Italia(Italiano)
- Luxembourg(English)
- Netherlands(English)
- Norway(English)
- Österreich(Deutsch)
- Portugal(English)
- Sweden(English)
- Switzerland
- United Kingdom(English)
