EXTTRI

Scicos Block
fr - eng

##
EXTTRI: Triangular or Diagonal extraction

### Contents

- EXTTRI: Triangular or Diagonal extraction
  - Palette
  - Description
  - Dialog box
  - Example
  - Default properties
  - Interfacing function
  - Computational function
  - See also
  - Authors

### Palette

- Matrix - Matrix operation palette

### Description

The EXTTRI block extracts some elements from the input matrix u.
When the "Extraction type" is set to "1", the block copies the elements on and above the main diagonal to an output matrix of the same size. The elements below the main diagonal are set to zero.
When the "Extraction type" is set to "2", the block copies the elements on and below the main diagonal to an output matrix of the same size. The elements above the main diagonal are set to zero.
When the "Extraction type" is set to "3", the block copies the elements on the main diagonal to an output matrix of the same size. The elements above and below the main diagonal are set to zero.

### Dialog box

- Datatype(1=real double 2=Complex)
  It indicates the type of the output. It support only the two types double (1) and complex (2). If we input another entry in this label Scicos will print the message "Datatype is not supported".
  Properties : Type 'vec' of size 1.

- extraction type (1=lower 2=upper 3=diagonal)
  It indicates the form of the output matrix. It can be an upper triangle, a lower triangle or a diagonal matrix.
  Properties : Type 'vec' of size 1.

### Example

    A=[1 2 3;4 5 6;7 8 9;10 11 12]
    If the extraction type is 2 then the output is
    B=[1 0 0;4 5 0;7 8 9;10 11 12]

### Default properties

- always active: no
- direct-feedthrough: yes
- zero-crossing: no
- mode: no
- regular inputs:
  - port 1 : 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: extrilz

### Interfacing function

- SCI/macros/scicos_blocks/MatrixOp/EXTTRI.sci [view code]

### Computational function

- SCI/routines/scicos/exttril.c [view code]
- SCI/routines/scicos/exttriu.c [view code]
- SCI/routines/scicos/extdiag.c [view code]
- SCI/routines/scicos/exttrilz.c [view code]
- SCI/routines/scicos/exttriuz.c [view code]
- SCI/routines/scicos/extdiagz.c [view code]

### See also

- EXTRACT - EXTRACT: Matrix Extractor (Scicos Block)

### Authors

Fady NASSIF INRIA