<?xml version="1.0" encoding="UTF-8"?>

<!--

 * Scilab ( https://www.scilab.org/ ) - This file is part of Scilab

 * Copyright (C) INRIA

 *


 * 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="eval3dp">

    <refnamediv>

        <refname>eval3dp</refname>

        <refpurpose>3次元パラメータ表現の曲面の小平面を計算</refpurpose>

    </refnamediv>

    <refsynopsisdiv>

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

        <synopsis>[Xf,Yf,Zf]=eval3dp(fun,p1,p2)</synopsis>

    </refsynopsisdiv>

    <refsection>

        <title>引数</title>

        <variablelist>

            <varlistentry>

                <term>Xf,Yf,Zf</term>

                <listitem>

                    <para>

                        大きさ (4,n-1*m-1)の行列. <literal>Xf(:,i)</literal> ,<literal>Yf(:,i)</literal> and <literal>Zf(:,i)</literal> はそれぞれ

                        i番目の4角形の小平面の4点のx軸,y軸,z軸です.

                    </para>

                </listitem>

            </varlistentry>

            <varlistentry>

                <term>fun</term>

                <listitem>

                    <para>Scilab関数.</para>

                </listitem>

            </varlistentry>

            <varlistentry>

                <term>p1</term>

                <listitem>

                    <para>

                        大きさ <literal>n</literal>のベクトル.

                    </para>

                </listitem>

            </varlistentry>

            <varlistentry>

                <term>p2</term>

                <listitem>

                    <para>

                        大きさ <literal>m</literal>のベクトル.

                    </para>

                </listitem>

            </varlistentry>

        </variablelist>

    </refsection>

    <refsection>

        <title>説明</title>

        <para>

            <literal>eval3dp</literal> は関数<literal>fun</literal>

            により定義される3次元パラメータ表現の曲面の

            4角形小平面表現を計算します.

            <literal>fun(p1,p2)</literal> は,

            曲面の対応する点の

            x軸,y軸,z軸座標を

            [x(i),y(i),z(i)]=fun(p1(i),p2(i)) により計算します.

            これは効率を改善するために使用されます.

        </para>

    </refsection>

    <refsection>

        <title>例</title>

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

p1=linspace(0,2*%pi,10);

p2=linspace(0,2*%pi,10);

deff("[x,y,z]=scp(p1,p2)",["x=p1.*sin(p1).*cos(p2)";..

                           "y=p1.*cos(p1).*cos(p2)";..

                           "z=p1.*sin(p2)"])

[Xf,Yf,Zf]=eval3dp(scp,p1,p2);

plot3d(Xf,Yf,Zf)

 ]]></programlisting>

        <scilab:image>p1=linspace(0,2*%pi,10);

            p2=linspace(0,2*%pi,10);

            deff("[x,y,z]=scp(p1,p2)",["x=p1.*sin(p1).*cos(p2)";..

            "y=p1.*cos(p1).*cos(p2)";..

            "z=p1.*sin(p2)"])

            [Xf,Yf,Zf]=eval3dp(scp,p1,p2);

            plot3d(Xf,Yf,Zf)

        </scilab:image>

    </refsection>

    <refsection role="see also">

        <title>参照</title>

        <simplelist type="inline">

            <member>

                <link linkend="genfac3d">genfac3d</link>

            </member>

            <member>

                <link linkend="plot3d">plot3d</link>

            </member>

        </simplelist>

    </refsection>

</refentry>

