update f2c solution with webtools
[scilab.git] / scilab / modules / xcos / help / en_US / palettes / Sinks_pal / CMSCOPE.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!--
3  * Scicos
4  *
5  * Copyright (C) INRIA - METALAU Project <scicos@inria.fr> (HTML version)
6  * Copyright (C) DIGITEO - Scilab Consortium (XML Docbook version)
7  * Copyright (C) 2016-2017 - FOSSEE IIT Bombay - Dipti Ghosalkar
8  *
9  * This program is free software; you can redistribute it and/or modify
10  * it under the terms of the GNU General Public License as published by
11  * the Free Software Foundation; either version 2 of the License, or
12  *  (at your option) any later version.
13  *
14  * This program is distributed in the hope that it will be useful,
15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17  * GNU General Public License for more details.
18  *
19  * You should have received a copy of the GNU General Public License
20  * along with this program; if not, write to the Free Software
21  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
22  *
23  * See the file ./license.txt
24  -->
25 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="CMSCOPE">
26     <refnamediv>
27         <refname>CMSCOPE</refname>
28         <refpurpose>Multi display scope</refpurpose>
29     </refnamediv>
30     <refsection>
31         <title>Block Screenshot</title>
32         <para>
33             <inlinemediaobject>
34                 <imageobject>
35                     <imagedata fileref="../../../../images/palettes/CMSCOPE.png" align="center" valign="middle"/>
36                 </imageobject>
37             </inlinemediaobject>
38         </para>
39     </refsection>
40     <refsection id="Contents_CMSCOPE">
41         <title>Contents</title>
42         <itemizedlist>
43             <listitem>
44                 <para>
45                     <link linkend="CMSCOPE">Multi display scope</link>
46                 </para>
47             </listitem>
48             <listitem>
49                 <itemizedlist>
50                     <listitem>
51                         <para>
52                             <xref linkend="Palette_CMSCOPE">Palette</xref>
53                         </para>
54                     </listitem>
55                     <listitem>
56                         <para>
57                             <xref linkend="Description_CMSCOPE">Description</xref>
58                         </para>
59                     </listitem>
60                     <listitem>
61                         <para>
62                             <xref linkend="Dialogbox_CMSCOPE">Dialog box</xref>
63                         </para>
64                     </listitem>
65                     <listitem>
66                         <para>
67                             <xref linkend="Defaultproperties_CMSCOPE">Default properties</xref>
68                         </para>
69                     </listitem>
70                     <listitem>
71                         <para>
72                             <xref linkend="Interfacingfunction_CMSCOPE">Interfacing function</xref>
73                         </para>
74                     </listitem>
75                     <listitem>
76                         <para>
77                             <xref linkend="Computationalfunction_CMSCOPE">Computational function</xref>
78                         </para>
79                     </listitem>
80                 </itemizedlist>
81             </listitem>
82         </itemizedlist>
83     </refsection>
84     <refsection id="Palette_CMSCOPE">
85         <title>Palette</title>
86         <itemizedlist>
87             <listitem>
88                 <para>
89                     <link linkend="Sinks_pal">Sinks palette</link>
90                 </para>
91             </listitem>
92         </itemizedlist>
93     </refsection>
94     <refsection id="Description_CMSCOPE">
95         <title>Description</title>
96         <para>
97             When you start a simulation, Xcos open Scope windows.  The Scope
98             block displays its input with respect to simulation time. The Scope
99             block can have multiple axes (one per port); all axes have a common
100             time range with independent y-axes. The Scope allows you to adjust the
101             amount of time and the range of input values displayed.
102
103         </para>
104     </refsection>
105     <refsection id="Dialogbox_CMSCOPE">
106         <title>Dialog box</title>
107         <para>
108             <inlinemediaobject>
109                 <imageobject>
110                     <imagedata fileref="../../../../images/gui/CMSCOPE_gui.gif" align="center" valign="middle"/>
111                 </imageobject>
112             </inlinemediaobject>
113         </para>
114         <para>
115
116         </para>
117         <itemizedlist>
118             <listitem>
119                 <para>
120                     <emphasis role="bold">Input ports sizes</emphasis>
121                 </para>
122                 <para> It allows multiple input ports.</para>
123                 <para> Properties : Type 'vec' of size -1 </para>
124             </listitem>
125             <listitem>
126                 <para>
127                     <emphasis role="bold">Drawing colors </emphasis>
128                 </para>
129                 <para>
130                     a vector of integers. The i-th element is the color number (≥ 0) or marker type (&lt; 0) used to draw the evolution of the i-th input port signal. See<emphasis role="bold">plot2d</emphasis> for color (dash type) definitions.
131                 </para>
132                 <para> Properties : Type 'vec' of size -1 </para>
133             </listitem>
134             <listitem>
135                 <para>
136                     <emphasis role="bold">Output window number</emphasis>
137                 </para>
138                 <para>
139                     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 default value is used<emphasis role="bold">(1)</emphasis> , Xcos define the output window number.
140                 </para>
141                 <para> Properties : Type 'vec' of size 1 </para>
142             </listitem>
143             <listitem>
144                 <para>
145                     <emphasis role="bold">Output window position</emphasis>
146                 </para>
147                 <para> a 2 vector specifying the coordinates of the upper left corner of the graphic window. Answer [] for default window position.</para>
148                 <para> Properties : Type 'vec' of size -1 </para>
149             </listitem>
150             <listitem>
151                 <para>
152                     <emphasis role="bold">Output window sizes</emphasis>
153                 </para>
154                 <para> a 2 vector specifying the coordinates of the upper left corner of the graphic window. Answer [] for default window position.</para>
155                 <para> Properties : Type 'vec' of size size -1 </para>
156             </listitem>
157             <listitem>
158                 <para>
159                     <emphasis role="bold">Ymin vector</emphasis>
160                 </para>
161                 <para> Minimum values of the input; used to set up the Y-axis of the plot in the graphics window.</para>
162                 <para> Properties : Type 'vec' of size size(%1,'*') </para>
163             </listitem>
164             <listitem>
165                 <para>
166                     <emphasis role="bold">Ymax vector</emphasis>
167                 </para>
168                 <para> Maximum values of the input; used to set up the Y-axis of the plot in the graphics window.</para>
169                 <para> Properties : Type 'vec' of size size(%1,'*') </para>
170             </listitem>
171             <listitem>
172                 <para>
173                     <emphasis role="bold">Refresh period</emphasis>
174                 </para>
175                 <para> Maximum value on the X-axis (time). The plot is redrawn when time reaches a multiple of this value.</para>
176                 <para> Properties : Type 'vec' of size size(%1,'*') </para>
177             </listitem>
178             <listitem>
179                 <para>
180                     <emphasis role="bold">Buffer size</emphasis>
181                 </para>
182                 <para>
183                     To improve efficiency it is possible to buffer the input data. The drawing is only done after each<emphasis role="bold">Buffer size</emphasis> call to the block.
184                 </para>
185                 <para> Properties : Type 'vec' of size 1 </para>
186             </listitem>
187             <listitem>
188                 <para>
189                     <emphasis role="bold">Accept herited events 0/1</emphasis>
190                 </para>
191                 <para>
192                     if 0<emphasis role="bold">CSCOPE_f</emphasis> draws a new point only when an event occurs on its event input port. if 1<emphasis role="bold">CSCOPE_f</emphasis> 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 another upstream block (herited events).
193                 </para>
194                 <para> Properties : Type 'vec' of size 1 </para>
195             </listitem>
196             <listitem>
197                 <para>
198                     <emphasis role="bold">Name of Scope </emphasis>
199                 </para>
200                 <para> Name/label of the block.</para>
201                 <para> Properties : Type 'str' of size 1</para>
202             </listitem>
203         </itemizedlist>
204     </refsection>
205     <refsection id="Defaultproperties_CMSCOPE">
206         <title>Default properties</title>
207         <itemizedlist>
208             <listitem>
209                 <para>
210                     <emphasis role="bold">always active:</emphasis> no
211                 </para>
212             </listitem>
213             <listitem>
214                 <para>
215                     <emphasis role="bold">direct-feedthrough:</emphasis> yes
216                 </para>
217             </listitem>
218             <listitem>
219                 <para>
220                     <emphasis role="bold">zero-crossing:</emphasis> no
221                 </para>
222             </listitem>
223             <listitem>
224                 <para>
225                     <emphasis role="bold">mode:</emphasis> no
226                 </para>
227             </listitem>
228             <listitem>
229                 <para>
230                     <emphasis role="bold">regular inputs:</emphasis>
231                 </para>
232                 <para>
233                     <emphasis role="bold">- port 1 : size [1,1] / type 1</emphasis>
234                 </para>
235                 <para>
236                     <emphasis role="bold">- port 2 : size [1,1] / type 1</emphasis>
237                 </para>
238             </listitem>
239             <listitem>
240                 <para>
241                     <emphasis role="bold">number/sizes of activation inputs:</emphasis> 1
242                 </para>
243             </listitem>
244             <listitem>
245                 <para>
246                     <emphasis role="bold">number/sizes of activation outputs:</emphasis> 0
247                 </para>
248             </listitem>
249             <listitem>
250                 <para>
251                     <emphasis role="bold">continuous-time state:</emphasis> no
252                 </para>
253             </listitem>
254             <listitem>
255                 <para>
256                     <emphasis role="bold">discrete-time state:</emphasis> no
257                 </para>
258             </listitem>
259             <listitem>
260                 <para>
261                     <emphasis role="bold">object discrete-time state:</emphasis> no
262                 </para>
263             </listitem>
264             <listitem>
265                 <para>
266                     <emphasis role="bold">name of computational function:</emphasis>
267                     <emphasis role="italic">cmscope</emphasis>
268                 </para>
269             </listitem>
270         </itemizedlist>
271     </refsection>
272     <refsection id="Interfacingfunction_CMSCOPE">
273         <title>Interfacing function</title>
274         <itemizedlist>
275             <listitem>
276                 <para> SCI/modules/scicos_blocks/macros/Sinks/CMSCOPE.sci</para>
277             </listitem>
278         </itemizedlist>
279     </refsection>
280     <refsection id="Computationalfunction_CMSCOPE">
281         <title>Computational function</title>
282         <itemizedlist>
283             <listitem>
284                 <para> SCI/modules/scicos_blocks/src/c/cmscope.c (Type 4)</para>
285             </listitem>
286         </itemizedlist>
287     </refsection>
288     <refsection id="Example_CMSCOPE">
289         <title>Multi display scope example</title>
290         <link type="scilab" linkend="scilab.xcos/xcos/tests/unit_tests/cmscope.zcos">
291             <inlinemediaobject>
292                 <imageobject>
293                     <imagedata align="center" fileref="../../../../tests/unit_tests/cmscope.zcos" valign="middle"/>
294                 </imageobject>
295             </inlinemediaobject>
296         </link>
297     </refsection>
298     <refsection id="Seealso_CMSCOPE">
299         <title>See also</title>
300         <itemizedlist>
301             <listitem>
302                 <para>
303                     <link linkend="SCALE_CMSCOPE">SCALE_CMSCOPE - Multi display scope with autoscale feature of graph</link>
304                 </para>
305             </listitem>
306         </itemizedlist>
307     </refsection>
308 </refentry>