Scilab Home page | Wiki | Bug tracker | Forge | Mailing list archives | ATOMS | File exchange
Please login or create an account
Change language to: English - Français - Português - 日本語 -

Please note that the recommended version of Scilab is 6.0.2. This page might be outdated.
However, this page did not exist in the previous stable version.

Scilab help >> Графики > 3d_plot > param3d1

# 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])```

### Arguments

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))`; 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. The default values are 35 and 45 degree.

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. This is the default value.

type=3

3d isometric with box bounds given by optional `ebox`, similarily to `type=1`.

type=4

3d isometric bounds derived from the data, similarily`to 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). This is the default value.

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 acount. 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). The `ebox` default value is `[0,1,0,1,0,1]`.

### Description

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

Note that properties like `rotation angles`, `colors` and `thickness` of the plotted curves can also be got or modified through the polyline entity properties (see polyline_properties).

Enter the command `param3d1()` to see a demo.

### Examples

```xset('window',20) // create a window number 20
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])

xdel(20);
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 Compound 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 — 3D plot of a parametric curve
• plot3d — 3D plot of a surface
• plot2d — 2D plot
• gca — Return handle of current axes.
• xdel — удаление графического окна
• delete — delete a graphic entity and its children.

### Comments

Add a comment:
Please login to comment this page.

 Report an issue << param3d 3d_plot param3d properties >>

 Scilab EnterprisesCopyright (c) 2011-2017 (Scilab Enterprises)Copyright (c) 1989-2012 (INRIA)Copyright (c) 1989-2007 (ENPC)with contributors Last updated:Tue Apr 02 17:37:56 CEST 2013
{"ft_lang_label":"__label__en","ft_lang_prob":0.69545084,"math_prob":0.95778584,"size":3954,"snap":"2019-35-2019-39","text_gpt3_token_len":1110,"char_repetition_ratio":0.10810126,"word_repetition_ratio":0.116838485,"special_character_ratio":0.2665655,"punctuation_ratio":0.17401668,"nsfw_num_words":0,"has_unicode_error":false,"math_prob_llama3":0.9869306,"pos_list":[0,1,2],"im_url_duplicate_count":[null,2,null],"WARC_HEADER":"{\"WARC-Type\":\"response\",\"WARC-Date\":\"2019-08-20T19:34:28Z\",\"WARC-Record-ID\":\"<urn:uuid:53e67188-d34a-43cb-8daa-e42e26410fcb>\",\"Content-Length\":\"40781\",\"Content-Type\":\"application/http; msgtype=response\",\"WARC-Warcinfo-ID\":\"<urn:uuid:f873d65e-eef3-4343-90ab-8b933e895b6d>\",\"WARC-Concurrent-To\":\"<urn:uuid:dc40dfd9-d293-4f7c-8f86-dc5f42fdb2f9>\",\"WARC-IP-Address\":\"176.9.3.186\",\"WARC-Target-URI\":\"https://help.scilab.org/docs/5.4.1/ru_RU/param3d1.html\",\"WARC-Payload-Digest\":\"sha1:EZ3EIPZK4G752PHUML4ZLJPPYVMD75WN\",\"WARC-Block-Digest\":\"sha1:ZQTIFAKOS5JFDSNIM3EEOGAPLFDAV6OZ\",\"WARC-Identified-Payload-Type\":\"application/xhtml+xml\",\"warc_filename\":\"/cc_download/warc_2019/CC-MAIN-2019-35/CC-MAIN-2019-35_segments_1566027315558.25_warc_CC-MAIN-20190820180442-20190820202442-00297.warc.gz\"}"}