<?xml version="1.0" encoding="UTF-8"?>
<!--
 * Scilab ( https://www.scilab.org/ ) - This file is part of Scilab
 * Copyright (C) INRIA - Farid Belahcene
 *
 * 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="bar">

    <refnamediv>

        <refname>bar</refname>

        <refpurpose>棒ヒストグラム</refpurpose>

    </refnamediv>

    <refsynopsisdiv>

        <title>呼び出し手順</title>

        <synopsis>
            bar(y)
            bar(x, y)
            bar(x, y, width, colors, style)
            bar(x, y [,width] [,colors] [,style])
            bar(h, x, y ..)
        </synopsis>

    </refsynopsisdiv>

    <refsection>

        <title>引数</title>

        <variablelist>

            <varlistentry>

                <term>h</term>

                <listitem>

                    <para>axes ハンドル, (デフォルト: h=gca() ).</para>

                </listitem>

            </varlistentry>

            <varlistentry>

                <term>y</term>

                <listitem>

                    <para>
                        scalar, vector of size N, or matrix N*M of real numbers or encoded integers,
                      with
                      <itemizedlist>
                        <listitem>
                          N : number of groups (each group of bars gathered on/around an x position)
                        </listitem>
                        <listitem>
                          M : number of categories in each group
                        </listitem>
                      </itemizedlist>
                    </para>

                </listitem>

            </varlistentry>

            <varlistentry>

                <term>x</term>

                <listitem>

                    <para>a real scalar or a vector of size N. By default,
                      <itemizedlist>
                        <listitem>
                          If <varname>y</varname> is a vector: <literal>x=1:length(y)</literal>
                        </listitem>
                        <listitem>
                          If <varname>y</varname> is a matrix: <literal>x=1:size(y,"r")</literal>
                        </listitem>
                      </itemizedlist>
                    </para>

                </listitem>

            </varlistentry>

            <varlistentry>

                <term>width</term>

                <listitem>

                    <para>(オプション), 実数スカラー, bar の幅 (利用可能な空間の割合) を定義

                        (デフォルト: 0.8, すなわち 80%).

                    </para>

                </listitem>

            </varlistentry>

            <varlistentry>

                <term>colors</term>

                <listitem>
                    <para>
                        (オプション) Single string or vector of M strings: colors names (among
                        predefined ones) or "#RRGGBB" hexadecimal codes of categories colors.
                        Default = default plot() colors series, starting with "blue".
                    </para>
                </listitem>

            </varlistentry>

            <varlistentry>

                <term>style:</term>

                <listitem>

                    <para>文字列, 'grouped' または 'stacked' (デフォルト: 'grouped').</para>

                </listitem>

            </varlistentry>

        </variablelist>

    </refsection>

    <refsection>

        <title>説明</title>

        <para>

            <literal>bar(y,...) :</literal> y がベクトルの場合, bar 関数は

            <literal>polyline_style</literal>  6型を有するポリラインを描画します.

            y がベクトルの場合, bar はベクトルyをベクトル1:size(y,'*')に対して

            描画します. y が行列 N*M の場合, bar は M個のポリライン(6型)を描画し,

            各ポリラインはyの列に対してベクトルx=1:size(y,1)に対応します.

        </para>

        <para>

            <literal>bar(x,y,...) :</literal> yがベクトルの場合, bar 関数は

            <literal>polyline_style</literal> 6型 を有するポリラインを描画します.

            ただし, xの長さ = yの長さとなります.

            y が行列 NxMの場合, bar 関数は6型 を有するM本のポリラインを描画します.

            各ポリラインはyの列に対するベクトルxに対応します.

        </para>

        <para>

            <literal>bar(h,...) :</literal> は描画を実行中のカレントの軸を定義します.

        </para>

        <para>

            <literal>bar(...,width,...) :</literal> は棒の幅をパーセント単位で

            定義します(通常: 0&lt;width&lt;=1).

        </para>

        <para>

            <literal>bar(...,style,...) :</literal> は棒の描画方法を定義します.

            y が行列 N*M の場合 (つまり, M本の6型ポリライン),

            M個の棒を描画する方法が二種類あります.

            styleオプション = 'grouped'により,

            M個のポリラインをxの各要素に対して中心に置くことができます,

            そして, style オプション 'stacked' によりこれらをスタックすることができます.

        </para>

        <para>
            <literal>bar(...,colors,...) : </literal> defines the colors identifying categories
            and filling the corresponding subsets of bars.
        </para>

        <para>bar()を複数回コールする場合,

            <literal>barhomogenize</literal>関数により

            カレントの軸に含まれる

            全ての棒(すなわち,6型のポリライン)の幅とスタイルを統一できます.

        </para>

    </refsection>

    <refsection>

        <title>例</title>

        <scilab:image>

            y=[1 -3 5];

            bar(y,0.5,'yellow');

        </scilab:image>

    </refsection>

    <refsection>

        <title>例</title>

        <programlisting role="example"><![CDATA[

// 最初の例: 棒を描画 (すなわち,polyline_style type =6のポリライン) ただし,

// width=0.5 , colors='yellow' で default style='grouped', x=1:length(y).

scf(0);

y=[1 -3 5];

bar(y,0.5,'yellow');

 ]]></programlisting>



        <programlisting role="example"><![CDATA[



// 2番目の例: 棒を 3 つ描画 (すなわち,polyline_style type =6の3個のポリライン),default style='grouped'

scf(1);

x=[1 2 5]; y=[1  -5 6;3 -2 7;4  -3 8];

bar(x,y);

 ]]></programlisting>

        <scilab:image>

            x=[1 2 5];

            y=[1  -5 6;3 -2 7;4  -3 8];

            bar(x,y);

        </scilab:image>

        <programlisting role="example"><![CDATA[



// 3番目の例 : style='stacked'.

scf(2);

x=[1 2 5]; y=[1 4 7;2 5 8;3 6  9];

bar(x,y,'stacked');

 ]]></programlisting>

        <scilab:image>

            x=[1 2 5];

            y=[1 4 7;2 5 8;3 6  9];

            bar(x,y,'stacked');

        </scilab:image>

        <programlisting role="example"><![CDATA[

// 4番目の例: width=0.2;colors='green'; default style='grouped'

scf(3);

x=[1 2 5]; y=[1 4 7;2 5 8;3 6 9];

bar(x,y,0.2,'green');

 ]]></programlisting>

        <scilab:image>

            x=[1 2 5];

            y=[1 4 7;2 5 8;3 6 9];

            bar(x,y,0.2,'green');

        </scilab:image>

    </refsection>

    <refsection role="see also">

        <title>参照</title>

        <simplelist type="inline">
            <member>
                <link linkend="barh">barh</link>
            </member>
            <member>
                <link linkend="barhomogenize">barhomogenize</link>
            </member>
            <member>
                <link linkend="histplot">histplot</link>
            </member>
            <member>
                <link linkend="plot">plot</link>
            </member>
            <member>
                <link linkend="color_list">named colors</link>
            </member>
            <member>
                <link linkend="polyline_properties">polyline_properties</link>
            </member>
            <member>
                <link linkend="bar3d">bar3d</link>
            </member>
        </simplelist>
    </refsection>
    <refsection role="history">
        <title>履歴</title>
        <revhistory>
            <revision>
                <revnumber>6.0.1</revnumber>
                <revdescription>
                    <itemizedlist>
                      <listitem>
                        A vector of M colors can now be provided, one for each category.
                      </listitem>
                      <listitem>
                        Available colors are no longer restricted to the 10 major colors. All the
                        predefined colors names can now be used.
                      </listitem>
                      <listitem>
                        Colors can now be specified also by their "#RRGGBB" hexadecimal codes.
                      </listitem>
                    </itemizedlist>
                </revdescription>
            </revision>
        </revhistory>
    </refsection>
</refentry>

