<?xml version="1.0" encoding="UTF-8"?>
<!--
 * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
 * Copyright (C) 2000 - INRIA - Carlos Klimann
 *
 * 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:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="samplef">
    <refnamediv>
        <refname>samplef</refname>
        <refpurpose>母集団からの置換を有する標本化および
            その値の頻度.
        </refpurpose>
    </refnamediv>
    <refsynopsisdiv>
        <title>呼び出し手順</title>
        <synopsis>s = samplef(n,X,f,orient)</synopsis>
    </refsynopsisdiv>
    <refsection>
        <title>パラメータ</title>
        <variablelist>
            <varlistentry>
                <term>n</term>
                <listitem>
                    <para>正の整数 (標本の大きさ)</para>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>X</term>
                <listitem>
                    <para>行列. 標本はこの行列から展開されます</para>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>f</term>
                <listitem>
                    <para>
                        Xと同じ大きさの正の整数.
                        Xの対応する値の頻度を示します.
                    </para>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>orient</term>
                <listitem>
                    <para>オプションのパラメータ. 利用可能な値は 1, 2, 'r' または 'c'です</para>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>s</term>
                <listitem>
                    <para>標本を含むベクトルまたは行列</para>
                </listitem>
            </varlistentry>
        </variablelist>
    </refsection>
    <refsection>
        <title>説明</title>
        <para>
            この関数は, 長さnのベクトルsを出力します.
            その出力には,
            ベクトル(または行列)Xから置換を指定して抽出された
            n個の標本が含まれます.
            その各要素は,ベクトルfの対応する値により指定された頻度から
            計算されます.
        </para>
        <para>
            s=samplef(n,X,f)   (または  s=samplef(n,X,f,'*'))   は,
            その値がXから抽出されたn個の標本となる
            ベクトル s を返します.
            各値は,fの対応する値に比例した標本化確率を有します.
            fはXと同じ大きさを有します.
        </para>
        <para>
            s=samplef(n,X,f,'r')           (または等価な,
            s=samplef(n,X,f,1)) は,size(X,'r')xnの行列を返します.
            その出力には,
            Xから抽出されたn行のランダム標本が含まれます.
            その各行は,Xの行から置換付きで展開された
            fの対応する値に比例した標本化確率を有します.
            fの長さは,Xの行の数に等しい必要があります.
        </para>
        <para>
            s=samplef(n,X,f,'c')           (または等価な,
            s=samplef(n,X,f,2))    は,nxsize(X,'c')の行列を返します.
            その出力には,
            Xから抽出されたn列のランダム標本が含まれます.
            その各列は,Xの列から置換付きで展開された
            fの対応する値に比例した標本化確率を有します.
            fの長さは,Xの列の数に等しい必要があります.
        </para>
    </refsection>
    <refsection>
        <title>例</title>
        <programlisting role="example"><![CDATA[
a=[3 7 9;22 4 2]
f1=[10 1 1 1 1 1]
f2=[1 ; 15]
f3=[10 1 1]
s=samplef(15,a,f1)
s=samplef(15,a,f2,'r')
s=samplef(15,a,f3,'c')
 ]]></programlisting>
    </refsection>
    <refsection role="see also">
        <title>参照</title>
        <simplelist type="inline">
            <member>
                <link linkend="sample">sample</link>
            </member>
            <member>
                <link linkend="samwr">samwr</link>
            </member>
        </simplelist>
    </refsection>
</refentry>
