Scilab Function
Last update : 8/6/2005

polarplot - Plot polar coordinates

### Calling Sequence

  `polarplot(theta,rho,[style,strf,leg,rect])`
  `polarplot(theta,rho,<opt_args>)`

### Parameters

- `rho`: a vector, the radius values
- `theta`: a vector with same size than rho, the angle values.
- `<opt_args>`: a sequence of statements `key1=value1, key2=value2`, ... where keys may be `style`,`leg`,`rect`,`strf` or `frameflag`
- `style`: is a real row vector of size nc. The style to use for curve `i` is defined by `style(i)`. The default style is `1:nc` (1 for the first curve, 2 for the second, etc.).
  - `-`if `style(i)` is negative, the curve is plotted using the mark with id `abs(style(i))+1`; use `xset()` to see the mark ids.
  - `-`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; use `xset()` to see the color ids.
  - `-`When only one curve is drawn, `style` can be the row vector of size 2 `[sty,pos]` where `sty` is used to specify the style and `pos` is an integer ranging from 1 to 6 which specifies a position to use for the caption. This can be useful when a user wants to draw multiple curves on a plot by calling the function `plot2d` several times and wants to give a caption for each curve.
- `strf`: is a string of length 3 `"xy0"`.
  - `default`The default is `"030"`.
  - `x`: controls the display of captions,
    - `x=0`: no captions.
    - `x=1`: captions are displayed. They are given by the optional argument `leg`.
  - `y`: controls the computation of the frame. same as frameflag
    - `y=0`: the current boundaries (set by a previous call to another high level plotting function) are used. Useful when superposing multiple plots.
    - `y=1`: the optional argument `rect` is used to specify the boundaries of the plot.
    - `y=2`: the boundaries of the plot are computed using min and max values of `x` and `y`.
    - `y=3`: like `y=1` but produces isoview scaling.
    - `y=4`: like `y=2` but produces isoview scaling.
    - `y=5`: like `y=1` but `plot2d` can change the boundaries of the plot and the ticks of the axes to produce pretty graduations. When the zoom button is activated, this mode is used.
    - `y=6`: like `y=2` but `plot2d` can change the boundaries of the plot and the ticks of the axes to produce pretty graduations. When the zoom button is activated, this mode is used.
    - `y=7`: like `y=5` but the scale of the new plot is merged with the current scale.
    - `y=8`: like `y=6` but the scale of the new plot is merged with the current scale.
- `leg`: a string. It is used when the first character x of argument `strf` is 1. `leg` has the form `"leg1@leg2@...."` where `leg1`, `leg2`, etc. are respectively the captions of the first curve, of the second curve, etc. The default is `" "`.
- `rect`: This argument is used when the second character y of argument `strf` is 1, 3 or 5. It is a row vector of size 4 and gives the dimension of the frame: `rect=[xmin,ymin,xmax,ymax]`.

### Description

polarplot creates a polar coordinate plot of the angle theta versus the radius rho. theta is the angle from the x-axis to the radius vector specified in radians; rho is the length of the radius vector specified in dataspace units.

### Examples

    t= 0:.01:2*%pi;
    clf();polarplot(sin(7*t),cos(8*t))

    clf();polarplot([sin(7*t') sin(6*t')],[cos(8*t') cos(8*t')],[1,2])