<?xml version="1.0" encoding="UTF-8"?>
<!--
 * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
 * Copyright (C) 2011 - INRIA - Serge Steer
 *
 * Copyright (C) 2012 - 2016 - Scilab Enterprises
 *
 * This file is hereby licensed under the terms of the GNU GPL v2.0,
 * pursuant to article 5.3.4 of the CeCILL v.2.1.
 * This file was originally licensed under the terms of the CeCILL v2.1,
 * and continues to be available under such terms.
 * For more information, see the COPYING file which you should have received
 * along with this program.
 *
 -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="repmat" xml:lang="fr">
    <refnamediv>
        <refname>repmat</refname>
        <refpurpose>Définit un grand tableau par pavage avec un tableau 2D.</refpurpose>
    </refnamediv>
    <refsynopsisdiv>
        <title>Sequence d'appel</title>
        <synopsis>
          B = repmat(A, siz)
          B = repmat(A, m)
          B = repmat(A, m, n,...)
      </synopsis>
    </refsynopsisdiv>
    <refsection role="parameters">
        <title>Arguments</title>
        <variablelist>
            <varlistentry>
                <term>A</term>
                <listitem>
                    <para>tableau 2D.</para>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>m, n, ...</term>
                <listitem>
                    <para>
                        entiers, nombres de copie de <literal>A</literal> pour
                        chaque dimension de <literal>B</literal>.
                    </para>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>siz</term>
                <listitem>
                    <para>vecteur d'entiers, Chaque élément donne le nombre de
                        copie de <literal>A</literal> pour la dimension
                        correspondante de <literal>B</literal>.
                    </para>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>B</term>
                <listitem>
                    <para>Le tableau résultant du pavage.</para>
                </listitem>
            </varlistentry>
        </variablelist>
    </refsection>
    <refsection role="description">
        <title>Description</title>
        <para>
            <literal>repmat(A,m,n)</literal> or de façon équivalente,
            <literal>repmat(A,[m,n])</literal> retourne un grand tableau formé
            d'un pavage <literal>m</literal>-par- <literal>n</literal> avec
            des copies de <literal>A</literal>.  La taille du résultat est
            <literal>[size(A,1)*M, size(A,2)*N]</literal>.
        </para>
        <para>
            <literal>repmat(A,m)</literal> crée un pavage
            <literal>m</literal>-by- <literal>m</literal>.
        </para>
        <para>
            <literal>repmat(A,[m n p ...])</literal> pave un tableau
            mutidimensionnel <literal>m</literal>-par-
            <literal>n</literal>-par- <literal>p</literal> ... avec des copies
            de <literal>A</literal>. La taille du résultat est
            <literal>[size(A,1)*M, size(A,2)*N, size(A,3)*P,
                ...]
            </literal>
            .
        </para>
        <para>Cette fonction supporte les tableaux de réels, d'entiers, de
            booléens, de chaînes de caractères, de polynômes, et de fractions
            rationnelles ainsi que les matrices creuses. Cette fonction peut
            être étendue en utilisant le méchanisme de surcharge.
        </para>
    </refsection>
    <refsection role="examples">
        <title>Exemples</title>
        <programlisting role="example"><![CDATA[
    repmat(1:3,2,2)
    repmat(int8([1 0 1;0 1 0]),2,3,2)
    repmat("Scilab",3,2)
    t="Scilab";t(ones(3,2))
    repmat([1/%s;2/(%s+1)],1,3)

 ]]></programlisting>
    </refsection>
    <refsection role="see also">
        <title>Voir aussi</title>
        <simplelist type="inline">
            <member>
                <link linkend="matrix">matrix</link>
            </member>
            <member>
                <link linkend="extraction">extraction</link>
            </member>
            <member>
                <link linkend="size">size</link>
            </member>
        </simplelist>
    </refsection>
    <refsection role="history">
        <title>Historique</title>
        <revhistory>
            <revision>
                <revnumber>5.3.1</revnumber>
                <revremark>Fonction repmat introduite.</revremark>
            </revision>
        </revhistory>
    </refsection>
</refentry>
