1
1
<?xml version="1.0" encoding="UTF-8"?>
2
2
<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" version="5.0-subset Scilab" xml:id="bsplin3val" xml:lang="en">
4
<refname>bsplin3val</refname>
5
<refpurpose>3d spline arbitrary derivative evaluation
10
<title>Calling Sequence</title>
11
<synopsis>[dfp]=bsplin3val(xp,yp,zp,tl,der)</synopsis>
14
<title>Arguments</title>
17
<term>xp, yp, zp</term>
19
<para>real vectors or matrices of same size</para>
25
<para>tlist of type "splin3d", defining a 3d tensor spline (called
26
<literal>s</literal> in the following)
34
vector with 3 components <literal>[ox,oy,oz]</literal>
35
defining which derivative of <literal>s</literal> to compute.
43
vector or matrix of same format than <literal>xp</literal>,
44
<literal>yp</literal> and <literal>zp</literal>, elementwise
45
evaluation of the specified derivative of <literal>s</literal> on
53
<title>Description</title>
55
While the function <link linkend="interp3d">interp3d</link> may
56
compute only the spline <literal>s</literal> and its first derivatives,
57
<literal>bsplin3val</literal> may compute any derivative of
58
<literal>s</literal>. The derivative to compute is specified by the
59
argument <literal>der=[ox,oy,oz]</literal> :
64
<imagedata align="center" fileref="../mml/bsplin3val_equation1.mml"/>
69
So <literal>der=[0 0 0]</literal> corresponds to
70
<emphasis>s</emphasis>, <literal>der=[1 0 0]</literal> to
71
<emphasis>ds/dx</emphasis>, <literal>der=[0 1 0]</literal> to
72
<emphasis>ds/dy</emphasis>, <literal>der=[1 1 0]</literal> to
73
<emphasis>d2s/dxdy</emphasis>, etc...
75
<para>For a point with coordinates
76
<emphasis>(xp(i),yp(i),zp(i))</emphasis> outside the grid, the function
81
<title>Examples</title>
82
<programlisting role="example"><![CDATA[
4
<refname>bsplin3val</refname>
5
<refpurpose>3d spline arbitrary derivative evaluation
10
<title>Calling Sequence</title>
11
<synopsis>[dfp]=bsplin3val(xp,yp,zp,tl,der)</synopsis>
14
<title>Arguments</title>
17
<term>xp, yp, zp</term>
19
<para>real vectors or matrices of same size</para>
25
<para>tlist of type "splin3d", defining a 3d tensor spline (called
26
<literal>s</literal> in the following)
34
vector with 3 components <literal>[ox,oy,oz]</literal>
35
defining which derivative of <literal>s</literal> to compute.
43
vector or matrix of same format than <literal>xp</literal>,
44
<literal>yp</literal> and <literal>zp</literal>, elementwise
45
evaluation of the specified derivative of <literal>s</literal> on
53
<title>Description</title>
55
While the function <link linkend="interp3d">interp3d</link> may
56
compute only the spline <literal>s</literal> and its first derivatives,
57
<literal>bsplin3val</literal> may compute any derivative of
58
<literal>s</literal>. The derivative to compute is specified by the
59
argument <literal>der=[ox,oy,oz]</literal> :
64
<imagedata align="center" fileref="../mml/bsplin3val_equation1.mml"/>
69
So <literal>der=[0 0 0]</literal> corresponds to
70
<emphasis>s</emphasis>, <literal>der=[1 0 0]</literal> to
71
<emphasis>ds/dx</emphasis>, <literal>der=[0 1 0]</literal> to
72
<emphasis>ds/dy</emphasis>, <literal>der=[1 1 0]</literal> to
73
<emphasis>d2s/dxdy</emphasis>, etc...
75
<para>For a point with coordinates
76
<emphasis>(xp(i),yp(i),zp(i))</emphasis> outside the grid, the function
81
<title>Examples</title>
82
<programlisting role="example"><![CDATA[
83
83
deff("v=f(x,y,z)","v=cos(x).*sin(y).*cos(z)");
84
84
deff("v=fx(x,y,z)","v=-sin(x).*sin(y).*cos(z)");
85
85
deff("v=fxy(x,y,z)","v=-sin(x).*cos(y).*cos(z)");
111
111
fxxyz_e = fxxyz(xp,yp,zp)
112
112
fxxyz_i = bsplin3val(xp,yp,zp,tl,[2 1 1])
113
113
]]></programlisting>
115
<refsection role="see also">
116
<title>See Also</title>
117
<simplelist type="inline">
119
<link linkend="splin3d">splin3d</link>
122
<link linkend="interp3d">interp3d</link>
127
<title>History</title>
130
<revnumber>5.4.0</revnumber>
131
<revremark>previously, imaginary part of input arguments were implicitly ignored.</revremark>
115
<refsection role="see also">
116
<title>See Also</title>
117
<simplelist type="inline">
119
<link linkend="splin3d">splin3d</link>
122
<link linkend="interp3d">interp3d</link>
127
<title>History</title>
130
<revnumber>5.4.0</revnumber>
131
<revremark>previously, imaginary part of input arguments were implicitly ignored.</revremark>