~ubuntu-branches/ubuntu/raring/scilab/raring-proposed

« back to all changes in this revision

Viewing changes to modules/graphics/help/en_US/Graphics.xml

  • Committer: Package Import Robot
  • Author(s): Sylvestre Ledru
  • Date: 2012-08-30 14:42:38 UTC
  • mfrom: (1.4.7)
  • Revision ID: package-import@ubuntu.com-20120830144238-c1y2og7dbm7m9nig
Tags: 5.4.0-beta-3-1~exp1
* New upstream release
* Update the scirenderer dep
* Get ride of libjhdf5-java dependency

Show diffs side-by-side

added added

removed removed

Lines of Context:
11
11
 *
12
12
 -->
13
13
<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" version="5.0-subset Scilab" xml:lang="en" xml:id="Graphics">
14
 
  <refnamediv>
15
 
    <refname>Graphics: Getting started</refname>
16
 
    <refpurpose> graphics library overview</refpurpose>
17
 
  </refnamediv>
18
 
  <refsection>
19
 
    <title>2d plotting</title>
20
 
    <variablelist>
21
 
      <varlistentry>
22
 
        <term>
23
 
          <link linkend="plot2d">plot2d</link>
24
 
        </term>
25
 
        <listitem>
26
 
          <para>Plot a curve</para>
27
 
          <para>
28
 
            <emphasis role="bold">Example:</emphasis>
29
 
          </para>
30
 
          <para>
31
 
            <scilab:image>plot2d();</scilab:image>
32
 
          </para>
33
 
        </listitem>
34
 
      </varlistentry>
35
 
      <varlistentry>
36
 
        <term>
37
 
          <link linkend="plot2d2">plot2d2</link>
38
 
        </term>
39
 
        <listitem>
40
 
          <para>Plot a curve as step function</para>
41
 
          <para>
42
 
            <emphasis role="bold">Example:</emphasis>
43
 
          </para>
44
 
          <para>
45
 
            <scilab:image>plot2d2();</scilab:image>
46
 
          </para>
47
 
        </listitem>
48
 
      </varlistentry>
49
 
      <varlistentry>
50
 
        <term>
51
 
          <link linkend="plot2d3">plot2d3</link>
52
 
        </term>
53
 
        <listitem>
54
 
          <para>Plot a curve with vertical bars</para>
55
 
          <para>
56
 
            <emphasis role="bold">Example:</emphasis>
57
 
          </para>
58
 
          <para>
59
 
            <scilab:image>plot2d3();</scilab:image>
60
 
          </para>
61
 
        </listitem>
62
 
      </varlistentry>
63
 
      <varlistentry>
64
 
        <term>
65
 
          <link linkend="plot2d4">plot2d4</link>
66
 
        </term>
67
 
        <listitem>
68
 
          <para>Plot a curve with arrows</para>
69
 
          <para>
70
 
            <emphasis role="bold">Example:</emphasis>
71
 
          </para>
72
 
          <para>
73
 
            <scilab:image>plot2d4();</scilab:image>
74
 
          </para>
75
 
        </listitem>
76
 
      </varlistentry>
77
 
      <varlistentry>
78
 
        <term>
79
 
          <link linkend="fplot2d">fplot2d</link>
80
 
        </term>
81
 
        <listitem>
82
 
          <para>Plot a curve defined by a function</para>
83
 
          <para>
84
 
            <emphasis role="bold">Example:</emphasis>
85
 
          </para>
86
 
          <para>
87
 
            <scilab:image>fplot2d();</scilab:image>
88
 
          </para>
89
 
        </listitem>
90
 
      </varlistentry>
91
 
      <varlistentry>
92
 
        <term>
93
 
          <link linkend="champ">champ</link>
94
 
        </term>
95
 
        <listitem>
96
 
          <para>2D vector field</para>
97
 
          <para>
98
 
            <emphasis role="bold">Example:</emphasis>
99
 
          </para>
100
 
          <para>
101
 
            <scilab:image>champ();</scilab:image>
102
 
          </para>
103
 
        </listitem>
104
 
      </varlistentry>
105
 
      <varlistentry>
106
 
        <term>
107
 
          <link linkend="champ1">champ1</link>
108
 
        </term>
109
 
        <listitem>
110
 
          <para>2D vector field with colored arrows</para>
111
 
          <para>
112
 
            <emphasis role="bold">Example:</emphasis>
113
 
          </para>
114
 
          <para>
115
 
            <scilab:image>champ1();</scilab:image>
116
 
          </para>
117
 
        </listitem>
118
 
      </varlistentry>
119
 
      <varlistentry>
120
 
        <term>
121
 
          <link linkend="fchamp">fchamp</link>
122
 
        </term>
123
 
        <listitem>
124
 
          <para>Direction field of a 2D first order ODE</para>
125
 
          <para>
126
 
            <emphasis role="bold">Example:</emphasis>
127
 
          </para>
128
 
          <para>
129
 
            <scilab:image>fchamp();</scilab:image>
130
 
          </para>
131
 
        </listitem>
132
 
      </varlistentry>
133
 
      <varlistentry>
134
 
        <term>
135
 
          <link linkend="contour2d">contour2d</link>
136
 
        </term>
137
 
        <listitem>
138
 
          <para>Level curves of a surface on a 2D plot</para>
139
 
        </listitem>
140
 
      </varlistentry>
141
 
      <varlistentry>
142
 
        <term>
143
 
          <link linkend="fcontour2d">fcontour2d</link>
144
 
        </term>
145
 
        <listitem>
146
 
          <para>Level curves of a surface defined by a function on a 2D plot</para>
147
 
          <para>
148
 
            <emphasis role="bold">Example:</emphasis>
149
 
          </para>
150
 
          <para>
151
 
            <scilab:image>fcontour2d();</scilab:image>
152
 
          </para>
153
 
        </listitem>
154
 
      </varlistentry>
155
 
      <varlistentry>
156
 
        <term>
157
 
          <link linkend="grayplot">grayplot</link>
158
 
        </term>
159
 
        <listitem>
160
 
          <para>2D plot of a surface using colors</para>
161
 
          <para>
162
 
            <emphasis role="bold">Example:</emphasis>
163
 
          </para>
164
 
          <para>
165
 
            <scilab:image>grayplot();</scilab:image>
166
 
          </para>
167
 
        </listitem>
168
 
      </varlistentry>
169
 
      <varlistentry>
170
 
        <term>
171
 
          <link linkend="fgrayplot">fgrayplot</link>
172
 
        </term>
173
 
        <listitem>
174
 
          <para>2D plot of a surface defined by a function using colors</para>
175
 
          <para>
176
 
            <emphasis role="bold">Example:</emphasis>
177
 
          </para>
178
 
          <para>
179
 
            <scilab:image>fgrayplot();</scilab:image>
180
 
          </para>
181
 
        </listitem>
182
 
      </varlistentry>
183
 
      <varlistentry>
184
 
        <term>
185
 
          <link linkend="Sgrayplot">Sgrayplot</link>
186
 
        </term>
187
 
        <listitem>
188
 
          <para>Smooth 2D plot of a surface using colors</para>
189
 
          <para>
190
 
            <emphasis role="bold">Example:</emphasis>
191
 
          </para>
192
 
          <para>
193
 
            <scilab:image>Sgrayplot();</scilab:image>
194
 
          </para>
195
 
        </listitem>
196
 
      </varlistentry>
197
 
      <varlistentry>
198
 
        <term>
199
 
          <link linkend="Sfgrayplot">Sfgrayplot</link>
200
 
        </term>
201
 
        <listitem>
202
 
          <para>Smooth 2D plot of a surface defined by a function using colors</para>
203
 
          <para>
204
 
            <emphasis role="bold">Example:</emphasis>
205
 
          </para>
206
 
          <para>
207
 
            <scilab:image>Sfgrayplot();</scilab:image>
208
 
          </para>
209
 
        </listitem>
210
 
      </varlistentry>
211
 
      <varlistentry>
212
 
        <term>
213
 
          <link linkend="xgrid">xgrid</link>
214
 
        </term>
215
 
        <listitem>
216
 
          <para>Add a grid on a 2D plot</para>
217
 
          <para>
218
 
            <emphasis role="bold">Example:</emphasis>
219
 
          </para>
220
 
          <para>
221
 
            <scilab:image>xgrid();</scilab:image>
222
 
          </para>
223
 
        </listitem>
224
 
      </varlistentry>
225
 
      <varlistentry>
226
 
        <term>
227
 
          <link linkend="errbar">errbar</link>
228
 
        </term>
229
 
        <listitem>
230
 
          <para>Add vertical error bars on a 2D plot</para>
231
 
          <para>
232
 
            <emphasis role="bold">Example:</emphasis>
233
 
          </para>
234
 
          <para>
235
 
            <scilab:image>errbar();</scilab:image>
236
 
          </para>
237
 
        </listitem>
238
 
      </varlistentry>
239
 
      <varlistentry>
240
 
        <term>
241
 
          <link linkend="histplot">histplot</link>
242
 
        </term>
243
 
        <listitem>
244
 
          <para>Plot a histogram</para>
245
 
          <para>
246
 
            <emphasis role="bold">Example:</emphasis>
247
 
          </para>
248
 
          <para>
249
 
            <scilab:image>histplot();</scilab:image>
250
 
          </para>
251
 
        </listitem>
252
 
      </varlistentry>
253
 
      <varlistentry>
254
 
        <term>
255
 
          <link linkend="Matplot">Matplot</link>
256
 
        </term>
257
 
        <listitem>
258
 
          <para>2D plot of a matrix using colors</para>
259
 
          <para>
260
 
            <emphasis role="bold">Example:</emphasis>
261
 
          </para>
262
 
          <para>
263
 
            <scilab:image>Matplot();</scilab:image>
264
 
          </para>
265
 
        </listitem>
266
 
      </varlistentry>
267
 
    </variablelist>
268
 
  </refsection>
269
 
  <refsection>
270
 
    <title>3d plotting</title>
271
 
    <variablelist>
272
 
      <varlistentry>
273
 
        <term>
274
 
          <link linkend="plot3d">plot3d</link>
275
 
        </term>
276
 
        <listitem>
277
 
          <para>Plot a surface</para>
278
 
          <para>
279
 
            <emphasis role="bold">Example:</emphasis>
280
 
          </para>
281
 
          <para>
282
 
            <scilab:image>plot3d();</scilab:image>
283
 
          </para>
284
 
        </listitem>
285
 
      </varlistentry>
286
 
      <varlistentry>
287
 
        <term>
288
 
          <link linkend="plot3d1">plot3d1</link>
289
 
        </term>
290
 
        <listitem>
291
 
          <para>Plot a surface with gray or color level</para>
292
 
          <para>
293
 
            <emphasis role="bold">Example:</emphasis>
294
 
          </para>
295
 
          <para>
296
 
            <scilab:image>plot3d1();</scilab:image>
297
 
          </para>
298
 
        </listitem>
299
 
      </varlistentry>
300
 
      <varlistentry>
301
 
        <term>
302
 
          <link linkend="fplot3d">fplot3d</link>
303
 
        </term>
304
 
        <listitem>
305
 
          <para>Plot a surface defined by a function</para>
306
 
          <para>
307
 
            <emphasis role="bold">Example:</emphasis>
308
 
          </para>
309
 
          <para>
310
 
            <scilab:image>fplot3d();</scilab:image>
311
 
          </para>
312
 
        </listitem>
313
 
      </varlistentry>
314
 
      <varlistentry>
315
 
        <term>
316
 
          <link linkend="fplot3d1">fplot3d1</link>
317
 
        </term>
318
 
        <listitem>
319
 
          <para>Plot a surface defined by a function with gray or color level</para>
320
 
          <para>
321
 
            <emphasis role="bold">Example:</emphasis>
322
 
          </para>
323
 
          <para>
324
 
            <scilab:image>fplot3d1();</scilab:image>
325
 
          </para>
326
 
        </listitem>
327
 
      </varlistentry>
328
 
      <varlistentry>
329
 
        <term>
330
 
          <link linkend="param3d">param3d</link>
331
 
        </term>
332
 
        <listitem>
333
 
          <para>Plot one curve</para>
334
 
          <para>
335
 
            <emphasis role="bold">Example:</emphasis>
336
 
          </para>
337
 
          <para>
338
 
            <scilab:image>param3d();</scilab:image>
339
 
          </para>
340
 
        </listitem>
341
 
      </varlistentry>
342
 
      <varlistentry>
343
 
        <term>
344
 
          <link linkend="param3d1">param3d1</link>
345
 
        </term>
346
 
        <listitem>
347
 
          <para>Plots curves</para>
348
 
          <para>
349
 
            <emphasis role="bold">Example:</emphasis>
350
 
          </para>
351
 
          <para>
352
 
            <scilab:image>param3d1();</scilab:image>
353
 
          </para>
354
 
        </listitem>
355
 
      </varlistentry>
356
 
      <varlistentry>
357
 
        <term>
358
 
          <link linkend="contour">contour</link>
359
 
        </term>
360
 
        <listitem>
361
 
          <para>Level curves on a 3D surface</para>
362
 
          <para>
363
 
            <emphasis role="bold">Example:</emphasis>
364
 
          </para>
365
 
          <para>
366
 
            <scilab:image>contour();</scilab:image>
367
 
          </para>
368
 
        </listitem>
369
 
      </varlistentry>
370
 
      <varlistentry>
371
 
        <term>
372
 
          <link linkend="fcontour">fcontour</link>
373
 
        </term>
374
 
        <listitem>
375
 
          <para>Level curves on a 3D surface defined by a function</para>
376
 
          <para>
377
 
            <emphasis role="bold">Example:</emphasis>
378
 
          </para>
379
 
          <para>
380
 
            <scilab:image>fcontour();</scilab:image>
381
 
          </para>
382
 
        </listitem>
383
 
      </varlistentry>
384
 
      <varlistentry>
385
 
        <term>
386
 
          <link linkend="hist3d">hist3d</link>
387
 
        </term>
388
 
        <listitem>
389
 
          <para>3D representation of a histogram</para>
390
 
          <para>
391
 
            <emphasis role="bold">Example:</emphasis>
392
 
          </para>
393
 
          <para>
394
 
            <scilab:image>hist3d();</scilab:image>
395
 
          </para>
396
 
        </listitem>
397
 
      </varlistentry>
398
 
      <varlistentry>
399
 
        <term>
400
 
          <link linkend="genfac3d">genfac3d</link>
401
 
        </term>
402
 
        <listitem>
403
 
          <para>Compute facets of a 3D surface</para>
404
 
          <para>
405
 
            <emphasis role="bold">Example:</emphasis>
406
 
          </para>
407
 
          <para>
408
 
            <scilab:image>genfac3d();</scilab:image>
409
 
          </para>
410
 
        </listitem>
411
 
      </varlistentry>
412
 
      <varlistentry>
413
 
        <term>
414
 
          <link linkend="eval3dp">eval3dp</link>
415
 
        </term>
416
 
        <listitem>
417
 
          <para>Compute facets of a 3D surface</para>
418
 
          <para>
419
 
            <emphasis role="bold">Example:</emphasis>
420
 
          </para>
421
 
          <para>
422
 
            <scilab:image>p1=linspace(0,2*%pi,10);
423
 
              p2=linspace(0,2*%pi,10);
424
 
              deff("[x,y,z]=scp(p1,p2)",["x=p1.*sin(p1).*cos(p2)";..
425
 
              "y=p1.*cos(p1).*cos(p2)";..
426
 
              "z=p1.*sin(p2)"])
427
 
              [Xf,Yf,Zf]=eval3dp(scp,p1,p2);
428
 
              plot3d(Xf,Yf,Zf)
429
 
            </scilab:image>
430
 
          </para>
431
 
        </listitem>
432
 
      </varlistentry>
433
 
      <varlistentry>
434
 
        <term>
435
 
          <link linkend="geom3d">geom3d</link>
436
 
        </term>
437
 
        <listitem>
438
 
          <para>Projection from 3D on 2D after a 3D plot</para>
439
 
          <para>
440
 
            <emphasis role="bold">Example:</emphasis>
441
 
          </para>
442
 
          <para>
443
 
            <scilab:image>deff("[z]=surface(x,y)","z=sin(x)*cos(y)")
444
 
              t=%pi*(-10:10)/10;
445
 
              // 3D plot of the surface
446
 
              fplot3d(t,t,surface,35,45,"X@Y@Z")
447
 
              // now (t,t,sin(t).*cos(t)) is a curve on the surface
448
 
              // which can be drawn using geom3d and xpoly
449
 
              [x,y]=geom3d(%pi/2,0,surface(%pi/2,0))
450
 
            </scilab:image>
451
 
          </para>
452
 
        </listitem>
453
 
      </varlistentry>
454
 
    </variablelist>
455
 
  </refsection>
456
 
  <refsection>
457
 
    <title>Line and polygon plotting</title>
458
 
    <variablelist>
459
 
      <varlistentry>
460
 
        <term>
461
 
          <link linkend="xpoly">xpoly</link>
462
 
        </term>
463
 
        <listitem>
464
 
          <para>Draw a polyline or a polygon</para>
465
 
        </listitem>
466
 
      </varlistentry>
467
 
      <varlistentry>
468
 
        <term>
469
 
          <link linkend="xpolys">xpolys</link>
470
 
        </term>
471
 
        <listitem>
472
 
          <para>Draw a set of polylines or polygons</para>
473
 
        </listitem>
474
 
      </varlistentry>
475
 
      <varlistentry>
476
 
        <term>
477
 
          <link linkend="xrpoly">xrpoly</link>
478
 
        </term>
479
 
        <listitem>
480
 
          <para>Draw a regular polygon</para>
481
 
        </listitem>
482
 
      </varlistentry>
483
 
      <varlistentry>
484
 
        <term>
485
 
          <link linkend="xsegs">xsegs</link>
486
 
        </term>
487
 
        <listitem>
488
 
          <para>Draw unconnected segments</para>
489
 
        </listitem>
490
 
      </varlistentry>
491
 
      <varlistentry>
492
 
        <term>
493
 
          <link linkend="xfpoly">xfpoly</link>
494
 
        </term>
495
 
        <listitem>
496
 
          <para>Fill a polygon</para>
497
 
        </listitem>
498
 
      </varlistentry>
499
 
      <varlistentry>
500
 
        <term>
501
 
          <link linkend="xfpolys">xfpolys</link>
502
 
        </term>
503
 
        <listitem>
504
 
          <para>Fill a set of polygons</para>
505
 
        </listitem>
506
 
      </varlistentry>
507
 
    </variablelist>
508
 
  </refsection>
509
 
  <refsection>
510
 
    <title>Rectangle plotting</title>
511
 
    <variablelist>
512
 
      <varlistentry>
513
 
        <term>
514
 
          <link linkend="xrect">xrect</link>
515
 
        </term>
516
 
        <listitem>
517
 
          <para>Draw a rectangle</para>
518
 
        </listitem>
519
 
      </varlistentry>
520
 
      <varlistentry>
521
 
        <term>
522
 
          <link linkend="xfrect">xfrect</link>
523
 
        </term>
524
 
        <listitem>
525
 
          <para>Fill a rectangle</para>
526
 
        </listitem>
527
 
      </varlistentry>
528
 
      <varlistentry>
529
 
        <term>
530
 
          <link linkend="xrects">xrects</link>
531
 
        </term>
532
 
        <listitem>
533
 
          <para>Draw or fill a set of rectangles</para>
534
 
        </listitem>
535
 
      </varlistentry>
536
 
    </variablelist>
537
 
  </refsection>
538
 
  <refsection>
539
 
    <title>Arc plotting</title>
540
 
    <variablelist>
541
 
      <varlistentry>
542
 
        <term>
543
 
          <link linkend="xarc">xarc</link>
544
 
        </term>
545
 
        <listitem>
546
 
          <para>Draw a part of an ellipse</para>
547
 
        </listitem>
548
 
      </varlistentry>
549
 
      <varlistentry>
550
 
        <term>
551
 
          <link linkend="xarcs">xarcs</link>
552
 
        </term>
553
 
        <listitem>
554
 
          <para>Draw parts of a set of ellipses</para>
555
 
        </listitem>
556
 
      </varlistentry>
557
 
      <varlistentry>
558
 
        <term>
559
 
          <link linkend="xfarc">xfarc</link>
560
 
        </term>
561
 
        <listitem>
562
 
          <para>Fill a part of an ellipse</para>
563
 
        </listitem>
564
 
      </varlistentry>
565
 
      <varlistentry>
566
 
        <term>
567
 
          <link linkend="xfarcs">xfarcs</link>
568
 
        </term>
569
 
        <listitem>
570
 
          <para>Fill parts of a set of ellipses</para>
571
 
        </listitem>
572
 
      </varlistentry>
573
 
    </variablelist>
574
 
  </refsection>
575
 
  <refsection>
576
 
    <title>Arrow plotting</title>
577
 
    <variablelist>
578
 
      <varlistentry>
579
 
        <term>
580
 
          <link linkend="xarrows">xarrows</link>
581
 
        </term>
582
 
        <listitem>
583
 
          <para>Draw a set of arrows</para>
584
 
        </listitem>
585
 
      </varlistentry>
586
 
    </variablelist>
587
 
  </refsection>
588
 
  <refsection>
589
 
    <title>Strings</title>
590
 
    <variablelist>
591
 
      <varlistentry>
592
 
        <term>
593
 
          <link linkend="xstring">xstring</link>
594
 
        </term>
595
 
        <listitem>
596
 
          <para>Draw strings</para>
597
 
        </listitem>
598
 
      </varlistentry>
599
 
      <varlistentry>
600
 
        <term>
601
 
          <link linkend="xstringl">xstringl</link>
602
 
        </term>
603
 
        <listitem>
604
 
          <para>Compute a box which surrounds strings</para>
605
 
        </listitem>
606
 
      </varlistentry>
607
 
      <varlistentry>
608
 
        <term>
609
 
          <link linkend="xstringb">xstringb</link>
610
 
        </term>
611
 
        <listitem>
612
 
          <para>Draw strings into a box</para>
613
 
          <para>
614
 
            <emphasis role="bold">Example:</emphasis>
615
 
          </para>
616
 
          <para>
617
 
            <scilab:image>xstringb();</scilab:image>
618
 
          </para>
619
 
        </listitem>
620
 
      </varlistentry>
621
 
      <varlistentry>
622
 
        <term>
623
 
          <link linkend="xtitle">xtitle</link>
624
 
        </term>
625
 
        <listitem>
626
 
          <para>Add titles on a graphics window</para>
627
 
          <para>
628
 
            <emphasis role="bold">Example:</emphasis>
629
 
          </para>
630
 
          <para>
631
 
            <scilab:image>xtitle();</scilab:image>
632
 
          </para>
633
 
        </listitem>
634
 
      </varlistentry>
635
 
      <varlistentry>
636
 
        <term>
637
 
          <link linkend="titlepage">titlepage</link>
638
 
        </term>
639
 
        <listitem>
640
 
          <para>Add a title in the middle of a graphics window</para>
641
 
        </listitem>
642
 
      </varlistentry>
643
 
      <varlistentry>
644
 
        <term>
645
 
          <link linkend="xinfo">xinfo</link>
646
 
        </term>
647
 
        <listitem>
648
 
          <para>Draw an info string in the message subwindow</para>
649
 
        </listitem>
650
 
      </varlistentry>
651
 
    </variablelist>
652
 
  </refsection>
653
 
  <refsection>
654
 
    <title>Frames and axes</title>
655
 
    <variablelist>
656
 
      <varlistentry>
657
 
        <term>
658
 
          <link linkend="drawaxis">drawaxis</link>
659
 
        </term>
660
 
        <listitem>
661
 
          <para>Draw an axis</para>
662
 
        </listitem>
663
 
      </varlistentry>
664
 
      <varlistentry>
665
 
        <term>
666
 
          <link linkend="graduate">graduate</link>
667
 
        </term>
668
 
        <listitem>
669
 
          <para>Pretty axis graduations</para>
670
 
        </listitem>
671
 
      </varlistentry>
672
 
      <varlistentry>
673
 
        <term>
674
 
          <link linkend="plotframe">plotframe</link>
675
 
        </term>
676
 
        <listitem>
677
 
          <para>Plot a frame with scaling and grids</para>
678
 
        </listitem>
679
 
      </varlistentry>
680
 
    </variablelist>
681
 
  </refsection>
682
 
  <refsection>
683
 
    <title>Coordinates transformations</title>
684
 
    <variablelist>
685
 
      <varlistentry>
686
 
        <term>
687
 
          <link linkend="isoview">isoview</link>
688
 
        </term>
689
 
        <listitem>
690
 
          <para>Set scales for isometric plot (do not change the size of the window)</para>
691
 
        </listitem>
692
 
      </varlistentry>
693
 
      <varlistentry>
694
 
        <term>
695
 
          <link linkend="square">square</link>
696
 
        </term>
697
 
        <listitem>
698
 
          <para>Set scales for isometric plot (change the size of the window)</para>
699
 
        </listitem>
700
 
      </varlistentry>
701
 
      <varlistentry>
702
 
        <term>
703
 
          <link linkend="scaling">scaling</link>
704
 
        </term>
705
 
        <listitem>
706
 
          <para>Affine transformation of a set of points</para>
707
 
        </listitem>
708
 
      </varlistentry>
709
 
      <varlistentry>
710
 
        <term>
711
 
          <link linkend="rotate">rotate</link>
712
 
        </term>
713
 
        <listitem>
714
 
          <para>Rotation of a set of points</para>
715
 
        </listitem>
716
 
      </varlistentry>
717
 
      <varlistentry>
718
 
        <term>
719
 
          <link linkend="xsetech">xsetech</link>
720
 
        </term>
721
 
        <listitem>
722
 
          <para>Set the sub-window of a graphics window for plotting</para>
723
 
        </listitem>
724
 
      </varlistentry>
725
 
      <varlistentry>
726
 
        <term>
727
 
          <link linkend="subplot">subplot</link>
728
 
        </term>
729
 
        <listitem>
730
 
          <para>Divide a graphics window into a matrix of sub-windows</para>
731
 
        </listitem>
732
 
      </varlistentry>
733
 
      <varlistentry>
734
 
        <term>
735
 
          <link linkend="xgetech">xgetech</link>
736
 
        </term>
737
 
        <listitem>
738
 
          <para>Get the current graphics scale</para>
739
 
        </listitem>
740
 
      </varlistentry>
741
 
      <varlistentry>
742
 
        <term>
743
 
          <link linkend="xchange">xchange</link>
744
 
        </term>
745
 
        <listitem>
746
 
          <para>Transform real to pixel coordinates</para>
747
 
        </listitem>
748
 
      </varlistentry>
749
 
    </variablelist>
750
 
  </refsection>
751
 
  <refsection>
752
 
    <title>Colors</title>
753
 
    <variablelist>
754
 
      <varlistentry>
755
 
        <term>
756
 
          <link linkend="colormap">colormap</link>
757
 
        </term>
758
 
        <listitem>
759
 
          <para>Using colormaps</para>
760
 
        </listitem>
761
 
      </varlistentry>
762
 
      <varlistentry>
763
 
        <term>
764
 
          <link linkend="getcolor">getcolor</link>
765
 
        </term>
766
 
        <listitem>
767
 
          <para>Dialog to select colors in the current colormap</para>
768
 
        </listitem>
769
 
      </varlistentry>
770
 
      <varlistentry>
771
 
        <term>
772
 
          <link linkend="addcolor">addcolor</link>
773
 
        </term>
774
 
        <listitem>
775
 
          <para>Add new colors to the current colormap</para>
776
 
        </listitem>
777
 
      </varlistentry>
778
 
      <varlistentry>
779
 
        <term>
780
 
          <link linkend="graycolormap">graycolormap</link>
781
 
        </term>
782
 
        <listitem>
783
 
          <para>Linear gray colormap</para>
784
 
        </listitem>
785
 
      </varlistentry>
786
 
      <varlistentry>
787
 
        <term>
788
 
          <link linkend="hotcolormap">hotcolormap</link>
789
 
        </term>
790
 
        <listitem>
791
 
          <para>Red to yellow colormap</para>
792
 
        </listitem>
793
 
      </varlistentry>
794
 
    </variablelist>
795
 
  </refsection>
796
 
  <refsection>
797
 
    <title>Graphics context</title>
798
 
    <variablelist>
799
 
      <varlistentry>
800
 
        <term>
801
 
          <link linkend="xset">xset</link>
802
 
        </term>
803
 
        <listitem>
804
 
          <para>Set values of the graphics context</para>
805
 
        </listitem>
806
 
      </varlistentry>
807
 
      <varlistentry>
808
 
        <term>
809
 
          <link linkend="xget">xget</link>
810
 
        </term>
811
 
        <listitem>
812
 
          <para>Get current values of the graphics context</para>
813
 
        </listitem>
814
 
      </varlistentry>
815
 
      <varlistentry>
816
 
        <term>
817
 
          <link linkend="xlfont">xlfont</link>
818
 
        </term>
819
 
        <listitem>
820
 
          <para>Load a font in the graphics context or query loaded font</para>
821
 
        </listitem>
822
 
      </varlistentry>
823
 
      <varlistentry>
824
 
        <term>
825
 
          <link linkend="getsymbol">getsymbol</link>
826
 
        </term>
827
 
        <listitem>
828
 
          <para>Dialog to select a symbol and its size</para>
829
 
        </listitem>
830
 
      </varlistentry>
831
 
    </variablelist>
832
 
  </refsection>
833
 
  <refsection>
834
 
    <title>Save and load</title>
835
 
    <variablelist>
836
 
      <varlistentry>
837
 
        <term>
838
 
          <link linkend="xsave">xsave</link>
839
 
        </term>
840
 
        <listitem>
841
 
          <para>Save graphics into a file</para>
842
 
        </listitem>
843
 
      </varlistentry>
844
 
      <varlistentry>
845
 
        <term>
846
 
          <link linkend="xload">xload</link>
847
 
        </term>
848
 
        <listitem>
849
 
          <para>Load a saved graphics</para>
850
 
        </listitem>
851
 
      </varlistentry>
852
 
      <varlistentry>
853
 
        <term>
854
 
          <link linkend="xs2bmp">xs2bmp</link>
855
 
        </term>
856
 
        <listitem>
857
 
          <para>Export graphics using the BMP format</para>
858
 
        </listitem>
859
 
      </varlistentry>
860
 
      <varlistentry>
861
 
        <term>
862
 
          <link linkend="xs2emf">xs2emf</link>
863
 
        </term>
864
 
        <listitem>
865
 
          <para>Export graphics using the EMF format</para>
866
 
        </listitem>
867
 
      </varlistentry>
868
 
      <varlistentry>
869
 
        <term>
870
 
          <link linkend="xs2eps">xs2eps</link>
871
 
        </term>
872
 
        <listitem>
873
 
          <para>Export graphics using the EPS format</para>
874
 
        </listitem>
875
 
      </varlistentry>
876
 
      <varlistentry>
877
 
        <term>
878
 
          <link linkend="xs2gif">xs2gif</link>
879
 
        </term>
880
 
        <listitem>
881
 
          <para>Export graphics using the GIF format</para>
882
 
        </listitem>
883
 
      </varlistentry>
884
 
      <varlistentry>
885
 
        <term>
886
 
          <link linkend="xs2jpg">xs2jpg</link>
887
 
        </term>
888
 
        <listitem>
889
 
          <para>Export graphics using the JPG format</para>
890
 
        </listitem>
891
 
      </varlistentry>
892
 
      <varlistentry>
893
 
        <term>
894
 
          <link linkend="xs2pdf">xs2pdf</link>
895
 
        </term>
896
 
        <listitem>
897
 
          <para>Export graphics using the PDF format</para>
898
 
        </listitem>
899
 
      </varlistentry>
900
 
      <varlistentry>
901
 
        <term>
902
 
          <link linkend="xs2png">xs2png</link>
903
 
        </term>
904
 
        <listitem>
905
 
          <para>Export graphics using the PNG format</para>
906
 
        </listitem>
907
 
      </varlistentry>
908
 
      <varlistentry>
909
 
        <term>
910
 
          <link linkend="xs2ppm">xs2ppm</link>
911
 
        </term>
912
 
        <listitem>
913
 
          <para>Export graphics using the PPM format</para>
914
 
        </listitem>
915
 
      </varlistentry>
916
 
      <varlistentry>
917
 
        <term>
918
 
          <link linkend="xs2ps">xs2ps</link>
919
 
        </term>
920
 
        <listitem>
921
 
          <para>Export graphics using the PS format</para>
922
 
        </listitem>
923
 
      </varlistentry>
924
 
      <varlistentry>
925
 
        <term>
926
 
          <link linkend="xs2svg">xs2svg</link>
927
 
        </term>
928
 
        <listitem>
929
 
          <para>Export graphics using the SVG format</para>
930
 
        </listitem>
931
 
      </varlistentry>
932
 
    </variablelist>
933
 
  </refsection>
934
 
  <refsection>
935
 
    <title>Graphics primitives</title>
936
 
    <variablelist>
937
 
      <varlistentry>
938
 
        <term>
939
 
          <link linkend="clf">clf</link>
940
 
        </term>
941
 
        <listitem>
942
 
          <para>Clear a graphics window and erase the associated recorded graphics</para>
943
 
        </listitem>
944
 
      </varlistentry>
945
 
      <varlistentry>
946
 
        <term>
947
 
          <link linkend="xclear">xclear</link>
948
 
        </term>
949
 
        <listitem>
950
 
          <para>Clear a graphics window</para>
951
 
        </listitem>
952
 
      </varlistentry>
953
 
      <varlistentry>
954
 
        <term>
955
 
          <link linkend="driver">driver</link>
956
 
        </term>
957
 
        <listitem>
958
 
          <para>Select a graphics driver</para>
959
 
        </listitem>
960
 
      </varlistentry>
961
 
      <varlistentry>
962
 
        <term>
963
 
          <link linkend="xinit">xinit</link>
964
 
        </term>
965
 
        <listitem>
966
 
          <para>Initialisation of a graphics driver</para>
967
 
        </listitem>
968
 
      </varlistentry>
969
 
      <varlistentry>
970
 
        <term>
971
 
          <link linkend="xend">xend</link>
972
 
        </term>
973
 
        <listitem>
974
 
          <para>Close a graphics session</para>
975
 
        </listitem>
976
 
      </varlistentry>
977
 
      <varlistentry>
978
 
        <term>
979
 
          <link linkend="xbasr">xbasr</link>
980
 
        </term>
981
 
        <listitem>
982
 
          <para>Redraw a graphics window</para>
983
 
        </listitem>
984
 
      </varlistentry>
985
 
      <varlistentry>
986
 
        <term>
987
 
          <link linkend="replot">replot</link>
988
 
        </term>
989
 
        <listitem>
990
 
          <para>Redraw the current graphics window with new boundaries</para>
991
 
        </listitem>
992
 
      </varlistentry>
993
 
      <varlistentry>
994
 
        <term>
995
 
          <link linkend="xpause">xpause</link>
996
 
        </term>
997
 
        <listitem>
998
 
          <para>Suspend Scilab</para>
999
 
        </listitem>
1000
 
      </varlistentry>
1001
 
      <varlistentry>
1002
 
        <term>
1003
 
          <link linkend="show_window">show_window</link>
1004
 
        </term>
1005
 
        <listitem>
1006
 
          <para>Raise the current graphics window</para>
1007
 
        </listitem>
1008
 
      </varlistentry>
1009
 
      <varlistentry>
1010
 
        <term>
1011
 
          <link linkend="xdel">xdel</link>
1012
 
        </term>
1013
 
        <listitem>
1014
 
          <para>Delete a graphics window</para>
1015
 
        </listitem>
1016
 
      </varlistentry>
1017
 
      <varlistentry>
1018
 
        <term>
1019
 
          <link linkend="winsid">winsid</link>
1020
 
        </term>
1021
 
        <listitem>
1022
 
          <para>Return the list of graphics windows</para>
1023
 
        </listitem>
1024
 
      </varlistentry>
1025
 
      <varlistentry>
1026
 
        <term>
1027
 
          <link linkend="xname">xname</link>
1028
 
        </term>
1029
 
        <listitem>
1030
 
          <para>Change the name of the current graphics window</para>
1031
 
        </listitem>
1032
 
      </varlistentry>
1033
 
    </variablelist>
1034
 
  </refsection>
1035
 
  <refsection>
1036
 
    <title>Mouse position</title>
1037
 
    <variablelist>
1038
 
      <varlistentry>
1039
 
        <term>
1040
 
          <link linkend="xclick">xclick</link>
1041
 
        </term>
1042
 
        <listitem>
1043
 
          <para>Wait for a mouse click</para>
1044
 
        </listitem>
1045
 
      </varlistentry>
1046
 
      <varlistentry>
1047
 
        <term>
1048
 
          <link linkend="locate">locate</link>
1049
 
        </term>
1050
 
        <listitem>
1051
 
          <para>Mouse selection of a set of points</para>
1052
 
        </listitem>
1053
 
      </varlistentry>
1054
 
      <varlistentry>
1055
 
        <term>
1056
 
          <link linkend="xgetmouse">xgetmouse</link>
1057
 
        </term>
1058
 
        <listitem>
1059
 
          <para>Get the current position of the mouse</para>
1060
 
        </listitem>
1061
 
      </varlistentry>
1062
 
    </variablelist>
1063
 
  </refsection>
1064
 
  <refsection>
1065
 
    <title>Interactive editor</title>
1066
 
    <variablelist>
1067
 
      <varlistentry>
1068
 
        <term>
1069
 
          <link linkend="edit_curv">edit_curv</link>
1070
 
        </term>
1071
 
        <listitem>
1072
 
          <para>Interactive graphics curve editor</para>
1073
 
        </listitem>
1074
 
      </varlistentry>
1075
 
    </variablelist>
1076
 
  </refsection>
1077
 
  <refsection>
1078
 
    <title>Graphics functions for automatic control</title>
1079
 
    <variablelist>
1080
 
      <varlistentry>
1081
 
        <term>
1082
 
          <link linkend="bode">bode</link>
1083
 
        </term>
1084
 
        <listitem>
1085
 
          <para>Bode plot</para>
1086
 
          <para>
1087
 
            <emphasis role="bold">Example:</emphasis>
1088
 
          </para>
1089
 
          <para>
1090
 
            <scilab:image>s=poly(0,'s')
1091
 
              h=syslin('c',(s^2+2*0.9*10*s+100)/(s^2+2*0.3*10.1*s+102.01))
1092
 
              clf();bode(h,0.01,100);
1093
 
            </scilab:image>
1094
 
          </para>
1095
 
        </listitem>
1096
 
      </varlistentry>
1097
 
      <varlistentry>
1098
 
        <term>
1099
 
          <link linkend="gainplot">gainplot</link>
1100
 
        </term>
1101
 
        <listitem>
1102
 
          <para>Magnitude plot</para>
1103
 
          <para>
1104
 
            <emphasis role="bold">Example:</emphasis>
1105
 
          </para>
1106
 
          <para>
1107
 
            <scilab:image>s=poly(0,'s')
1108
 
              h1=syslin('c',(s^2+2*0.9*10*s+100)/(s^2+2*0.3*10.1*s+102.01))
1109
 
              h2=syslin('c',(s^2+2*0.1*15.1*s+228.01)/(s^2+2*0.9*15*s+225))
1110
 
              clf();gainplot([h1;h2],0.01,100,['h1';'h2'])
1111
 
              title('Gainplot');
1112
 
            </scilab:image>
1113
 
          </para>
1114
 
        </listitem>
1115
 
      </varlistentry>
1116
 
      <varlistentry>
1117
 
        <term>
1118
 
          <link linkend="nyquist">nyquist</link>
1119
 
        </term>
1120
 
        <listitem>
1121
 
          <para>Nyquist plot</para>
1122
 
          <para>
1123
 
            <emphasis role="bold">Example:</emphasis>
1124
 
          </para>
1125
 
          <para>
1126
 
            <scilab:image>s=poly(0,'s')
1127
 
              h=syslin('c',(s^2+2*0.9*10*s+100)/(s^2+2*0.3*10.1*s+102.01));
1128
 
              h1=h*syslin('c',(s^2+2*0.1*15.1*s+228.01)/(s^2+2*0.9*15*s+225))
1129
 
              nyquist(h1)
1130
 
              ax=gca();
1131
 
              h_h=ax.children($).children(2);
1132
 
              tip=datatipCreate(h_h,[1.331,0.684]);
1133
 
              datatipSetOrientation(tip,"upper left");
1134
 
            </scilab:image>
1135
 
          </para>
1136
 
        </listitem>
1137
 
      </varlistentry>
1138
 
      <varlistentry>
1139
 
        <term>
1140
 
          <link linkend="m_circle">m_circle</link>
1141
 
        </term>
1142
 
        <listitem>
1143
 
          <para>M-circle plot</para>
1144
 
          <para>
1145
 
            <emphasis role="bold">Example:</emphasis>
1146
 
          </para>
1147
 
          <para>
1148
 
            <scilab:image>m_circle();</scilab:image>
1149
 
          </para>
1150
 
        </listitem>
1151
 
      </varlistentry>
1152
 
      <varlistentry>
1153
 
        <term>
1154
 
          <link linkend="chart">chart</link>
1155
 
        </term>
1156
 
        <listitem>
1157
 
          <para>Nichols chart</para>
1158
 
          <para>
1159
 
            <emphasis role="bold">Example:</emphasis>
1160
 
          </para>
1161
 
          <para>
1162
 
            <scilab:image>chart();</scilab:image>
1163
 
          </para>
1164
 
        </listitem>
1165
 
      </varlistentry>
1166
 
      <varlistentry>
1167
 
        <term>
1168
 
          <link linkend="black">black</link>
1169
 
        </term>
1170
 
        <listitem>
1171
 
          <para>Black's diagram</para>
1172
 
          <para>
1173
 
            <emphasis role="bold">Example:</emphasis>
1174
 
          </para>
1175
 
          <para>
1176
 
            <scilab:image>s=poly(0,'s');
1177
 
              sl=syslin('c',5*(1+s)/(.1*s^4+s^3+15*s^2+3*s+1))
1178
 
              clf();black(sl,0.01,10);
1179
 
            </scilab:image>
1180
 
          </para>
1181
 
        </listitem>
1182
 
      </varlistentry>
1183
 
      <varlistentry>
1184
 
        <term>
1185
 
          <link linkend="evans">evans</link>
1186
 
        </term>
1187
 
        <listitem>
1188
 
          <para>Evans root locus</para>
1189
 
          <para>
1190
 
            <emphasis role="bold">Example:</emphasis>
1191
 
          </para>
1192
 
          <para>
1193
 
            <scilab:image>evans();</scilab:image>
1194
 
          </para>
1195
 
        </listitem>
1196
 
      </varlistentry>
1197
 
      <varlistentry>
1198
 
        <term>
1199
 
          <link linkend="sgrid">sgrid</link>
1200
 
        </term>
1201
 
        <listitem>
1202
 
          <para>s-plane grid lines</para>
1203
 
          <para>
1204
 
            <emphasis role="bold">Example:</emphasis>
1205
 
          </para>
1206
 
          <para>
1207
 
            <scilab:image>sgrid();</scilab:image>
1208
 
          </para>
1209
 
        </listitem>
1210
 
      </varlistentry>
1211
 
      <varlistentry>
1212
 
        <term>
1213
 
          <link linkend="plzr">plzr</link>
1214
 
        </term>
1215
 
        <listitem>
1216
 
          <para>pole-zero plot</para>
1217
 
          <para>
1218
 
            <emphasis role="bold">Example:</emphasis>
1219
 
          </para>
1220
 
          <para>
1221
 
            <scilab:image>s=poly(0,'s');
1222
 
              n=[1+s   2+3*s+4*s^2        5; 0        1-s             s];
1223
 
              d=[1+3*s   5-s^3           s+1;1+s     1+s+s^2      3*s-1];
1224
 
              h=syslin('c',n./d); 
1225
 
              plzr(h);
1226
 
            </scilab:image>
1227
 
          </para>
1228
 
        </listitem>
1229
 
      </varlistentry>
1230
 
      <varlistentry>
1231
 
        <term>
1232
 
          <link linkend="zgrid">zgrid</link>
1233
 
        </term>
1234
 
        <listitem>
1235
 
          <para>zgrid plot</para>
1236
 
          <para>
1237
 
            <emphasis role="bold">Example:</emphasis>
1238
 
          </para>
1239
 
          <para>
1240
 
            <scilab:image>zgrid();</scilab:image>
1241
 
          </para>
1242
 
        </listitem>
1243
 
      </varlistentry>
1244
 
    </variablelist>
1245
 
  </refsection>
 
14
    <refnamediv>
 
15
        <refname>Graphics: Getting started</refname>
 
16
        <refpurpose> graphics library overview</refpurpose>
 
17
    </refnamediv>
 
18
    <refsection>
 
19
        <title>2d plotting</title>
 
20
        <variablelist>
 
21
            <varlistentry>
 
22
                <term>
 
23
                    <link linkend="plot2d">plot2d</link>
 
24
                </term>
 
25
                <listitem>
 
26
                    <para>Plot a curve</para>
 
27
                    <para>
 
28
                        <emphasis role="bold">Example:</emphasis>
 
29
                    </para>
 
30
                    <para>
 
31
                        <scilab:image>plot2d();</scilab:image>
 
32
                    </para>
 
33
                </listitem>
 
34
            </varlistentry>
 
35
            <varlistentry>
 
36
                <term>
 
37
                    <link linkend="plot2d2">plot2d2</link>
 
38
                </term>
 
39
                <listitem>
 
40
                    <para>Plot a curve as step function</para>
 
41
                    <para>
 
42
                        <emphasis role="bold">Example:</emphasis>
 
43
                    </para>
 
44
                    <para>
 
45
                        <scilab:image>plot2d2();</scilab:image>
 
46
                    </para>
 
47
                </listitem>
 
48
            </varlistentry>
 
49
            <varlistentry>
 
50
                <term>
 
51
                    <link linkend="plot2d3">plot2d3</link>
 
52
                </term>
 
53
                <listitem>
 
54
                    <para>Plot a curve with vertical bars</para>
 
55
                    <para>
 
56
                        <emphasis role="bold">Example:</emphasis>
 
57
                    </para>
 
58
                    <para>
 
59
                        <scilab:image>plot2d3();</scilab:image>
 
60
                    </para>
 
61
                </listitem>
 
62
            </varlistentry>
 
63
            <varlistentry>
 
64
                <term>
 
65
                    <link linkend="plot2d4">plot2d4</link>
 
66
                </term>
 
67
                <listitem>
 
68
                    <para>Plot a curve with arrows</para>
 
69
                    <para>
 
70
                        <emphasis role="bold">Example:</emphasis>
 
71
                    </para>
 
72
                    <para>
 
73
                        <scilab:image>plot2d4();</scilab:image>
 
74
                    </para>
 
75
                </listitem>
 
76
            </varlistentry>
 
77
            <varlistentry>
 
78
                <term>
 
79
                    <link linkend="fplot2d">fplot2d</link>
 
80
                </term>
 
81
                <listitem>
 
82
                    <para>Plot a curve defined by a function</para>
 
83
                    <para>
 
84
                        <emphasis role="bold">Example:</emphasis>
 
85
                    </para>
 
86
                    <para>
 
87
                        <scilab:image>fplot2d();</scilab:image>
 
88
                    </para>
 
89
                </listitem>
 
90
            </varlistentry>
 
91
            <varlistentry>
 
92
                <term>
 
93
                    <link linkend="champ">champ</link>
 
94
                </term>
 
95
                <listitem>
 
96
                    <para>2D vector field</para>
 
97
                    <para>
 
98
                        <emphasis role="bold">Example:</emphasis>
 
99
                    </para>
 
100
                    <para>
 
101
                        <scilab:image>champ();</scilab:image>
 
102
                    </para>
 
103
                </listitem>
 
104
            </varlistentry>
 
105
            <varlistentry>
 
106
                <term>
 
107
                    <link linkend="champ1">champ1</link>
 
108
                </term>
 
109
                <listitem>
 
110
                    <para>2D vector field with colored arrows</para>
 
111
                    <para>
 
112
                        <emphasis role="bold">Example:</emphasis>
 
113
                    </para>
 
114
                    <para>
 
115
                        <scilab:image>champ1();</scilab:image>
 
116
                    </para>
 
117
                </listitem>
 
118
            </varlistentry>
 
119
            <varlistentry>
 
120
                <term>
 
121
                    <link linkend="fchamp">fchamp</link>
 
122
                </term>
 
123
                <listitem>
 
124
                    <para>Direction field of a 2D first order ODE</para>
 
125
                    <para>
 
126
                        <emphasis role="bold">Example:</emphasis>
 
127
                    </para>
 
128
                    <para>
 
129
                        <scilab:image>fchamp();</scilab:image>
 
130
                    </para>
 
131
                </listitem>
 
132
            </varlistentry>
 
133
            <varlistentry>
 
134
                <term>
 
135
                    <link linkend="contour2d">contour2d</link>
 
136
                </term>
 
137
                <listitem>
 
138
                    <para>Level curves of a surface on a 2D plot</para>
 
139
                </listitem>
 
140
            </varlistentry>
 
141
            <varlistentry>
 
142
                <term>
 
143
                    <link linkend="fcontour2d">fcontour2d</link>
 
144
                </term>
 
145
                <listitem>
 
146
                    <para>Level curves of a surface defined by a function on a 2D plot</para>
 
147
                    <para>
 
148
                        <emphasis role="bold">Example:</emphasis>
 
149
                    </para>
 
150
                    <para>
 
151
                        <scilab:image>fcontour2d();</scilab:image>
 
152
                    </para>
 
153
                </listitem>
 
154
            </varlistentry>
 
155
            <varlistentry>
 
156
                <term>
 
157
                    <link linkend="grayplot">grayplot</link>
 
158
                </term>
 
159
                <listitem>
 
160
                    <para>2D plot of a surface using colors</para>
 
161
                    <para>
 
162
                        <emphasis role="bold">Example:</emphasis>
 
163
                    </para>
 
164
                    <para>
 
165
                        <scilab:image>grayplot();</scilab:image>
 
166
                    </para>
 
167
                </listitem>
 
168
            </varlistentry>
 
169
            <varlistentry>
 
170
                <term>
 
171
                    <link linkend="fgrayplot">fgrayplot</link>
 
172
                </term>
 
173
                <listitem>
 
174
                    <para>2D plot of a surface defined by a function using colors</para>
 
175
                    <para>
 
176
                        <emphasis role="bold">Example:</emphasis>
 
177
                    </para>
 
178
                    <para>
 
179
                        <scilab:image>fgrayplot();</scilab:image>
 
180
                    </para>
 
181
                </listitem>
 
182
            </varlistentry>
 
183
            <varlistentry>
 
184
                <term>
 
185
                    <link linkend="Sgrayplot">Sgrayplot</link>
 
186
                </term>
 
187
                <listitem>
 
188
                    <para>Smooth 2D plot of a surface using colors</para>
 
189
                    <para>
 
190
                        <emphasis role="bold">Example:</emphasis>
 
191
                    </para>
 
192
                    <para>
 
193
                        <scilab:image>Sgrayplot();</scilab:image>
 
194
                    </para>
 
195
                </listitem>
 
196
            </varlistentry>
 
197
            <varlistentry>
 
198
                <term>
 
199
                    <link linkend="Sfgrayplot">Sfgrayplot</link>
 
200
                </term>
 
201
                <listitem>
 
202
                    <para>Smooth 2D plot of a surface defined by a function using colors</para>
 
203
                    <para>
 
204
                        <emphasis role="bold">Example:</emphasis>
 
205
                    </para>
 
206
                    <para>
 
207
                        <scilab:image>Sfgrayplot();</scilab:image>
 
208
                    </para>
 
209
                </listitem>
 
210
            </varlistentry>
 
211
            <varlistentry>
 
212
                <term>
 
213
                    <link linkend="xgrid">xgrid</link>
 
214
                </term>
 
215
                <listitem>
 
216
                    <para>Add a grid on a 2D plot</para>
 
217
                    <para>
 
218
                        <emphasis role="bold">Example:</emphasis>
 
219
                    </para>
 
220
                    <para>
 
221
                        <scilab:image>xgrid();</scilab:image>
 
222
                    </para>
 
223
                </listitem>
 
224
            </varlistentry>
 
225
            <varlistentry>
 
226
                <term>
 
227
                    <link linkend="errbar">errbar</link>
 
228
                </term>
 
229
                <listitem>
 
230
                    <para>Add vertical error bars on a 2D plot</para>
 
231
                    <para>
 
232
                        <emphasis role="bold">Example:</emphasis>
 
233
                    </para>
 
234
                    <para>
 
235
                        <scilab:image>errbar();</scilab:image>
 
236
                    </para>
 
237
                </listitem>
 
238
            </varlistentry>
 
239
            <varlistentry>
 
240
                <term>
 
241
                    <link linkend="histplot">histplot</link>
 
242
                </term>
 
243
                <listitem>
 
244
                    <para>Plot a histogram</para>
 
245
                    <para>
 
246
                        <emphasis role="bold">Example:</emphasis>
 
247
                    </para>
 
248
                    <para>
 
249
                        <scilab:image>histplot();</scilab:image>
 
250
                    </para>
 
251
                </listitem>
 
252
            </varlistentry>
 
253
            <varlistentry>
 
254
                <term>
 
255
                    <link linkend="Matplot">Matplot</link>
 
256
                </term>
 
257
                <listitem>
 
258
                    <para>2D plot of a matrix using colors</para>
 
259
                    <para>
 
260
                        <emphasis role="bold">Example:</emphasis>
 
261
                    </para>
 
262
                    <para>
 
263
                        <scilab:image>Matplot();</scilab:image>
 
264
                    </para>
 
265
                </listitem>
 
266
            </varlistentry>
 
267
        </variablelist>
 
268
    </refsection>
 
269
    <refsection>
 
270
        <title>3d plotting</title>
 
271
        <variablelist>
 
272
            <varlistentry>
 
273
                <term>
 
274
                    <link linkend="plot3d">plot3d</link>
 
275
                </term>
 
276
                <listitem>
 
277
                    <para>Plot a surface</para>
 
278
                    <para>
 
279
                        <emphasis role="bold">Example:</emphasis>
 
280
                    </para>
 
281
                    <para>
 
282
                        <scilab:image>plot3d();</scilab:image>
 
283
                    </para>
 
284
                </listitem>
 
285
            </varlistentry>
 
286
            <varlistentry>
 
287
                <term>
 
288
                    <link linkend="plot3d1">plot3d1</link>
 
289
                </term>
 
290
                <listitem>
 
291
                    <para>Plot a surface with gray or color level</para>
 
292
                    <para>
 
293
                        <emphasis role="bold">Example:</emphasis>
 
294
                    </para>
 
295
                    <para>
 
296
                        <scilab:image>plot3d1();</scilab:image>
 
297
                    </para>
 
298
                </listitem>
 
299
            </varlistentry>
 
300
            <varlistentry>
 
301
                <term>
 
302
                    <link linkend="fplot3d">fplot3d</link>
 
303
                </term>
 
304
                <listitem>
 
305
                    <para>Plot a surface defined by a function</para>
 
306
                    <para>
 
307
                        <emphasis role="bold">Example:</emphasis>
 
308
                    </para>
 
309
                    <para>
 
310
                        <scilab:image>fplot3d();</scilab:image>
 
311
                    </para>
 
312
                </listitem>
 
313
            </varlistentry>
 
314
            <varlistentry>
 
315
                <term>
 
316
                    <link linkend="fplot3d1">fplot3d1</link>
 
317
                </term>
 
318
                <listitem>
 
319
                    <para>Plot a surface defined by a function with gray or color level</para>
 
320
                    <para>
 
321
                        <emphasis role="bold">Example:</emphasis>
 
322
                    </para>
 
323
                    <para>
 
324
                        <scilab:image>fplot3d1();</scilab:image>
 
325
                    </para>
 
326
                </listitem>
 
327
            </varlistentry>
 
328
            <varlistentry>
 
329
                <term>
 
330
                    <link linkend="param3d">param3d</link>
 
331
                </term>
 
332
                <listitem>
 
333
                    <para>Plot one curve</para>
 
334
                    <para>
 
335
                        <emphasis role="bold">Example:</emphasis>
 
336
                    </para>
 
337
                    <para>
 
338
                        <scilab:image>param3d();</scilab:image>
 
339
                    </para>
 
340
                </listitem>
 
341
            </varlistentry>
 
342
            <varlistentry>
 
343
                <term>
 
344
                    <link linkend="param3d1">param3d1</link>
 
345
                </term>
 
346
                <listitem>
 
347
                    <para>Plots curves</para>
 
348
                    <para>
 
349
                        <emphasis role="bold">Example:</emphasis>
 
350
                    </para>
 
351
                    <para>
 
352
                        <scilab:image>param3d1();</scilab:image>
 
353
                    </para>
 
354
                </listitem>
 
355
            </varlistentry>
 
356
            <varlistentry>
 
357
                <term>
 
358
                    <link linkend="contour">contour</link>
 
359
                </term>
 
360
                <listitem>
 
361
                    <para>Level curves on a 3D surface</para>
 
362
                    <para>
 
363
                        <emphasis role="bold">Example:</emphasis>
 
364
                    </para>
 
365
                    <para>
 
366
                        <scilab:image>contour();</scilab:image>
 
367
                    </para>
 
368
                </listitem>
 
369
            </varlistentry>
 
370
            <varlistentry>
 
371
                <term>
 
372
                    <link linkend="fcontour">fcontour</link>
 
373
                </term>
 
374
                <listitem>
 
375
                    <para>Level curves on a 3D surface defined by a function</para>
 
376
                    <para>
 
377
                        <emphasis role="bold">Example:</emphasis>
 
378
                    </para>
 
379
                    <para>
 
380
                        <scilab:image>fcontour();</scilab:image>
 
381
                    </para>
 
382
                </listitem>
 
383
            </varlistentry>
 
384
            <varlistentry>
 
385
                <term>
 
386
                    <link linkend="hist3d">hist3d</link>
 
387
                </term>
 
388
                <listitem>
 
389
                    <para>3D representation of a histogram</para>
 
390
                    <para>
 
391
                        <emphasis role="bold">Example:</emphasis>
 
392
                    </para>
 
393
                    <para>
 
394
                        <scilab:image>hist3d();</scilab:image>
 
395
                    </para>
 
396
                </listitem>
 
397
            </varlistentry>
 
398
            <varlistentry>
 
399
                <term>
 
400
                    <link linkend="genfac3d">genfac3d</link>
 
401
                </term>
 
402
                <listitem>
 
403
                    <para>Compute facets of a 3D surface</para>
 
404
                    <para>
 
405
                        <emphasis role="bold">Example:</emphasis>
 
406
                    </para>
 
407
                    <para>
 
408
                        <scilab:image>genfac3d();</scilab:image>
 
409
                    </para>
 
410
                </listitem>
 
411
            </varlistentry>
 
412
            <varlistentry>
 
413
                <term>
 
414
                    <link linkend="eval3dp">eval3dp</link>
 
415
                </term>
 
416
                <listitem>
 
417
                    <para>Compute facets of a 3D surface</para>
 
418
                    <para>
 
419
                        <emphasis role="bold">Example:</emphasis>
 
420
                    </para>
 
421
                    <para>
 
422
                        <scilab:image>p1=linspace(0,2*%pi,10);
 
423
                            p2=linspace(0,2*%pi,10);
 
424
                            deff("[x,y,z]=scp(p1,p2)",["x=p1.*sin(p1).*cos(p2)";..
 
425
                            "y=p1.*cos(p1).*cos(p2)";..
 
426
                            "z=p1.*sin(p2)"])
 
427
                            [Xf,Yf,Zf]=eval3dp(scp,p1,p2);
 
428
                            plot3d(Xf,Yf,Zf)
 
429
                        </scilab:image>
 
430
                    </para>
 
431
                </listitem>
 
432
            </varlistentry>
 
433
            <varlistentry>
 
434
                <term>
 
435
                    <link linkend="geom3d">geom3d</link>
 
436
                </term>
 
437
                <listitem>
 
438
                    <para>Projection from 3D on 2D after a 3D plot</para>
 
439
                    <para>
 
440
                        <emphasis role="bold">Example:</emphasis>
 
441
                    </para>
 
442
                    <para>
 
443
                        <scilab:image>deff("[z]=surface(x,y)","z=sin(x)*cos(y)")
 
444
                            t=%pi*(-10:10)/10;
 
445
                            // 3D plot of the surface
 
446
                            fplot3d(t,t,surface,35,45,"X@Y@Z")
 
447
                            // now (t,t,sin(t).*cos(t)) is a curve on the surface
 
448
                            // which can be drawn using geom3d and xpoly
 
449
                            [x,y]=geom3d(%pi/2,0,surface(%pi/2,0))
 
450
                        </scilab:image>
 
451
                    </para>
 
452
                </listitem>
 
453
            </varlistentry>
 
454
        </variablelist>
 
455
    </refsection>
 
456
    <refsection>
 
457
        <title>Line and polygon plotting</title>
 
458
        <variablelist>
 
459
            <varlistentry>
 
460
                <term>
 
461
                    <link linkend="xpoly">xpoly</link>
 
462
                </term>
 
463
                <listitem>
 
464
                    <para>Draw a polyline or a polygon</para>
 
465
                </listitem>
 
466
            </varlistentry>
 
467
            <varlistentry>
 
468
                <term>
 
469
                    <link linkend="xpolys">xpolys</link>
 
470
                </term>
 
471
                <listitem>
 
472
                    <para>Draw a set of polylines or polygons</para>
 
473
                </listitem>
 
474
            </varlistentry>
 
475
            <varlistentry>
 
476
                <term>
 
477
                    <link linkend="xrpoly">xrpoly</link>
 
478
                </term>
 
479
                <listitem>
 
480
                    <para>Draw a regular polygon</para>
 
481
                </listitem>
 
482
            </varlistentry>
 
483
            <varlistentry>
 
484
                <term>
 
485
                    <link linkend="xsegs">xsegs</link>
 
486
                </term>
 
487
                <listitem>
 
488
                    <para>Draw unconnected segments</para>
 
489
                </listitem>
 
490
            </varlistentry>
 
491
            <varlistentry>
 
492
                <term>
 
493
                    <link linkend="xfpoly">xfpoly</link>
 
494
                </term>
 
495
                <listitem>
 
496
                    <para>Fill a polygon</para>
 
497
                </listitem>
 
498
            </varlistentry>
 
499
            <varlistentry>
 
500
                <term>
 
501
                    <link linkend="xfpolys">xfpolys</link>
 
502
                </term>
 
503
                <listitem>
 
504
                    <para>Fill a set of polygons</para>
 
505
                </listitem>
 
506
            </varlistentry>
 
507
        </variablelist>
 
508
    </refsection>
 
509
    <refsection>
 
510
        <title>Rectangle plotting</title>
 
511
        <variablelist>
 
512
            <varlistentry>
 
513
                <term>
 
514
                    <link linkend="xrect">xrect</link>
 
515
                </term>
 
516
                <listitem>
 
517
                    <para>Draw a rectangle</para>
 
518
                </listitem>
 
519
            </varlistentry>
 
520
            <varlistentry>
 
521
                <term>
 
522
                    <link linkend="xfrect">xfrect</link>
 
523
                </term>
 
524
                <listitem>
 
525
                    <para>Fill a rectangle</para>
 
526
                </listitem>
 
527
            </varlistentry>
 
528
            <varlistentry>
 
529
                <term>
 
530
                    <link linkend="xrects">xrects</link>
 
531
                </term>
 
532
                <listitem>
 
533
                    <para>Draw or fill a set of rectangles</para>
 
534
                </listitem>
 
535
            </varlistentry>
 
536
        </variablelist>
 
537
    </refsection>
 
538
    <refsection>
 
539
        <title>Arc plotting</title>
 
540
        <variablelist>
 
541
            <varlistentry>
 
542
                <term>
 
543
                    <link linkend="xarc">xarc</link>
 
544
                </term>
 
545
                <listitem>
 
546
                    <para>Draw a part of an ellipse</para>
 
547
                </listitem>
 
548
            </varlistentry>
 
549
            <varlistentry>
 
550
                <term>
 
551
                    <link linkend="xarcs">xarcs</link>
 
552
                </term>
 
553
                <listitem>
 
554
                    <para>Draw parts of a set of ellipses</para>
 
555
                </listitem>
 
556
            </varlistentry>
 
557
            <varlistentry>
 
558
                <term>
 
559
                    <link linkend="xfarc">xfarc</link>
 
560
                </term>
 
561
                <listitem>
 
562
                    <para>Fill a part of an ellipse</para>
 
563
                </listitem>
 
564
            </varlistentry>
 
565
            <varlistentry>
 
566
                <term>
 
567
                    <link linkend="xfarcs">xfarcs</link>
 
568
                </term>
 
569
                <listitem>
 
570
                    <para>Fill parts of a set of ellipses</para>
 
571
                </listitem>
 
572
            </varlistentry>
 
573
        </variablelist>
 
574
    </refsection>
 
575
    <refsection>
 
576
        <title>Arrow plotting</title>
 
577
        <variablelist>
 
578
            <varlistentry>
 
579
                <term>
 
580
                    <link linkend="xarrows">xarrows</link>
 
581
                </term>
 
582
                <listitem>
 
583
                    <para>Draw a set of arrows</para>
 
584
                </listitem>
 
585
            </varlistentry>
 
586
        </variablelist>
 
587
    </refsection>
 
588
    <refsection>
 
589
        <title>Strings</title>
 
590
        <variablelist>
 
591
            <varlistentry>
 
592
                <term>
 
593
                    <link linkend="xstring">xstring</link>
 
594
                </term>
 
595
                <listitem>
 
596
                    <para>Draw strings</para>
 
597
                </listitem>
 
598
            </varlistentry>
 
599
            <varlistentry>
 
600
                <term>
 
601
                    <link linkend="xstringl">xstringl</link>
 
602
                </term>
 
603
                <listitem>
 
604
                    <para>Compute a box which surrounds strings</para>
 
605
                </listitem>
 
606
            </varlistentry>
 
607
            <varlistentry>
 
608
                <term>
 
609
                    <link linkend="xstringb">xstringb</link>
 
610
                </term>
 
611
                <listitem>
 
612
                    <para>Draw strings into a box</para>
 
613
                    <para>
 
614
                        <emphasis role="bold">Example:</emphasis>
 
615
                    </para>
 
616
                    <para>
 
617
                        <scilab:image>xstringb();</scilab:image>
 
618
                    </para>
 
619
                </listitem>
 
620
            </varlistentry>
 
621
            <varlistentry>
 
622
                <term>
 
623
                    <link linkend="xtitle">xtitle</link>
 
624
                </term>
 
625
                <listitem>
 
626
                    <para>Add titles on a graphics window</para>
 
627
                    <para>
 
628
                        <emphasis role="bold">Example:</emphasis>
 
629
                    </para>
 
630
                    <para>
 
631
                        <scilab:image>xtitle();</scilab:image>
 
632
                    </para>
 
633
                </listitem>
 
634
            </varlistentry>
 
635
            <varlistentry>
 
636
                <term>
 
637
                    <link linkend="titlepage">titlepage</link>
 
638
                </term>
 
639
                <listitem>
 
640
                    <para>Add a title in the middle of a graphics window</para>
 
641
                </listitem>
 
642
            </varlistentry>
 
643
            <varlistentry>
 
644
                <term>
 
645
                    <link linkend="xinfo">xinfo</link>
 
646
                </term>
 
647
                <listitem>
 
648
                    <para>Draw an info string in the message subwindow</para>
 
649
                </listitem>
 
650
            </varlistentry>
 
651
        </variablelist>
 
652
    </refsection>
 
653
    <refsection>
 
654
        <title>Frames and axes</title>
 
655
        <variablelist>
 
656
            <varlistentry>
 
657
                <term>
 
658
                    <link linkend="drawaxis">drawaxis</link>
 
659
                </term>
 
660
                <listitem>
 
661
                    <para>Draw an axis</para>
 
662
                </listitem>
 
663
            </varlistentry>
 
664
            <varlistentry>
 
665
                <term>
 
666
                    <link linkend="graduate">graduate</link>
 
667
                </term>
 
668
                <listitem>
 
669
                    <para>Pretty axis graduations</para>
 
670
                </listitem>
 
671
            </varlistentry>
 
672
            <varlistentry>
 
673
                <term>
 
674
                    <link linkend="plotframe">plotframe</link>
 
675
                </term>
 
676
                <listitem>
 
677
                    <para>Plot a frame with scaling and grids</para>
 
678
                </listitem>
 
679
            </varlistentry>
 
680
        </variablelist>
 
681
    </refsection>
 
682
    <refsection>
 
683
        <title>Coordinates transformations</title>
 
684
        <variablelist>
 
685
            <varlistentry>
 
686
                <term>
 
687
                    <link linkend="isoview">isoview</link>
 
688
                </term>
 
689
                <listitem>
 
690
                    <para>Set scales for isometric plot (do not change the size of the window)</para>
 
691
                </listitem>
 
692
            </varlistentry>
 
693
            <varlistentry>
 
694
                <term>
 
695
                    <link linkend="square">square</link>
 
696
                </term>
 
697
                <listitem>
 
698
                    <para>Set scales for isometric plot (change the size of the window)</para>
 
699
                </listitem>
 
700
            </varlistentry>
 
701
            <varlistentry>
 
702
                <term>
 
703
                    <link linkend="scaling">scaling</link>
 
704
                </term>
 
705
                <listitem>
 
706
                    <para>Affine transformation of a set of points</para>
 
707
                </listitem>
 
708
            </varlistentry>
 
709
            <varlistentry>
 
710
                <term>
 
711
                    <link linkend="rotate">rotate</link>
 
712
                </term>
 
713
                <listitem>
 
714
                    <para>Rotation of a set of points</para>
 
715
                </listitem>
 
716
            </varlistentry>
 
717
            <varlistentry>
 
718
                <term>
 
719
                    <link linkend="xsetech">xsetech</link>
 
720
                </term>
 
721
                <listitem>
 
722
                    <para>Set the sub-window of a graphics window for plotting</para>
 
723
                </listitem>
 
724
            </varlistentry>
 
725
            <varlistentry>
 
726
                <term>
 
727
                    <link linkend="subplot">subplot</link>
 
728
                </term>
 
729
                <listitem>
 
730
                    <para>Divide a graphics window into a matrix of sub-windows</para>
 
731
                </listitem>
 
732
            </varlistentry>
 
733
            <varlistentry>
 
734
                <term>
 
735
                    <link linkend="xgetech">xgetech</link>
 
736
                </term>
 
737
                <listitem>
 
738
                    <para>Get the current graphics scale</para>
 
739
                </listitem>
 
740
            </varlistentry>
 
741
            <varlistentry>
 
742
                <term>
 
743
                    <link linkend="xchange">xchange</link>
 
744
                </term>
 
745
                <listitem>
 
746
                    <para>Transform real to pixel coordinates</para>
 
747
                </listitem>
 
748
            </varlistentry>
 
749
        </variablelist>
 
750
    </refsection>
 
751
    <refsection>
 
752
        <title>Colors</title>
 
753
        <variablelist>
 
754
            <varlistentry>
 
755
                <term>
 
756
                    <link linkend="colormap">colormap</link>
 
757
                </term>
 
758
                <listitem>
 
759
                    <para>Using colormaps</para>
 
760
                </listitem>
 
761
            </varlistentry>
 
762
            <varlistentry>
 
763
                <term>
 
764
                    <link linkend="getcolor">getcolor</link>
 
765
                </term>
 
766
                <listitem>
 
767
                    <para>Dialog to select colors in the current colormap</para>
 
768
                </listitem>
 
769
            </varlistentry>
 
770
            <varlistentry>
 
771
                <term>
 
772
                    <link linkend="addcolor">addcolor</link>
 
773
                </term>
 
774
                <listitem>
 
775
                    <para>Add new colors to the current colormap</para>
 
776
                </listitem>
 
777
            </varlistentry>
 
778
            <varlistentry>
 
779
                <term>
 
780
                    <link linkend="graycolormap">graycolormap</link>
 
781
                </term>
 
782
                <listitem>
 
783
                    <para>Linear gray colormap</para>
 
784
                </listitem>
 
785
            </varlistentry>
 
786
            <varlistentry>
 
787
                <term>
 
788
                    <link linkend="hotcolormap">hotcolormap</link>
 
789
                </term>
 
790
                <listitem>
 
791
                    <para>Red to yellow colormap</para>
 
792
                </listitem>
 
793
            </varlistentry>
 
794
        </variablelist>
 
795
    </refsection>
 
796
    <refsection>
 
797
        <title>Graphics context</title>
 
798
        <variablelist>
 
799
            <varlistentry>
 
800
                <term>
 
801
                    <link linkend="xset">xset</link>
 
802
                </term>
 
803
                <listitem>
 
804
                    <para>Set values of the graphics context</para>
 
805
                </listitem>
 
806
            </varlistentry>
 
807
            <varlistentry>
 
808
                <term>
 
809
                    <link linkend="xget">xget</link>
 
810
                </term>
 
811
                <listitem>
 
812
                    <para>Get current values of the graphics context</para>
 
813
                </listitem>
 
814
            </varlistentry>
 
815
            <varlistentry>
 
816
                <term>
 
817
                    <link linkend="xlfont">xlfont</link>
 
818
                </term>
 
819
                <listitem>
 
820
                    <para>Load a font in the graphics context or query loaded font</para>
 
821
                </listitem>
 
822
            </varlistentry>
 
823
            <varlistentry>
 
824
                <term>
 
825
                    <link linkend="getsymbol">getsymbol</link>
 
826
                </term>
 
827
                <listitem>
 
828
                    <para>Dialog to select a symbol and its size</para>
 
829
                </listitem>
 
830
            </varlistentry>
 
831
        </variablelist>
 
832
    </refsection>
 
833
    <refsection>
 
834
        <title>Save and load</title>
 
835
        <variablelist>
 
836
            <varlistentry>
 
837
                <term>
 
838
                    <link linkend="xsave">xsave</link>
 
839
                </term>
 
840
                <listitem>
 
841
                    <para>Save graphics into a file</para>
 
842
                </listitem>
 
843
            </varlistentry>
 
844
            <varlistentry>
 
845
                <term>
 
846
                    <link linkend="xload">xload</link>
 
847
                </term>
 
848
                <listitem>
 
849
                    <para>Load a saved graphics</para>
 
850
                </listitem>
 
851
            </varlistentry>
 
852
            <varlistentry>
 
853
                <term>
 
854
                    <link linkend="xs2bmp">xs2bmp</link>
 
855
                </term>
 
856
                <listitem>
 
857
                    <para>Export graphics using the BMP format</para>
 
858
                </listitem>
 
859
            </varlistentry>
 
860
            <varlistentry>
 
861
                <term>
 
862
                    <link linkend="xs2emf">xs2emf</link>
 
863
                </term>
 
864
                <listitem>
 
865
                    <para>Export graphics using the EMF format</para>
 
866
                </listitem>
 
867
            </varlistentry>
 
868
            <varlistentry>
 
869
                <term>
 
870
                    <link linkend="xs2eps">xs2eps</link>
 
871
                </term>
 
872
                <listitem>
 
873
                    <para>Export graphics using the EPS format</para>
 
874
                </listitem>
 
875
            </varlistentry>
 
876
            <varlistentry>
 
877
                <term>
 
878
                    <link linkend="xs2gif">xs2gif</link>
 
879
                </term>
 
880
                <listitem>
 
881
                    <para>Export graphics using the GIF format</para>
 
882
                </listitem>
 
883
            </varlistentry>
 
884
            <varlistentry>
 
885
                <term>
 
886
                    <link linkend="xs2jpg">xs2jpg</link>
 
887
                </term>
 
888
                <listitem>
 
889
                    <para>Export graphics using the JPG format</para>
 
890
                </listitem>
 
891
            </varlistentry>
 
892
            <varlistentry>
 
893
                <term>
 
894
                    <link linkend="xs2pdf">xs2pdf</link>
 
895
                </term>
 
896
                <listitem>
 
897
                    <para>Export graphics using the PDF format</para>
 
898
                </listitem>
 
899
            </varlistentry>
 
900
            <varlistentry>
 
901
                <term>
 
902
                    <link linkend="xs2png">xs2png</link>
 
903
                </term>
 
904
                <listitem>
 
905
                    <para>Export graphics using the PNG format</para>
 
906
                </listitem>
 
907
            </varlistentry>
 
908
            <varlistentry>
 
909
                <term>
 
910
                    <link linkend="xs2ppm">xs2ppm</link>
 
911
                </term>
 
912
                <listitem>
 
913
                    <para>Export graphics using the PPM format</para>
 
914
                </listitem>
 
915
            </varlistentry>
 
916
            <varlistentry>
 
917
                <term>
 
918
                    <link linkend="xs2ps">xs2ps</link>
 
919
                </term>
 
920
                <listitem>
 
921
                    <para>Export graphics using the PS format</para>
 
922
                </listitem>
 
923
            </varlistentry>
 
924
            <varlistentry>
 
925
                <term>
 
926
                    <link linkend="xs2svg">xs2svg</link>
 
927
                </term>
 
928
                <listitem>
 
929
                    <para>Export graphics using the SVG format</para>
 
930
                </listitem>
 
931
            </varlistentry>
 
932
        </variablelist>
 
933
    </refsection>
 
934
    <refsection>
 
935
        <title>Graphics primitives</title>
 
936
        <variablelist>
 
937
            <varlistentry>
 
938
                <term>
 
939
                    <link linkend="clf">clf</link>
 
940
                </term>
 
941
                <listitem>
 
942
                    <para>Clear a graphics window and erase the associated recorded graphics</para>
 
943
                </listitem>
 
944
            </varlistentry>
 
945
            <varlistentry>
 
946
                <term>
 
947
                    <link linkend="xclear">xclear</link>
 
948
                </term>
 
949
                <listitem>
 
950
                    <para>Clear a graphics window</para>
 
951
                </listitem>
 
952
            </varlistentry>
 
953
            <varlistentry>
 
954
                <term>
 
955
                    <link linkend="driver">driver</link>
 
956
                </term>
 
957
                <listitem>
 
958
                    <para>Select a graphics driver</para>
 
959
                </listitem>
 
960
            </varlistentry>
 
961
            <varlistentry>
 
962
                <term>
 
963
                    <link linkend="xinit">xinit</link>
 
964
                </term>
 
965
                <listitem>
 
966
                    <para>Initialisation of a graphics driver</para>
 
967
                </listitem>
 
968
            </varlistentry>
 
969
            <varlistentry>
 
970
                <term>
 
971
                    <link linkend="xend">xend</link>
 
972
                </term>
 
973
                <listitem>
 
974
                    <para>Close a graphics session</para>
 
975
                </listitem>
 
976
            </varlistentry>
 
977
            <varlistentry>
 
978
                <term>
 
979
                    <link linkend="xbasr">xbasr</link>
 
980
                </term>
 
981
                <listitem>
 
982
                    <para>Redraw a graphics window</para>
 
983
                </listitem>
 
984
            </varlistentry>
 
985
            <varlistentry>
 
986
                <term>
 
987
                    <link linkend="replot">replot</link>
 
988
                </term>
 
989
                <listitem>
 
990
                    <para>Redraw the current graphics window with new boundaries</para>
 
991
                </listitem>
 
992
            </varlistentry>
 
993
            <varlistentry>
 
994
                <term>
 
995
                    <link linkend="xpause">xpause</link>
 
996
                </term>
 
997
                <listitem>
 
998
                    <para>Suspend Scilab</para>
 
999
                </listitem>
 
1000
            </varlistentry>
 
1001
            <varlistentry>
 
1002
                <term>
 
1003
                    <link linkend="show_window">show_window</link>
 
1004
                </term>
 
1005
                <listitem>
 
1006
                    <para>Raise the current graphics window</para>
 
1007
                </listitem>
 
1008
            </varlistentry>
 
1009
            <varlistentry>
 
1010
                <term>
 
1011
                    <link linkend="xdel">xdel</link>
 
1012
                </term>
 
1013
                <listitem>
 
1014
                    <para>Delete a graphics window</para>
 
1015
                </listitem>
 
1016
            </varlistentry>
 
1017
            <varlistentry>
 
1018
                <term>
 
1019
                    <link linkend="winsid">winsid</link>
 
1020
                </term>
 
1021
                <listitem>
 
1022
                    <para>Return the list of graphics windows</para>
 
1023
                </listitem>
 
1024
            </varlistentry>
 
1025
            <varlistentry>
 
1026
                <term>
 
1027
                    <link linkend="xname">xname</link>
 
1028
                </term>
 
1029
                <listitem>
 
1030
                    <para>Change the name of the current graphics window</para>
 
1031
                </listitem>
 
1032
            </varlistentry>
 
1033
        </variablelist>
 
1034
    </refsection>
 
1035
    <refsection>
 
1036
        <title>Mouse position</title>
 
1037
        <variablelist>
 
1038
            <varlistentry>
 
1039
                <term>
 
1040
                    <link linkend="xclick">xclick</link>
 
1041
                </term>
 
1042
                <listitem>
 
1043
                    <para>Wait for a mouse click</para>
 
1044
                </listitem>
 
1045
            </varlistentry>
 
1046
            <varlistentry>
 
1047
                <term>
 
1048
                    <link linkend="locate">locate</link>
 
1049
                </term>
 
1050
                <listitem>
 
1051
                    <para>Mouse selection of a set of points</para>
 
1052
                </listitem>
 
1053
            </varlistentry>
 
1054
            <varlistentry>
 
1055
                <term>
 
1056
                    <link linkend="xgetmouse">xgetmouse</link>
 
1057
                </term>
 
1058
                <listitem>
 
1059
                    <para>Get the current position of the mouse</para>
 
1060
                </listitem>
 
1061
            </varlistentry>
 
1062
        </variablelist>
 
1063
    </refsection>
 
1064
    <refsection>
 
1065
        <title>Interactive editor</title>
 
1066
        <variablelist>
 
1067
            <varlistentry>
 
1068
                <term>
 
1069
                    <link linkend="edit_curv">edit_curv</link>
 
1070
                </term>
 
1071
                <listitem>
 
1072
                    <para>Interactive graphics curve editor</para>
 
1073
                </listitem>
 
1074
            </varlistentry>
 
1075
        </variablelist>
 
1076
    </refsection>
 
1077
    <refsection>
 
1078
        <title>Graphics functions for automatic control</title>
 
1079
        <variablelist>
 
1080
            <varlistentry>
 
1081
                <term>
 
1082
                    <link linkend="bode">bode</link>
 
1083
                </term>
 
1084
                <listitem>
 
1085
                    <para>Bode plot</para>
 
1086
                    <para>
 
1087
                        <emphasis role="bold">Example:</emphasis>
 
1088
                    </para>
 
1089
                    <para>
 
1090
                        <scilab:image>s=poly(0,'s')
 
1091
                            h=syslin('c',(s^2+2*0.9*10*s+100)/(s^2+2*0.3*10.1*s+102.01))
 
1092
                            clf();bode(h,0.01,100);
 
1093
                        </scilab:image>
 
1094
                    </para>
 
1095
                </listitem>
 
1096
            </varlistentry>
 
1097
            <varlistentry>
 
1098
                <term>
 
1099
                    <link linkend="gainplot">gainplot</link>
 
1100
                </term>
 
1101
                <listitem>
 
1102
                    <para>Magnitude plot</para>
 
1103
                    <para>
 
1104
                        <emphasis role="bold">Example:</emphasis>
 
1105
                    </para>
 
1106
                    <para>
 
1107
                        <scilab:image>s=poly(0,'s')
 
1108
                            h1=syslin('c',(s^2+2*0.9*10*s+100)/(s^2+2*0.3*10.1*s+102.01))
 
1109
                            h2=syslin('c',(s^2+2*0.1*15.1*s+228.01)/(s^2+2*0.9*15*s+225))
 
1110
                            clf();gainplot([h1;h2],0.01,100,['h1';'h2'])
 
1111
                            title('Gainplot');
 
1112
                        </scilab:image>
 
1113
                    </para>
 
1114
                </listitem>
 
1115
            </varlistentry>
 
1116
            <varlistentry>
 
1117
                <term>
 
1118
                    <link linkend="nyquist">nyquist</link>
 
1119
                </term>
 
1120
                <listitem>
 
1121
                    <para>Nyquist plot</para>
 
1122
                    <para>
 
1123
                        <emphasis role="bold">Example:</emphasis>
 
1124
                    </para>
 
1125
                    <para>
 
1126
                        <scilab:image>s=poly(0,'s')
 
1127
                            h=syslin('c',(s^2+2*0.9*10*s+100)/(s^2+2*0.3*10.1*s+102.01));
 
1128
                            h1=h*syslin('c',(s^2+2*0.1*15.1*s+228.01)/(s^2+2*0.9*15*s+225))
 
1129
                            nyquist(h1)
 
1130
                            ax=gca();
 
1131
                            h_h=ax.children($).children(2);
 
1132
                            tip=datatipCreate(h_h,[1.331,0.684]);
 
1133
                            datatipSetOrientation(tip,"upper left");
 
1134
                        </scilab:image>
 
1135
                    </para>
 
1136
                </listitem>
 
1137
            </varlistentry>
 
1138
            <varlistentry>
 
1139
                <term>
 
1140
                    <link linkend="m_circle">m_circle</link>
 
1141
                </term>
 
1142
                <listitem>
 
1143
                    <para>M-circle plot</para>
 
1144
                    <para>
 
1145
                        <emphasis role="bold">Example:</emphasis>
 
1146
                    </para>
 
1147
                    <para>
 
1148
                        <scilab:image>m_circle();</scilab:image>
 
1149
                    </para>
 
1150
                </listitem>
 
1151
            </varlistentry>
 
1152
            <varlistentry>
 
1153
                <term>
 
1154
                    <link linkend="chart">chart</link>
 
1155
                </term>
 
1156
                <listitem>
 
1157
                    <para>Nichols chart</para>
 
1158
                    <para>
 
1159
                        <emphasis role="bold">Example:</emphasis>
 
1160
                    </para>
 
1161
                    <para>
 
1162
                        <scilab:image>chart();</scilab:image>
 
1163
                    </para>
 
1164
                </listitem>
 
1165
            </varlistentry>
 
1166
            <varlistentry>
 
1167
                <term>
 
1168
                    <link linkend="black">black</link>
 
1169
                </term>
 
1170
                <listitem>
 
1171
                    <para>Black's diagram</para>
 
1172
                    <para>
 
1173
                        <emphasis role="bold">Example:</emphasis>
 
1174
                    </para>
 
1175
                    <para>
 
1176
                        <scilab:image>s=poly(0,'s');
 
1177
                            sl=syslin('c',5*(1+s)/(.1*s^4+s^3+15*s^2+3*s+1))
 
1178
                            clf();black(sl,0.01,10);
 
1179
                        </scilab:image>
 
1180
                    </para>
 
1181
                </listitem>
 
1182
            </varlistentry>
 
1183
            <varlistentry>
 
1184
                <term>
 
1185
                    <link linkend="evans">evans</link>
 
1186
                </term>
 
1187
                <listitem>
 
1188
                    <para>Evans root locus</para>
 
1189
                    <para>
 
1190
                        <emphasis role="bold">Example:</emphasis>
 
1191
                    </para>
 
1192
                    <para>
 
1193
                        <scilab:image>evans();</scilab:image>
 
1194
                    </para>
 
1195
                </listitem>
 
1196
            </varlistentry>
 
1197
            <varlistentry>
 
1198
                <term>
 
1199
                    <link linkend="sgrid">sgrid</link>
 
1200
                </term>
 
1201
                <listitem>
 
1202
                    <para>s-plane grid lines</para>
 
1203
                    <para>
 
1204
                        <emphasis role="bold">Example:</emphasis>
 
1205
                    </para>
 
1206
                    <para>
 
1207
                        <scilab:image>sgrid();</scilab:image>
 
1208
                    </para>
 
1209
                </listitem>
 
1210
            </varlistentry>
 
1211
            <varlistentry>
 
1212
                <term>
 
1213
                    <link linkend="plzr">plzr</link>
 
1214
                </term>
 
1215
                <listitem>
 
1216
                    <para>pole-zero plot</para>
 
1217
                    <para>
 
1218
                        <emphasis role="bold">Example:</emphasis>
 
1219
                    </para>
 
1220
                    <para>
 
1221
                        <scilab:image>s=poly(0,'s');
 
1222
                            n=[1+s   2+3*s+4*s^2        5; 0        1-s             s];
 
1223
                            d=[1+3*s   5-s^3           s+1;1+s     1+s+s^2      3*s-1];
 
1224
                            h=syslin('c',n./d); 
 
1225
                            plzr(h);
 
1226
                        </scilab:image>
 
1227
                    </para>
 
1228
                </listitem>
 
1229
            </varlistentry>
 
1230
            <varlistentry>
 
1231
                <term>
 
1232
                    <link linkend="zgrid">zgrid</link>
 
1233
                </term>
 
1234
                <listitem>
 
1235
                    <para>zgrid plot</para>
 
1236
                    <para>
 
1237
                        <emphasis role="bold">Example:</emphasis>
 
1238
                    </para>
 
1239
                    <para>
 
1240
                        <scilab:image>zgrid();</scilab:image>
 
1241
                    </para>
 
1242
                </listitem>
 
1243
            </varlistentry>
 
1244
        </variablelist>
 
1245
    </refsection>
1246
1246
</refentry>