13 Blocks
13.1 ABSBLK_f Scicos abs block
DIALOGUE PARAMETERS :
None.
DESCRIPTION :
This block realizes element-wise vector absolute value operation.
This block has a single input and a single output port.
Port dimension is determined by the context.
13.2 AFFICH_f Scicos numerical display
DIALOGUE PARAMETERS :
- font
: integer, the selected font number (see xset)
- fontsize
: integer, the selected font size (set xset)
- color
: integer, the selected color for the text (see xset)
- Total numer of digits
: an integer greater than 3, the maximum number of digits used to
represent the number (sign, integer part and rational part)
- rational part number of digits
: an integer greater than or equal 0, the number of digits used to
represent the rational part
DESCRIPTION :
This block displays the value of its unique input inside the block
(in the diagram) during simulation. The block must be located in the
main Scicos window.
Warning: each time the block is moved user must click on it to set its
parameters. The display position is then automatically updated.
See Also :
SCOPE_f X
13.3 ANDLOG_f Scicos logical AND block
DIALOGUE PARAMETERS :
None.
DESCRIPTION :
This block, with two event inputs and a regular output,
outputs +1 or -1 on its regular ouput depending on input events.
- +1
:
When events are synchronously present on both event input ports
- -1
:
When only one event is present.
See Also :
IFTHEL_f X
13.4 ANIMXY_f Scicos 2D animated visualization block
DESCRIPTION :
This block realizes the visualization of the evolution of the two
regular input signals by drawing the second input as a function of
the first at instants of events on the event input port.
DIALOGUE PARAMETERS :
- Curve colors
: an integer. It is the color number (>=0)
or marker type (<0) used to draw the evolution of the input port
signal. See xset() for color (dash type) definitions.
- Line or mark size
: an integer.
- Output window number
: The number of graphic window used for the display. It is often good
to use high values to avoid conflict with palettes and Super Block
windows. If you have more than one scope, make sure they don't have
the same window numbers (unless superposition of the curves is
desired).
- Output window position
: a 2 vector specifying the coordinates of the upper left corner of
the graphic window. Answer [] for default window position.
- Output window size
: a 2 vector specifying the width and height of
the graphic window. Answer [] for default window dimensions.
- Xmin, Xmax
: Minimum and maximum values of the first input; used to set up the X-axis
of the plot in the graphics window.
- Ymin, Ymax
: Minimum and maximum values of the second input; used to set up the
Y-axis of the plot in the graphics window.
- Buffer size
: an integer. In order to minimize the number of graphics outputs, data
may buffered.
REMARKS :
Output window number, Output window size, Output window
position are only taken into account at the initialisation time of the
simulation.
See Also :
SCOPE_f X, EVENTSCOPE_f X, SCOPXY_f X
13.5 BIGSOM_f Scicos addition block
DIALOGUE PARAMETERS :
- Input signs
: a vector sgn of weights (generaly +1 or -1). The number of
input signs fix the number of input ports.
DESCRIPTION :
This block realize weighted sum of the input vectors. The output is vector kth component is
the sum of the kth components of each input ports weighted by sgn(k).
See Also :
GAIN_f X, SOM_f X
13.6 CLINDUMMY_f Scicos dummy continuous system with state
DESCRIPTION :
This block should be placed in any block diagram that contains a
zero-crossing block but no continuous system with state. The reason
for that is that it is the ode solver that find zero crossing
surfaces.
See Also :
ZCROSS_f X
13.7 CLKINV_f Scicos Super Block event input port
DESCRIPTION :
This block must only be used inside Scicos Super Blocks to represent
an event input port.
In a Super Block, the event input ports must be numbered from 1 to the
number of event input ports.
DIALOGUE PARAMETERS :
- Port number
: an integer defining the port number.
See Also :
IN_f X, OUT_f X, CLKOUTV_f X
13.8 CLKIN_f Scicos Super Block event input port
DESCRIPTION :
This block must only be used inside Scicos Super Blocks to represent
an event input port.
In a Super Block, the event input ports must be numbered from 1 to the
number of event input ports.
DIALOGUE PARAMETERS :
- Port number
: an integer defining the port number.
See Also :
IN_f X, OUT_f X, CLKOUT_f X
13.9 CLKOUTV_f Scicos Super Block event output port
DESCRIPTION :
This block must only be used inside Scicos Super Blocks to represent
an event output port.
In a Super_Block, the event output ports must be numbered from 1 to the
number of event output ports.
DIALOGUE PARAMETERS :
- Port number
: an integer giving the port number.
See Also :
IN_f X, OUT_f X, CLKINV_f X
13.10 CLKOUT_f Scicos Super Block event output port
DESCRIPTION :
This block must only be used inside Scicos Super Blocks to represent
an event output port.
In a Super_Block, the event output ports must be numbered from 1 to the
number of event output ports.
DIALOGUE PARAMETERS :
- Port number
: an integer giving the port number.
See Also :
IN_f X, OUT_f X, CLKIN_f X
13.11 CLKSOMV_f Scicos event addition block
DIALOGUE PARAMETERS :
None.
DESCRIPTION :
This block is an event addition block with up to three inputs. The
output reproduces
the events on all the input ports. Strictly speaking, CLKSOMV is not a
Scicos block because it is discarded at the compilation phase. The
inputs and output of CLKSOMV are synchronized.
13.12 CLKSOM_f Scicos event addition block
DIALOGUE PARAMETERS :
None.
DESCRIPTION :
This block is an event addition block with up to three inputs. The
output reproduces
the events on all the input ports. Strictly speaking, CLKSOM is not a
Scicos block because it is discarded at the compilation phase. The
inputs and output of CLKSOM are synchronized.
13.13 CLKSPLIT_f Scicos event split block
DIALOGUE PARAMETERS :
None.
DESCRIPTION :
This block is an event split block with an input and two outputs. The
outputs reproduces the event the input port on each output ports.
Strictly speaking, CLKSPLIT is not a Scicos block because it is
discarded at the compilation phase. This block is automatically
created when creating a new link issued from a link.
The inputs and output of CLKSPLIT are synchronized.
13.14 CLOCK_f Scicos periodic event generator
DESCRIPTION :
This block is a Super Block constructed by feeding back the output
of an event delay block into its input event port. The unique
output of this block generates a regular train of events.
DIALOGUE PARAMETERS :
- Period
: scalar. One over the frequency of the clock. Period is the time that
separates two output events.
- Init time
: scalar. Starting date. if negative the clock never starts.
See Also :
EVTDLY_f X
13.15 CLR_f Scicos continuous-time linear system (SISO transfer function)
DIALOGUE PARAMETERS :
- Numerator
: a polynomial in s.
- Denominator
: a polynomial in s.
DESCRIPTION :
This block realizes a SISO linear system represented by its rational
transfer function Numerator/Denominator.
The rational function must be proper.
See Also :
CLSS_f X, INTEGRAL_f X
13.16 CLSS_f Scicos continuous-time linear state-space system
DESCRIPTION :
This block realizes a continuous-time linear state-space system.
xdot=A*x+B*u
y =C*x+D*u
The system is defined by the (A,B,C,D) matrices and the initial
state x0. The dimensions must be compatible.
DIALOGUE PARAMETERS :
- A
: square matrix. The A matrix
- B
: the B matrix, [] if system has no input
- C
: the C matrix , [] if system has no output
- D
: the D matrix, [] if system has no D term.
- x0
: vector. The initial state of the system.
See Also :
CLR_f X, INTEGRAL_f X
13.17 CONST_f Scicos constant value(s) generator
DIALOGUE PARAMETERS :
- constants
: a real vector. The vector size gives the size of the output
port. The value constants(i) is assigned to the ith component of
the output.
DESCRIPTION :
This block is a constant value(s) generator.
13.18 COSBLK_f Scicos cosine block
DIALOGUE PARAMETERS :
None.
DESCRIPTION :
This block realizes vector cosine operation. y(i)=cos(u(i)).
The port input and output port sizes are equal and determined by the
context.
See Also :
SINBLK_f X, GENSIN_f X
13.19 CURV_f Scicos block, tabulated function of time
DIALOGUE PARAMETERS :
Tabulated function is entered using a graphics curve editor (see
edit_curv in Scilab documentation)
DESCRIPTION :
This block defines a tabulated function of time. Between mesh
points block performs a linear interpolation. Outside tabulation block
outputs last tabulated value.
User may define the tabulation of the function using a curve editor.
13.20 DELAYV_f Scicos time varying delay block
DIALOGUE PARAMETERS :
- Number inputs
: size of the delayed vector (-1 not allowed)
- Register initial state
: register initial state vector. Dimension must be greater than or
equal to 2
- Max delay
: Maximum delay that can be produced by this block
DESCRIPTION :
This block implements a time varying discretized delay. The value of
the delay is given by the second input port. The delayed signal enters
the first input port and leaves the unique output prot.
The first event output port must be connected to unique input event port if
auto clocking is desired. But the input event port can also be driven
by outside clock. In that case, the max delay is size of initial
condition times the period of the incoming clock.
The second output event port generates an event if the second input
goes above the maximum delay specified. This signal can be ignored. In
that case the output will be delayed by max delay.
See Also :
DELAY_f X, EVTDLY_f X, REGISTER_f X
13.21 DELAY_f Scicos delay block
DIALOGUE PARAMETERS :
- Discretization time step
: positive scalar, delay discretization time step
- Register initial state
: register initial state vector. Dimension must be greater than or
equal to
2
DESCRIPTION :
This block implements as a discretized delay. It is in fact a Scicos
super block formed by a shift register and a clock.
value of the delay is given by the discretization time step multiplied by the
number of states of the register minus one
See Also :
DELAYV_f X, EVTDLY_f X, REGISTER_f X
13.22 DEMUX_f Scicos demultiplexer block
DIALOGUE PARAMETERS :
- number of output ports
:
positive integer less than or equal to 8.
DESCRIPTION :
Given a vector valued input this block splits inputs over vector
valued outputs. So u=[y1;y2....;yn], where yi are numbered
from top to bottom. Input and Output port sizes are determined by the
context.
See Also :
MUX_f X
13.23 DLRADAPT_f Scicos discrete-time linear adaptive system
DIALOGUE PARAMETERS :
- Vector of p mesh points
: a vector which defines u2 mesh points.
Numerator roots
: a matrix, each line gives the roots of the numerator at the
corresponding mesh point.
- Denominator roots
: a matrix, each line gives the roots of the denominator at the
corresponding mesh point.
- gain
: a vector, each vector entry gives the transfer gain at the
corresponding mesh point.
- past inputs
: a vector of initial value of past degree(Numerator) inputs
- past outputs
: a vector of initial value of past degree(Denominator) outputs
DESCRIPTION :
This block realizes a SISO linear system represented by its rational
transfer function whose numerator and denominator roots are tabulated
functions of the second block input. The rational function must be
proper.
Roots are interpolated linearly between mesh points.
See Also :
DLSS_f X, DLR_f X
13.24 DLR_f Scicos discrete-time linear system (transfer function)
DIALOGUE PARAMETERS :
- Numerator
: a polynomial in z.
- Denominator
: a polynomial in z.
DESCRIPTION :
This block realizes a SISO linear system represented by its rational
transfer function (in the symbolic variable z).
The rational function must be proper.
See Also :
DLSS_f X, DLRADAPT_f X
13.25 DLSS_f Scicos discrete-time linear state-space system
DESCRIPTION :
This block realizes a discrete-time linear state-space system.
The system is defined by the (A,B,C,D) matrices and the initial
state x0. The dimensions must be compatible. At the arrival of
an input event on the unique input event port, the state is
updated.
DIALOGUE PARAMETERS :
- A
: square matrix. The A matrix
- B
: the B matrix
- C
: the C matrix
- x0
: vector. The initial state of the system.
See Also :
DLR_f X, INTEGRAL_f X, CLSS_f X, DLSS_f X
13.26 EVENTSCOPE_f Scicos event visualization block
DESCRIPTION :
This block realizes the visualization of the input event signals.
DIALOGUE PARAMETERS :
- Number of event inputs
: an integer giving the number of event input ports
colors
: a vector of integers. The i-th element is the color number (>=0)
or dash type (<0) used to draw the evolution of the i-th
input port signal. See xset for color (dash type) definitions.
- Output window number
: The number of graphic window used for the display. It is often good
to use high values to avoid conflict with palettes and Super Block
windows. If you have more than one scope, make sure they don't have
the same window numbers (unless superposition of the curves is
desired).
Output window position
: a 2 vector specifying the coordinates of the upper left corner of
the graphic window. Answer [] for default window position.
- Output window size
: a 2 vector specifying the width and height of
the graphic window. Answer [] for default window dimensions.
- Refresh period
: Maximum value on the X-axis (time). The plot is redrawn when time
reaches a multiple of this value.
REMARKS :
Output window number, Output window size, Output window
position are only taken into account at the initialisation time of the
simulation.
See Also :
SCOPXY_f X, SCOPE_f X, ANIMXY_f X
13.27 EVTDLY_f Scicos event delay block
DESCRIPTION :
One event is generated Delay after an event enters the unique input
event port. Block may also generate an initial output event.
DIALOGUE PARAMETERS :
- Delay
: scalar. Time delay between input and output event.
- Auto-exec
: scalar. If Auto-exec>=0 block initially generates an output event at date Auto-exec.
See Also :
CLOCK_f X
13.28 EVTGEN_f Scicos event firing block
DESCRIPTION :
One event is generated on the unique output event port if Event
time is larger than equal to zero, if not, no event is generated.
DIALOGUE PARAMETERS :
- Event time
: scalar. date of the initial event
See Also :
CLOCK_f X, EVTDLY_f X
13.29 EXPBLK_f Scicos a^u block
DIALOGUE PARAMETERS :
DESCRIPTION :
This block realizes y(i)=a^u(i). The input and output port sizes
are determined by the compiler.
13.30 GAINBLK_f Scicos gain block
DIALOGUE PARAMETERS :
DESCRIPTION :
This block is a gain block. The output is the Gain times the
regular input (vector). The dimensions of Gain determines the
input (number of columns) and output (number of rows) port sizes.
13.31 GAIN_f Scicos gain block
DIALOGUE PARAMETERS :
DESCRIPTION :
This block is a gain block. The output is the Gain times the
regular input (vector). The dimensions of Gain determines the
input (number of columns) and output (number of rows) port sizes.
This block is obsolete. Use GAINBLK_f block instead of it
13.32 GENERAL_f Scicos general zero crossing detector
DESCRIPTION :
Depending on the sign (just before the crossing) of the inputs and
the input numbers of the inputs that have crossed zero, an event is
programmed (or not) with a given delay, for each output. The number
of combinations grows so fast that this becomes unusable for blocks
having more than 2 or 3 inputs. For the moment this block is not
documented.
DIALOGUE PARAMETERS :
- Size of regular input
: integer.
- Number of output events
: integer.
- the routing matrix
: matrix. number of rows is the number of output events. The columns
correspond to each possible combination of signs and zero crossings
of the inputs. The entries of the matrix give the delay for generating
the output event (<0 no event is generated).
See Also :
NEGTOPOS_f X, POSTONEG_f X, ZCROSS_f X
13.33 GENERIC_f Scicos generic interfacing function
DESCRIPTION :
This block can realize any type of block. The computational function
must already be defined in Scilab, Fortran or C code.
DIALOGUE PARAMETERS :
- simulation function
: a character string, the name of the computational function
- function type
: a non negative integer, the type of the computational function
- input port sizes
: a vector of integers, size of regular input ports.
- output port sizes
: a vector of integers, size of regular output ports.
- input event port sizes
: a vector of ones, size of event input ports. The size of the vector
gives the number of event input ports.
- output event port sizes
: a vector of ones, size of event output ports. The size of the vector
gives the number of of event output ports.
- Initial continuous state
: a column vector.
- Initial discrete state
: a column vector.
- System type
: a string: c,d, z or l (CBB, DBB, zero crossing or synchro).
- Real parameter vector
: column vector. Any parameters used in the block can be defined here
as a column vector.
- Integer parameter vector
: column vector. Any integer parameters used in the block can be defined here
as a column vector.
- initial firing
: vector. Size of this vector corresponds to the number of event
outputs. The value of the i-th entry specifies the time of the
preprogrammed event firing on the i-th output event port. If less than
zero, no event is preprogrammed.
- direct feedthrough
: character "y" or "n", specifies if block has a direct input to
output feedthrough.
- Time dependance
: character "y" or "n", specifies if block output depends explicitly
on time.
See Also :
scifunc_block X
13.34 GENSIN_f Scicos sinusoid generator
DESCRIPTION :
This block is a sine wave generator: M*sin(F*t+P)
DIALOGUE PARAMETERS :
- Magnitude
: a scalar. The magnitude M.
- Frequency
: a scalar. The frequency F.
- Phase
: a scalar. The phase P.
See Also :
GENSQR_f X, RAND_f X, SAWTOOTH_f X
13.35 GENSQR_f Scicos square wave generator
DESCRIPTION :
This block is a square wave generator: output takes values
-M and M. Every time an event is received on the input event port,
the output switches from -M to M, or M to -M.
DIALOGUE PARAMETERS :
See Also :
GENSIN_f X, SAWTOOTH_f X, RAND_f X
13.36 HALT_f Scicos Stop block
DIALOGUE PARAMETERS :
- State on halt
: scalar. A value to be placed in the state of the block. For
debugging purposes this allows to distinguish between different
halts.
DESCRIPTION :
This block has a unique input event port. Upon the arrival of an
event,
the simulation is stopped and the main Scicos window is activated.
Simulation can be restarted or continued (Run button).
13.37 IFTHEL_f Scicos if then else block
DIALOGUE PARAMETERS :
None.
DESCRIPTION :
One event is generated on one of the output event ports when an
input event arrives. Depending on the sign of the regular input,
the event is generated on the first or second output.
This is a synchro block, i.e., input and output event are synchronized.
13.38 INTEGRAL_f Scicos simple integrator
DESCRIPTION :
This block is an integrator. The output is the integral of the input.
DIALOGUE PARAMETERS :
- Initial state
: a scalar. The initial condition of the integrator.
See Also :
CLSS_f X, CLR_f X
13.39 INTRP2BLK_f Scicos 2D linear interpolation block
DIALOGUE PARAMETERS :
- X coord.
: an n-vector (strictly increasing)
- Y coord.
: an m-vector (strictly increasing)
- Z values
: an mxn matrix
DESCRIPTION :
The output of this block is a function of the inputs obtained
by bilinear interpolation. This block has two scalar inputs
and a single scalar output. The X(i) and Y(i) give respectively
the X coordinate and the Y coordinate of the i-th data
point to be interpolated and Z(Y(i),X(i)) its value.
13.40 INTRPLBLK_f Scicos linear interpolation block
DIALOGUE PARAMETERS :
- X coord.
: a vector (strictly increasing)
- Y coord.
: a vector (same size as X coord)
DESCRIPTION :
The output of this block is a function of the input obtained
by linear interpolation. This block has a single scalar input
and a single scalar output port. The X coord. and Y coord. give
respectively the X coordinate and the Y coordinate of the data
points to be interpolated. X coord must be strictly increasing.
13.41 INVBLK_f Scicos inversion block
DIALOGUE PARAMETERS :
None.
DESCRIPTION :
This block computes y(i)=1/u(i). The input (output) size is
determined by the context
13.42 IN_f Scicos Super Block regular input port
DESCRIPTION :
This block must only be used inside Scicos Super Blocks to represent
a regular input port. The input size is determined by the context.
In a Super Block, regular input ports must be numbered from 1 to the
number of regular input ports.
DIALOGUE PARAMETERS :
- Port number
: an integer giving the port number.
See Also :
CLKIN_f X, OUT_f X, CLKOUT_f X
13.43 LOGBLK_f Scicos logarithm block
DIALOGUE PARAMETERS :
- a : real scalar greater than 1
DESCRIPTION :
This block realizes y(i)=log(u(i))/log(a). The input and output port sizes
are determined by the context.
13.44 LOOKUP_f Scicos Lookup table with graphical editor
DESCRIPTION :
This block realizes a non-linear function defined using a graphical
editor.
13.45 MAX_f Scicos max block
DIALOGUE PARAMETERS :
None.
DESCRIPTION :
The block outputs the maximum of the input vector:
y=max(u1,...un).
The input vector size is determined by the compiler according to the
connected blocks port sizes.
See Also :
MIN_f X
13.46 MCLOCK_f Scicos 2 frequency event clock
DESCRIPTION :
This block is a Super Block constructed by feeding back the outputs
of an MFCLCK block into its input event port. The two
outputs of this block generate regular train of events, the frequency
of the first input being equal to that of the second output divided
by an integer n. The two outputs are synchronized (this is impossible
for standard blocks; this is a Super Block).
DIALOGUE PARAMETERS :
- Basic period
: scalar. equals 1/f, f being the highest frequency.
- n
: an intger >1. the frequency of the first output event is f/n.
See Also :
MFCLCK_f X, CLOCK_f X
13.47 MFCLCK_f Scicos basic block for frequency division of event clock
DESCRIPTION :
This block is used in the Super Block MCLOCK. The input event is
directed once every n times to output 1 and the rest of the time
to output 2. There is a delay of "Basic period" in the transmission
of the event. If this period >0 then the second output is initially
fired. It is not if this period=0. In the latter case, the input
is driven by an event clock and in the former case, feedback can
be used.
DIALOGUE PARAMETERS :
- Basic period
: positive scalar.
- n
: an integer greater than 1.
See Also :
MCLOCK_f X, CLOCK_f X
13.48 MIN_f Scicos min block
DIALOGUE PARAMETERS :
None.
DESCRIPTION :
The block outputs the minimum of the input vector:
y=min(u1,...un).
The input vector size is determined by the compiler according to the
connected blocks port sizes.
See Also :
MAX_f X
13.49 MUX_f Scicos multiplexer block
DIALOGUE PARAMETERS :
- number of output ports
:
integer greater than or equal to 1 and less than 8
DESCRIPTION :
Given n vector valued inputs this block merges inputs in an single
output vector. So y=[u1;u2....;un], where ui are numbered
from top to bottom. Input and Output port sizes are determined by the
context.
See Also :
MUX_f X
13.50 NEGTOPOS_f Scicos negative to positive detector
DESCRIPTION :
An output event is generated when the unique input crosses zero
with a positive slope.
See Also :
POSTONEG_f X, ZCROSS_f X, GENERAL_f X
13.51 OUT_f Scicos Super Block regular output port
DIALOGUE PARAMETERS :
- Port number
: an integer giving the port number.
DESCRIPTION :
This block must only be used inside Scicos Super Blocks to represent
a regular output port.
In a Super Block, regular output ports must be numbered from 1 to the
number of regular output ports.
size of the output is determined by the compiler according to the
connected blocks port sizes.
See Also :
CLKIN_f X, IN_f X, CLKOUT_f X
13.52 POSTONEG_f Scicos positive to negative detector
DESCRIPTION :
An output event is generated when the unique input crosses zero
with a negative slope.
See Also :
NEGTOPOS_f X, ZCROSS_f X, GENERAL_f X
13.53 POWBLK_f Scicos u^a block
DIALOGUE PARAMETERS :
DESCRIPTION :
This block realizes y(i)=u(i)^a. The input and output port sizes
are determined by the compiler according to the
connected blocks port sizes.
13.54 PROD_f Scicos element wise product block
DESCRIPTION :
The output is the element wize product of the inputs.
13.55 QUANT_f Scicos Quantization block
DIALOGUE PARAMETERS :
- Step
: scalar, Quantization step
- Quantization method
: scalar with possible values 1,2,3 or 4
1
- 1
: Round method
- 2
: Truncation method
- 3
:
Floor method
- 4
:
Ceil method
0
DESCRIPTION :
This block outputs the quantization of the input according to a choice
of methods
for Round method
y(i)=Step*(int(u(i)/Step+0.5)-0.5) if u(i)<0.
y(i)=Step*(int(u(i)/Step-0.5)+0.5). if u(i)>=0.
For truncation method
y(i)=Step*(int(u(i)/Step+0.5)) if u(i)<0.
y(i)=Step*(int(u(i)/Step-0.5)) if u(i)>=0.
For floor method
y(i)=Step*(int(u(i)/Step+0.5)) .
For ceil method
y(i)=Step*(int(u(i)/Step-0.5)) .
13.56 RAND_f Scicos random wave generator
DESCRIPTION :
This block is a random wave generator: each output component takes piecewise
constant random values. Every time an event is received on the
input event port, the outputs take new independent random values.
output port size is given by the size of A and B vectors
DIALOGUE PARAMETERS :
- flag
: 0 or 1. 0 for uniform distribution on [A,A+B] and 1 for normal
distribution N(A,B*B).
- A
: scalar
- B
: scalar
See Also :
GENSIN_f X, SAWTOOTH_f X, GENSQR_f X
13.57 REGISTER_f Scicos shift register block
DESCRIPTION :
This block realizes a shift register. At every input event, the
register is shifted one step.
DIALOGUE PARAMETERS :
- Initial condition
: a column vector. It contains the initial state of the register.
See Also :
DELAY_f X, DELAYV_f X, EVTDLY_f X
13.58 RELAY_f Scicos relay block
DIALOGUE PARAMETERS :
- number of inputs
: a scalar. Number of regular and event inputs.
- initial connected input
: an integer. It must be between 1 and the number of inputs.
DESCRIPTION :
This block routes one of the regular inputs to the unique regular
output. the choice of which input is to be routed is done, initially
by the "initial connected input" parameter. Then, every time an input
event arrives on the i-th input event port, the i-th regular input
port is routed to the regular output.
13.59 RFILE_f Scicos "read from file" block
DIALOGUE PARAMETERS :
- Time record Selection
: an empty matrix or a positive integer. If an integer i is given
the ith element of the read record is assumed to be the date of
the output event. If empty no output event exists.
- Output record selection
: a vector of positive integer. [k1,..,kn],The kith
element of the read record gives the value of ith output.
- Input file name
: a character string defining the path of the file
- Input Format
: a character string defining the Fortran format to use or nothing for
an unformatted (binary) write
- Buffer size
: To improve efficiency it is possible to buffer the input data. read
on the file is only done after each Buffer size call to the
block.
- size of output
: a scalar. This fixes the number of "value" read.
DESCRIPTION :
This block allows user to read datas in a file, in formatted or binary
mode. Output record selection and Time record Selection allows the user to select data among file records.
Each call to the block advance one record in the file.
See Also :
WFILE_f X
13.60 SAMPLEHOLD_f Scicos Sample and hold block
DIALOGUE PARAMETERS :
None.
DESCRIPTION :
Each time an input event is received block copy its input on the
output and hold it until input event.
For periodic Sample and hold, event input must be generated by a Clock.
See Also :
DELAY_f X, CLOCK_f X
13.61 SAT_f Scicos Saturation block
DESCRIPTION :
This block realizes the non-linear function: saturation.
DIALOGUE PARAMETERS :
- Min
: a scalar. Lower saturation bound
- Max
: a scalar. Upper saturation bound
- Slope
: a scalar. The slope of the line going through the origin
and describing the behaviour of the function around zero.
See Also :
LOOKUP_f X
13.62 SAWTOOTH_f Scicos sawtooth wave generator
DESCRIPTION :
This block is a sawtooth wave generator: output is (t-t_i)
from ti to t_(i+1) where t_i and t_(i+1) denote the times of
two successive input events.
DIALOGUE PARAMETERS :
None.
See Also :
GENSIN_f X, GENSQR_f X, RAND_f X
13.63 SCOPE_f Scicos visualization block
DESCRIPTION :
This block realizes the visualization of the evolution of the signals
on the standard input port(s) at instants of events on the event
input port.
DIALOGUE PARAMETERS :
- Curve colors
: a vector of integers. The i-th element is the color number (>0)
or dash type (<0) used to draw the evolution of the i-th
input port signal. See plot2d for color (dash type) definitions.
- Output window number
: The number of graphic window used for the display. It is often good
to use high values to avoid conflict with palettes and Super Block
windows. If you have more than one scope, make sure they don't have
the same window numbers (unless superposition of the curves is
desired).
- Output window position
: a 2 vector specifying the coordinates of the upper left corner of
the graphic window. Answer [] for default window position.
- Output window size
: a 2 vector specifying the width and height of
the graphic window. Answer [] for default window dimensions.
- Ymin, Ymax
: Minimum and maximum values of the input; used to set up the Y-axis
of the plot in the graphics window.
- Refresh period
: Maximum value on the X-axis (time). The plot is redrawn when time
reaches a multiple of this value.
- Buffer size
: To improve efficiency it is possible to buffer the input data. The
drawing is only done after each Buffer size call to the block.
- Accept herited events
: if 0 SCOPE_f draws a new point only when an event occurs on its
event input port. if 1 SCOPE_f draws a new point when an event occurs
on its event input port and when it's regular input changes due to
an event on an other upstrem block (herited events).
REMARKS :
Output window number, Output window size, Output window
position are only taken into account at the initialisation time of the
simulation.
See Also :
SCOPXY_f X, EVENTSCOPE_f X, ANIMXY_f X
13.64 SCOPXY_f Scicos visualization block
DESCRIPTION :
This block realizes the visualization of the evolution of the two
regular input signals by drawing the second input as a function of
the first at instants of events on the event input port.
DIALOGUE PARAMETERS :
- Curve colors
: an integer. It is the color number (>0)
or dash type (<0) used to draw the evolution of the input port
signal. See plot2d for color (dash type) definitions.
- Line or mark size
: an integer.
- Output window number
: The number of graphic window used for the display. It is often good
to use high values to avoid conflict with palettes and Super Block
windows. If you have more than one scope, make sure they don't have
the same window numbers (unless superposition of the curves is
desired).
- Output window position
: a 2 vector specifying the coordinates of the upper left corner of
the graphic window. Answer [] for default window position.
- Output window size
: a 2 vector specifying the width and height of
the graphic window. Answer [] for default window dimensions.
- Xmin, Xmax
: Minimum and maximum values of the first input; used to set up the X-axis
of the plot in the graphics window.
- Ymin, Ymax
: Minimum and maximum values of the second input; used to set up the
Y-axis of the plot in the graphics window.
- Buffer size
: To improve efficiency it is possible to buffer the input data. The
drawing is only done after each Buffer size call to the block.
REMARKS :
Output window number, Output window size, Output window
position are only taken into account at the initialisation time of the
simulation.
See Also :
SCOPE_f X, EVENTSCOPE_f X, ANIMXY_f X
13.65 SELECT_f Scicos selector block
DIALOGUE PARAMETERS :
- number of inputs
: a scalar. Number of regular and event inputs.
- initial connected input
: an integer. It must be between 1 and the number of inputs.
DESCRIPTION :
This block routes one of the regular inputs to the unique regular
output. the choice of which input is to be routed is done, initially
by the "initial connected input" parameter. Then, every time the block
is activated through its i-th input activation port, the i-th regular
input value port is put to the regular output.
13.66 SINBLK_f Scicos sine block
DIALOGUE PARAMETERS :
None.
DESCRIPTION :
This block realizes vector sine operation. y(i)=sin(u(i)).
The input and output port sizes are equal and determined by the
context.
13.67 SOM_f Scicos addition block
DIALOGUE PARAMETERS :
- Input signs
: a (1x3) vector of +1 and -1. If -1, the corresponding input is
multiplied by -1 before addition.
DESCRIPTION :
This block is a sum. The output is the element-wise sum of the inputs.
Input ports are located at up, left or right and down position.
You must specify 3 gain numbers but if only two links are
connected only the first values are used, ports are numbered anti-clock wise.
See Also :
GAIN_f X
13.68 SPLIT_f Scicos regular split block
DIALOGUE PARAMETERS :
None.
DESCRIPTION :
This block is a regular split block with an input and two outputs. The
outputs reproduces the input port on each output ports.
Strictly speaking, SPLIT is not a Scicos block because it is
discarded at the compilation phase. This block is automatically
created when creating a new link issued from a link.
Port sizes are determined by the context.
13.69 STOP_f Scicos Stop block
DIALOGUE PARAMETERS :
- State on halt
: scalar. A value to be placed in the state of the block. For
debugging purposes this allows to distinguish between different
halts.
DESCRIPTION :
This block has a unique input event port. Upon the arrival of an
event,
the simulation is stopped and the main Scicos window is activated.
Simulation can be restarted or continued (Run button).
13.70 SUPER_f Scicos Super block
DESCRIPTION :
This block opens up a new Scicos window for editing a new block
diagram. This diagram describes the internal functions of the
super block.
Super block inputs and outputs (regular or event) are designated by
special (input or output) blocks.
Regular input blocks must be numbered from 1 to the number of regular
input ports. Regular input ports of the super block are numbered from
the top of the block shape to the bottom.
Regular output portss must be numbered from 1 to the number of regular
output ports. Regular output ports of the super block are numbered
from the top of the block shape to the bottom.
Event input blocks must be numbered from 1 to the number of event
input ports. Event input ports of the super block are numbered from
the left of the block shape to the right.
Event output ports must be numbered from 1 to the number of event
output ports. Event output ports of the super block are numbered from
the left of the block shape to the right.
See Also :
CLKIN_f X, OUT_f X, CLKOUT_f X, IN_f X
13.71 TANBLK_f Scicos tan block
DIALOGUE PARAMETERS :
None.
DESCRIPTION :
This block realizes vector tangent operation.
input (output) port size is determined by the compiler.
See Also :
SINBLK_f X
13.72 TCLSS_f Scicos jump continuous-time linear state-space system
DESCRIPTION :
This block realizes a continuous-time linear state-space system
with the possibility of jumps in the state. The number of inputs
to this block is two. The first input is the regular input of the
linear system, the second carries the new value of the state which
is copied into the state when an event arrives at the unique event
input port of this block. That means the state of the system jumps
to the value present on the second input (of size equal to that of
the state).
The system is defined by the (A,B,C,D) matrices and the initial
state x0. The dimensions must be compatible. The sizes of inputs
and outputs are adjusted automatically.
DIALOGUE PARAMETERS :
- A
: square matrix. The A matrix
- B
: the B matrix
- C
: the C matrix
- D
: the D matrix
- x0
: vector. The initial state of the system.
See Also :
CLSS_f X, CLR_f X
13.73 TEXT_f Scicos text drawing block
DIALOGUE PARAMETERS :
- txt
: a character string, Text to be displayed
- font
: a positive integer less than 6, number of selected font (see xset)
- siz
: a positive integer, selected font size (see xset)
DESCRIPTION :
This special block is only use to add text at any point of the diagram
window. It has no effect on the simulation.
13.74 TIME_f Scicos time generator
DIALOGUE PARAMETERS :
None.
DESCRIPTION :
This block is a time generator. The unique regular output is the
current time.
13.75 TRASH_f Scicos Trash block
DIALOGUE PARAMETERS :
None
DESCRIPTION :
This block does nothing. It simply allows to safely connect the outputs
of other blocks which should be ignored. Useful for sinking outputs of
no interest. The input size is determined by the compiler.
13.76 WFILE_f Scicos "write to file" block
DIALOGUE PARAMETERS :
- input size
: a scalar. This fixes the input size
- Output file name
: a character string defining the path of the file
- Output Format
: a character string defining the Fortran format to use or nothing for
an unformatted (binary) write
- Buffer size
: To improve efficiency it is possible to buffer the input data. write
on the file is only done after each Buffer size calls to the block.
DESCRIPTION :
This block allows user to save data in a file, in formatted and binary
mode.
Each call to the block corresponds to a record in the file. Each
record has the following form:
[t,V1,...,Vn] where t is the value of time when block is
called and Vi is the ith input value
See Also :
RFILE_f X
13.77 ZCROSS_f Scicos zero crossing detector
DESCRIPTION :
An output event is generated when all inputs (if more than one)
cross zero simultaneously.
DIALOGUE PARAMETERS :
- Number of inputs
: a positive integer.
See Also :
POSTONEG_f X, GENERAL_f X
13.78 scifunc_block Scicos block defined interactively
DESCRIPTION :
This block can realize any type of Scicos block. The function of the
block is defined interactively using dialogue boxes and in Scilab
language. During simulation, these instructions are interpreted by
Scilab; the simulation of diagrams that include these types of blocks
is slower. For more information see Scicos reference manual.
DIALOGUE PARAMETERS :
- number of inputs
: a scalar. Number of regular input ports
- number of outputs
: a scalar. Number of regular output ports
- number of input events
: a scalar. Number of input event ports
- number of output events
: a scalar. Number of output event ports
- Initial continuous state
: a column vector.
- Initial discrete state
: a column vector.
- System type
: a string: c or d (CBB or DBB, other types are not supported).
- System parameter
: column vector. Any parameters used in the block can be defined here
a column vector.
- initial firing
: vector. Size of this vector corresponds to the number of event
outputs. The value of the i-th entry specifies the time of the
preprogrammed event firing on the i-th output event port. If less than
zero, no event is preprogrammed.
- Instructions
: other dialogues are opened consecutively where used may input Scilab
code associated with the computations needed (block initialization,
outputs, continuous and
discrete state, output events date, block ending),
See Also :
GENERIC_f X