~ubuntu-branches/ubuntu/raring/scilab/raring-proposed

« back to all changes in this revision

Viewing changes to modules/xcos/help/en_US/palettes/Mathoperations_pal/SUMMATION.xml

  • Committer: Package Import Robot
  • Author(s): Sylvestre Ledru
  • Date: 2012-08-30 14:42:38 UTC
  • mfrom: (1.4.7)
  • Revision ID: package-import@ubuntu.com-20120830144238-c1y2og7dbm7m9nig
Tags: 5.4.0-beta-3-1~exp1
* New upstream release
* Update the scirenderer dep
* Get ride of libjhdf5-java dependency

Show diffs side-by-side

added added

removed removed

Lines of Context:
22
22
 * See the file ./license.txt
23
23
 -->
24
24
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns3="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" version="5.0-subset Scilab" xml:id="SUMMATION">
25
 
  <refnamediv>
26
 
    <refname>SUMMATION</refname>
27
 
    <refpurpose>Matrix Addition/Subtraction</refpurpose>
28
 
  </refnamediv>
29
 
  <refsection>
30
 
    <title>Block Screenshot</title>
31
 
    <para>
32
 
      <inlinemediaobject>
33
 
        <imageobject>
34
 
          <imagedata align="center" fileref="../../../../images/palettes/SUMMATION.png" valign="middle"/>
35
 
        </imageobject>
36
 
      </inlinemediaobject>
37
 
    </para>
38
 
  </refsection>
39
 
  <refsection id="Contents_SUMMATION">
40
 
    <title>Contents</title>
41
 
    <itemizedlist>
42
 
      <listitem>
43
 
        <para>
44
 
          <link linkend="SUMMATION">Matrix Summation</link>
45
 
        </para>
46
 
      </listitem>
47
 
      <listitem>
48
 
        <itemizedlist>
49
 
          <listitem>
50
 
            <para>
51
 
              <xref linkend="Palette_SUMMATION">Palette</xref>
52
 
            </para>
53
 
          </listitem>
54
 
          <listitem>
55
 
            <para>
56
 
              <xref linkend="Description_SUMMATION">Description</xref>
57
 
            </para>
58
 
          </listitem>
59
 
          <listitem>
60
 
            <para>
61
 
              <xref linkend="Dialogbox_SUMMATION">Dialog box</xref>
62
 
            </para>
63
 
          </listitem>
64
 
          <listitem>
65
 
            <para>
66
 
              <xref linkend="Defaultproperties_SUMMATION">Default properties</xref>
67
 
            </para>
68
 
          </listitem>
69
 
          <listitem>
70
 
            <para>
71
 
              <xref linkend="Interfacingfunction_SUMMATION">Interfacing function</xref>
72
 
            </para>
73
 
          </listitem>
74
 
          <listitem>
75
 
            <para>
76
 
              <xref linkend="Computationalfunction_SUMMATION">Computational function</xref>
77
 
            </para>
78
 
          </listitem>
79
 
          <listitem>
80
 
            <para>
81
 
              <xref linkend="Seealso_SUMMATION">See also</xref>
82
 
            </para>
83
 
          </listitem>
84
 
        </itemizedlist>
85
 
      </listitem>
86
 
    </itemizedlist>
87
 
  </refsection>
88
 
  <refsection id="Palette_SUMMATION">
89
 
    <title>Palette</title>
90
 
    <itemizedlist>
91
 
      <listitem>
92
 
        <para>
93
 
          <link linkend="Mathoperations_pal">Math operations palette</link>
94
 
        </para>
95
 
      </listitem>
96
 
    </itemizedlist>
97
 
  </refsection>
98
 
  <refsection id="Description_SUMMATION">
99
 
    <title>Description</title>
100
 
    <para>
101
 
      This block performs addition or subtraction on scalar, vector or matrix inputs. The input datatype
102
 
      is set with the <emphasis role="bold">Datatype</emphasis> parameter. The <emphasis role="bold">
103
 
        Number of inputs or sign vector
104
 
      </emphasis>
105
 
      parameter defines the number of inputs and operation. For
106
 
      a single vector's input the block collapse the elements of the vector. Vectors/matrices inputs
107
 
      must have the same size.
108
 
    </para>
109
 
    <para>The behavior of the block is summarized in the following table :</para>
110
 
    <para/>
111
 
    <informaltable border="1" cellpadding="2">
112
 
      <tr>
113
 
        <td align="left" width="18%">
114
 
          <emphasis role="bold">Number of inputs</emphasis>
115
 
        </td>
116
 
        <td align="left" width="20%">
117
 
          <emphasis role="bold">Operation</emphasis>
118
 
        </td>
119
 
        <td align="left">
120
 
          <emphasis role="bold">Remarks</emphasis>
121
 
        </td>
122
 
      </tr>
123
 
      <tr>
124
 
        <td align="left">One</td>
125
 
        <td align="left">y = (+/-)u</td>
126
 
        <td align="left">
127
 
          <emphasis>u</emphasis> is a scalar value and the block has the behavior of a unitary gain.
128
 
        </td>
129
 
      </tr>
130
 
      <tr>
131
 
        <td align="left">One</td>
132
 
        <td align="left">y = u[1]+u[2]+...+u[N]</td>
133
 
        <td align="left">
134
 
          <emphasis>u</emphasis> is a vector or a matrix and the block output is the sum of the elements of the input
135
 
          vector or matrix.
136
 
        </td>
137
 
      </tr>
138
 
      <tr>
139
 
        <td align="left">Two or more</td>
140
 
        <td align="left">y = k[1]*u1+k[2]*u2+...+k[N]*uN</td>
141
 
        <td align="left">
142
 
          <emphasis>k</emphasis> is the scalar or vector value write in the <emphasis role="bold">
143
 
            Number of inputs or sign vector
144
 
          </emphasis>
145
 
          parameter. For the addition of all inputs, simply set this
146
 
          parameter to the number of inputs. To add/subtract the input <emphasis>ui</emphasis>, set in this
147
 
          parameter a vector k with <emphasis>k[i]</emphasis> = +1 (addition) or -1 (subtraction)
148
 
          for the input <emphasis>ui</emphasis>.
149
 
        </td>
150
 
      </tr>
151
 
    </informaltable>
152
 
    <para>With integer input, on overflow the result can take different forms:</para>
153
 
    <para>
154
 
      1- A normal non saturated result. By example, if type is int8 and the result 128, the block output
155
 
      value will be -128.
156
 
    </para>
157
 
    <para>2- A saturated result. For the previous example the block output value will be 127.</para>
158
 
    <para>3- An error message warning the user about the overflow.</para>
159
 
    <para>
160
 
      The user can select one of these three forms by setting the
161
 
      <emphasis role="bold">Do on Overflow</emphasis> field to 0,1 or 2.
162
 
    </para>
163
 
    <para/>
164
 
  </refsection>
165
 
  <refsection id="Dialogbox_SUMMATION">
166
 
    <title>Dialog box</title>
167
 
    <para>
168
 
      <inlinemediaobject>
169
 
        <imageobject>
170
 
          <imagedata align="center" fileref="../../../../images/gui/SUMMATION_gui.gif" valign="middle"/>
171
 
        </imageobject>
172
 
      </inlinemediaobject>
173
 
    </para>
174
 
    <para/>
175
 
    <itemizedlist>
176
 
      <listitem>
177
 
        <para>
178
 
          <emphasis role="bold">Datatype (1=real double 2=complex 3=int32 ...)</emphasis>
179
 
        </para>
180
 
        <para>
181
 
          It indicates the type of the input/output data. It support all datatype, number must be between 1 and 8.
182
 
        </para>
183
 
        <para>Properties : Type 'vec' of size 1.</para>
184
 
      </listitem>
185
 
      <listitem>
186
 
        <para>
187
 
          <emphasis role="bold">Number of inputs or sign vector (of +1,-1)</emphasis>
188
 
        </para>
189
 
        <para>
190
 
          It indicates the number of inputs and the operation see the description for more detail. If you set a value
191
 
          other of -1 or +1, you get an error message box.
192
 
        </para>
193
 
        <para>Properties : Type 'vec' of size -1.</para>
194
 
      </listitem>
195
 
      <listitem>
196
 
        <para>
197
 
          <emphasis role="bold">Do on Overflow(0=Nothing 1=Saturate 2=Error)</emphasis>
198
 
        </para>
199
 
        <para>When this parameter is set to zero the result is similar to a
200
 
          normal summation of two integer matrix. When it is set to 1, on
201
 
          overflow the block saturate the result. When it is set to 2, on
202
 
          overflow an error message box appears. If the Data type is double or
203
 
          complex this parameter is not used.
204
 
        </para>
205
 
        <para>Properties : Type 'vec' of size 1.</para>
206
 
      </listitem>
207
 
    </itemizedlist>
208
 
  </refsection>
209
 
  <refsection id="Defaultproperties_SUMMATION">
210
 
    <title>Default properties</title>
211
 
    <itemizedlist>
212
 
      <listitem>
213
 
        <para>
214
 
          <emphasis role="bold">always active:</emphasis> no
215
 
        </para>
216
 
      </listitem>
217
 
      <listitem>
218
 
        <para>
219
 
          <emphasis role="bold">direct-feedthrough:</emphasis> yes
220
 
        </para>
221
 
      </listitem>
222
 
      <listitem>
223
 
        <para>
224
 
          <emphasis role="bold">zero-crossing:</emphasis> no
225
 
        </para>
226
 
      </listitem>
227
 
      <listitem>
228
 
        <para>
229
 
          <emphasis role="bold">mode:</emphasis> no
230
 
        </para>
231
 
      </listitem>
232
 
      <listitem>
233
 
        <para>
234
 
          <emphasis role="bold">regular inputs:</emphasis>
235
 
        </para>
236
 
        <para>
237
 
          <emphasis role="bold">- port 1 : size [-1,-2] / type 1</emphasis>
238
 
        </para>
239
 
        <para>
240
 
          <emphasis role="bold">- port 2 : size [-1,-2] / type 1</emphasis>
241
 
        </para>
242
 
      </listitem>
243
 
      <listitem>
244
 
        <para>
245
 
          <emphasis role="bold">regular outputs:</emphasis>
246
 
        </para>
247
 
        <para>
248
 
          <emphasis role="bold">- port 1 : size [-1,-2] / type 1</emphasis>
249
 
        </para>
250
 
      </listitem>
251
 
      <listitem>
252
 
        <para>
253
 
          <emphasis role="bold">number/sizes of activation inputs:</emphasis> 0
254
 
        </para>
255
 
      </listitem>
256
 
      <listitem>
257
 
        <para>
258
 
          <emphasis role="bold">number/sizes of activation outputs:</emphasis> 0
259
 
        </para>
260
 
      </listitem>
261
 
      <listitem>
262
 
        <para>
263
 
          <emphasis role="bold">continuous-time state:</emphasis> no
264
 
        </para>
265
 
      </listitem>
266
 
      <listitem>
267
 
        <para>
268
 
          <emphasis role="bold">discrete-time state:</emphasis> no
269
 
        </para>
270
 
      </listitem>
271
 
      <listitem>
272
 
        <para>
273
 
          <emphasis role="bold">object discrete-time state:</emphasis> no
274
 
        </para>
275
 
      </listitem>
276
 
      <listitem>
277
 
        <para>
278
 
          <emphasis role="bold">name of computational function:</emphasis>
279
 
          <emphasis role="italic">summation</emphasis>
280
 
        </para>
281
 
      </listitem>
282
 
    </itemizedlist>
283
 
  </refsection>
284
 
  <refsection id="Interfacingfunction_SUMMATION">
285
 
    <title>Interfacing function</title>
286
 
    <itemizedlist>
287
 
      <listitem>
288
 
        <para>SCI/modules/scicos_blocks/macros/Linear/SUMMATION.sci</para>
289
 
      </listitem>
290
 
    </itemizedlist>
291
 
  </refsection>
292
 
  <refsection id="Computationalfunction_SUMMATION">
293
 
    <title>Computational function</title>
294
 
    <itemizedlist>
295
 
      <listitem>
296
 
        <para>SCI/modules/scicos_blocks/src/c/summation.c</para>
297
 
      </listitem>
298
 
      <listitem>
299
 
        <para>SCI/modules/scicos_blocks/src/c/summation_z.c</para>
300
 
      </listitem>
301
 
      <listitem>
302
 
        <para>SCI/modules/scicos_blocks/src/c/summation_i32n.c</para>
303
 
      </listitem>
304
 
      <listitem>
305
 
        <para>SCI/modules/scicos_blocks/src/c/summation_i16n.c</para>
306
 
      </listitem>
307
 
      <listitem>
308
 
        <para>SCI/modules/scicos_blocks/src/c/summation_i8n.c</para>
309
 
      </listitem>
310
 
      <listitem>
311
 
        <para>SCI/modules/scicos_blocks/src/c/summation_ui32n.c</para>
312
 
      </listitem>
313
 
      <listitem>
314
 
        <para>SCI/modules/scicos_blocks/src/c/summation_ui16n.c</para>
315
 
      </listitem>
316
 
      <listitem>
317
 
        <para>SCI/modules/scicos_blocks/src/c/summation_ui8n.c</para>
318
 
      </listitem>
319
 
      <listitem>
320
 
        <para>SCI/modules/scicos_blocks/src/c/summation_i32s.c</para>
321
 
      </listitem>
322
 
      <listitem>
323
 
        <para>SCI/modules/scicos_blocks/src/c/summation_i16s.c</para>
324
 
      </listitem>
325
 
      <listitem>
326
 
        <para>SCI/modules/scicos_blocks/src/c/summation_i8s.c</para>
327
 
      </listitem>
328
 
      <listitem>
329
 
        <para>SCI/modules/scicos_blocks/src/c/summation_ui32s.c</para>
330
 
      </listitem>
331
 
      <listitem>
332
 
        <para>SCI/modules/scicos_blocks/src/c/summation_ui16s.c</para>
333
 
      </listitem>
334
 
      <listitem>
335
 
        <para>SCI/modules/scicos_blocks/src/c/summation_ui8s.c</para>
336
 
      </listitem>
337
 
      <listitem>
338
 
        <para>SCI/modules/scicos_blocks/src/c/summation_i32e.c</para>
339
 
      </listitem>
340
 
      <listitem>
341
 
        <para>SCI/modules/scicos_blocks/src/c/summation_i16e.c</para>
342
 
      </listitem>
343
 
      <listitem>
344
 
        <para>SCI/modules/scicos_blocks/src/c/summation_i8e.c</para>
345
 
      </listitem>
346
 
      <listitem>
347
 
        <para>SCI/modules/scicos_blocks/src/c/summation_ui32e.c</para>
348
 
      </listitem>
349
 
      <listitem>
350
 
        <para>SCI/modules/scicos_blocks/src/c/summation_ui16e.c</para>
351
 
      </listitem>
352
 
      <listitem>
353
 
        <para>SCI/modules/scicos_blocks/src/c/summation_ui8e.c</para>
354
 
      </listitem>
355
 
    </itemizedlist>
356
 
  </refsection>
357
 
  <refsection id="Seealso_SUMMATION">
358
 
    <title>See also</title>
359
 
    <itemizedlist>
360
 
      <listitem>
361
 
        <para>
362
 
          <link linkend="BIGSOM_f">BIGSOM_f - Sclar/Vector Addition/Soustraction (Xcos block)</link>
363
 
        </para>
364
 
      </listitem>
365
 
      <listitem>
366
 
        <para>
367
 
          <link linkend="SUM_f">SUM_f - Addition (Xcos block)</link>
368
 
        </para>
369
 
      </listitem>
370
 
    </itemizedlist>
371
 
  </refsection>
 
25
    <refnamediv>
 
26
        <refname>SUMMATION</refname>
 
27
        <refpurpose>Matrix Addition/Subtraction</refpurpose>
 
28
    </refnamediv>
 
29
    <refsection>
 
30
        <title>Block Screenshot</title>
 
31
        <para>
 
32
            <inlinemediaobject>
 
33
                <imageobject>
 
34
                    <imagedata align="center" fileref="../../../../images/palettes/SUMMATION.png" valign="middle"/>
 
35
                </imageobject>
 
36
            </inlinemediaobject>
 
37
        </para>
 
38
    </refsection>
 
39
    <refsection id="Contents_SUMMATION">
 
40
        <title>Contents</title>
 
41
        <itemizedlist>
 
42
            <listitem>
 
43
                <para>
 
44
                    <link linkend="SUMMATION">Matrix Summation</link>
 
45
                </para>
 
46
            </listitem>
 
47
            <listitem>
 
48
                <itemizedlist>
 
49
                    <listitem>
 
50
                        <para>
 
51
                            <xref linkend="Palette_SUMMATION">Palette</xref>
 
52
                        </para>
 
53
                    </listitem>
 
54
                    <listitem>
 
55
                        <para>
 
56
                            <xref linkend="Description_SUMMATION">Description</xref>
 
57
                        </para>
 
58
                    </listitem>
 
59
                    <listitem>
 
60
                        <para>
 
61
                            <xref linkend="Dialogbox_SUMMATION">Dialog box</xref>
 
62
                        </para>
 
63
                    </listitem>
 
64
                    <listitem>
 
65
                        <para>
 
66
                            <xref linkend="Defaultproperties_SUMMATION">Default properties</xref>
 
67
                        </para>
 
68
                    </listitem>
 
69
                    <listitem>
 
70
                        <para>
 
71
                            <xref linkend="Interfacingfunction_SUMMATION">Interfacing function</xref>
 
72
                        </para>
 
73
                    </listitem>
 
74
                    <listitem>
 
75
                        <para>
 
76
                            <xref linkend="Computationalfunction_SUMMATION">Computational function</xref>
 
77
                        </para>
 
78
                    </listitem>
 
79
                    <listitem>
 
80
                        <para>
 
81
                            <xref linkend="Seealso_SUMMATION">See also</xref>
 
82
                        </para>
 
83
                    </listitem>
 
84
                </itemizedlist>
 
85
            </listitem>
 
86
        </itemizedlist>
 
87
    </refsection>
 
88
    <refsection id="Palette_SUMMATION">
 
89
        <title>Palette</title>
 
90
        <itemizedlist>
 
91
            <listitem>
 
92
                <para>
 
93
                    <link linkend="Mathoperations_pal">Math operations palette</link>
 
94
                </para>
 
95
            </listitem>
 
96
        </itemizedlist>
 
97
    </refsection>
 
98
    <refsection id="Description_SUMMATION">
 
99
        <title>Description</title>
 
100
        <para>
 
101
            This block performs addition or subtraction on scalar, vector or matrix inputs. The input datatype
 
102
            is set with the <emphasis role="bold">Datatype</emphasis> parameter. The <emphasis role="bold">
 
103
                Number of inputs or sign vector
 
104
            </emphasis>
 
105
            parameter defines the number of inputs and operation. For
 
106
            a single vector's input the block collapse the elements of the vector. Vectors/matrices inputs
 
107
            must have the same size.
 
108
        </para>
 
109
        <para>The behavior of the block is summarized in the following table :</para>
 
110
        <para/>
 
111
        <informaltable border="1" cellpadding="2">
 
112
            <tr>
 
113
                <td align="left" width="18%">
 
114
                    <emphasis role="bold">Number of inputs</emphasis>
 
115
                </td>
 
116
                <td align="left" width="20%">
 
117
                    <emphasis role="bold">Operation</emphasis>
 
118
                </td>
 
119
                <td align="left">
 
120
                    <emphasis role="bold">Remarks</emphasis>
 
121
                </td>
 
122
            </tr>
 
123
            <tr>
 
124
                <td align="left">One</td>
 
125
                <td align="left">y = (+/-)u</td>
 
126
                <td align="left">
 
127
                    <emphasis>u</emphasis> is a scalar value and the block has the behavior of a unitary gain.
 
128
                </td>
 
129
            </tr>
 
130
            <tr>
 
131
                <td align="left">One</td>
 
132
                <td align="left">y = u[1]+u[2]+...+u[N]</td>
 
133
                <td align="left">
 
134
                    <emphasis>u</emphasis> is a vector or a matrix and the block output is the sum of the elements of the input
 
135
                    vector or matrix.
 
136
                </td>
 
137
            </tr>
 
138
            <tr>
 
139
                <td align="left">Two or more</td>
 
140
                <td align="left">y = k[1]*u1+k[2]*u2+...+k[N]*uN</td>
 
141
                <td align="left">
 
142
                    <emphasis>k</emphasis> is the scalar or vector value write in the <emphasis role="bold">
 
143
                        Number of inputs or sign vector
 
144
                    </emphasis>
 
145
                    parameter. For the addition of all inputs, simply set this
 
146
                    parameter to the number of inputs. To add/subtract the input <emphasis>ui</emphasis>, set in this
 
147
                    parameter a vector k with <emphasis>k[i]</emphasis> = +1 (addition) or -1 (subtraction)
 
148
                    for the input <emphasis>ui</emphasis>.
 
149
                </td>
 
150
            </tr>
 
151
        </informaltable>
 
152
        <para>With integer input, on overflow the result can take different forms:</para>
 
153
        <para>
 
154
            1- A normal non saturated result. By example, if type is int8 and the result 128, the block output
 
155
            value will be -128.
 
156
        </para>
 
157
        <para>2- A saturated result. For the previous example the block output value will be 127.</para>
 
158
        <para>3- An error message warning the user about the overflow.</para>
 
159
        <para>
 
160
            The user can select one of these three forms by setting the
 
161
            <emphasis role="bold">Do on Overflow</emphasis> field to 0,1 or 2.
 
162
        </para>
 
163
        <para/>
 
164
    </refsection>
 
165
    <refsection id="Dialogbox_SUMMATION">
 
166
        <title>Dialog box</title>
 
167
        <para>
 
168
            <inlinemediaobject>
 
169
                <imageobject>
 
170
                    <imagedata align="center" fileref="../../../../images/gui/SUMMATION_gui.gif" valign="middle"/>
 
171
                </imageobject>
 
172
            </inlinemediaobject>
 
173
        </para>
 
174
        <para/>
 
175
        <itemizedlist>
 
176
            <listitem>
 
177
                <para>
 
178
                    <emphasis role="bold">Datatype (1=real double 2=complex 3=int32 ...)</emphasis>
 
179
                </para>
 
180
                <para>
 
181
                    It indicates the type of the input/output data. It support all datatype, number must be between 1 and 8.
 
182
                </para>
 
183
                <para>Properties : Type 'vec' of size 1.</para>
 
184
            </listitem>
 
185
            <listitem>
 
186
                <para>
 
187
                    <emphasis role="bold">Number of inputs or sign vector (of +1,-1)</emphasis>
 
188
                </para>
 
189
                <para>
 
190
                    It indicates the number of inputs and the operation see the description for more detail. If you set a value
 
191
                    other of -1 or +1, you get an error message box.
 
192
                </para>
 
193
                <para>Properties : Type 'vec' of size -1.</para>
 
194
            </listitem>
 
195
            <listitem>
 
196
                <para>
 
197
                    <emphasis role="bold">Do on Overflow(0=Nothing 1=Saturate 2=Error)</emphasis>
 
198
                </para>
 
199
                <para>When this parameter is set to zero the result is similar to a
 
200
                    normal summation of two integer matrix. When it is set to 1, on
 
201
                    overflow the block saturate the result. When it is set to 2, on
 
202
                    overflow an error message box appears. If the Data type is double or
 
203
                    complex this parameter is not used.
 
204
                </para>
 
205
                <para>Properties : Type 'vec' of size 1.</para>
 
206
            </listitem>
 
207
        </itemizedlist>
 
208
    </refsection>
 
209
    <refsection id="Defaultproperties_SUMMATION">
 
210
        <title>Default properties</title>
 
211
        <itemizedlist>
 
212
            <listitem>
 
213
                <para>
 
214
                    <emphasis role="bold">always active:</emphasis> no
 
215
                </para>
 
216
            </listitem>
 
217
            <listitem>
 
218
                <para>
 
219
                    <emphasis role="bold">direct-feedthrough:</emphasis> yes
 
220
                </para>
 
221
            </listitem>
 
222
            <listitem>
 
223
                <para>
 
224
                    <emphasis role="bold">zero-crossing:</emphasis> no
 
225
                </para>
 
226
            </listitem>
 
227
            <listitem>
 
228
                <para>
 
229
                    <emphasis role="bold">mode:</emphasis> no
 
230
                </para>
 
231
            </listitem>
 
232
            <listitem>
 
233
                <para>
 
234
                    <emphasis role="bold">regular inputs:</emphasis>
 
235
                </para>
 
236
                <para>
 
237
                    <emphasis role="bold">- port 1 : size [-1,-2] / type 1</emphasis>
 
238
                </para>
 
239
                <para>
 
240
                    <emphasis role="bold">- port 2 : size [-1,-2] / type 1</emphasis>
 
241
                </para>
 
242
            </listitem>
 
243
            <listitem>
 
244
                <para>
 
245
                    <emphasis role="bold">regular outputs:</emphasis>
 
246
                </para>
 
247
                <para>
 
248
                    <emphasis role="bold">- port 1 : size [-1,-2] / type 1</emphasis>
 
249
                </para>
 
250
            </listitem>
 
251
            <listitem>
 
252
                <para>
 
253
                    <emphasis role="bold">number/sizes of activation inputs:</emphasis> 0
 
254
                </para>
 
255
            </listitem>
 
256
            <listitem>
 
257
                <para>
 
258
                    <emphasis role="bold">number/sizes of activation outputs:</emphasis> 0
 
259
                </para>
 
260
            </listitem>
 
261
            <listitem>
 
262
                <para>
 
263
                    <emphasis role="bold">continuous-time state:</emphasis> no
 
264
                </para>
 
265
            </listitem>
 
266
            <listitem>
 
267
                <para>
 
268
                    <emphasis role="bold">discrete-time state:</emphasis> no
 
269
                </para>
 
270
            </listitem>
 
271
            <listitem>
 
272
                <para>
 
273
                    <emphasis role="bold">object discrete-time state:</emphasis> no
 
274
                </para>
 
275
            </listitem>
 
276
            <listitem>
 
277
                <para>
 
278
                    <emphasis role="bold">name of computational function:</emphasis>
 
279
                    <emphasis role="italic">summation</emphasis>
 
280
                </para>
 
281
            </listitem>
 
282
        </itemizedlist>
 
283
    </refsection>
 
284
    <refsection id="Interfacingfunction_SUMMATION">
 
285
        <title>Interfacing function</title>
 
286
        <itemizedlist>
 
287
            <listitem>
 
288
                <para>SCI/modules/scicos_blocks/macros/Linear/SUMMATION.sci</para>
 
289
            </listitem>
 
290
        </itemizedlist>
 
291
    </refsection>
 
292
    <refsection id="Computationalfunction_SUMMATION">
 
293
        <title>Computational function</title>
 
294
        <itemizedlist>
 
295
            <listitem>
 
296
                <para>SCI/modules/scicos_blocks/src/c/summation.c</para>
 
297
            </listitem>
 
298
            <listitem>
 
299
                <para>SCI/modules/scicos_blocks/src/c/summation_z.c</para>
 
300
            </listitem>
 
301
            <listitem>
 
302
                <para>SCI/modules/scicos_blocks/src/c/summation_i32n.c</para>
 
303
            </listitem>
 
304
            <listitem>
 
305
                <para>SCI/modules/scicos_blocks/src/c/summation_i16n.c</para>
 
306
            </listitem>
 
307
            <listitem>
 
308
                <para>SCI/modules/scicos_blocks/src/c/summation_i8n.c</para>
 
309
            </listitem>
 
310
            <listitem>
 
311
                <para>SCI/modules/scicos_blocks/src/c/summation_ui32n.c</para>
 
312
            </listitem>
 
313
            <listitem>
 
314
                <para>SCI/modules/scicos_blocks/src/c/summation_ui16n.c</para>
 
315
            </listitem>
 
316
            <listitem>
 
317
                <para>SCI/modules/scicos_blocks/src/c/summation_ui8n.c</para>
 
318
            </listitem>
 
319
            <listitem>
 
320
                <para>SCI/modules/scicos_blocks/src/c/summation_i32s.c</para>
 
321
            </listitem>
 
322
            <listitem>
 
323
                <para>SCI/modules/scicos_blocks/src/c/summation_i16s.c</para>
 
324
            </listitem>
 
325
            <listitem>
 
326
                <para>SCI/modules/scicos_blocks/src/c/summation_i8s.c</para>
 
327
            </listitem>
 
328
            <listitem>
 
329
                <para>SCI/modules/scicos_blocks/src/c/summation_ui32s.c</para>
 
330
            </listitem>
 
331
            <listitem>
 
332
                <para>SCI/modules/scicos_blocks/src/c/summation_ui16s.c</para>
 
333
            </listitem>
 
334
            <listitem>
 
335
                <para>SCI/modules/scicos_blocks/src/c/summation_ui8s.c</para>
 
336
            </listitem>
 
337
            <listitem>
 
338
                <para>SCI/modules/scicos_blocks/src/c/summation_i32e.c</para>
 
339
            </listitem>
 
340
            <listitem>
 
341
                <para>SCI/modules/scicos_blocks/src/c/summation_i16e.c</para>
 
342
            </listitem>
 
343
            <listitem>
 
344
                <para>SCI/modules/scicos_blocks/src/c/summation_i8e.c</para>
 
345
            </listitem>
 
346
            <listitem>
 
347
                <para>SCI/modules/scicos_blocks/src/c/summation_ui32e.c</para>
 
348
            </listitem>
 
349
            <listitem>
 
350
                <para>SCI/modules/scicos_blocks/src/c/summation_ui16e.c</para>
 
351
            </listitem>
 
352
            <listitem>
 
353
                <para>SCI/modules/scicos_blocks/src/c/summation_ui8e.c</para>
 
354
            </listitem>
 
355
        </itemizedlist>
 
356
    </refsection>
 
357
    <refsection id="Seealso_SUMMATION">
 
358
        <title>See also</title>
 
359
        <itemizedlist>
 
360
            <listitem>
 
361
                <para>
 
362
                    <link linkend="BIGSOM_f">BIGSOM_f - Sclar/Vector Addition/Soustraction (Xcos block)</link>
 
363
                </para>
 
364
            </listitem>
 
365
            <listitem>
 
366
                <para>
 
367
                    <link linkend="SUM_f">SUM_f - Addition (Xcos block)</link>
 
368
                </para>
 
369
            </listitem>
 
370
        </itemizedlist>
 
371
    </refsection>
372
372
</refentry>