0
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
1 <p>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
2
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
3 The parameters panel will be empty if:
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
4 <ul>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
5 <li>No block is currently selected.<br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
6 <li>The currently selected Simulink model is not a valid LTPDA model.<br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
7 <li>The selected block it's not a valid LTPDA block (i.e., it do not contain a proper LTPDA function which answers
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
8 the call for parameters).<br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
9 </ul><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
10
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
11 Otherwise, the contents of the parameters panel will change accordingly to the user selection in the active LTPDA Simulink model.
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
12 <ul>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
13 <li>If a <b>function/method</b> block is selected, the panel will show the proper corresponding parameters.<br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
14 <li>If a <b>Object from list</b> block is selected, the panel will show the referenced index (that is the only parameter accepted).<br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
15 <li>If a <b>Mux/Demux</b> block is selected, the panel will show the number of inputs/outputs.<br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
16 <li>If a <b>From</b> block is selected, the panel will present the 'Find origin' button.<br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
17 </ul><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
18
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
19 <h2>Function/method parameters</h2><hr><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
20 If a valid LTPDA function or method block is selected (inside a valid LTPDA Simulink model), the GUI will first ask the inner
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
21 function or method for its required parameters; the panel then will be built accordingly.<br><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
22
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
23 <img src="images/parampanel_1.png" alt="The parameters for functions/methods" border="1"><br><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
24
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
25 The window is built automatically: <b>every line corresponds to a different parameter</b>, among those required by the selected
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
26 function.<br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
27 Inside every line, then, the structure is obviously similar, so different parameters can have the same fields and boxes.<br><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
28
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
29 <h2>Required or added parameters</h2>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
30 In the construction of the panel the GUI will consider whether the parameter was among those required by the function, or
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
31 if the parameter was added by the user. In this latter case it will be passed to the function, which can use it (if someway
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
32 expected, for example if it a possible optional parameter) or ignore it, if just unexpected. The GUI won't change the
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
33 behavior of the inner function, so it's up to the user to be aware of what can be passed to be used by every function.<br><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
34 In the parameters panel the difference among required and added parameters is shown on the far right: added parameters have a
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
35 small '<tt>-</tt>' button, which lets the user to remove it; required parameters have no such button, since the corresponding
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
36 parameter was automatically required by the function and not added by the user.<br><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
37 Please note that a parameter can also be disabled (see 'Enable checkbox', below): since a disabled parameter won't be passed to
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
38 the function, there's no difference in removing an added parameter or just disable it. The only difference of course is a
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
39 disabled parameter can be re-enabled in a second time, while a removed parameter has to be added and set over again.<br><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
40
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
41
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
42 <h3>Enable checkbox</h3>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
43 On the left, at the beginning of every line/parameter, there is a checkbox which lets the user to enable or disable the
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
44 corresponding parameter. If it's enabled the parameter will be passed to the function, so it's up to the user to set the proper
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
45 value. If it's disabled, on the contrary, it won't be part of the plist passed to the function, which thus will use the default
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
46 value (if any is expected).<br><br><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
47
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
48 The central part of the window is built line by line to reflect each parameter, so it can differ a lot.<br><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
49 <img src="images/parampanel_2.png" alt="A complicated parameters panel" border="1"><br><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
50
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
51 <h3>Parameter name</h3>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
52 Wherever expected, the first element on the left, aside the Enable checkbox, is the parameter name.<br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
53 For <b>double/char</b> parameters this means the parameter key; note that if the parameter was required by the function, the name is
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
54 fixed (see parameter 1,3,5,6 in the previous image), while for added parameters it can be changed (see parameter 7).<br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
55 In case of an added parameter the GUI will show both a text '<tt>Name:</tt>' and an
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
56 edit field, where the user can type in the parameter key itself.<br><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
57 For <b>specwin</b> parameters the key is fixed, so the GUI shows directly the name of the window type ('<tt>Kaiser</tt>',
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
58 '<tt>Rectangular</tt>',...).<br><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
59 Similarly, for <b>Poles and Zeros</b> parameters the key is fixed, so even for added parameters '<tt>Poles</tt>' and '<tt>Zeros</tt>'
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
60 are shown and cannot be altered.<br><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
61 Since the key is fixed also for <b>MIIR and PZmodel</b> parameters, the GUI shows directly the inner parameters to construct these
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
62 objects; note that this is just a way to build a MIIR object, typing in directly the plist. To build it in a different
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
63 way, for example retrieving from the Repository, must be used a proper Constructor block, setting the parameters to be
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
64 retrieved from Simulink (see 'From Simulink checkbox', below) and connection the Constructor block to the function port having
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
65 as a name the corresponding parameter's name.<br><br><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
66
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
67
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
68 <h3>Parameter value</h3>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
69 The following field lets the user to type in the parameters value. This is true for every '<tt>Value:</tt>' field in the
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
70 parameters panel.<br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
71 <b>Please note that often is possible to have a brief help text in the tooltip string, just moving the mouse pointer over
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
72 the edit field and waiting a second.</b><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
73 This will explain for example the meaning for the different edit fields in a specwin parameter, or it will explain how to type
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
74 in poles and zeros into their corresponding edit fields.<br><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
75
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
76 Inside an edit field the user can type in using the traditional MATLAB syntax:
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
77 <ul>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
78 <li><b>10</b>, will be considered a pure number. The parameter's value will be of course the number itself.<br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
79 <li><b>[1 2 3]</b>, among square brackets, will be converted into a vector (or matrix). Similarly, using {} will create
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
80 a cell array. The parameter's value will be a vector, a matrix or a cell array.<br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
81 <li><b>'Hello'</b>, among quotes, will be considered a string, and it won't be evaluated. The parameter's value will be
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
82 a string.<br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
83 <li><b>rand(1)</b>, without quotes, will be recognized as a command and it will be evaluated immediately. The parameter's
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
84 value will the output of the evaluated string.<br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
85 </ul><br><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
86
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
87 <h3>Expand edit field button</h3>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
88 The small gray button aside each parameter's value edit field, for double/char parameters, will open up a window with a bigger
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
89 edit field, where the user can type in the value more comfortably than in the small one in the panel. This is particularly
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
90 handy for those case when the parameter's value is a long and complicated command or vector, which can't fit easily in the
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
91 small space given in the panel.<br><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
92 <img src="images/parampanel_3.png" alt="The expanded edit field" border="1"><br><br><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
93
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
94 <h3>From Simulink checkbox</h3>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
95 If the parameter is not supposed to be set in the GUI's panel but it must be retrieved from Simulink (for example, using a
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
96 Constructor block for that particular type of object), the user can click on the small '<tt>From Simulink</tt>' checkbox.<br><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
97 <img src="images/parampanel_5a.png" alt="'From Simulink environment'" border="1"><br><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
98 The line will be updated, showing 'From Simulink environment'. Since this parameter will be retrieved from Simulink, the user
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
99 cannot alter it anyway in the current parameters panel.<br><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
100 In the LTPDA Simulink model, the block will be modified with a new inport, with the same name as the parameter's key:<br><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
101 <img src="images/parampanel_5b.png" alt="'From Simulink environment'" border="1"><br><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
102 While the first inport must be connected to the data coming in (if any is expected), as usual, the second port must be
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
103 connected to the constructor block providing the object which will become the parameter.<br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
104 In the example shown, the specwin Constructor block provide the specwin object that, inside the '<tt>pwelch</tt>' block, will
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
105 be retrieved as a parameter and passed to the function.<br><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
106
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
107 If the block had no data input, i.e. no input prior to the 'From Simulink' parameter, it will present a single inport, which
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
108 must be connected to the Constructor block providing the parameter's contents.<br><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
109
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
110 Since it's possible to set multiple parameters coming from Simulink, the user should take care of the connections to the
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
111 block, to avoid to shuffle the connected Constructor blocks - for example, inverting a specwin object and a MIIR object.<br><br><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
112
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
113
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
114 <h3>Load button</h3>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
115 For MIIR and PZmodel parameters the GUI will show also a '<tt>Load</tt>' button: the purpose of course is to retrieve these
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
116 objects from a file on disk. Please note that for now this will convert the loaded object into its constructive plist, if
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
117 possible, and the GUI will show again the parameters of the loaded object into the common parameters panel.<br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
118 <i>This will be discontinued or modified after R1</i><br><br><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
119
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
120
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
121 <h3>Adding parameters</h3>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
122 Immediately below the last parameter, on the left, the GUI shows a popup list containing all the parameters types which can be
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
123 added, and aside a '<tt>+</tt>' button to add a parameter of the selected type.<br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
124 Since it makes no sense to pass to a function 2 specwin object, PZmodels, MIIR filters, poles and zeros lists, these types won't
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
125 be available in the popup list if any object of the same type is already shown in the parameters panel.<br><br><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
126
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
127
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
128 <h3>Reset parameter</h3>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
129 In the lower left corner of the window the GUI draws the '<tt>Reset parameters</tt>' button: this will reset the block to its
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
130 empty initial state. If its a function/method block the GUI will then ask again for its list of required parameters, just like
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
131 the block was just added to the model from the library.<br><br><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
132
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
133
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
134 <h3>Set name checkbox</h3>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
135 At the bottom of the window, center line, there is the '<tt>Set name</tt>' checkbox.<br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
136 Enabling this the name of the output of the selected block will be assigned equal to the block's name (which can be altered freely
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
137 by the user, standing the limitations on the block's name posed by Simulink); this will let the user to set particular and
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
138 meaningful names instead of the automatically assigned ones, produced by the inner calculation functions.<br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
139 The plot of an object assigned a particular name, for example, will show the proper name set.<br><br><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
140
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
141
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
142 <h3>Keep local result</h3>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
143 Similarly to the '<tt>Maintain intermediate results</tt> checkbox in the main panel, this checkbox will mark the output of
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
144 the selected block to be maintained at the end of the analysis, instead of being deleted just like any other intermediate
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
145 result of the calculation.<br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
146 In the LTPDA Simulink model the block will be shown with a purple background, to mark it as a 'probe' and to make it
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
147 immediately recognizable.<br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
148 Disabling the checkbox the block's background will be back to its common color, and the intermediate result produced by the
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
149 block itself will be cleared at the end of the analysis.<br><br><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
150
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
151
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
152 <h3>Help button</h3>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
153 In the lower right corner of the window the GUI draws the '<tt>?</tt>' help button: this will recall the help associated to
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
154 the function or method contained into the selected block, and it will show it into a new window.<br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
155 The help shown is exactly the same available by the MATLAB command line, typing <tt>help function_name</tt>.<br><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
156
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
157 <h2>'Object from list' parameter</h2><hr><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
158 If the user selected a 'Object from list' (input) block into the active LTPDA Simulink model, the GUI will show:<br><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
159 <img src="images/parampanel_6.png" alt="'Object from list' parameter" border="1"><br><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
160 The only parameter which can be set in this case is the reference index contained into the input block selected: the index
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
161 will be used together with the Input array, so setting '<tt>1</tt>' will send to the connected block(s) the 1st element of
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
162 the Input array.<br><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
163
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
164 <h2>Mux/Demux parameter</h2><hr><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
165 Similarly to the 'Input from list' block, the GUI will answer a selected a Mux block into a valid LTPDA Simulink model with:<br><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
166 <img src="images/parampanel_7.png" alt="'Object from list' parameter" border="1"><br><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
167 Changing this parameter will immediately alter the mux block in Simulink; unlike the direct setting of the number of inputs
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
168 from Simulink, the GUI will change also the size of the block, in order to make it easier to connect the blocks and to be read.<br><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
169 The same applies to Demux blocks.<br><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
170
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
171 <h2>'From' block parameter</h2><hr><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
172 When the user selects a 'From' block into a valid LTPDA Simulink model, the GUI answers drawing the button '<tt>Find Origin</tt>',
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
173 which will provide a direct pointing to the address of the 'Goto' block source of that signal.<br><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
174 <img src="images/parampanel_8.png" alt="'Object from list' parameter" border="1"><br><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
175 If there's more than a single 'Goto' block, or if there's none, the GUI will show a proper warning.<br><br>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
176
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
177
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
178
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
179 </p>
|
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
|
180
|
