0
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 2 "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 3
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 4 <html lang="en">
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 5 <head>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 6 <meta name="generator" content=
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 7 "HTML Tidy for Mac OS X (vers 1st December 2004), see www.w3.org">
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 8 <meta http-equiv="Content-Type" content=
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 9 "text/html; charset=us-ascii">
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 10
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 11 <title>Constructing AOs from data files (LTPDA Toolbox)</title>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 12 <link rel="stylesheet" href="docstyle.css" type="text/css">
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 13 <meta name="generator" content="DocBook XSL Stylesheets V1.52.2">
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 14 <meta name="description" content=
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 15 "Presents an overview of the features, system requirements, and starting the toolbox.">
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 16 </head>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 17
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 18 <body>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 19 <a name="top_of_page" id="top_of_page"></a>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 20
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 21 <p style="font-size:1px;"> </p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 22
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 23 <table class="nav" summary="Navigation aid" border="0" width=
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 24 "100%" cellpadding="0" cellspacing="0">
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 25 <tr>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 26 <td valign="baseline"><b>LTPDA Toolbox</b></td><td><a href="../helptoc.html">contents</a></td>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 27
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 28 <td valign="baseline" align="right"><a href=
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 29 "ltpda_training_topic_1_5.html"><img src="b_prev.gif" border="0" align=
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 30 "bottom" alt="Saving and loading AOs"></a> <a href=
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 31 "ltpda_training_topic_1_7.html"><img src="b_next.gif" border="0" align=
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 32 "bottom" alt="Writing LTPDA scripts"></a></td>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 33 </tr>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 34 </table>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 35
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 36 <h1 class="title"><a name="f3-12899" id="f3-12899"></a>Constructing AOs from data files</h1>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 37 <hr>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 38
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 39 <p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 40 <p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 41 You can build AOs from existing ASCII data files. Various formats are supported,
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 42 for example, multiple columns, files containing comments.
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 43 </p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 44 <br>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 45 <h2>Install the data pack</h2>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 46 <br>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 47 <p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 48 The data-pack for this training session should be downloaded from the <a href="http://www.lisa.aei-hannover.de/ltpda/training_sessions/training_session_1/training_session_1.html">LTPDA web-site</a>.
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 49 The zip file will expand to a top-level directory. This should contain sub-directories
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 50 for each topic of the training session.
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 51 </p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 52 <p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 53 The rest of the tutorial will assume that you have changed directories in MATLAB
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 54 to the data-pack directory so that filenames are relative to that directory. To
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 55 change the working directory of MATLAB, either use the MATLAB interface
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 56 or type
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 57 </p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 58 <div class="fragment"><pre>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 59 cd /path/to/my/data/pack
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 60 </pre></div>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 61 <br>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 62 <h2>Create an AO from a simple ASCII file</h2>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 63 <br>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 64 <p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 65 The data-pack contains a simple two-column text file which represents a time-series
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 66 sampled at 10Hz. The first column contains the time-stamps, the second column the amplitude values.
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 67 </p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 68 <p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 69 To convert this data file to an AO, use the following command:
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 70 </p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 71 <div class="fragment"><pre>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 72 >> pl = plist(<span class="string">'filename'</span>, <span class="string">'topic1/simpleASCII.txt'</span>, ...
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 73 <span class="string">'columns'</span>, [1 2], ...
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 74 <span class="string">'type'</span>, <span class="string">'tsdata'</span>);
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 75 >> a = ao(pl)
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 76 M: constructing from plist
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 77 M: load file: simpleASCII.txt
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 78 M: constructing from filename and/or plist
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 79 M: constructing from data object tsdata
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 80 ----------- ao 01: simpleASCII.txt_01_02 -----------
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 81
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 82 name: simpleASCII.txt_01_02
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 83 data: (0,1.13549060238654) (0.1,2.37202031808076) (0.2,-0.531181753855465) (0.3,1.25684477541224) (0.4,1.30895517480354) ...
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 84 -------- tsdata 01 ------------
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 85
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 86 fs: 10
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 87 x: [1000 1], double
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 88 y: [1000 1], double
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 89 dx: [0 0], double
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 90 dy: [0 0], double
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 91 xunits: []
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 92 yunits: []
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 93 nsecs: 100
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 94 t0: 1970-01-01 00:00:00.000
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 95 -------------------------------
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 96
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 97 hist: ao / ao / SId: fromDatafile.m,v 1.39 2011/04/18 16:55:26 ingo Exp S-->SId: ao.m,v 1.346 2011/05/07 06:56:17 mauro Exp S
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 98 description:
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 99 UUID: bde61c39-2c7e-4e77-9c15-6e6a4cc29e12
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 100 ----------------------------------------------------
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 101 </pre></div>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 102 <p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 103 From the output on the screen you can see that
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 104 <ol>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 105 <li>the name of the AO has automatically been set based on the filename and
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 106 the columns of data loaded</li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 107 <li>the sample rate of the data is 10Hz, as expected</li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 108 <li>the length of the data is 100s</li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 109 </ol>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 110 </p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 111 <p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 112 You can plot this data and see that it is just a randon noise time-series.
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 113 </p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 114 <br>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 115 <h2>Create an AO from a multi-column ASCII file</h2>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 116 <br>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 117 <p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 118 The data-pack contains a data file which contains multiple columns of data. Here
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 119 we will load only selected columns from the file and produce multiple AOs, one
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 120 for each column loaded. Column 1 of the file contains the time-stamps; columns
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 121 2-6 contain sine waves at frequencies 1-5Hz.
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 122 </p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 123 <p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 124 Let's load the 2Hz and 4Hz sine waves from the file. At the same time, we'll
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 125 give the AOs names, Y units, and descriptions.
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 126 </p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 127 <div class="fragment"><pre>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 128 sigs = ao(plist(<span class="string">'filename'</span>, <span class="string">'topic1/multicolumnASCII.txt'</span>, ...
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 129 <span class="string">'type'</span>, <span class="string">'tsdata'</span>, ...
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 130 <span class="string">'columns'</span>, [1 3 1 5], ...
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 131 <span class="string">'name'</span>, {<span class="string">'sin2'</span>, <span class="string">'sin4'</span>}, ...
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 132 <span class="string">'yunits'</span>, {<span class="string">'m'</span>, <span class="string">'m'</span>}, ...
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 133 <span class="string">'description'</span>, {<span class="string">'sine wave at 2Hz'</span>, <span class="string">'sine wave at 4Hz'</span>}))
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 134 </pre></div>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 135 <p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 136 You can plot the results and focus on the first 2 seconds of data
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 137 </p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 138 <div class="fragment"><pre>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 139 sigs.iplot(plist(<span class="string">'XRanges'</span>, [0 2]))
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 140 </pre></div>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 141
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 142
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 143
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 144
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 145
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 146
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 147
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 148 </p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 149
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 150 <br>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 151 <br>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 152 <table class="nav" summary="Navigation aid" border="0" width=
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 153 "100%" cellpadding="0" cellspacing="0">
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 154 <tr valign="top">
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 155 <td align="left" width="20"><a href="ltpda_training_topic_1_5.html"><img src=
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 156 "b_prev.gif" border="0" align="bottom" alt=
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 157 "Saving and loading AOs"></a> </td>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 158
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 159 <td align="left">Saving and loading AOs</td>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 160
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 161 <td> </td>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 162
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 163 <td align="right">Writing LTPDA scripts</td>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 164
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 165 <td align="right" width="20"><a href=
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 166 "ltpda_training_topic_1_7.html"><img src="b_next.gif" border="0" align=
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 167 "bottom" alt="Writing LTPDA scripts"></a></td>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 168 </tr>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 169 </table><br>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 170
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 171 <p class="copy">©LTP Team</p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 172 </body>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 173 </html>