scilab/modules/graphics/help/pt_BR/2d_plot/plot.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!--
   3  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
   4  * Copyright (C) INRIA - Fabrice Leray
   5  * Copyright (C) 2012 - 2016 - Scilab Enterprises
   6  * Copyright (C) 2018 - 2019 - Samuel GOUGEON
   7  *
   8  * This file is hereby licensed under the terms of the GNU GPL v2.0,
   9  * pursuant to article 5.3.4 of the CeCILL v.2.1.
  10  * This file was originally licensed under the terms of the CeCILL v2.1,
  11  * and continues to be available under such terms.
  12  * For more information, see the COPYING file which you should have received
  13  * along with this program.
  14  *
  15  -->
  16 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
  17           xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns4="http://www.w3.org/1999/xhtml"
  18           xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook"
  19           xmlns:scilab="http://www.scilab.org" xml:id="plot" xml:lang="pt">
  20     <refnamediv>
  21         <refname>plot</refname>
  22         <refpurpose>Esboço 2d</refpurpose>
  23     </refnamediv>
  24     <refsynopsisdiv>
  25         <title>Seqüência de Chamamento</title>
  26         <synopsis>
  27             plot     // demo
  28             plot(y)
  29             plot(x, y)
  30             plot(x, fun)
  31             plot(x, list(fun, param))
  32             plot(.., LineSpec)
  33             plot(.., LineSpec, GlobalProperty)
  34             plot(x1, y1, LineSpec1, x2,y2,LineSpec2,...xN, yN, LineSpecN, GlobalProperty1,.. GlobalPropertyM)
  35             plot(x1,fun1,LineSpec1, x2,y2,LineSpec2,...xN,funN,LineSpecN, GlobalProperty1, ..GlobalPropertyM)
  36             plot(logflag,...)
  37             plot(axes_handle,...)
  38         </synopsis>
  39     </refsynopsisdiv>
  40     <refsection role="parameters">
  41         <title>Parâmetros</title>
  42         <variablelist>
  43             <varlistentry>
  44                 <term>x</term>
  45                 <listitem>
  46                     <para>uma matriz ou vetor de reais. Se omitido, é assumido como
  47                         sendo o vetor <literal>1:n</literal> onde <literal>n</literal> é o
  48                         número de pontos de curva dado pelo parâmetro
  49                         <literal>y</literal>.
  50                     </para>
  51                 </listitem>
  52             </varlistentry>
  53             <varlistentry>
  54                 <term>y</term>
  55                 <listitem>
  56                     <para>
  57                         uma matriz de reais ou um vetor.
  58                     </para>
  59                 </listitem>
  60             </varlistentry>
  61             <varlistentry>
  62                 <term>fun, fun1</term>
  63                 <listitem>
  64                     <para>
  65                         função definida como um macro ou uma primitiva, como em
  66                         <literal>plot(x, sin)</literal>
  67                     </para>
  68                     <para>
  69                         If the function to plot needs some parameters as input arguments, the
  70                         function and its parameters can be specified through a list, as in
  71                         <literal>plot(x, list(delip, -0.4))</literal>
  72                     </para>
  73                 </listitem>
  74             </varlistentry>
  75             <varlistentry>
  76                 <term>LineSpec</term>
  77                 <listitem>
  78                     <para>este argumento opcional deve ser usado como um atalho para
  79                         especificar um modo de desenhar uma linha. Podemos ter um
  80                         <literal>LineSpec</literal> por<literal> y</literal> ou
  81                         <literal>{x,y}</literal> previamente entrados. As opções
  82                         <literal>LineSpec</literal> lidam com os especificadores LineStyle,
  83                         Marker e Color (ver <link linkend="LineSpec">LineSpec</link>). Estes
  84                         especificadores determinam o estilo de linha, de marcas e a cor das
  85                         linhas esboçadas.
  86                     </para>
  87                 </listitem>
  88             </varlistentry>
  89             <varlistentry>
  90                 <term>GlobalProperty</term>
  91                 <listitem>
  92                     <para>este argumento opcional representa uma seqüência de pares de
  93                         declarações <literal>{PropertyName,PropertyValue}</literal> tque
  94                         define propriedades globais de objetos a serem aplicadas a todas as
  95                         curvas criadas pelo esboço. Para uma visualização completa de das
  96                         propriedades disponíveis veja <link linkend="GlobalProperty">GlobalProperty</link>.
  97                     </para>
  98                 </listitem>
  99             </varlistentry>
 100             <varlistentry>
 101                 <term>logflag</term>
 102                 <listitem>
 103                     <para>
 104                         "ln" | "nl" | "ll" : 2-character word made of "l" standing for
 105                         "<emphasis role="bold">L</emphasis>ogarithmic" or/and "n" standing for
 106                         "<emphasis role="bold">N</emphasis>ormal". The first character applies to
 107                         the X axis, the second to the Y axis. Hence, "ln" means that the X axis
 108                         is logarithmic and the Y axis is normal. The default is "nn":
 109                         both axes in normal scales.
 110                     </para>
 111                     <para>
 112                         <literal>logflag</literal> must be used after <literal>axes_handle</literal>
 113                         (if any) and before the first curve's data <literal>x</literal> or
 114                         <literal>y</literal> or <literal>fun</literal>.
 115                         It applies to all curves drawn by the <literal>plot(…)</literal> instruction.
 116                     </para>
 117                 </listitem>
 118             </varlistentry>
 119             <varlistentry>
 120                 <term>axes_handle</term>
 121                 <listitem>
 122                     <para>este argumento opcional força o esboço a aparecer dentro dos
 123                         eixos selecionados fornecidos por <literal>axes_handle</literal> ao
 124                         invés dos eixos correntes (ver <link linkend="gca">gca</link>).
 125                     </para>
 126                 </listitem>
 127             </varlistentry>
 128         </variablelist>
 129     </refsection>
 130     <refsection role="description">
 131         <title>Descrição</title>
 132         <para>
 133             <literal>plot</literal> esboça um conjunto de curvas 2d.
 134             <literal>plot</literal> foi reconstruído para lidar melhor com a sintaxe
 135             do Matlab. Para melhorar a compatibilidade gráfica com o Matlab, utilize
 136             <literal>plot</literal> (ao invés de <link linkend="plot2d">plot2d</link>).
 137         </para>
 138         <para>Especificação de entrada de dados:</para>
 139         <para>Neste parágrafo, para sermos mais claros, não mencionaremos os
 140             argumentos opcionais <literal>LineSpec</literal> ou
 141             <literal>GlobalProperty</literal> já que eles não interferem na entrada de
 142             dados (exceto pelas propriedades <literal>"Xdata"</literal>,
 143             <literal>"Ydata"</literal> e <literal>"Zdata"</literal>,
 144             ver <link linkend="GlobalProperty">GlobalProperty</link>). É assumido que todos
 145             estes argumentos podem estar presentes também.
 146         </para>
 147         <para>
 148             Se <literal>y</literal> é um vetor, plot(y) esboça um vetor
 149             <literal>y</literal> versus o vetor
 150             <literal>1:size(y,'*')</literal>.
 151         </para>
 152         <para>
 153             Se <literal>y</literal> é uma matriz, plot(y) esboça cada coluna de
 154             <literal>y</literal> versus o vetor <literal>1:size(y,1)</literal>.
 155         </para>
 156         <para>
 157             Se <literal>x</literal> e <literal>y</literal> são vetores,
 158             plot(x,y) esboça o vetor <literal>y</literal> versus o vetor
 159             <literal>x</literal>. Os vetores <literal>x</literal> e
 160             <literal>y</literal> devem ter o mesmo número de entradas.
 161         </para>
 162         <para>
 163             Se <literal>x</literal> é um vetor e <literal>y</literal> uma matriz
 164             plot(x,y) esboça cada coluna de <literal>y</literal> versus o vetor
 165             <literal>x</literal>. Neste caso, o número de colunas de
 166             <literal>y</literal> deve ser igual ao número de entradas de
 167             <literal>x</literal>.
 168         </para>
 169         <para>
 170             Se <literal>x</literal> e <literal>y</literal> são matrizes,
 171             plot(x,y) esboça cada coluna de <literal>y</literal> versus a coluna
 172             correspondente de <literal>x</literal>. Neste caso, os tamanhos
 173             <literal>x</literal> e <literal>y</literal> devem ser os mesmos.
 174         </para>
 175         <para>
 176             Finalmente, se apenas <literal>x</literal> ou <literal>y</literal> é
 177             uma matriz, o vetor é esboçado versus cada linha ou cada coluna da matriz.
 178             A escolha é feita dependendo se a dimensão de linha ou coluna do vetor
 179             coincide com a dimensão de linha ou coluna da matriz. No caso de uma
 180             matriz quadrada (apenas <literal>x</literal> ou penas
 181             <literal>y</literal>), a prioridade é dada a colunas ao invés de linhas
 182             (ver exemplos abaixo).
 183         </para>
 184         <para>
 185             <literal>y</literal> também pode ser uma função definida como um
 186             macro ou uma primitiva. Neste caso, os dados <literal>x</literal> devem
 187             ser fornecidos (como um vetor ou uma matriz) e a computação correspondente
 188             de <literal>y(x)</literal> é feita implicitamente.
 189         </para>
 190         <para>
 191             Os argumentos <literal>LineSpec</literal> e
 192             <literal>GlobalProperty</literal> devem ser utilizados para customizar o
 193             esboço. Aqui está uma lista completa das opções disponíveis.
 194         </para>
 195         <variablelist>
 196             <varlistentry>
 197                 <term>LineSpec</term>
 198                 <listitem>
 199                     <para>esta opção pode ser utilizada para se especificar, de um modo
 200                         curto e fácil, como as curvas são desenhadas. Deve sempre ser um
 201                         string contendo referências aos especificadores LineStyle, Marker e
 202                         Color.
 203                     </para>
 204                     <para>Essas referências devem ser ajustadas denro do string (a ordem
 205                         não é importante) de modo a não ter ambigüidades. Por exemplo, para
 206                         especificar uma linha vermelha de traço longo com marcas de rombos,
 207                         pode-se escrever : <literal>'r--d'</literal> ou
 208                         <literal>'--dire'</literal> ou <literal>'--reddiam'</literal> ou
 209                         outra sentença sem ambigüidade... ou de modo completo
 210                         <literal>'diamondred--'</literal> (ver <link linkend="LineSpec">LineSpec</link>).
 211                     </para>
 212                     <para>Note que os estilos de linha e marcas (e tamanhos) e as cores,
 213                         podem ser (re*)ajustados através das propriedades da entidade
 214                         poligonal (ver <link linkend="polyline_properties">polyline_properties</link>).
 215                     </para>
 216                 </listitem>
 217             </varlistentry>
 218             <varlistentry>
 219                 <term>GlobalProperty</term>
 220                 <listitem>
 221                     <para>esta opção pode ser utilizada para especificar como as linhas
 222                         serão desenhadas com mais opções que via
 223                         <literal>LineSpec</literal>. Deve sempre ser um par de declarações
 224                         constituidos de um string definindo <literal>PropertyName</literal>,
 225                         (nome da propriedade) e seu valor associado
 226                         <literal>PropertyValue</literal> (que pode ser um string, um inteiro
 227                         ou qualquer outra coisa... dependendo do tipo de
 228                         <literal>PropertyName</literal>). Utilizando-se
 229                         <literal>GlobalProperty</literal>, pode-se ajustar várias
 230                         propriedades : todas as propriedades disponíveis via LineSpec e
 231                         mais: a cor da marca (plano de fundo e primeiro plano), a
 232                         visibilidade, o recorte e a espessura das curvas.
 233                         (ver <link linkend="GlobalProperty">GlobalProperty</link>)
 234                     </para>
 235                     <para>
 236                         Note que todas as propriedades podem ser (re-)ajustadas
 237                         através das propriedades de entidades poligonais
 238                         (ver <link linkend="polyline_properties">polyline_properties</link>).
 239                     </para>
 240                 </listitem>
 241             </varlistentry>
 242         </variablelist>
 243     </refsection>
 244     <refsection role="description">
 245         <title>Observações </title>
 246         <para>Por padrão, esboços sucessivos são superpostos. Para limpar o esboço
 247             anterior, use <literal>clf()</literal>. Para habilitar o modo
 248             <literal>auto_clear</literal> (limpeza automática) como modo padrão, edite
 249             seus eixos fazendo o seguinte:
 250         </para>
 251         <para>da=gda();</para>
 252         <para>da.auto_clear = 'on'</para>
 253         <para>
 254             Para uma melhor exibição, a função <literal>plot</literal> pode
 255             modificar a propriedade <literal>box</literal> de seu Axes (eixos) raíze.
 256             Isto acontece quando uma entidade Axes é criada por uma chamada a
 257             <literal>plot</literal> ou é vazia antes da chamada. Se um dos eixos é
 258             centrado na origem, box é desabilitado. Em caso contrário, box é
 259             habilitado.
 260         </para>
 261         <para>Para mais informações sobre a propriedade box e sobre o
 262             posicionamento dos eixos, veja <link linkend="axes_properties">axes_properties</link>
 263         </para>
 264         <para>Uma tabela de cores padrão é utilizada para colorir as curvas
 265             esboçadas quando você não especifica as cores. Ao desenhar linhas
 266             múltiplas, o comando plot automaticamente atribui as cores abaixo de modo
 267             cíclico. Aqui estão as cores utilizadas:
 268         </para>
 269         <informaltable border="1">
 270             <tr>
 271                 <th> <literal>R</literal> </th>
 272                 <th> <literal>G</literal> </th>
 273                 <th> <literal>B</literal> </th>
 274             </tr>
 275             <tr> <td>0.</td>   <td>0.</td>   <td>1.</td>   </tr>
 276             <tr> <td>0.</td>   <td>0.5</td>  <td>0.</td>   </tr>
 277             <tr> <td>1.</td>   <td>0.</td>   <td>0.</td>   </tr>
 278             <tr> <td>0.</td>   <td>0.75</td> <td>0.75</td> </tr>
 279             <tr> <td>0.75</td> <td>0.</td>   <td>0.75</td> </tr>
 280             <tr> <td>0.75</td> <td>0.75</td> <td>0.</td>   </tr>
 281             <tr> <td>0.25</td> <td>0.25</td> <td>0.25</td> </tr>
 282         </informaltable>
 283         <para/>
 284         <para>
 285             Entre com o comando <literal>plot</literal> para visualizar uma
 286             demonstração.
 287         </para>
 288     </refsection>
 289     <refsection role="examples">
 290         <title>Exemplos</title>
 291         <para>
 292             <emphasis role="bold">Choosing the normal or logarithmic plotting mode:</emphasis>
 293         </para>
 294         <programlisting role="example"><![CDATA[
 295 gda().grid = [1 1]*color("grey70");
 296 title(gda(), "fontsize", 3, "color", "lightseagreen", "fontname", "helvetica bold");
 297
 298 x = linspace(1e-1,100,1000);
 299 xm = 35;
 300 dx = 17;
 301 G = exp(-((x-xm)/dx).^2/2)*30;
 302
 303 scf(1); clf
 304 subplot(2,2,1), plot(x, G),       title("plot(x, y)")
 305 subplot(2,2,2), plot("ln", x, G), title("semilog-x : plot(""ln"", x, y)"); gca().sub_ticks(1) = 8;
 306 subplot(2,2,3), plot("nl", x, G), title("semilog-y : plot(""nl"", x, y)"); gca().sub_ticks(2) = 8;
 307 subplot(2,2,4), plot("ll", x, G), title("loglog : plot(""ll"", x, y)");    gca().sub_ticks = [8 8];
 308
 309 sda();
 310  ]]></programlisting>
 311         <scilab:image>
 312             gda().grid = [1 1]*color("grey70");
 313             title(gda(), "", "fontsize", 3, "color", "lightseagreen", "fontname", "helvetica bold");
 314
 315             x = linspace(1e-1,100,1000);
 316             xm = 35;
 317             dx = 17;
 318             G = exp(-((x-xm)/dx).^2/2)*30;
 319             scf(1); clf
 320             subplot(2,2,1), plot(x, G),       title("plot(x, y)")
 321             subplot(2,2,2), plot("ln", x, G), title("semilog-x : plot(""ln"", x, y)")
 322             gca().sub_ticks(1) = 8;
 323             subplot(2,2,3), plot("nl", x, G), title("semilog-y : plot(""nl"", x, y)")
 324             gca().sub_ticks(2) = 8;
 325             subplot(2,2,4), plot("ll", x, G), title("loglog : plot(""ll"", x, y)")
 326             gca().sub_ticks = [8 8];
 327
 328             gcf().axes_size = [750 520];
 329             sda();
 330         </scilab:image>
 331         <para/>
 332         <para>
 333             <emphasis role="bold">Simple plot of a single curve:</emphasis>
 334         </para>
 335         <programlisting role="example"><![CDATA[
 336 // Default abscissae = indices
 337 subplot(1,2,1)
 338 plot(sin(0:0.1:2*%pi))
 339 xlabel("x indices")
 340
 341 // With explicit abscissae:
 342 x = [0:0.1:2*%pi]';
 343 subplot(1,2,2)
 344 plot(x, sin(x))
 345 xlabel("Specified abscissae")
 346  ]]></programlisting>
 347         <scilab:image>
 348             // Default abscissae = indices
 349             subplot(1,2,1)
 350             plot(sin(0:0.1:2*%pi))
 351             xlabel("x indices")
 352
 353             // With explicit abscissae:
 354             x = [0:0.1:2*%pi]';
 355             subplot(1,2,2)
 356             plot(x, sin(x))
 357             xlabel("Specified abscissae")
 358
 359             gcf().axes_size = [700 350];
 360         </scilab:image>
 361         <para>
 362             <emphasis role="bold">Multiple curves with shared abscissae:</emphasis>
 363             Y: 1 column = 1 curve:
 364         </para>
 365         <programlisting role="example"><![CDATA[
 366 clf
 367 x = [0:0.1:2*%pi]';
 368 plot(x, [sin(x) sin(2*x) sin(3*x)])
 369  ]]></programlisting>
 370         <scilab:image>
 371             x=[0:0.1:2*%pi]';
 372             plot(x,[sin(x) sin(2*x) sin(3*x)])
 373
 374             gcf().axes_size = [700 350];
 375         </scilab:image>
 376         <para>
 377             <emphasis role="bold">
 378                 Specifying a macro or a builtin instead of explicit ordinates:
 379             </emphasis>
 380         </para>
 381         <programlisting role="example"><![CDATA[
 382 clf
 383 subplot(2,2,1)         // sin() is a builtin
 384 plot(1:0.1:10, sin)    // <=> plot(1:0.1:10, sin(1:0.1:10))
 385 title("plot(x, sin)", "fontsize",3)
 386
 387 // with a macro:
 388 deff('y = myFun(x)','y = x + rand(x)')
 389 subplot(2,2,2)
 390 plot(-3:0.1:5, myFun)
 391 title("plot(x, myFun)", "fontsize",3)
 392
 393 // With functions with parameters:
 394 subplot(2,2,3)
 395 plot(1:0.05:7, list(delip, -0.4))  // <=> plot(1:0.05:7, delip(1:0.05:7,-0.4) )
 396 title("plot(x, list(delip,-0.4))", "fontsize",3)
 397
 398 function Y = myPow(x,p)
 399     [X,P] = ndgrid(x,p);
 400     Y = X.^P;
 401     m = max(abs(Y),"r");
 402     for i = 1:size(Y,2)
 403         Y(:,i) = Y(:,i)/m(i);
 404     end
 405 endfunction
 406 x = -5:0.1:6;
 407 subplot(2,2,4)
 408 plot(x, list(myPow,1:5))
 409 title("plot(x, list(myPow,1:5))", "fontsize",3)
 410  ]]></programlisting>
 411         <scilab:image><![CDATA[
 412             subplot(2,2,1)         // sin() is a builtin
 413             plot(1:0.1:10, sin)    // <=> plot(1:0.1:10, sin(1:0.1:10))
 414             title("plot(x,sin)", "fontsize",3)
 415
 416             // with a macro:
 417             deff('y = myFun(x)','y = x + rand(x)')
 418             subplot(2,2,2)
 419             plot(-3:0.1:5, myFun)
 420             title("plot(x, myFun)", "fontsize",3)
 421
 422             // With functions with parameters:
 423             subplot(2,2,3)
 424             plot(1:0.05:7, list(delip, -0.4))  // <=> plot(1:0.05:7, delip(1:0.05:7,-0.4) )
 425             title("plot(x, list(delip,-0.4))", "fontsize",3)
 426
 427             function Y = myPow(x,p)
 428                 [X,P] = ndgrid(x,p);
 429                 Y = X.^P;
 430                 m = max(abs(Y),"r");
 431                 for i = 1:size(Y,2)
 432                     Y(:,i) = Y(:,i)/m(i);
 433                 end
 434             endfunction
 435             x = -5:0.1:6;
 436             subplot(2,2,4)
 437             plot(x, list(myPow,1:5))
 438             title("plot(x, list(myPow,1:5))", "fontsize",3)
 439
 440             gcf().axes_size = [730 500];
 441         ]]></scilab:image>
 442         <para>
 443         <emphasis role="bold">Setting curves simple styles when calling plot():</emphasis>
 444         </para>
 445         <programlisting role="example"><![CDATA[
 446 clf
 447 t = -%pi:%pi/20:2*%pi;
 448 // sin() : in Red, with O marks, without line
 449 // cos() : in Green, with + marks, with a solid line
 450 // gaussian: in Blue, without marks, with dotted line
 451 gauss = 1.5*exp(-(t/2-1).^2)-1;
 452
 453 plot(t,sin,'ro', t,cos,'g+-', t,gauss,':b')
 454  ]]></programlisting>
 455         <scilab:image><![CDATA[
 456             t = -%pi:%pi/20:2*%pi;
 457             // sin() : in Red, with O marks, without line
 458             // cos() : in Green, with + marks, with a solid line
 459             // gaussian: in Blue, without marks, with dotted line
 460             gauss = 1.5*exp(-(t/2-1).^2)-1;
 461
 462             plot(t,sin,'ro', t,cos,'g+-', t,gauss,':b')
 463
 464             gcf().axes_size = [800 400];
 465         ]]>
 466         </scilab:image>
 467         <para>
 468         Vertical segments between two curves, with automatic colors, and using Global properties
 469         for markers styles. Targeting a defined axes.
 470         </para>
 471         <programlisting role="example"><![CDATA[
 472 clf
 473 subplot(1,3,3)
 474 ax3 = gca();         // We will draw here later
 475 xsetech([0 0 0.7 1]) // Defines the first Axes area
 476 t = -3:%pi/20:7;
 477 // Tuning markers properties
 478 plot([t ;t],[sin(t) ;cos(t)],'marker','d','markerFaceColor','green','markerEdgeColor','yel')
 479
 480 // Targeting a defined axes
 481 plot(ax3, t, sin)
 482  ]]></programlisting>
 483         <scilab:image><![CDATA[
 484             clf
 485             subplot(1,3,3)
 486             ax3 = gca();         // We will draw here later
 487             xsetech([0 0 0.7 1]) // Defines the first Axes area
 488             t = -3:%pi/20:7;
 489             // Tuning markers properties
 490             plot([t ;t],[sin(t) ;cos(t)],'marker','d','markerFaceColor','green','markerEdgeColor','yel')
 491
 492             // Targeting a defined axes
 493             plot(ax3, t, sin)
 494
 495             gcf().axes_size = [800 400];
 496         ]]>
 497         </scilab:image>
 498         <para/>
 499         <para/>
 500         <para>
 501             <emphasis role="bold">Case of a non-square Y matrix:</emphasis>
 502             When it is consistent and required, X or/and Y data are
 503             automatically transposed in order to become plottable.
 504         </para>
 505         <programlisting role="example"><![CDATA[
 506 clf()
 507 x = [5 6 7 8]
 508 y = [1   1   1   1   8
 509      2   3   4   5   9
 510      3   4   5   6  10
 511      4   5   6   7  12];
 512
 513 // Only one matching possibility case: how to make 4 identical plots in 4 manners...
 514 // x is 1x4 (vector) and y is 4x5 (non square matrix)
 515 subplot(221); plot(x', y , "o-");    // OK as is
 516 subplot(222); plot(x , y , "o-");    // x is transposed
 517 subplot(223); plot(x', y', "o-");    // y is transposed
 518 subplot(224); plot(x , y', "o-");    // x and y are transposed
 519  ]]></programlisting>
 520         <scilab:image>
 521             x = [5 6 7 8]
 522             y = [1   1   1   1   8
 523                  2   3   4   5   9
 524                  3   4   5   6  10
 525                  4   5   6   7  12];
 526
 527             // Only one matching possibility case: how to make 4 identical plots in 4 manners...
 528             // x is 1x4 (vector) and y is 4x5 (non square matrix)
 529             subplot(221); plot(x', y , "o-");    // OK as is
 530             subplot(222); plot(x , y , "o-");    // x is transposed
 531             subplot(223); plot(x', y', "o-");    // y is transposed
 532             subplot(224); plot(x , y', "o-");    // x and y are transposed
 533         </scilab:image>
 534         <para>
 535             <emphasis role="bold">Case of a square Y matrix, and X implicit or square:</emphasis>
 536         </para>
 537         <programlisting role="example"><![CDATA[
 538 clf
 539 t = [1   1   1   1
 540      2   3   4   5
 541      3   4   5   6
 542      4   5   6   7];
 543
 544 subplot(231), plot(t,"o-") , title("plot(t)",  "fontsize",3)
 545 subplot(234), plot(t',"o-"), title("plot(t'')", "fontsize",3)
 546
 547 subplot(232), plot(t,t,"o-") , title("plot(t, t)",  "fontsize",3)
 548 subplot(233), plot(t,t',"o-"), title("plot(t,t'')", "fontsize",3)
 549
 550 subplot(235), plot(t', t,"o-"),  title("plot(t'', t)",   "fontsize",3)
 551 subplot(236), plot(t', t',"o-"), title("plot(t'', t'')", "fontsize",3)
 552
 553 for i=1:6, gcf().children(i).data_bounds([1 3]) = 0.5; end
 554  ]]></programlisting>
 555         <scilab:image>
 556             clf
 557             t = [1   1   1   1
 558                  2   3   4   5
 559                  3   4   5   6
 560                  4   5   6   7];
 561
 562             subplot(231), plot(t,"o-") , title("plot(t)",  "fontsize",3)
 563             subplot(234), plot(t',"o-"), title("plot(t'')", "fontsize",3)
 564
 565             subplot(232), plot(t,t,"o-") , title("plot(t, t)",  "fontsize",3)
 566             subplot(233), plot(t,t',"o-"), title("plot(t,t'')", "fontsize",3)
 567
 568             subplot(235), plot(t', t,"o-"),  title("plot(t'', t)",   "fontsize",3)
 569             subplot(236), plot(t', t',"o-"), title("plot(t'', t'')", "fontsize",3)
 570
 571             for i=1:6, gcf().children(i).data_bounds([1 3]) = 0.5; end
 572
 573             gcf().axes_size = [800 450];
 574         </scilab:image>
 575         <para>
 576             <emphasis role="bold">Special cases of a matrix X and a vector Y:</emphasis>
 577         </para>
 578         <programlisting role="example"><![CDATA[
 579 clf
 580 X = [1   1   1   1
 581      2   3   4   5
 582      3   4   5   6
 583      4   5   6   7];
 584 y = [1 2 3 4];
 585
 586 subplot(221), plot(X, y,  "o-"), title("plot(X, row)",  "fontsize",3)
 587         // equivalent to plot(t, [1 1 1 1; 2 2 2 2; 3 3 3 3; 4 4 4 4])
 588 subplot(223), plot(X, y', "o-"), title("plot(X, col)  (row = col'')",  "fontsize",3)
 589 subplot(222), plot(X',y,  "o-"), title("plot(X'', row)",  "fontsize",3)
 590 subplot(224), plot(X',y', "o-"), title("plot(X'', col)  (row = col'')",  "fontsize",3)
 591
 592 for i = 1:4, gcf().children(i).data_bounds([1 3]) = 0.5; end
 593  ]]></programlisting>
 594         <scilab:image>
 595             clf
 596             X = [1   1   1   1
 597                  2   3   4   5
 598                  3   4   5   6
 599                  4   5   6   7];
 600             y = [1 2 3 4];
 601
 602             subplot(221), plot(X, y,  "o-"), title("plot(X, row)",  "fontsize",3)
 603                     // equivalent to plot(t, [1 1 1 1; 2 2 2 2; 3 3 3 3; 4 4 4 4])
 604             subplot(223), plot(X, y', "o-"), title("plot(X, col)  (row = col'')",  "fontsize",3)
 605             subplot(222), plot(X',y,  "o-"), title("plot(X'', row)",  "fontsize",3)
 606             subplot(224), plot(X',y', "o-"), title("plot(X'', col)  (row = col'')",  "fontsize",3)
 607
 608             for i = 1:4, gcf().children(i).data_bounds([1 3]) = 0.5; end
 609         </scilab:image>
 610         <para/>
 611         <para>
 612             <emphasis role="bold">Post-tuning Axes and curves:</emphasis>
 613         </para>
 614         <programlisting role="example"><![CDATA[
 615 x=[0:0.1:2*%pi]';
 616 plot(x-4,sin(x),x+2,cos(x))
 617
 618 // axis centered at (0,0)
 619 a=gca(); // Handle on axes entity
 620 a.x_location = "origin";
 621 a.y_location = "right";
 622 isoview on
 623
 624 // Some operations on entities created by plot ...
 625 a.children // list the children of the axes : here it is an Compound child composed of 2 entities
 626 poly1= a.children.children(2); //store polyline handle into poly1
 627 poly1.foreground = 4;  // another way to change the style...
 628 poly1.thickness = 3;   // ...and the thickness of a curve.
 629 poly1.clip_state='off' // clipping control
 630 isoview off
 631  ]]></programlisting>
 632         <scilab:image>
 633             x = [0:0.1:2*%pi]';
 634             plot(x-4,sin(x),x+2,cos(x))
 635             a = gca();
 636             a.x_location = "origin";
 637             a.y_location = "origin";
 638             isoview on
 639             a.children
 640             poly1 = a.children.children(2);
 641             poly1.foreground = 4;
 642             poly1.thickness = 3;
 643             poly1.clip_state='off'
 644             isoview off
 645         </scilab:image>
 646     </refsection>
 647     <refsection role="see also">
 648         <title>Ver Também</title>
 649         <simplelist type="inline">
 650             <member>
 651                 <link linkend="plot2d">plot2d</link>
 652             </member>
 653             <member>
 654                 <link linkend="plot2d2">plot2d2</link>
 655             </member>
 656             <member>
 657                 <link linkend="plot2d3">plot2d3</link>
 658             </member>
 659             <member>
 660                 <link linkend="plot2d4">plot2d4</link>
 661             </member>
 662             <member>
 663                 <link linkend="param3d">param3d</link>
 664             </member>
 665             <member>
 666                 <link linkend="surf">surf</link>
 667             </member>
 668             <member>
 669                 <link linkend="scf">scf</link>
 670             </member>
 671             <member>
 672                 <link linkend="clf">clf</link>
 673             </member>
 674             <member>
 675                 <link linkend="xdel">xdel</link>
 676             </member>
 677             <member>
 678                 <link linkend="delete">delete</link>
 679             </member>
 680             <member>
 681                 <link linkend="LineSpec">LineSpec</link>
 682             </member>
 683             <member>
 684                 <link linkend="color_list">Cores nomeadas</link>
 685             </member>
 686             <member>
 687                 <link linkend="GlobalProperty">GlobalProperty</link>
 688             </member>
 689         </simplelist>
 690     </refsection>
 691     <refsection role="history">
 692         <title>Histórico</title>
 693         <revhistory>
 694             <revision>
 695                 <revnumber>6.0.1</revnumber>
 696                 <revdescription>
 697                     The "color"|"foreground", "markForeground", and "markBackground" GlobalProperty
 698                     colors can now be chosen among the full predefined colors list, or by
 699                     their "#RRGGBB" hexadecimal codes, or by their indices in the colormap.
 700                 </revdescription>
 701             </revision>
 702             <revision>
 703                 <revnumber>6.0.2</revnumber>
 704                 <revdescription>
 705                     Plotting a function fun(x, params) with input parameters is now possible with
 706                     plot(x, list(fun, params)).
 707                 </revdescription>
 708             </revision>
 709             <revision>
 710                 <revnumber>6.1.0</revnumber>
 711                 <revdescription>
 712                     logflag option added.
 713                 </revdescription>
 714             </revision>
 715         </revhistory>
 716     </refsection>
 717 </refentry>