view m-toolbox/html_help/help/ug/ao_plot_content.html @ 0:f0afece42f48

Import.
author Daniele Nicolodi <nicolodi@science.unitn.it>
date Wed, 23 Nov 2011 19:22:13 +0100
parents
children
line wrap: on
line source

<!-- $Id: ao_plot_content.html,v 1.5 2009/09/29 22:27:12 ingo Exp $ -->
<p> 
  The data in an AO can be plotted using the <tt>iplot</tt> method.
</p>
<p>
  The <tt>iplot</tt> method provides an advanced plotting interface for AOs which tries to make good use of all the information
  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
  are used on the plot labels.
</p>

<p>
  In addition, <tt>iplot</tt> can be configured using a input <tt>plist</tt>. The following examples show some of the
  possible ways to use <tt>iplot</tt>
</p>

<div class="fragment"><pre>
    >> 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))
    ----------- ao 01: a1 -----------
 
           name:  None
           data: (0,0.887479404587351) (0.1,-0.449797172615395) (0.2,0.479022102390939) ...
                 -------- tsdata 01 ------------
              
                     fs:  10
                      x:  [200 1], double
                      y:  [200 1], double
                     dx:  [0 0], double
                     dy:  [0 0], double
                 xunits:  [s]
                 yunits:  []
                  nsecs:  20
                     t0:  1970-01-01 00:00:00.000
                 -------------------------------
                  
           hist:  ao / ao / SId: fromTSfcn ... $-->$Id: ao ... S
        mdlfile:  empty
    description:  
           UUID:  67d31c2f-8ee5-42ba-a96b-cfb288ecc9ea
    ---------------------------------

    >> a1.data
    -------- tsdata 01 ------------
 
        fs:  10
         x:  [200 1], double
         y:  [200 1], double
        dx:  [0 0], double
        dy:  [0 0], double
    xunits:  [s]
    yunits:  []
     nsecs:  20
        t0:  1970-01-01 00:00:00.000
    -------------------------------
</pre></div>
<p> Creates a time-series AO. If we look at the data object contained in this AO, we see that the <tt>xunits</tt>
are set to the defaults of seconds [s].</p>
<p>If we plot this object with <tt>iplot</tt> we see these units reflected in the x and y axis labels.</p>
<div class="fragment"><pre>
    >> iplot(a1)
</pre></div>

<img src="images/ao_iplot_eg1.png" alt="AO iplot eg1" border="3" width="600px">

<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>