1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90
|
<?xml version="1.0" encoding="UTF-8"?>
<!--
* Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
* Copyright (C) 2002-2004 - INRIA - Vincent COUVERT
*
* This file must be used under the terms of the CeCILL.
* This source file is licensed as described in the file COPYING, which
* you should have received as part of this distribution. The terms
* are also available at
* http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
*
-->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" version="5.0-subset Scilab" xml:lang="fr" xml:id="mtlb_prod">
<info>
<pubdate>$LastChangedDate$</pubdate>
</info>
<refnamediv>
<refname>mtlb_prod</refname>
<refpurpose>Fonction d'émulation de la fonction Matlab prod</refpurpose>
</refnamediv>
<refsection>
<title>Description</title>
<para>Dans plusieurs cas particuliers, la fonction <literal>prod</literal> se comporte différemment dans Matlab et dans Scilab :</para>
<itemizedlist>
<listitem>
<para>
En cas d'appel avec un paramètre d'entrée : La fonction Matlab <literal>prod</literal> traite
les valeurs en suivant la première dimension qui n'est pas 1 alors que la fonction Scilab
<literal>prod</literal> traite toutes les valeurs de l'entrée.
</para>
</listitem>
<listitem>
<para>
En cas d'appel avec deux paramètres d'entrée : La fonction Matlab <literal>prod</literal> peut être
utilisée avec le second paramètre donnant une dimension du premier paramètre qui n'existe pas
alors que la fonction Scilab <literal>prod</literal> retourne un message d'erreur.
</para>
</listitem>
</itemizedlist>
<para>
La fonction <literal>mtlb_prod(A[,dim])</literal> est utilisée par
<literal>mfile2sci</literal> pour remplacer <literal>prod(A[,dim])</literal> quand il n'était pas
possible de savoir ce qu'étaient les paramètres d'entrée pendant la conversion d'un code Matlab vers Scilab. Cette fonction va
déterminer la sémantique correcte pendant l'exécution. Pour obtenir un code plus performant
on peut remplacer les appels à <literal>mtlb_prod</literal> :
</para>
<itemizedlist>
<listitem>
<para>
En cas d'appel avec un paramètre d'entrée, si <literal>A</literal> est une matrice vide, un scalaire ou un vecteur,
<literal>mtlb_prod(A)</literal> peut être remplacé par <literal>prod(A)</literal>
</para>
</listitem>
<listitem>
<para>
En cas d'appel avec un paramètre d'entrée, si <literal>A</literal> est une matrice non-vide,
<literal>mtlb_prod(A)</literal> peut être remplacé par <literal>prod(A,1)</literal>
</para>
</listitem>
<listitem>
<para>
En cas d'appel avec un paramètre d'entrée, si <literal>A</literal> est hypermatrice,
<literal>mtlb_prod(A)</literal> peut être remplacé par <literal>prod(A,firstnonsingleton(A))</literal>
</para>
</listitem>
<listitem>
<para>
En cas d'appel avec deux paramètres d'entrée, si <literal>dim</literal> est inférieure au nombre
de dimensions de <literal>A</literal>
<literal>mtlb_prod(A,dim)</literal> peut être remplacé par <literal>prod(A,dim)</literal>
</para>
</listitem>
</itemizedlist>
<para>Attention : <literal>mtlb_prod</literal> ne doit pas être utilisée pour une programmation manuelle.</para>
</refsection>
<refsection>
<title>Voir Aussi</title>
<simplelist type="inline">
<member>
<link linkend="firstnonsingleton">firstnonsingleton</link>
</member>
</simplelist>
</refsection>
<refsection>
<title>Auteurs</title>
<simplelist type="vert">
<member>V.C.</member>
</simplelist>
</refsection>
</refentry>
|