Man Scilab

param3d1 - 3D plot of parametric curves

Calling Sequence

param3d1(x,y,z,[theta,alpha,leg,flag,ebox])

param3d1(x,y,list(z,colors),[theta,alpha,leg,flag,ebox])

Parameters

• x,y,z

  : matrices of the same size (nl,nc).

  Each column i of the matrices corresponds to the coordinates of the ith curve. You can give a specific color for each curve by using list(z,colors) instead of z , where colors is a vector of size nc . If color(i) is negative the curve is plotted using the mark with id abs(style(i))+1 ; if style(i) is strictly positive, a plain line with color id style(i) or a dashed line with dash id style(i) is used.

• theta,alpha : real values giving in degree the spherical coordinates of the observation point.
• leg : string defining the captions for each axis with @ as a field separator, for example "X@Y@Z".
• flag=[type,box] : type and box have the same meaning as in plot3d :
  • type : an integer (scaling).
    • type=0 the plot is made using the current 3D scaling (set by a previous call to param3d , plot3d , contour or plot3d1 ).
    • type=1 rescales automatically 3d boxes with extreme aspect ratios, the boundaries are specified by the value of the optional argument ebox .
    • type=2 rescales automatically 3d boxes with extreme aspect ratios, the boundaries are computed using the given data.
    • type=3 3d isometric with box bounds given by optional ebox , similarily to type=1 .
    • type=4 3d isometric bounds derived from the data, to similarily type=2 .
    • type=5 3d expanded isometric bounds with box bounds given by optional ebox , similarily to type=1 .
    • type=6 3d expanded isometric bounds derived from the data, similarily to type=2 .Note that axes boundaries can be customized through the axes entity properties (see axes_properties ).
  • box : an integer (frame around the plot).
    • box=0 nothing is drawn around the plot.
    • box=1 unimplemented (like box=0).
    • box=2 only the axes behind the surface are drawn.
    • box=3 a box surrounding the surface is drawn and captions are added.
    • box=4 a box surrounding the surface is drawn, captions and axes are added.Note that axes aspect can also be customized through the axes entity properties (see axes_properties ).
• ebox : It specifies the boundaries of the plot as the vector [xmin,xmax,ymin,ymax,zmin,zmax] . This argument is used together with type in flag : if it is set to 1 , 3 or 5 (see above to see the corresponding behaviour). If flag is missing, ebox is not taken into acoount. Note that, when specified, the ebox argument acts on the data_bounds field that can also be reset through the axes entity properties (see axes_properties ).

Description

param3d1 is used to plot 3D curves defined by their coordinates x , y and z . Note that data can also be set or get through the surface entity properties (see surface_properties ).

Note that properties like rotation angles , colors and thickness of the plotted curves can also be set through the param3d entity properties (see param3d_properties ).

Enter the command param3d1() to see a demo.

Examples

t=[0:0.1:5*%pi]';
param3d1([sin(t),sin(2*t)],[cos(t),cos(2*t)],..
  list([t/10,sin(t)],[3,2]),35,45,"X@Y@Z",[2,3])

 set("figure_style","new") //create a figure
 a=get("current_axes");//get the handle of the newly created axes
 t=[0:0.1:5*%pi]';
 param3d1([sin(t),sin(2*t)],[cos(t),cos(2*t)],[t/10,sin(t)])
 a.rotation_angles=[65,75]; 
 a.data_bounds=[-1,-1,-1;1,1,2]; //boundaries given by data_bounds
 a.thickness = 2;
 h=a.children //get the handle of the param3d entity: an agregation composed of 2 curves
 h.children(1).foreground = 3 // first curve
 curve2 = h.children(2);
 curve2.foreground = 6;
 curve2.mark_style = 2;

 

See Also

param3d ,   plot3d ,   plot2d ,   gca ,   xdel ,   delete ,  

Author

J.Ph.C.

Back