{"id":16013,"date":"2023-11-01T13:16:16","date_gmt":"2023-11-01T17:16:16","guid":{"rendered":"https:\/\/blogs.mathworks.com\/simulink\/?p=16013"},"modified":"2023-11-01T13:16:16","modified_gmt":"2023-11-01T17:16:16","slug":"how-to-create-a-mask-popup-parameter-that-can-be-tuned-in-rapid-accelerator","status":"publish","type":"post","link":"https:\/\/blogs.mathworks.com\/simulink\/2023\/11\/01\/how-to-create-a-mask-popup-parameter-that-can-be-tuned-in-rapid-accelerator\/","title":{"rendered":"How to Create a Mask Popup Parameter that can be tuned in Rapid Accelerator"},"content":{"rendered":"
A few weeks ago I published this blog post: <\/span>Getting the most out of Rapid Accelerator mode \u2013 Version R2023b<\/span><\/a>, where I described how to simulate a model multiple times in Rapid Accelerator mode for maximum performance using the parameter <\/span>RapidAcceleratorUpToDateCheck='off'<\/span>. <\/span><\/div>
In this previous post, I was tuning the value of a Gain block. This week I received the question: <\/span>Can I do the same for a parameter of type popup?<\/span><\/div>

The Problem<\/span><\/h2>
I have this model with a <\/span>masked subsystem<\/span><\/a> that has a popup parameter. Under the mask, the variable associated with the popup, <\/span>choice<\/span>, is used to control what type of noise is added to the signal:<\/span><\/div>
\"\"<\/img><\/div>
If I try to simulate the model as described in the previous blog post, I get an error saying that it's not possible to use <\/span>setBlockParameters<\/span><\/a> and <\/span>RapidAcceleratorUpToDateCheck='off'<\/span> at the same time:<\/span><\/div>
mdl = <\/span>'testNoise'<\/span>;<\/span><\/span><\/div><\/div>
blk = [mdl <\/span>'\/AddNoise'<\/span>];<\/span><\/span><\/div><\/div>
in(1:3) = Simulink.SimulationInput(mdl);<\/span><\/span><\/div><\/div>
for <\/span>i = 1:3<\/span><\/span><\/div><\/div>
in(i) = in(i).setModelParameter(SimulationMode=<\/span>'Rapid'<\/span>);<\/span><\/span><\/div><\/div>
in(i) = in(i).setModelParameter(RapidAcceleratorUpToDateCheck=<\/span>'off'<\/span>); <\/span><\/span><\/div><\/div>
end<\/span><\/span><\/div><\/div>
try<\/span><\/span><\/div><\/div>
in(1) = in(1).setBlockParameter(blk,<\/span>'choice'<\/span>,<\/span>'Random'<\/span>);<\/span><\/span><\/div><\/div>
catch <\/span>ME<\/span><\/span><\/div><\/div>
ME.message<\/span><\/span><\/div><\/div>
end<\/span><\/span><\/div>
ans = <\/span>'Cannot set 'BlockParameters' on SimulationInput object when 'RapidAcceleratorUpToDateCheck' is set to 'off'.'<\/div><\/div><\/div><\/div><\/div><\/div>

The Solution<\/span><\/h2>
The solution to this is described in the documentation page <\/span>Tune Mask Enumeration Parameters - Popup and Radio Button<\/span><\/a>. I find this page is a bit long and complex, so I will try to summarize the process here.<\/span><\/div>
The first thing you need to do is associate an <\/span>enumeration<\/span><\/a> with the popup parameter. For this example, the enumeration is:<\/span><\/div>
classdef<\/span> noise < Simulink.Mask.EnumerationBase<\/span><\/span><\/div>
<\/span>enumeration<\/span><\/span><\/div>
Random (1,<\/span>'Random'<\/span>)<\/span><\/span><\/div>
Pulse (2,<\/span>'Pulse'<\/span>)<\/span><\/span><\/div>
Sequence (3,<\/span>'Sequence'<\/span>)<\/span><\/span><\/div>
<\/span>end<\/span><\/span><\/div>
<\/span>end<\/span><\/span><\/div><\/div>
I then associate it with the parameter in the <\/span>Mask Editor<\/span><\/a> by double-clicking on the <\/span>Type options<\/span> field:<\/span><\/div>
\"\"<\/img><\/div>
In the Subsystem under the mask, I need to modify how the variable is specified in the block dialog. For this example, instead of using the variable <\/span>choice<\/span> directly, I need to specify <\/span>noiseValues(choice)<\/span>. The documentation explains the syntax, but in short you begin with the enumeration name (<\/span>noise<\/span> in this example) and you append \"<\/span>Values<\/span>\" to it. Then you pass to it, between parenthesis, the popup variable (<\/span>choice<\/span> in this example):<\/span><\/div>
\"\"<\/img><\/div>
If you create the masked Subsystem that way, you will notice that the dialog has a new \"Associate Variable\" option:<\/span><\/div>
\"\"<\/img><\/div>
This will open a dialog to specify the variable and optionally create it if it does not exist. For this example, I will create it myself:<\/span><\/div>
noiseType = noise.Random;<\/span><\/span><\/div><\/div><\/div>
\"\"<\/img><\/div>
Once you click ok, in the block dialog, you will see the variable name and the enumeration type next to it:<\/span><\/div>
\"\"<\/img><\/div>
And that's it, now it's time to simulate the model:<\/span><\/div>
mdl = <\/span>'testNoiseTunable'<\/span>;<\/span><\/span><\/div><\/div>
in(1:3) = Simulink.SimulationInput(mdl);<\/span><\/span><\/div><\/div>
for <\/span>i = 1:3<\/span><\/span><\/div><\/div>
in(i) = in(i).setModelParameter(SimulationMode=<\/span>'Rapid'<\/span>);<\/span><\/span><\/div><\/div>
in(i) = in(i).setModelParameter(RapidAcceleratorUpToDateCheck=<\/span>'off'<\/span>); <\/span><\/span><\/div><\/div>
end<\/span><\/span><\/div><\/div>
in(1) = in(1).setVariable(<\/span>'noiseType'<\/span>,noise.Random);<\/span><\/span><\/div><\/div>
in(2) = in(2).setVariable(<\/span>'noiseType'<\/span>,noise.Pulse);<\/span><\/span><\/div><\/div>
in(3) = in(3).setVariable(<\/span>'noiseType'<\/span>,noise.Sequence);<\/span><\/span><\/div><\/div>
out = sim(in,<\/span>'ShowProgress'<\/span>,<\/span>'off'<\/span>);<\/span><\/span><\/div><\/div><\/div>
Once the simulation completes, we can plot the results and confirm that the parameter has been tuned:<\/span><\/div>
plot(out(1).yout{1}.Values);<\/span><\/span><\/div><\/div>
hold <\/span>on<\/span><\/span><\/div><\/div>
plot(out(2).yout{1}.Values);<\/span><\/span><\/div><\/div>
plot(out(3).yout{1}.Values);<\/span><\/span><\/div><\/div>
hold <\/span>off<\/span><\/span><\/div><\/div>
legend({<\/span>'Random'<\/span>,<\/span>'Pulse'<\/span>,<\/span>'Sequence'<\/span>});<\/span><\/span><\/div>
<\/div>
<\/div>
<\/div>
<\/div>
<\/div><\/div><\/div><\/div><\/div>

Now it's your turn<\/span><\/h2>
If you are creating masked library blocks with parameters of type popups, be nice to your users and associate the popup with an enumeration type. This will enable them to tune it in Rapid Accelerator optimally. This will also enable the parameter to be tuned if the model is deployed with <\/span>Simulink Compiler<\/span><\/a>.<\/span><\/div>
\"\"<\/img><\/a><\/div>\r\n<\/div>