1
<?xml version="1.0" encoding="UTF-8"?>
2
<!DOCTYPE MAN SYSTEM "../../manrev.dtd">
4
<LANGUAGE>eng</LANGUAGE>
8
<TYPE>Scilab Function</TYPE>
10
<DATE>April 1993</DATE>
12
<SHORT_DESCRIPTION name="param3d">3D plot of a parametric
13
curve</SHORT_DESCRIPTION>
16
<CALLING_SEQUENCE_ITEM>param3d(x,y,z,[theta,alpha,leg,flag,ebox])</CALLING_SEQUENCE_ITEM>
22
<PARAM_NAME>x,y,z</PARAM_NAME>
25
<SP>: three vectors of the same size (points of the parametric
31
<PARAM_NAME>theta, alpha</PARAM_NAME>
34
<SP>: real values giving in degree the spherical coordinates of the
35
observation point.</SP>
40
<PARAM_NAME>leg</PARAM_NAME>
43
<SP>: string defining the labels for each axis with @ as a field
44
separator, for example "X@Y@Z".</SP>
49
<PARAM_NAME>flag=[type,box]</PARAM_NAME>
52
<SP>: <VERB>type</VERB> and <VERB>box</VERB> have the same meaning
53
as in <VERB>plot3d</VERB>:</SP>
57
<PARAM_NAME>type</PARAM_NAME>
60
<SP>: an integer (scaling).</SP>
64
<PARAM_NAME>type=0</PARAM_NAME>
67
<SP>the plot is made using the current 3D scaling (set
68
by a previous call to <VERB>param3d</VERB>,
69
<VERB>plot3d</VERB>, <VERB>contour</VERB> or
70
<VERB>plot3d1</VERB>).</SP>
75
<PARAM_NAME>type=1</PARAM_NAME>
78
<SP>rescales automatically 3d boxes with extreme aspect
79
ratios, the boundaries are specified by the value of the
80
optional argument <VERB>ebox</VERB>.</SP>
85
<PARAM_NAME>type=2</PARAM_NAME>
88
<SP>rescales automatically 3d boxes with extreme aspect
89
ratios, the boundaries are computed using the given
95
<PARAM_NAME>type=3</PARAM_NAME>
98
<SP>3d isometric with box bounds given by optional
99
<VERB>ebox</VERB>, similarily to
100
<VERB>type=1</VERB>.</SP>
105
<PARAM_NAME>type=4</PARAM_NAME>
108
<SP>3d isometric bounds derived from the data, to
109
similarily<VERB>type=2</VERB>.</SP>
114
<PARAM_NAME>type=5</PARAM_NAME>
117
<SP>3d expanded isometric bounds with box bounds given
118
by optional <VERB>ebox</VERB>, similarily to
119
<VERB>type=1</VERB>.</SP>
124
<PARAM_NAME>type=6</PARAM_NAME>
127
<SP>3d expanded isometric bounds derived from the data,
128
similarily to <VERB>type=2</VERB>.Note that axes
129
boundaries can be customized through the axes entity
130
properties (see <LINK>axes_properties</LINK>).</SP>
138
<PARAM_NAME>box</PARAM_NAME>
141
<SP>: an integer (frame around the plot).</SP>
145
<PARAM_NAME>box=0</PARAM_NAME>
148
<SP>nothing is drawn around the plot.</SP>
153
<PARAM_NAME>box=1</PARAM_NAME>
156
<SP>unimplemented (like box=0).</SP>
161
<PARAM_NAME>box=2</PARAM_NAME>
164
<SP>only the axes behind the surface are drawn.</SP>
169
<PARAM_NAME>box=3</PARAM_NAME>
172
<SP>a box surrounding the surface is drawn and captions
178
<PARAM_NAME>box=4</PARAM_NAME>
181
<SP>a box surrounding the surface is drawn, captions and
182
axes are added.Note that axes aspect can also be
183
customized through the axes entity properties (see
184
<LINK>axes_properties</LINK>).</SP>
195
<PARAM_NAME>ebox</PARAM_NAME>
198
<SP>: It specifies the boundaries of the plot as the vector
199
<VERB>[xmin,xmax,ymin,ymax,zmin,zmax]</VERB>. This argument is used
200
together with <VERB>type</VERB> in <VERB>flag</VERB> : if it is set
201
to <VERB>1</VERB>, <VERB>3</VERB> or <VERB>5</VERB> (see above to
202
see the corresponding behaviour). If <VERB>flag</VERB> is missing,
203
<VERB>ebox</VERB> is not taken into acoount. Note that, when
204
specified, the <VERB>ebox</VERB> argument acts on the
205
<VERB>data_bounds</VERB> field that can also be reset through the
206
axes entity properties (see <LINK>axes_properties</LINK>).</SP>
213
<P><VERB>param3d</VERB> is used to plot a 3D curve defined by its
214
coordinates <VERB>x</VERB>, <VERB>y</VERB> and <VERB>z</VERB>. Note that
215
data can also be set or get through the surface entity properties (see
216
<LINK>surface_properties</LINK>).</P>
218
<P>Note that properties like <VERB>rotation angles</VERB>,
219
<VERB>colors</VERB> and <VERB>thickness</VERB> of the plotted curves can
220
also be set through the param3d entity properties (see
221
<LINK>param3d_properties</LINK>).</P>
223
<P>Use <VERB>param3d1</VERB> to do multiple plots.</P>
225
<P>Enter the command <VERB>param3d()</VERB> to see a demo.</P>
231
param3d(sin(t),cos(t),t/10,35,45,"X@Y@Z",[2,3])
237
<LINK>param3d1</LINK>
245
<AUTHOR>J.Ph.C.</AUTHOR>
b'\\ No newline at end of file'