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.



Sample
~~~~~~



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 a graphics window
+ `delete`_ delete a graphic entity and its children.


.. _param3d: param3d.html
.. _plot3d: plot3d.html
.. _delete: delete.html
.. _surface_properties: surface_properties.html
.. _xdel: xdel.html
.. _plot2d: plot2d.html
.. _axes_properties: axes_properties.html
.. _gca: gca.html
.. _polyline_properties: polyline_properties.html