* Bug #8784 fixed - Autoscale for cscope graph
[scilab.git] / scilab / modules / xcos / help / en_US / palettes / Sinks_pal / SCALE_CSCOPE.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="SCALE_CSCOPE">
26     <refnamediv>
27         <refname>SCALE_CSCOPE</refname>
28         <refpurpose>Single Display Scope with autoscale feature of graph</refpurpose>
29     </refnamediv>
30     <refsection>
31         <title>Block Screenshot</title>
32         <para>
33             <inlinemediaobject>
34                 <imageobject>
35                     <imagedata fileref="../../../../images/palettes/SCALE_CSCOPE.png" align="center" valign="middle"/>
36                 </imageobject>
37             </inlinemediaobject>
38         </para>
39     </refsection>
40     <refsection id="Contents_SCALE_CSCOPE">
41         <title>Contents</title>
42         <itemizedlist>
43             <listitem>
44                 <para>
45                     <link linkend="SCALE_CSCOPE">Single Display Scope with autoscale feature of graph</link>
46                 </para>
47             </listitem>
48             <listitem>
49                 <itemizedlist>
50                     <listitem>
51                         <para>
52                             <xref linkend="Palette_SCALE_CSCOPE">Palette</xref>
53                         </para>
54                     </listitem>
55                     <listitem>
56                         <para>
57                             <xref linkend="Description_SCALE_CSCOPE">Description</xref>
58                         </para>
59                     </listitem>
60                     <listitem>
61                         <para>
62                             <xref linkend="Dialogbox_SCALE_CSCOPE">Dialog box</xref>
63                         </para>
64                     </listitem>
65                     <listitem>
66                         <para>
67                             <xref linkend="Defaultproperties_SCALE_CSCOPE">Default properties</xref>
68                         </para>
69                     </listitem>
70                     <listitem>
71                         <para>
72                             <xref linkend="Interfacingfunction_SCALE_CSCOPE">Interfacing function</xref>
73                         </para>
74                     </listitem>
75                     <listitem>
76                         <para>
77                             <xref linkend="Computationalfunction_SCALE_CSCOPE">Computational function</xref>
78                         </para>
79                     </listitem>
80                     <listitem>
81                         <para>
82                             <xref linkend="Seealso_SCALE_CSCOPE">See also</xref>
83                         </para>
84                     </listitem>
85                 </itemizedlist>
86             </listitem>
87         </itemizedlist>
88     </refsection>
89     <refsection id="Palette_SCALE_CSCOPE">
90         <title>Palette</title>
91         <itemizedlist>
92             <listitem>
93                 <para>
94                     <link linkend="Sinks_pal">Sinks palette</link>
95                 </para>
96             </listitem>
97         </itemizedlist>
98     </refsection>
99     <refsection id="Description_SCALE_CSCOPE">
100         <title>Description</title>
101         <para>
102             The Scope block displays its input with respect to simulation
103             time. Both axes have a common range.  The Scope allows you to adjust
104             the amount of time and the range of input values displayed. It has feature to scale graph at runtime.
105
106         </para>
107     </refsection>
108     <refsection id="Dialogbox_SCALE_CSCOPE">
109         <title>Dialog box</title>
110         <para>
111             <inlinemediaobject>
112                 <imageobject>
113                     <imagedata fileref="../../../../images/gui/SCALE_CSCOPE_gui.gif" align="center" valign="middle"/>
114                 </imageobject>
115             </inlinemediaobject>
116         </para>
117         <para>
118
119         </para>
120         <itemizedlist>
121             <listitem>
122                 <para>
123                     <emphasis role="bold">Color </emphasis>
124                 </para>
125                 <para>
126                     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.
127                 </para>
128                 <para> Properties : Type 'vec' of size 8 </para>
129             </listitem>
130             <listitem>
131                 <para>
132                     <emphasis role="bold">Output window number </emphasis>
133                 </para>
134                 <para>
135                     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> , Scicos define the output window number.
136                 </para>
137                 <para> Properties : Type 'vec' of size 1 </para>
138             </listitem>
139             <listitem>
140                 <para>
141                     <emphasis role="bold">Output window position</emphasis>
142                 </para>
143                 <para> a 2 vector specifying the coordinates of the upper left corner of the graphic window. Answer [] for default window position.</para>
144                 <para> Properties : Type 'vec' of size 1 </para>
145             </listitem>
146             <listitem>
147                 <para>
148                     <emphasis role="bold">Output window sizes</emphasis>
149                 </para>
150                 <para> a 2 vector specifying the coordinates of the upper left corner of the graphic window. Answer [] for default window position.</para>
151                 <para> Properties : Type 'vec' of size -1 </para>
152             </listitem>
153             <listitem>
154                 <para>
155                     <emphasis role="bold">Ymin</emphasis>
156                 </para>
157                 <para> Minimum values of the input; used to set up the Y-axis of the plot in the graphics window.</para>
158                 <para> Properties : Type 'vec' of size 1 </para>
159             </listitem>
160             <listitem>
161                 <para>
162                     <emphasis role="bold">Ymax</emphasis>
163                 </para>
164                 <para> Maximum values of the input; used to set up the Y-axis of the plot in the graphics window.</para>
165                 <para> Properties : Type 'vec' of size 1 </para>
166             </listitem>
167             <listitem>
168                 <para>
169                     <emphasis role="bold">Refresh period</emphasis>
170                 </para>
171                 <para> Maximum value on the X-axis (time). The plot is redrawn when time reaches a multiple of this value.</para>
172                 <para> Properties : Type 'vec' of size 1 </para>
173             </listitem>
174             <listitem>
175                 <para>
176                     <emphasis role="bold">Buffer size</emphasis>
177                 </para>
178                 <para>
179                     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.
180                 </para>
181                 <para> Properties : Type 'vec' of size 1 </para>
182             </listitem>
183             <listitem>
184                 <para>
185                     <emphasis role="bold">Accept herited events 0/1</emphasis>
186                 </para>
187                 <para>
188                     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 an other upstream block (herited events).
189                 </para>
190                 <para> Properties : Type 'vec' of size 1 </para>
191             </listitem>
192             <listitem>
193                 <para>
194                     <emphasis role="bold">Name of Scope </emphasis>
195                 </para>
196                 <para> Name/label of the block.</para>
197                 <para> Properties : Type 'str' of size 1</para>
198             </listitem>
199             <listitem>
200                 <para>
201                     <emphasis role="bold">Auto scale 0/1</emphasis>
202                 </para>
203                 <para>
204                     if 0 autoscaling of graph wont be activated  If 1 autoscaling of graph at runtime will be activated and visible.
205                 </para>
206                 <para> Properties : Type 'vec' of size 1</para>
207             </listitem>
208         </itemizedlist>
209     </refsection>
210     <refsection id="Defaultproperties_SCALE_CSCOPE">
211         <title>Default properties</title>
212         <itemizedlist>
213             <listitem>
214                 <para>
215                     <emphasis role="bold">always active:</emphasis> no
216                 </para>
217             </listitem>
218             <listitem>
219                 <para>
220                     <emphasis role="bold">direct-feedthrough:</emphasis> yes
221                 </para>
222             </listitem>
223             <listitem>
224                 <para>
225                     <emphasis role="bold">zero-crossing:</emphasis> no
226                 </para>
227             </listitem>
228             <listitem>
229                 <para>
230                     <emphasis role="bold">mode:</emphasis> no
231                 </para>
232             </listitem>
233             <listitem>
234                 <para>
235                     <emphasis role="bold">regular inputs:</emphasis>
236                 </para>
237                 <para>
238                     <emphasis role="bold">- port 1 : size [-1,1] / type 1</emphasis>
239                 </para>
240             </listitem>
241             <listitem>
242                 <para>
243                     <emphasis role="bold">number/sizes of activation inputs:</emphasis> 1
244                 </para>
245             </listitem>
246             <listitem>
247                 <para>
248                     <emphasis role="bold">number/sizes of activation outputs:</emphasis> 0
249                 </para>
250             </listitem>
251             <listitem>
252                 <para>
253                     <emphasis role="bold">continuous-time state:</emphasis> no
254                 </para>
255             </listitem>
256             <listitem>
257                 <para>
258                     <emphasis role="bold">discrete-time state:</emphasis> no
259                 </para>
260             </listitem>
261             <listitem>
262                 <para>
263                     <emphasis role="bold">object discrete-time state:</emphasis> no
264                 </para>
265             </listitem>
266             <listitem>
267                 <para>
268                     <emphasis role="bold">name of computational function:</emphasis>
269                     <emphasis role="italic">scale_cscope</emphasis>
270                 </para>
271             </listitem>
272         </itemizedlist>
273     </refsection>
274     <refsection id="Interfacingfunction_SCALE_CSCOPE">
275         <title>Interfacing function</title>
276         <itemizedlist>
277             <listitem>
278                 <para> SCI/modules/scicos_blocks/macros/Sinks/SCALE_CSCOPE.sci</para>
279             </listitem>
280         </itemizedlist>
281     </refsection>
282     <refsection id="Computationalfunction_SCALE_CSCOPE">
283         <title>Computational function</title>
284         <itemizedlist>
285             <listitem>
286                 <para> SCI/modules/scicos_blocks/src/c/scale_cscope.c (Type 4)</para>
287             </listitem>
288         </itemizedlist>
289     </refsection>
290     <refsection id="Example_SCALE_CSCOPE">
291         <title>Single display scope example with auto scale</title>
292         <para>
293             <link type="scilab" linkend="scilab.xcos/xcos/examples/sinks_pal/en_US/SCALE_CSCOPE_en_US.zcos">
294                 <inlinemediaobject>
295                     <imageobject>
296                         <imagedata fileref="../../../../examples/sinks_pal/en_US/SCALE_CSCOPE_en_US.zcos" align="center" valign="middle"/>
297                     </imageobject>
298                 </inlinemediaobject>
299             </link>
300         </para>
301         <scilab:image><![CDATA[
302             importXcosDiagram(SCI + "/modules/xcos/examples/sinks_pal/en_US/SCALE_CSCOPE_en_US.zcos");
303             xcos_simulate(scs_m, 4);
304         ]]></scilab:image>
305     </refsection>
306     <refsection id="Seealso_SCALE_CSCOPE">
307         <title>See also</title>
308         <itemizedlist>
309             <listitem>
310                 <para>
311                     <link linkend="CSCOPE">CSCOPE - Single Display Scope</link>
312                 </para>
313             </listitem>
314             <listitem>
315                 <para>
316                     <link linkend="CMSCOPE">CMSCOPE - Multi display scope</link>
317                 </para>
318             </listitem>
319         </itemizedlist>
320     </refsection>
321 </refentry>