doc-fr/reference/fann/functions/fann-create-train-from-callback.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 242efce0dc3aefd028a2956340231d8c62d4e38a Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->

<refentry xml:id="function.fann-create-train-from-callback" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
  <refname>fann_create_train_from_callback</refname>
  <refpurpose>Crée la structure de données d'entrainement depuis une fonction
   fournie par l'utilisateur</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>resource</type><methodname>fann_create_train_from_callback</methodname>
   <methodparam><type>int</type><parameter>num_data</parameter></methodparam>
   <methodparam><type>int</type><parameter>num_input</parameter></methodparam>
   <methodparam><type>int</type><parameter>num_output</parameter></methodparam>
   <methodparam><type>callable</type><parameter>user_function</parameter></methodparam>
  </methodsynopsis>
  <para>
   Crée la structure de données d'entrainement depuis une fonction
   fournie par l'utilisateur. Sachant que les données d'entrainement
   sont numérotées (donnée 1, donnée 2...), l'utilisateur doit écrire
   une fonction qui reçoit le numéro du jeu de données d'entrainement
   (d'entrée et de sortie) et elle doit retourner le jeu.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <variablelist>
   <varlistentry>
    <term><parameter>num_data</parameter></term>
    <listitem>
     <para>
      Le nombre de données d'entrainement
     </para>
    </listitem>
   </varlistentry>
   <varlistentry>
    <term><parameter>num_input</parameter></term>
    <listitem>
     <para>
      Le nombre d'entrées par données d'entrainement
     </para>
    </listitem>
   </varlistentry>
   <varlistentry>
    <term><parameter>num_output</parameter></term>
    <listitem>
     <para>
      Le nombre de sorties par données d'entrainement
     </para>
    </listitem>
   </varlistentry>
   <varlistentry>
    <term><parameter>user_function</parameter></term>
    <listitem>
     <para>
      La fonction fournie par l'utilisateur doit avoir les paramètres suivants :
      <simplelist>
       <member>
        <literal>num</literal> - Le nombre de données d'entrainement
       </member>
       <member>
        <literal>num_input</literal> - Le nombre d'entrées par données
        d'entrainement
       </member>
       <member>
        <literal>num_output</literal> - Le nombre de sorties par données d'entrainement
       </member>
      </simplelist>
     </para>
     <para>
      La fonction doit retourner un tableau associatif avec les clés
      <literal>input</literal> et <literal>output</literal> et deux
      valeurs de tableaux pour les entrées et les sorties.
     </para>
    </listitem>
   </varlistentry>
  </variablelist>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  &fann.return.train;
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Exemple avec <methodname>fann_create_train_from_callback</methodname></title>
    <programlisting role="php">
<![CDATA[
<?php
function create_train_callback($num_data, $num_input, $num_output) {
    return array(
        "input" => array_fill(0, $num_input, 1),
        "output" => array_fill(0, $num_output, 1),
    );
}

$num_data = 3;
$num_input = 2;
$num_output = 1;
$train_data = fann_create_train_from_callback($num_data, $num_input, $num_output, "create_train_callback");
if ($train_data) {
    // Do something with $train_data
}
?>
]]>
    </programlisting>
   </example>
  </para>
 </refsect1>

 <refsect1 role="notes">
  &reftitle.notes;
  &fann.note.function.fann-2.2;
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>fann_read_train_from_file</function></member>
    <member><function>fann_train_on_data</function></member>
    <member><function>fann_destroy_train</function></member>
    <member><function>fann_save_train</function></member>
   </simplelist>
  </para>
 </refsect1>


</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->