| 1 |
<TITLE>/</TITLE> |
|---|
| 2 |
<BODY> |
|---|
| 3 |
<A HREF = "index.html">[Index for ./basics]</A> |
|---|
| 4 |
<A HREF = "../index.html">[Return to Master Index]</A> |
|---|
| 5 |
<H1>circles</H1> |
|---|
| 6 |
<H2>(./basics/circles.m)</H2> |
|---|
| 7 |
<HR><H3>Function Synopsis</H3> |
|---|
| 8 |
<pre>hcir=circles(xc,yc,rad,p1,v1,p2,v2,p3,v3,p4,v4,...</pre> |
|---|
| 9 |
<HR><H3>Help text</H3> |
|---|
| 10 |
<pre> |
|---|
| 11 |
|
|---|
| 12 |
CIRCLES plot circles at optionally input centers with required input radii. |
|---|
| 13 |
|
|---|
| 14 |
CIRCLES(RAD) draws circles at the origin with radii RAD. |
|---|
| 15 |
|
|---|
| 16 |
CIRCLES(XC,YC,RAD) draws circles with radii RAD and with |
|---|
| 17 |
centers at (XC,YC). |
|---|
| 18 |
|
|---|
| 19 |
Input : XC - x-coord vector of circle centers (optional, See Note 4) |
|---|
| 20 |
YC - y-coord vector of circle centers (optional, See Note 4) |
|---|
| 21 |
RAD - vector of circle radii (required) |
|---|
| 22 |
p1,v1... - parameter/value plotting pairs (optional, See Note 4) |
|---|
| 23 |
|
|---|
| 24 |
Output : HCIR - vector of handles to circles drawn. |
|---|
| 25 |
|
|---|
| 26 |
The parameter/value pairs currently allowed in the CIRCLES |
|---|
| 27 |
function are as follows ( default values appear in {} ) : |
|---|
| 28 |
|
|---|
| 29 |
Color {'r' = red} |
|---|
| 30 |
LineStyle {'-' = solid} |
|---|
| 31 |
LineWidth {0.5 points; 1 point = 1/72 inches} |
|---|
| 32 |
MarkerSize {6 points} |
|---|
| 33 |
|
|---|
| 34 |
See the Matlab Reference Guide entry on the LINE command for |
|---|
| 35 |
a complete description of parameter/value pair specification. |
|---|
| 36 |
|
|---|
| 37 |
The idea and some of the constructs used in pv decoding |
|---|
| 38 |
in this routine come from an unreleased MathWorks function |
|---|
| 39 |
called polar2.m written by John L. Galenski III |
|---|
| 40 |
and provided by Jeff Faneuff. |
|---|
| 41 |
|
|---|
| 42 |
NOTES: 1) CIRCLES always overlays existing axes, regardless |
|---|
| 43 |
of the state of 'hold'. |
|---|
| 44 |
2) CIRCLES does not force the axis to be 'equal'. |
|---|
| 45 |
3) CIRCLES is a special case of the routine ELLIPSES; |
|---|
| 46 |
although ELLIPSES can be used to draw circles, |
|---|
| 47 |
CIRCLES is much faster at drawing circles because |
|---|
| 48 |
it does not deal with orientation and eccentricity |
|---|
| 49 |
parameters. |
|---|
| 50 |
4) If you want to specify parameter/vaule plotting |
|---|
| 51 |
attributes with circles at the origin, you must pass |
|---|
| 52 |
CIRCLES 0-vectors for the x- and y- coordinates of |
|---|
| 53 |
the circles. If you don't, CIRCLES will not be able |
|---|
| 54 |
to decode the parameter/value sequence and you will |
|---|
| 55 |
probably get the following error: |
|---|
| 56 |
??? Error using ==> + |
|---|
| 57 |
Matrix dimensions must agree. |
|---|
| 58 |
|
|---|
| 59 |
Call as: >> hcir=circles(xc,yc,rad,p1,v1,p2,v2,...) |
|---|
| 60 |
|
|---|
| 61 |
Written by : Brian O. Blanton |
|---|
| 62 |
|
|---|
| 63 |
</pre> |
|---|
| 64 |
<HR> |
|---|
| 65 |
Produced by <A HREF="http://www.nd.edu/Courses/kantor/matlab/mat2html">mat2html</A> on Tue Feb 2 16:15:45 EST 1999 |
|---|
| 66 |
<BR> |
|---|
| 67 |
Cross-Directory links are: OFF<BR> |
|---|
| 68 |
</BODY> |
|---|
