<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
<!DOCTYPE MAN SYSTEM "../../manrev.dtd">
<MAN>
  <LANGUAGE>eng</LANGUAGE>
  <TITLE>contourf</TITLE>
  <TYPE>Scilab Function</TYPE>
  <DATE>April 1993</DATE>
  <SHORT_DESCRIPTION name="contourf"> filled level curves of a surface on a 2D plot</SHORT_DESCRIPTION>
  <CALLING_SEQUENCE>
    <CALLING_SEQUENCE_ITEM>contourf(x,y,z,nz,[style,strf,leg,rect,nax])  </CALLING_SEQUENCE_ITEM>
  </CALLING_SEQUENCE>
  <PARAM>
    <PARAM_INDENT>
      <PARAM_ITEM>
        <PARAM_NAME>x,y</PARAM_NAME>
        <PARAM_DESCRIPTION>
          <SP>: two real row vectors of size n1 and n2: the grid.</SP>
        </PARAM_DESCRIPTION>
      </PARAM_ITEM>
      <PARAM_ITEM>
        <PARAM_NAME>z</PARAM_NAME>
        <PARAM_DESCRIPTION>
          <SP>: real matrix of size (n1,n2), the values of the function.</SP>
        </PARAM_DESCRIPTION>
      </PARAM_ITEM>
      <PARAM_ITEM>
        <PARAM_NAME>nz</PARAM_NAME>
        <PARAM_DESCRIPTION>
          <SP>: the level values or the number of levels.</SP>
          <PARAM_INDENT>
            <PARAM_ITEM>
              <PARAM_NAME>-  </PARAM_NAME>
              <PARAM_DESCRIPTION>
                <SP>If <VERB>nz</VERB> is an integer, its value gives the number of level curves  equally spaced from zmin to zmax as follows:</SP>
                <VERBATIM>
<![CDATA[
 z= zmin + (1:nz)*(zmax-zmin)/(nz+1)
   ]]>
                </VERBATIM>
                <P>
    Note that the <VERB>zmin</VERB> and <VERB>zmax</VERB> levels are not drawn  (generically they are reduced to points) but they can be added  with 
  </P>
                <VERBATIM>
<![CDATA[
 [im,jm] = find(z == zmin);     // or zmax 
 plot2d(x(im)',y(jm)',-9,"000")
   ]]>
                </VERBATIM>
              </PARAM_DESCRIPTION>
            </PARAM_ITEM>
            <PARAM_ITEM>
              <PARAM_NAME>-  </PARAM_NAME>
              <PARAM_DESCRIPTION>
                <SP>If <VERB>nz</VERB> is a vector, <VERB>nz(i)</VERB> gives the value of the ith level curve.</SP>
              </PARAM_DESCRIPTION>
            </PARAM_ITEM>
          </PARAM_INDENT>
        </PARAM_DESCRIPTION>
      </PARAM_ITEM>
      <PARAM_ITEM>
        <PARAM_NAME>style,strf,leg,rect,nax</PARAM_NAME>
        <PARAM_DESCRIPTION>
          <SP>: see <VERB>plot2d</VERB>. The argument <VERB>style</VERB> gives the colors which are to be used for level curves. It must have the same size as the number of levels.</SP>
        </PARAM_DESCRIPTION>
      </PARAM_ITEM>
    </PARAM_INDENT>
  </PARAM>
  <DESCRIPTION>
    <P><VERB>contourf</VERB> paints surface between two consecutives level curves of a surface <VERB>z=f(x,y)</VERB> on a 2D plot.
    The values of <VERB>f(x,y)</VERB> are given by the matrix <VERB>z</VERB> at the
    grid points defined by <VERB>x</VERB> and <VERB>y</VERB>.</P>
    <P>
    You can change the format of the floating point number printed on the levels
    by using <VERB>xset(&quot;fpf&quot;,string)</VERB> where <VERB>string</VERB> gives the 
    format in C format syntax (for example <VERB>string=&quot;%.3f&quot;</VERB>). Use 
    <VERB>string=&quot;&quot;</VERB> to switch back to default format.</P>
    <P>
    Enter the command <VERB>contour2d()</VERB> to see a demo.</P>
  </DESCRIPTION>
  <EXAMPLE>
<![CDATA[
contourf(1:10,1:10,rand(10,10),5,1:5,"011"," ",[0,0,11,11])
 ]]>
  </EXAMPLE>
  <SEE_ALSO>
    <SEE_ALSO_ITEM>
      <LINK>contour</LINK>
    </SEE_ALSO_ITEM>
    <SEE_ALSO_ITEM>
      <LINK>fcontour</LINK>
    </SEE_ALSO_ITEM>
    <SEE_ALSO_ITEM>
      <LINK>fcontour2d</LINK>
    </SEE_ALSO_ITEM>
    <SEE_ALSO_ITEM>
      <LINK>contour2di</LINK>
    </SEE_ALSO_ITEM>
    <SEE_ALSO_ITEM>
      <LINK>plot2d</LINK>
    </SEE_ALSO_ITEM>
    <SEE_ALSO_ITEM>
      <LINK>xset</LINK>
    </SEE_ALSO_ITEM>
  </SEE_ALSO>
  <AUTHOR>J.Ph.C.  </AUTHOR>
</MAN>
