comparison m-toolbox/html_help/help/ug/ao_plot.html @ 0:f0afece42f48

Import.
author Daniele Nicolodi <nicolodi@science.unitn.it>
date Wed, 23 Nov 2011 19:22:13 +0100
parents
children
comparison
equal deleted inserted replaced
-1:000000000000 0:f0afece42f48
1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
2 "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
3
4 <html lang="en">
5 <head>
6 <meta name="generator" content=
7 "HTML Tidy for Mac OS X (vers 1st December 2004), see www.w3.org">
8 <meta http-equiv="Content-Type" content=
9 "text/html; charset=us-ascii">
10
11 <title>Plotting Analysis Objects (LTPDA Toolbox)</title>
12 <link rel="stylesheet" href="docstyle.css" type="text/css">
13 <meta name="generator" content="DocBook XSL Stylesheets V1.52.2">
14 <meta name="description" content=
15 "Presents an overview of the features, system requirements, and starting the toolbox.">
16 </head>
17
18 <body>
19 <a name="top_of_page" id="top_of_page"></a>
20
21 <p style="font-size:1px;">&nbsp;</p>
22
23 <table class="nav" summary="Navigation aid" border="0" width=
24 "100%" cellpadding="0" cellspacing="0">
25 <tr>
26 <td valign="baseline"><b>LTPDA Toolbox</b></td><td><a href="../helptoc.html">contents</a></td>
27
28 <td valign="baseline" align="right"><a href=
29 "ao_save.html"><img src="b_prev.gif" border="0" align=
30 "bottom" alt="Saving Analysis Objects"></a>&nbsp;&nbsp;&nbsp;<a href=
31 "collection_objects.html"><img src="b_next.gif" border="0" align=
32 "bottom" alt="Collection objects"></a></td>
33 </tr>
34 </table>
35
36 <h1 class="title"><a name="f3-12899" id="f3-12899"></a>Plotting Analysis Objects</h1>
37 <hr>
38
39 <p>
40 <p>
41 The data in an AO can be plotted using the <tt>iplot</tt> method.
42 </p>
43 <p>
44 The <tt>iplot</tt> method provides an advanced plotting interface for AOs which tries to make good use of all the information
45 contained within the input AOs. For example, if the <tt>xunits</tt> and <tt>yunits</tt> fields of the input AOs are set, these labels
46 are used on the plot labels.
47 </p>
48
49 <p>
50 In addition, <tt>iplot</tt> can be configured using a input <tt>plist</tt>. The following examples show some of the
51 possible ways to use <tt>iplot</tt>
52 </p>
53
54 <div class="fragment"><pre>
55 >> a1 = ao(plist(<span class="string">'tsfcn'</span>, <span class="string">'sin(2*pi*0.3*t) + randn(size(t))'</span>, <span class="string">'fs'</span>, 10, <span class="string">'nsecs'</span>, 20))
56 ----------- ao 01: a1 -----------
57
58 name: None
59 data: (0,0.887479404587351) (0.1,-0.449797172615395) (0.2,0.479022102390939) ...
60 -------- tsdata 01 ------------
61
62 fs: 10
63 x: [200 1], double
64 y: [200 1], double
65 dx: [0 0], double
66 dy: [0 0], double
67 xunits: [s]
68 yunits: []
69 nsecs: 20
70 t0: 1970-01-01 00:00:00.000
71 -------------------------------
72
73 hist: ao / ao / SId: fromTSfcn ... $-->$Id: ao ... S
74 mdlfile: empty
75 description:
76 UUID: 67d31c2f-8ee5-42ba-a96b-cfb288ecc9ea
77 ---------------------------------
78
79 >> a1.data
80 -------- tsdata 01 ------------
81
82 fs: 10
83 x: [200 1], double
84 y: [200 1], double
85 dx: [0 0], double
86 dy: [0 0], double
87 xunits: [s]
88 yunits: []
89 nsecs: 20
90 t0: 1970-01-01 00:00:00.000
91 -------------------------------
92 </pre></div>
93 <p> Creates a time-series AO. If we look at the data object contained in this AO, we see that the <tt>xunits</tt>
94 are set to the defaults of seconds [s].</p>
95 <p>If we plot this object with <tt>iplot</tt> we see these units reflected in the x and y axis labels.</p>
96 <div class="fragment"><pre>
97 >> iplot(a1)
98 </pre></div>
99
100 <img src="images/ao_iplot_eg1.png" alt="AO iplot eg1" border="3" width="600px">
101
102 <p>We also see that the time-origin of the data (<tt>t0</tt> field of the <tt>tsdata</tt> class) is displayed as the plot title.</p>
103
104
105
106
107
108
109 </p>
110
111 <br>
112 <br>
113 <table class="nav" summary="Navigation aid" border="0" width=
114 "100%" cellpadding="0" cellspacing="0">
115 <tr valign="top">
116 <td align="left" width="20"><a href="ao_save.html"><img src=
117 "b_prev.gif" border="0" align="bottom" alt=
118 "Saving Analysis Objects"></a>&nbsp;</td>
119
120 <td align="left">Saving Analysis Objects</td>
121
122 <td>&nbsp;</td>
123
124 <td align="right">Collection objects</td>
125
126 <td align="right" width="20"><a href=
127 "collection_objects.html"><img src="b_next.gif" border="0" align=
128 "bottom" alt="Collection objects"></a></td>
129 </tr>
130 </table><br>
131
132 <p class="copy">&copy;LTP Team</p>
133 </body>
134 </html>