NCCOOS Trac Projects: Top | Web | Platforms | Processing | Viz | Sprints | Sandbox | (Wind)

root/gliderproc/trunk/MATLAB/opnml/html/3.FEM/plotdrog.html

Revision 495 (checked in by cbc, 11 years ago)

Initial import of Stark code.

Line 
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>plotdrog</H1>
6 <H2>(./FEM/plotdrog.m)</H2>
7 <HR><H3>Function Synopsis</H3>
8 <pre>h=plotdrog(x,y,ndrog,tstride,dstride)</pre>
9 <HR><H3>Help text</H3>
10 <pre>
11 PLOTDROG plot drogue .pth file output from DROG3D or DROG3DDT.
12    PLOTDROG plots the paths of drogue locations as specified
13    in the x,y coordinate arrays.  PLOTDROG takes as required
14    arguments the x,y coordinates of the drogue locations AND
15    the number of drogues in the path file.  The path information
16    from  DROG3D or DROG3DDT can be read into MATLAB with
17    READ_PTH, which reads .pth files.
18
19    PLOTDROG draws each drogue with a separate line, solid
20    by default.  Each drogue line is referenced with
21    one object handle.  Therefore, to change the linetype or
22    color of the lines, use the MATLAB command SET and the handle
23    returned by PLOTDROG.
24
25    Even though READ_PTH returns the entire path matrix, only
26    two columns of it are passed to PLOTDROG.  It is up to the
27    user to make sure the correct ones are passed in.  I.e.,
28    there is no way for PLOTDROG to ensure x,y represent
29    HORIZONTAL coordinates, etc.
30
31    INPUT:
32          x,y      - x,y coordinates of drogues
33          ndrog   - number of drogues in path matrix;
34                     this number is returned by READ_PTH
35          tstride - time stride (optional, def = 1) is
36                     the number of timesteps to skip over.  1 would
37                     mean &quot;plot all timesteps&quot;; 2 would mean &quot;plot
38                     every other timestep&quot;; i.e., skip every other
39                     timestep; etc...
40          dstride - drogue stride (optional, def = 1) is
41                     the number of drogues to skip; see tstride above.
42                     In order to specify dstride, you must also specify
43                     tstride.
44
45          Both tstride and dstride can be vectors of specific timesteps
46          or drogue numbers to plot.  In order to plot only ONE drogue
47          or ONE timestep, pass into PLOTDROG the values of tstride
48          and/or dstride enclosed in {}'s.  For example, to
49          plot the initial drogue locations, call PLOTDROG as:
50          &gt;&gt; h=plotdrog(x,y,ndrog,{1});
51          To plot the 3rd drogue for all timesteps, call PLOTDROG as:
52          &gt;&gt; h=plotdrog(x,y,ndrog,1,{3});
53  
54  OUTPUT:
55           h       - the handle(s) to the path lines on the current axes
56
57           dstride - the number of drogues to skip, see tstride above.
58                     In order to specify dstride, you must also specify
59                     tstride.
60
61    CALL:  h=plotdrog(x,y,ndrog);
62           h=plotdrog(x,y,ndrog,tstride);
63           h=plotdrog(x,y,ndrog,tstride,dstride);
64          
65  Written by: Brian O. Blanton
66
67 </pre>
68 <HR>
69 Produced by <A HREF="http://www.nd.edu/Courses/kantor/matlab/mat2html">mat2html</A> on Tue Feb  2 16:15:45 EST 1999
70 <BR>
71 Cross-Directory links are: OFF<BR>
72 </BODY>
Note: See TracBrowser for help on using the browser.