| 1 |
<TITLE>/</TITLE> |
|---|
| 2 |
<BODY> |
|---|
| 3 |
<A HREF = "index.html">[Index for ./FEM]</A> |
|---|
| 4 |
<A HREF = "../index.html">[Return to Master Index]</A> |
|---|
| 5 |
<H1>vecplot</H1> |
|---|
| 6 |
<H2>(./FEM/vecplot.m)</H2> |
|---|
| 7 |
<HR><H3>Function Synopsis</H3> |
|---|
| 8 |
<pre>retval=vecplot(varargin)</pre> |
|---|
| 9 |
<HR><H3>Help text</H3> |
|---|
| 10 |
<pre> |
|---|
| 11 |
VECPLOT routine to plot vectors. |
|---|
| 12 |
VECPLOT draws vectors on the current figure, at (x,y) |
|---|
| 13 |
locations determined in one of two ways. If the first |
|---|
| 14 |
argument to VECPLOT is a <A HREF = "../3.FEM/fem_grid_struct.html">fem_grid_struct</A>, then VECPLOT |
|---|
| 15 |
extracts the FEM domain coordinates as the vector origins. |
|---|
| 16 |
Otherwise, the user supplies the (x,y) coordinates |
|---|
| 17 |
explicitly. This flexibility exists because vector |
|---|
| 18 |
plotting does not require any knowledge of nodal |
|---|
| 19 |
connectivity, and perhaps the (u,v) data are not |
|---|
| 20 |
from a FEM model output. |
|---|
| 21 |
|
|---|
| 22 |
VECPLOT scales the magnitude of |
|---|
| 23 |
(u,v) by the magnitude of max(abs(u,v)) and then |
|---|
| 24 |
forces a vector of magnitude sc to be 10% of the x data |
|---|
| 25 |
range. By default, sc = 1., so that a 1 m/s vector will |
|---|
| 26 |
be scaled to 10% of the x data range. If sc=.5, then |
|---|
| 27 |
a vector magnitude of 50 cm/s will be scaled to 10% of the |
|---|
| 28 |
x data range. Decreasing sc serves to make the vectors |
|---|
| 29 |
appear larger. VECPLOT then prompts the user to place |
|---|
| 30 |
the vector scale on the figure, unless scale_xor,scale_yor |
|---|
| 31 |
is specified (see below). |
|---|
| 32 |
|
|---|
| 33 |
INPUT: <A HREF = "../3.FEM/fem_grid_struct.html">fem_grid_struct</A> (from <A HREF = "../3.FEM/loadgrid.html">LOADGRID</A>, see <A HREF = "../3.FEM/fem_grid_struct.html">FEM_GRID_STRUCT</A>) |
|---|
| 34 |
OR |
|---|
| 35 |
x,y - vector origins |
|---|
| 36 |
u,v - vector amplitudes |
|---|
| 37 |
These inputs are optional, but if one is needed, all |
|---|
| 38 |
preceeding it wil be required. |
|---|
| 39 |
sc - vector scaler; (optional; default = 1.) |
|---|
| 40 |
sclab - label for vector scale; (optional; default = 'cm/s') |
|---|
| 41 |
scale_xor,scale_yor - location to place vector scale |
|---|
| 42 |
|
|---|
| 43 |
OUTPUT: h - vector of handles to the vector lines drawn, the |
|---|
| 44 |
scale vector, and the scale vector text. |
|---|
| 45 |
|
|---|
| 46 |
NOTES: VECPLOT requires atleast 2 coordinates and vectors. |
|---|
| 47 |
|
|---|
| 48 |
CALL: hv=vecplot(x,y,u,v,sc,sclab) |
|---|
| 49 |
or |
|---|
| 50 |
hv=vecplot(<A HREF = "../3.FEM/fem_grid_struct.html">fem_grid_struct</A>,u,v,sc,sclab) |
|---|
| 51 |
|
|---|
| 52 |
Written by : Brian O. Blanton |
|---|
| 53 |
|
|---|
| 54 |
</pre> |
|---|
| 55 |
<HR><H3>Cross-Reference Information</H3>This function calls |
|---|
| 56 |
<pre><UL> |
|---|
| 57 |
<LI><A HREF = "../3.FEM/is_valid_struct.html">is_valid_struct</A>./FEM/is_valid_struct.m</LI> |
|---|
| 58 |
</UL></pre> |
|---|
| 59 |
<HR> |
|---|
| 60 |
Produced by <A HREF="http://www.nd.edu/Courses/kantor/matlab/mat2html">mat2html</A> on Tue Feb 2 16:15:45 EST 1999 |
|---|
| 61 |
<BR> |
|---|
| 62 |
Cross-Directory links are: OFF<BR> |
|---|
| 63 |
</BODY> |
|---|
