<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
<!DOCTYPE MAN SYSTEM "../../manrev.dtd">
<MAN>
  <LANGUAGE>eng</LANGUAGE>
  <TITLE>pvm_f772sci</TITLE>
  <TYPE>Scilab function</TYPE>
  <DATE>May 1998</DATE>
  <SHORT_DESCRIPTION name="pvm_f772sci"> Convert a F77 complex into a complex scalar</SHORT_DESCRIPTION>
  <CALLING_SEQUENCE>
    <CALLING_SEQUENCE_ITEM>[res] = pvm_f772sci(var)  </CALLING_SEQUENCE_ITEM>
  </CALLING_SEQUENCE>
  <PARAM>
    <PARAM_INDENT>
      <PARAM_ITEM>
        <PARAM_NAME>var : local scilab variable.  On  return, the  variable will  be</PARAM_NAME>
        <PARAM_DESCRIPTION>
          <SP>overwritten with the result  of conversion operation.</SP>
        </PARAM_DESCRIPTION>
      </PARAM_ITEM>
      <PARAM_ITEM>
        <PARAM_NAME>res</PARAM_NAME>
        <PARAM_DESCRIPTION>
          <SP>: if the parameter var is not a variable, the result of the conversion  is returned in res.</SP>
        </PARAM_DESCRIPTION>
      </PARAM_ITEM>
    </PARAM_INDENT>
  </PARAM>
  <DESCRIPTION>
    <P><VERB>pvm_f772sci</VERB> converts all the complex matrices
    contained in the representation of a scilab  variable 
    form a f77 coding to the Scilab complex matrix coding scheme. 
    This can be  useful if Scilab is receiving  data  from  a   non  scilab
    application (directly from a C or F77 program for example).</P>
    <P>
    Note  that  the parameter is passed  by  adress. It  means that if the
    parameter is a  variable, this variable will  be overwritten with  the
    result of conversion operation. On the other case, if the parameter is
    not a variable, the result will be returned in res.</P>
  </DESCRIPTION>
  <EXAMPLE>
<![CDATA[
a = [1+%i, 2+2*%i,3+3*%i];
pvm_f772sci(a)
if norm(a - [1.+2* %i,3.+%i, 2. + 3. *%i ]) >10*%eps then pause;end
 ]]>
  </EXAMPLE>
  <SEE_ALSO>
    <SEE_ALSO_ITEM>
      <LINK>pvm_sci2f77</LINK>
    </SEE_ALSO_ITEM>
  </SEE_ALSO>
</MAN>
