<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE MAN SYSTEM "../../manrev.dtd">
<MAN>
  <LANGUAGE>eng</LANGUAGE>

  <TITLE>fec_properties</TITLE>

  <TYPE>Scilab Data type</TYPE>

  <DATE>2002</DATE>

  <SHORT_DESCRIPTION name="fec_properties">description of the fec entities
  properties</SHORT_DESCRIPTION>

  <DESCRIPTION>
    <P>The Fec entity is a leaf of the graphics entities hierarchy. It
    represents 2D finite elements plots (see <VERB>fec</VERB>,
    <VERB>Sgrayplot</VERB>).</P>

    <DESCRIPTION_INDENT>
      <DESCRIPTION_ITEM label="parent: ">
        <SP>This property contains the handle of the parent. The parent of the
        fec entity should be of the type <VERB>"Axes"</VERB> or
        <VERB>"Compound"</VERB>.</SP>
      </DESCRIPTION_ITEM>

      <DESCRIPTION_ITEM label="children: ">
        <SP>This property contains a vector with the <VERB>children</VERB> of
        the handle. However, <VERB>Fec</VERB> handles currently do not have
        any <VERB>children</VERB>.</SP>
      </DESCRIPTION_ITEM>

      <DESCRIPTION_ITEM label="visible: ">
        <SP>This field contains the <VERB>visible</VERB> property value for
        the entity . It should be <VERB>"on" </VERB> or <VERB>"off"</VERB> .
        By default, the plot is visible, the value's property is
        <VERB>"on"</VERB>. If <VERB>"off"</VERB> the plot is not drawn on the
        screen.</SP>
      </DESCRIPTION_ITEM>

      <DESCRIPTION_ITEM label="data: ">
        <SP>This is a three column matrix <VERB>[x,y,f]</VERB>, where
        <VERB>x(i)</VERB> and <VERB>y(i)</VERB> are the coordinates of the
        <VERB>i</VERB>'th node. <VERB>f(i)</VERB> is the value associated to
        the node <VERB>i</VERB>.</SP>
      </DESCRIPTION_ITEM>

      <DESCRIPTION_ITEM label="triangles: ">
        <SP>This is a five column matrix <VERB>[tn,n1,n2,n3,flag]</VERB>.
        <VERB>tn(j)</VERB> is the triangle number. <VERB>n1(j)</VERB>,
        <VERB>n2(j)</VERB> and <VERB>n3(j)</VERB> are the index of the nodes
        which constitute the triangle. (<VERB>flag(j)</VERB> is not
        used).</SP>
      </DESCRIPTION_ITEM>

      <DESCRIPTION_ITEM label="z_bounds: ">
        <SP>This <TT>[zmin,zmax]</TT> vector gives the z values associated
        with the first and the last color (of the current colormap). More
        exactly if the colormap have <TT>nc</TT> colors and if we note <TT>dz
        = (zmax-zmin)/nc</TT>, then the part of the triangulation where
        <TT>zmin + (i-1)dz &lt;= z &lt; zmin + i dz</TT> is filled with the
        color <TT>i</TT>). By default <TT>zmin = min(func)</TT> and <TT>zmax =
        max(func)</TT>. If you want to do an animation with func values that
        varie in time, take for <TT>zmin</TT> and <TT>zmax</TT> the global
        minimum and maximum or something close. </SP>
      </DESCRIPTION_ITEM>

      <DESCRIPTION_ITEM label="user_data: ">
        <SP>This field can be use to store any scilab variable in the fec data
        structure, and to retreive it.</SP>
      </DESCRIPTION_ITEM>
    </DESCRIPTION_INDENT>
  </DESCRIPTION>

  <EXAMPLE><![CDATA[


   set("figure_style","new"); //create a figure

   x=-10:10; y=-10:10;m =rand(21,21);
   Sgrayplot(x,y,m);
   a=get("current_axes");
   f=a.children.children(1)
   f.data(:,3)=(1:size(f.data,1))';
   a.parent.color_map=hotcolormap(64);

 
  ]]></EXAMPLE>

  <SEE_ALSO>
    <SEE_ALSO_ITEM>
      <LINK>set</LINK>
    </SEE_ALSO_ITEM>

    <SEE_ALSO_ITEM>
      <LINK>get</LINK>
    </SEE_ALSO_ITEM>

    <SEE_ALSO_ITEM>
      <LINK>delete</LINK>
    </SEE_ALSO_ITEM>

    <SEE_ALSO_ITEM>
      <LINK>fec</LINK>
    </SEE_ALSO_ITEM>

    <SEE_ALSO_ITEM>
      <LINK>Sgrayplot</LINK>
    </SEE_ALSO_ITEM>

    <SEE_ALSO_ITEM>
      <LINK>graphics_entities</LINK>
    </SEE_ALSO_ITEM>
  </SEE_ALSO>

  <AUTHOR>Djalel ABDEMOUCHE</AUTHOR>
</MAN>