Scicos Block
fr - eng

##
SUMMATION Matrix Summation

### Contents

- SUMMATION Matrix Summation
  - Palette
  - Description
  - Dialog box
  - Default properties
  - Interfacing function
  - Computational function
  - Authors

### Palette

- Linear - Linear palette

### Description

The Sum block performs addition or subtraction on its inputs. This block can add or subtract scalar, vector, or matrix inputs. It can also collapse the elements of a single input vector.
The number of inputs is given by the second parameter. This parameter can be a vector of +1 and -1 or it can be a positive value. In the first case the size of the vector indicates the number of inputs and the signs indicates whether it is a summation or a subtraction. In the second case, the block is a summation block and the value indicates the number of inputs.
On overflow, the result can take different forms:
1- A normal non saturated result.
2- A saturated result.
3- An error message warning the user about the overflow.
The user can select one of these three forms by setting the "DO ON OVERFLOW" field to 0,1 or 2.

### Dialog box

- Datatype (1=real double 2=complex 3=int32 ...)
  It indicates the type of the input/output data. It support all datatype, number must be between 1 and 8.
  Properties : Type 'vec' of size 1.

- Number of inputs or sign vector (of +1, -1)
  It indicates the number of inputs and the operation see the description for more detail.
  Properties : Type 'vec' of size -1.

- Do on Overflow(0=Nothing 1=Saturate 2=Error)
  When this parameter is set to zero the result is similar to a normal summation of two integer matrix. When it is set to 1, on overflow the block saturate the result. When it is set to 2, on overflow an error message box appears. If the Data type is double or complex this parameter is not used.
  Properties : Type 'vec' of size 1.

### Default properties

- always active: no
- direct-feedthrough: yes
- zero-crossing: no
- mode: no
- regular inputs:
  - port 1 : size [-1,-2] / type 1
  - port 2 : size [-1,-2] / type 1
- regular outputs:
  - port 1 : size [-1,-2] / type 1
- number/sizes of activation inputs: 0
- number/sizes of activation outputs: 0
- continuous-time state: no
- discrete-time state: no
- object discrete-time state: no
- name of computational function: summation

### Interfacing function

- SCI/macros/scicos_blocks/Linear/SUMMATION.sci [view code]

### Computational function

- SCI/routines/scicos/summation.c [view code]
- SCI/routines/scicos/summation_z.c [view code]
- SCI/routines/scicos/summation_i32n.c [view code]
- SCI/routines/scicos/summation_i16n.c [view code]
- SCI/routines/scicos/summation_i8n.c [view code]
- SCI/routines/scicos/summation_ui32n.c [view code]
- SCI/routines/scicos/summation_ui16n.c [view code]
- SCI/routines/scicos/summation_ui8n.c [view code]
- SCI/routines/scicos/summation_i32s.c [view code]
- SCI/routines/scicos/summation_i16s.c [view code]
- SCI/routines/scicos/summation_i8s.c [view code]
- SCI/routines/scicos/summation_ui32s.c [view code]
- SCI/routines/scicos/summation_ui16s.c [view code]
- SCI/routines/scicos/summation_ui8s.c [view code]
- SCI/routines/scicos/summation_i32e.c [view code]
- SCI/routines/scicos/summation_i16e.c [view code]
- SCI/routines/scicos/summation_i8e.c [view code]
- SCI/routines/scicos/summation_ui32e.c [view code]
- SCI/routines/scicos/summation_ui16e.c [view code]
- SCI/routines/scicos/summation_ui8e.c [view code]

### Authors

- Fady NASSIF INRIA
- Alan Layec INRIA
- Ramine Nikoukhah INRIA