<?xml version="1.0" encoding="UTF-8"?>
<refentry version="5.0-subset Scilab" xml:id="gf_util" xml:lang="en"
          xmlns="http://docbook.org/ns/docbook"
          xmlns:xlink="http://www.w3.org/1999/xlink"
          xmlns:xi="http://www.w3.org/2001/XInclude"
          xmlns:svg="http://www.w3.org/2000/svg"
          xmlns:mml="http://www.w3.org/1998/Math/MathML"
          xmlns:html="http://www.w3.org/1999/xhtml"
          xmlns:db="http://docbook.org/ns/docbook">
  <refnamediv>
    <refname>gf_util</refname>
    <refpurpose>  Performs various operations which do not fit elsewhere.
</refpurpose>
  </refnamediv>

  <refsynopsisdiv>
    <title>Calling Sequence</title>

    <synopsis>gf_util('save matrix', string FMT, string FILENAME, mat A)</synopsis>
    <synopsis>A = gf_util('load matrix', string FMT, string FILENAME)</synopsis>
    <synopsis>tl = gf_util('trace level' [, int level])</synopsis>
    <synopsis>tl = gf_util('warning level', int level)</synopsis>
  </refsynopsisdiv>

  <refsection>
    <title>Description</title>
    <para>  Performs various operations which do not fit elsewhere.
</para>
  </refsection>

  <refsection>
    <title>Command list</title>

    <itemizedlist>
    <listitem>
    <para><literal>gf_util('save matrix', string FMT, string FILENAME, mat A)</literal></para>

    <para>       Exports a sparse matrix into the file named FILENAME, using
    Harwell-Boeing (FMT='hb') or Matrix-Market (FMT='mm') formatting. 
    </para>
    </listitem>

    <listitem>
    <para><literal>A = gf_util('load matrix', string FMT, string FILENAME)</literal></para>

    <para>        Imports a sparse matrix from a file. 
    </para>
    </listitem>

    <listitem>
    <para><literal>tl = gf_util('trace level' [, int level])</literal></para>

    <para>         Set the verbosity of some getfem++ routines.

      Typically the messages printed by the model bricks, 0 means no
      trace message (default is 3). if no level is given,
      the current trace level is returned. 
    </para>
    </listitem>

    <listitem>
    <para><literal>tl = gf_util('warning level', int level)</literal></para>

    <para>         Filter the less important warnings displayed by getfem.

      0 means no warnings, default level is 3. if no level is given,
      the current warning level is returned. 
    </para>
    </listitem>

    </itemizedlist>
  </refsection>

  <refsection>
    <title>See Also</title>
    <simplelist type="inline">
      <member><link linkend="getfem_types">getfem types</link></member>
    </simplelist>
  </refsection>

  <refsection>
    <title>Authors</title>
    <para>Y. Collette</para>
  </refsection>

</refentry>
