This example shows how to convert a harness model that uses a Signal Builder block as an input to a harness-free model with root inports. The example collects data from the harness model and stores it in MAT-files, for use by the harness-free model. After storing the data, the example removes the Signal Builder block from the harness model and adds root inports to create a harness-free model. Then, the data in the MAT-files is mapped to the root inports of the model.
|On this page…|
Before converting the model to be harness-free, capture the test cases in the harness.
Open the example model. In the MATLAB Command Window type sldemo_autotrans.
Use MATLAB function slexAutotransRootInportsSaveActiveGroupslexAutotransRootInportsSaveActiveGroup to save the Signal Builder block data of the active group into a MAT-file. At the command line type slexAutotransRootInportsSaveActiveGroup('slexAutotransRootInport','ManeuversGUI'). This function creates a MAT-file in the current directory with the same name as the active group. The function slexAutotransRootInportsSaveActiveGroupslexAutotransRootInportsSaveActiveGroup has been provided with this example.
Remove the Signal Builder block named ManeuversGUI and replace it with two inports.
Delete the Signal Builder block named ManeuversGUI.
Open the Simulink Library Browser and select Commonly Used Blocks.
Drag and drop two input ports from the Library Browser to the model.
Connect the input ports to the lines previously connected to the Signal Builder block.
Rename the inport ports. Name the input port connected to the Throttle line Throttle. Name the input port connected to the BrakeTorque line Brake.
Save the model as slexAutotransRootInportsExample1.slx or use the example slexAutotransRootInportsExample.slx.
The remaining steps of this example use the model slexAutotransRootInportsExample.slx. If you saved the model with a different name use your model name in the steps going forward.
Now that the model is harness-free, set up the inputs that you already saved (See "Save Harness Data to MAT-Files").
From the Simulation->Model Configuration Parameters->Data Import/Export pane, click the Edit Input button.
The Root Inport Mapping tool opens.
This example uses this tool to set up the model inputs from the MAT-file and map those inputs to an input port, based on a mapping algorithm. To select the MAT-file that contains the input data, navigate to the Signals panel and click the browse(...) MAT-file button. In the browser, select the MAT-file that you saved earlier.
Once you select the MAT-file slexAutotransRootInportPassingManeuver.mat that contains the input data, determine the root input port to which to send input data. Simulink matches input data with input ports based on one of five criteria:
Index - Maps in the order it appears in the file to the corresponding port number.
Block Name - Maps by variable name to the corresponding root inport with the matching block name.
Signal Name - Maps by variable name to the corresponding root inport with the matching signal name.
Block Path - Maps by the BlockPath parameter to the corresponding root inport with the matching block path.
Custom - Maps using a MATLAB function.
Earlier in this example, you used the slexAutotransRootInportsSaveActiveGroup to save input data to variables of the same name as the harness signals Throttle and Brake, and you added input ports with names matching the variables. Given the set of conditions for the input data and the model input ports, the best choice for a mapping criteria is Block Name. Using this criteria, Simulink tries try to match input data variable names to the names of the input ports. To select this option:
Click the Block Name radio button.
Click the Map Signals button.
The software prompts you to compile, continue without compiling, or cancel the mapping. Choose to compile the model to verify the mapping.
When compiling the data, Simulink evaluates inports against the following criteria to determine whether or not there is a compatibility issue. The status of this compatibility is reflected by the table colors green, orange, or red. Clicking a cell in the table which has orange or red color will open the Comparison Tool for further inspection.
Data Type - Double, single, enum, ....
Complexity - Real or complex
Dimensions - Signal dimensions vs port dimensions
After reviewing the results of the mapping compatibility, finalize the inputs to the model by clicking the Apply or OK button on the Root Inport Mapping tool. These buttons load the data that has been mapped to the input ports from the MAT-file to the base workspace. Simulink sets the Model Configuration Parameters->Data Import/Export->External Input edit box with the proper comma separated list of inputs. To apply the changes to the model, in the Configuration Parameters dialog, click Apply.
With the changes applied you can now simulate the model and view the results. Click the Play button on the model. To view the results of the simulation, double-click the Scope Block PlotResults.