13
13
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns4="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" xml:lang="fr_FR">
15
<refname>SUMMATION</refname>
16
<refpurpose>Addition/Soustraction de matrices</refpurpose>
23
<imagedata align="center" fileref="../../../../images/palettes/SUMMATION.png" valign="middle"/>
28
<refsection id="Contents_SUMMATION">
29
<title>Contenu</title>
33
<link linkend="SUMMATION">Addition/Soustraction de matrices</link>
40
<xref linkend="Palette_SUMMATION">Palette</xref>
45
<xref linkend="Description_SUMMATION">Description</xref>
50
<xref linkend="Dialogbox_SUMMATION">Boîte de dialogue</xref>
55
<xref linkend="Defaultproperties_SUMMATION">Propriétés par défaut</xref>
60
<xref linkend="Interfacingfunction_SUMMATION">Fonction d'interfaçage</xref>
65
<xref linkend="Computationalfunction_SUMMATION">Fonctions de calcul</xref>
70
<xref linkend="Seealso_SUMMATION">Voir aussi</xref>
77
<refsection id="Palette_SUMMATION">
78
<title>Palette</title>
82
<link linkend="Mathoperations_pal">Palette Opérations mathématiques</link>
87
<refsection id="Description_SUMMATION">
88
<title>Description</title>
90
Ce bloc effectue l'addition ou la soustraction des entrées scalaires, vectorielles ou matricielles.
91
Le types de données en entrée est réglé avec le paramètre <emphasis role="bold">Datatype</emphasis>.
92
Le paramètre <emphasis role="bold">Number of inputs or sign vector</emphasis> définit le nombre d'entrées
93
et l'opération. Pour une entrée vectorielle unique le bloc effectue la somme des éléments du vecteur.
94
Les vecteurs/matrices d'entrée doivent avoir les mêmes dimensions.
97
Le comportement de ce bloc est résumé dans le tableau suivant :
100
<informaltable border="1" cellpadding="2">
102
<td align="left" width="18%">
103
<emphasis role="bold">Nombre d'entrées</emphasis>
105
<td align="left" width="18%">
106
<emphasis role="bold">Opération</emphasis>
109
<emphasis role="bold">Remarques</emphasis>
113
<td align="left" rawspan="2">Une</td>
114
<td align="left">y = u</td>
116
<emphasis>u</emphasis> est une valeur scalaire et le bloc se comporte comme un gain unitaire.
120
<td align="left" rawspan="2">Une</td>
121
<td align="left">y = u[1]+u[2]+...+u[N]</td>
123
<emphasis>u</emphasis> est un vecteur ou une matrice et la sortie du bloc est la somme des éléments du
124
vecteur ou de la matrice d'entrée.
128
<td align="left">Deux ou plus</td>
129
<td align="left">y = k[1]*u1+k[2]*u2+...+k[N]*uN</td>
131
<emphasis>k</emphasis> est une valeur scalaire ou vectorielle écrite dans le paramètre
132
<emphasis role="bold">Number of inputs or sign vector</emphasis>. Pour l'addition de toutes les entrées,
133
mettre simplement ce paramètre au nombre d'entrées. Pour additionner/soustraire l'entrée
134
<emphasis>ui</emphasis>, mettre dans ce paramètre un vecteur k avec <emphasis>k[i]</emphasis>
135
= +1 (addition) ou -1 (soustraction) pour l'entrée <emphasis>ui</emphasis>.
140
Avec une entrée entière, lors d'un dépassement de capacité, le résultat peut prendre des formes différentes :
143
1- Un résultat normal non saturé. Par exemple, si le type est int8 et le résultat 128, la valeur de sortie
146
<para>2- Un résultat saturé. Pour l'exemple précédent la valeur de sortie du bloc sera 127</para>
147
<para>3- Un message d'erreur prévenant l'utilisateur du dépassement de capacité.</para>
149
L'utilisateur peut sélectionner l'une de ces trois formes en mettant le champ
150
<emphasis role="bold">Do on Overflow</emphasis> à 0,1 ou 2.
154
<refsection id="Dialogbox_SUMMATION">
155
<title>Boîte de dialogue</title>
159
<imagedata align="center" fileref="../../../../images/gui/SUMMATION_gui.gif" valign="middle"/>
167
<emphasis role="bold">Datatype (1=real double 2=complex 3=int32 ...)</emphasis>
170
Il indique le type des données d'entrée/sortie. Il supporte tous les types de données,
171
le nombre doit être entre 1 et 8.
173
<para>Propriétés : Type 'vec' de taille 1.</para>
177
<emphasis role="bold">Number of inputs or sign vector (of +1, -1)</emphasis>
179
<para>Il indique le nombre d'entrées et l'opération. Voir la description pour plus de détails.</para>
180
<para>Propriétés : Type 'vec' de taille -1.</para>
184
<emphasis role="bold">Do on Overflow(0=Nothing 1=Saturate 2=Error)</emphasis>
187
Quand ce paramètre est mis à zéro le résultat est similaire à l'addition normale de deux matrices
188
entières. Quand il est à 1, sur un dépassement de capacité le bloc sature le résultat.
189
Quand il est à 2, sur un dépassement de capacité une boîte de message d'erreur est affichée.
190
Si le type de donnée est double ou complexe ce paramètre n'est pas utilisé.
192
<para>Propriétés : Type 'vec' de taille 1.</para>
196
<refsection id="Defaultproperties_SUMMATION">
197
<title>Propriétés par défaut</title>
201
<emphasis role="bold">always active:</emphasis> non
206
<emphasis role="bold">direct-feedthrough:</emphasis> oui
211
<emphasis role="bold">zero-crossing:</emphasis> non
216
<emphasis role="bold">mode:</emphasis> non
221
<emphasis role="bold">regular inputs:</emphasis>
224
<emphasis role="bold">- port 1 : size [-1,-2] / type 1</emphasis>
227
<emphasis role="bold">- port 2 : size [-1,-2] / type 1</emphasis>
232
<emphasis role="bold">regular outputs:</emphasis>
235
<emphasis role="bold">- port 1 : size [-1,-2] / type 1</emphasis>
240
<emphasis role="bold">number/sizes of activation inputs:</emphasis> 0
245
<emphasis role="bold">number/sizes of activation outputs:</emphasis> 0
250
<emphasis role="bold">continuous-time state:</emphasis> non
255
<emphasis role="bold">discrete-time state:</emphasis> non
260
<emphasis role="bold">object discrete-time state:</emphasis> non
265
<emphasis role="bold">name of computational function:</emphasis>
266
<emphasis role="italic">summation</emphasis>
271
<refsection id="Interfacingfunction_SUMMATION">
272
<title>Fonction d'interfaçage</title>
275
<para>SCI/modules/scicos_blocks/macros/Linear/SUMMATION.sci</para>
279
<refsection id="Computationalfunction_SUMMATION">
280
<title>Fonctions de calcul</title>
283
<para>SCI/modules/scicos_blocks/src/c/summation.c</para>
286
<para>SCI/modules/scicos_blocks/src/c/summation_z.c</para>
289
<para>SCI/modules/scicos_blocks/src/c/summation_i32n.c</para>
292
<para>SCI/modules/scicos_blocks/src/c/summation_i16n.c</para>
295
<para>SCI/modules/scicos_blocks/src/c/summation_i8n.c</para>
298
<para>SCI/modules/scicos_blocks/src/c/summation_ui32n.c</para>
301
<para>SCI/modules/scicos_blocks/src/c/summation_ui16n.c</para>
304
<para>SCI/modules/scicos_blocks/src/c/summation_ui8n.c</para>
307
<para>SCI/modules/scicos_blocks/src/c/summation_i32s.c</para>
310
<para>SCI/modules/scicos_blocks/src/c/summation_i16s.c</para>
313
<para>SCI/modules/scicos_blocks/src/c/summation_i8s.c</para>
316
<para>SCI/modules/scicos_blocks/src/c/summation_ui32s.c</para>
319
<para>SCI/modules/scicos_blocks/src/c/summation_ui16s.c</para>
322
<para>SCI/modules/scicos_blocks/src/c/summation_ui8s.c</para>
325
<para>SCI/modules/scicos_blocks/src/c/summation_i32e.c</para>
328
<para>SCI/modules/scicos_blocks/src/c/summation_i16e.c</para>
331
<para>SCI/modules/scicos_blocks/src/c/summation_i8e.c</para>
334
<para>SCI/modules/scicos_blocks/src/c/summation_ui32e.c</para>
337
<para>SCI/modules/scicos_blocks/src/c/summation_ui16e.c</para>
340
<para>SCI/modules/scicos_blocks/src/c/summation_ui8e.c</para>
344
<refsection id="Seealso_SUMMATION">
345
<title>Voir aussi</title>
349
<link linkend="BIGSOM_f">BIGSOM_f - Addition/Soustraction de scalaires ou vecteurs (Xcos block)</link>
354
<link linkend="SUM_f">SUM_f - Addition de matrices (Xcos block)</link>
15
<refname>SUMMATION</refname>
16
<refpurpose>Addition/Soustraction de matrices</refpurpose>
23
<imagedata align="center" fileref="../../../../images/palettes/SUMMATION.png" valign="middle"/>
28
<refsection id="Contents_SUMMATION">
29
<title>Contenu</title>
33
<link linkend="SUMMATION">Addition/Soustraction de matrices</link>
40
<xref linkend="Palette_SUMMATION">Palette</xref>
45
<xref linkend="Description_SUMMATION">Description</xref>
50
<xref linkend="Dialogbox_SUMMATION">Boîte de dialogue</xref>
55
<xref linkend="Defaultproperties_SUMMATION">Propriétés par défaut</xref>
60
<xref linkend="Interfacingfunction_SUMMATION">Fonction d'interfaçage</xref>
65
<xref linkend="Computationalfunction_SUMMATION">Fonctions de calcul</xref>
70
<xref linkend="Seealso_SUMMATION">Voir aussi</xref>
77
<refsection id="Palette_SUMMATION">
78
<title>Palette</title>
82
<link linkend="Mathoperations_pal">Palette Opérations mathématiques</link>
87
<refsection id="Description_SUMMATION">
88
<title>Description</title>
90
Ce bloc effectue l'addition ou la soustraction des entrées scalaires, vectorielles ou matricielles.
91
Le types de données en entrée est réglé avec le paramètre <emphasis role="bold">Datatype</emphasis>.
92
Le paramètre <emphasis role="bold">Number of inputs or sign vector</emphasis> définit le nombre d'entrées
93
et l'opération. Pour une entrée vectorielle unique le bloc effectue la somme des éléments du vecteur.
94
Les vecteurs/matrices d'entrée doivent avoir les mêmes dimensions.
97
Le comportement de ce bloc est résumé dans le tableau suivant :
100
<informaltable border="1" cellpadding="2">
102
<td align="left" width="18%">
103
<emphasis role="bold">Nombre d'entrées</emphasis>
105
<td align="left" width="18%">
106
<emphasis role="bold">Opération</emphasis>
109
<emphasis role="bold">Remarques</emphasis>
113
<td align="left" rawspan="2">Une</td>
114
<td align="left">y = u</td>
116
<emphasis>u</emphasis> est une valeur scalaire et le bloc se comporte comme un gain unitaire.
120
<td align="left" rawspan="2">Une</td>
121
<td align="left">y = u[1]+u[2]+...+u[N]</td>
123
<emphasis>u</emphasis> est un vecteur ou une matrice et la sortie du bloc est la somme des éléments du
124
vecteur ou de la matrice d'entrée.
128
<td align="left">Deux ou plus</td>
129
<td align="left">y = k[1]*u1+k[2]*u2+...+k[N]*uN</td>
131
<emphasis>k</emphasis> est une valeur scalaire ou vectorielle écrite dans le paramètre
132
<emphasis role="bold">Number of inputs or sign vector</emphasis>. Pour l'addition de toutes les entrées,
133
mettre simplement ce paramètre au nombre d'entrées. Pour additionner/soustraire l'entrée
134
<emphasis>ui</emphasis>, mettre dans ce paramètre un vecteur k avec <emphasis>k[i]</emphasis>
135
= +1 (addition) ou -1 (soustraction) pour l'entrée <emphasis>ui</emphasis>.
140
Avec une entrée entière, lors d'un dépassement de capacité, le résultat peut prendre des formes différentes :
143
1- Un résultat normal non saturé. Par exemple, si le type est int8 et le résultat 128, la valeur de sortie
146
<para>2- Un résultat saturé. Pour l'exemple précédent la valeur de sortie du bloc sera 127</para>
147
<para>3- Un message d'erreur prévenant l'utilisateur du dépassement de capacité.</para>
149
L'utilisateur peut sélectionner l'une de ces trois formes en mettant le champ
150
<emphasis role="bold">Do on Overflow</emphasis> à 0,1 ou 2.
154
<refsection id="Dialogbox_SUMMATION">
155
<title>Boîte de dialogue</title>
159
<imagedata align="center" fileref="../../../../images/gui/SUMMATION_gui.gif" valign="middle"/>
167
<emphasis role="bold">Datatype (1=real double 2=complex 3=int32 ...)</emphasis>
170
Il indique le type des données d'entrée/sortie. Il supporte tous les types de données,
171
le nombre doit être entre 1 et 8.
173
<para>Propriétés : Type 'vec' de taille 1.</para>
177
<emphasis role="bold">Number of inputs or sign vector (of +1, -1)</emphasis>
179
<para>Il indique le nombre d'entrées et l'opération. Voir la description pour plus de détails.</para>
180
<para>Propriétés : Type 'vec' de taille -1.</para>
184
<emphasis role="bold">Do on Overflow(0=Nothing 1=Saturate 2=Error)</emphasis>
187
Quand ce paramètre est mis à zéro le résultat est similaire à l'addition normale de deux matrices
188
entières. Quand il est à 1, sur un dépassement de capacité le bloc sature le résultat.
189
Quand il est à 2, sur un dépassement de capacité une boîte de message d'erreur est affichée.
190
Si le type de donnée est double ou complexe ce paramètre n'est pas utilisé.
192
<para>Propriétés : Type 'vec' de taille 1.</para>
196
<refsection id="Defaultproperties_SUMMATION">
197
<title>Propriétés par défaut</title>
201
<emphasis role="bold">always active:</emphasis> non
206
<emphasis role="bold">direct-feedthrough:</emphasis> oui
211
<emphasis role="bold">zero-crossing:</emphasis> non
216
<emphasis role="bold">mode:</emphasis> non
221
<emphasis role="bold">regular inputs:</emphasis>
224
<emphasis role="bold">- port 1 : size [-1,-2] / type 1</emphasis>
227
<emphasis role="bold">- port 2 : size [-1,-2] / type 1</emphasis>
232
<emphasis role="bold">regular outputs:</emphasis>
235
<emphasis role="bold">- port 1 : size [-1,-2] / type 1</emphasis>
240
<emphasis role="bold">number/sizes of activation inputs:</emphasis> 0
245
<emphasis role="bold">number/sizes of activation outputs:</emphasis> 0
250
<emphasis role="bold">continuous-time state:</emphasis> non
255
<emphasis role="bold">discrete-time state:</emphasis> non
260
<emphasis role="bold">object discrete-time state:</emphasis> non
265
<emphasis role="bold">name of computational function:</emphasis>
266
<emphasis role="italic">summation</emphasis>
271
<refsection id="Interfacingfunction_SUMMATION">
272
<title>Fonction d'interfaçage</title>
275
<para>SCI/modules/scicos_blocks/macros/Linear/SUMMATION.sci</para>
279
<refsection id="Computationalfunction_SUMMATION">
280
<title>Fonctions de calcul</title>
283
<para>SCI/modules/scicos_blocks/src/c/summation.c</para>
286
<para>SCI/modules/scicos_blocks/src/c/summation_z.c</para>
289
<para>SCI/modules/scicos_blocks/src/c/summation_i32n.c</para>
292
<para>SCI/modules/scicos_blocks/src/c/summation_i16n.c</para>
295
<para>SCI/modules/scicos_blocks/src/c/summation_i8n.c</para>
298
<para>SCI/modules/scicos_blocks/src/c/summation_ui32n.c</para>
301
<para>SCI/modules/scicos_blocks/src/c/summation_ui16n.c</para>
304
<para>SCI/modules/scicos_blocks/src/c/summation_ui8n.c</para>
307
<para>SCI/modules/scicos_blocks/src/c/summation_i32s.c</para>
310
<para>SCI/modules/scicos_blocks/src/c/summation_i16s.c</para>
313
<para>SCI/modules/scicos_blocks/src/c/summation_i8s.c</para>
316
<para>SCI/modules/scicos_blocks/src/c/summation_ui32s.c</para>
319
<para>SCI/modules/scicos_blocks/src/c/summation_ui16s.c</para>
322
<para>SCI/modules/scicos_blocks/src/c/summation_ui8s.c</para>
325
<para>SCI/modules/scicos_blocks/src/c/summation_i32e.c</para>
328
<para>SCI/modules/scicos_blocks/src/c/summation_i16e.c</para>
331
<para>SCI/modules/scicos_blocks/src/c/summation_i8e.c</para>
334
<para>SCI/modules/scicos_blocks/src/c/summation_ui32e.c</para>
337
<para>SCI/modules/scicos_blocks/src/c/summation_ui16e.c</para>
340
<para>SCI/modules/scicos_blocks/src/c/summation_ui8e.c</para>
344
<refsection id="Seealso_SUMMATION">
345
<title>Voir aussi</title>
349
<link linkend="BIGSOM_f">BIGSOM_f - Addition/Soustraction de scalaires ou vecteurs (Xcos block)</link>
354
<link linkend="SUM_f">SUM_f - Addition de matrices (Xcos block)</link>