<?xml version="1.0" encoding="ISO-8859-1"?>
<!--
 * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
 * Copyright (C) INRIA
 * 
 * This file must be used under the terms of the CeCILL.
 * This source file is licensed as described in the file COPYING, which
 * you should have received as part of this distribution.  The terms
 * are also available at    
 * http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
 *
 -->
<refentry version="5.0-subset Scilab" xml:id="fec" xml:lang="en"
          xmlns="http://docbook.org/ns/docbook"
          xmlns:xlink="http://www.w3.org/1999/xlink"
          xmlns:svg="http://www.w3.org/2000/svg"
          xmlns:ns4="http://www.w3.org/1999/xhtml"
          xmlns:mml="http://www.w3.org/1998/Math/MathML"
          xmlns:db="http://docbook.org/ns/docbook">
  <info>
    <pubdate>$LastChangedDate$</pubdate>
  </info>

  <refnamediv>
    <refname>fec</refname>

    <refpurpose>Esboo pseudo-colorido triangular de uma funo definida por
    uma malha triangular</refpurpose>
  </refnamediv>

  <refsynopsisdiv>
    <title>Seqncia de Chamamento</title>

    <synopsis>fec(x,y,triangles,func,&lt;opt_args&gt;)
fec(x,y,triangles,func,[strf,leg,rect,nax,zminmax,colminmax,colout,mesh])</synopsis>
  </refsynopsisdiv>

  <refsection>
    <title>Parmetros</title>

    <variablelist>
      <varlistentry>
        <term>x,y</term>

        <listitem>
          <para>dois vetores de tamanho <literal>n</literal>,
          <literal>(x(i),y(i))</literal> fornece as coordenadas do n
          <literal>i</literal></para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>func</term>

        <listitem>
          <para>vetor de tamanho <literal>n</literal> :
          <literal>func(i)</literal> fornece o valor no n
          <literal>i</literal> da funo para a qual queremos o esboo
          pseudo-colorido.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>triangles</term>

        <listitem>
          <para> uma matriz <literal>[Ntr,5]</literal>. Cada linha de
          <literal>triangles</literal> especifica um tringulo da malha
          <literal>triangle(j) = [number,node1,node2,node3,flag]</literal>.
          <literal>node1,node2,node3</literal> so os nmeros dos ns que
          constituem o tringulo. number  o nmero do tringulo e flag  um
          inteiro que no  usado na funo fec </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>&lt;opt_args&gt;</term>

        <listitem>
          <para>representa uma seqncia de declaraes <literal>key1=value1,
          key2=value2</literal>,... onde <literal>key1</literal>,
          <literal>key2,...</literal> podem ser um dos seguintes: strf, leg,
          rect, nax, zminmax, colminmax, colout, mesh (ver <link
          linkend="plot2d">plot2d</link> para os quatro primeiros). </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>strf,leg,rect,nax</term>

        <listitem>
          <para>ver plot2d</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>zminmax</term>

        <listitem>
          <para>vetor com dois compontentes[zmin zmax] (til para animaes em
          particular)</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>colminmax</term>

        <listitem>
          <para>vetor de dois inteiros positivos [colmin colmax] </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>colout</term>

        <listitem>
          <para>vetor de dois inteiros [under_min_col upper_max_col] </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>mesh</term>

        <listitem>
          <para>escalar booleano, valor padro %f (deve ser verdadeiro se voc
          tambm quiser exibir a malha)</para>
        </listitem>
      </varlistentry>
    </variablelist>
  </refsection>

  <refsection>
    <title>Descrio</title>

    <para>Esta funo  boa para se desenhar solues de elementos finitos
    triangulares lineares ou simplesmente para se exibir uma funo definida
    sobre uma triangularizao. A interpolao de cores  feita atravs de um
    software de computao e, portanto, no  to rpida.</para>

    <para>A funo <link linkend="colorbar">colorbar</link> pode se utilizada
    para se visualizar a escala de cores (ver a seo de exemplos).</para>

    <para>O argumento <literal>zminmax</literal> fornece os valores de z
    asosicados s primeira e ltimas cores (do mapa de cores corrente). Mais
    exatamente, se o mapa de cores possue nc cores e se notarmos <emphasis>dz
    = (zmax-zmin)/nc</emphasis>, ento a parte da triangularizao onde
    <emphasis>zmin + (i-1)dz &lt;= z &lt; zmin + i dz</emphasis>  preenchida
    com a cor <emphasis>i</emphasis>). Por padro <emphasis>zmin =
    min(func)</emphasis> e <emphasis>zmax = max(func)</emphasis>. Se voc
    quiser uma animao com valores da funo que variam no tempo, tome para
    zmin e zmax os valores mximo e mnimo globais ou algo prximo.</para>

    <para>O argumento <literal>colout</literal> permite que o usurio escolha
    as cores para as duas regies extremas <emphasis>{func &lt;
    zmin}</emphasis> and <emphasis>{func &gt; zmax}</emphasis>,
    <literal>under_min_col</literal> e <literal>upper_max_col</literal> podem
    ser iguais (independentemente) a: </para>

    <variablelist>
      <varlistentry>
        <term>-1</term>

        <listitem>
          <para>neste caso a mesma cor que a zona de vizinhana  utilizada
          (CUIDADO: voc no v que o limite correspondente  cruzado), este 
          o caso padro. </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>0</term>

        <listitem>
          <para>neste caso, a regio de extremidade no  pintanda. </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>k</term>

        <listitem>
          <para>(k sendo um ndice de cor vlido no mapa de cores corrente) a
          regio de extremidade  pintada com a cor k. </para>
        </listitem>
      </varlistentry>
    </variablelist>

    <para>Se voc no quiser usar o mapa de cores completo, voc pode utilizar
    o argumento <emphasis>1 &lt;= colmin &lt; colmax &lt;= nc</emphasis> (nc
    sendo o nmero de cores do mapa de cores corrente) para utilizar apenas a
    sub-parte [colmin,colmax] do mapa de cores. (por padro, todas as cores do
    mapa de cores so utilizadas). </para>

    <para>Ver arquivos de demonstrao <literal>demos/fec</literal>:</para>

    <para><literal>fec.ex1</literal>  um simples arquivo de exemplo no qual
    uma malha e uma funo sobre esta malha  completamente construda em
    sintaxe do Scilab</para>

    <para><literal>fec.ex2</literal>  um exemplo no qual a malha e os valores
    da funo foram computados por um construtor de malhas externo (malha do
    tipo amdba) e um programa externo. Um conjunto de macros ( fornecido pelo
    arquivo <literal>macros.sci</literal>) pode ser utilizado para ler os
    arquivos de dados no Scilab e esboar os resultados.</para>
  </refsection>

  <refsection>
    <title>Exemplos</title>

    <programlisting role="example"><![CDATA[ 
// definindo uma mini-triangularizao (4 vrtices, 2 tringulos)
x = [0 1 0 -1];
y = [0 0 1  1];
T = [1 1 2 3 1;
     2 3 4 1 1];
z = [0 1 0 -1];  // valores da funo em cada vrtice
xbasc()
xset("colormap",jetcolormap(64))
subplot(1,2,1)
   colorbar(-1,1)
   fec(x,y,T,z,strf="040",mesh=%t)
   xtitle("exemplo de fec (com a malha)")
subplot(1,2,2)
   colorbar(-1,1)
   fec(x,y,T,z,strf="040")  // rmq: mesh=%f por padro
   xtitle("exemplo de fec (em a malha)")
xselect()

// este exemplo mostra o efeito de zminmax e usa os
// dados de exemplos anteriores (voc tem que execut-los primeiro)
xbasc()
xset("colormap",jetcolormap(64))
colorbar(-0.5,0.5)  // cuidado, a barra de cores deve ser ajustada na mo!
fec(x,y,T,z,strf="040", zminmax=[-0.5 0.5], mesh=%t)
xtitle("exemplo de fec: utilizando o argumento zminmax")
xselect()

// este exemplo mostra os efeitos de zminmax e colout. Utiliza
// tambm os dados de exemplos anteriores (voc tem que execut-los primeiro)
xbasc()
xset("colormap",jetcolormap(64))
subplot(2,2,1)
   colorbar(-0.5,0.5)
   fec(x,y,T,z,strf="040", zminmax=[-0.5 0.5], colout=[0 0], mesh=%t)
   xtitle("exemplo de fec: utilizando zminmax e colout =[0 0]")
subplot(2,2,2)
   colorbar(-0.5,0.5)
   fec(x,y,T,z,strf="040", zminmax=[-0.5 0.5], colout=[32 32], mesh=%t)
   xtitle("exemplo de fec : utilizando zminmax e colout =[32 32]")
subplot(2,2,3)
   colorbar(-0.5,0.5)
   fec(x,y,T,z,strf="040", zminmax=[-0.5 0.5], colout=[-1 0], mesh=%t)
   xtitle("exemplo de fec : utilizando zminmax e colout =[-1 0]")
subplot(2,2,4)
   colorbar(-0.5,0.5)
   fec(x,y,T,z,strf="040", zminmax=[-0.5 0.5], colout=[0 -1], mesh=%t)
   xtitle("exemplo de fec: utilizando zminmax e colout =[0 -1]")
xselect()

// este exemplo mostra um recurso de colminmax:
// utilizando dois mapas de cores para dois subesboos.
// Tambm utiliza dados de exemplos anteriores.
xbasc()
xset("colormap",[hotcolormap(64);jetcolormap(64)])
subplot(1,2,1)
   colorbar(-1,1,[1 64])
   fec(x,y,T,z,strf="040", colminmax=[1 64], mesh=%t)
   xtitle("fec utilizando mapa de cores hot ")
subplot(1,2,2)
   colorbar(-1,1,[65 128])
   fec(x,y,T,z,strf="040", colminmax=[65 128], mesh=%t)
   xtitle("fec utilizando mapa de cores jet ")
xselect()
 ]]></programlisting>
  </refsection>

  <refsection>
    <title>Ver Tambm</title>

    <simplelist type="inline">
      <member><link linkend="colorbar">colorbar</link></member>

      <member><link linkend="Sfgrayplot">Sfgrayplot</link></member>

      <member><link linkend="Sgrayplot">Sgrayplot</link></member>
    </simplelist>
  </refsection>
</refentry>