Mercurial > hg > ltpda

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

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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>Version 2.1 LTPDA Toolbox Software (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 "releasenotesV2_2.html"><img src="b_prev.gif" border="0" align=
30 "bottom" alt="Version 2.2 LTPDA Toolbox Software"></a>&nbsp;&nbsp;&nbsp;<a href=
31 "releasenotesV2_0_1.html"><img src="b_next.gif" border="0" align=
32 "bottom" alt="Version 2.0.1 LTPDA Toolbox Software"></a></td>
33 </tr>
34 </table>
35
36 <h1 class="title"><a name="f3-12899" id="f3-12899"></a>Version 2.1 LTPDA Toolbox Software</h1>
37 <hr>
38
39 <p>
40
41 <!-- BEGIN: Content file -->
42
43 <a name="top_of_page"></a>
44 <p>This table summarizes what's new in Version 2.1:</p>
45 <table cellspacing="0" class="body" cellpadding="4" border="2" width="100%">
46 <colgroup>
47 <col width="25%">
48 <col width="25%">
49 <col width="25%">
50 <col width="25%">
51 </colgroup>
52 <thead>
53 <tr valign="top">
54 <th bgcolor="#B2B2B2" valign="top"><p>New Features and Changes</p></th>
55 <th bgcolor="#B2B2B2" valign="top"><p>Version Compatibility Considerations</p></th>
56 <th bgcolor="#B2B2B2" valign="top"><p>Fixed Bugs and Known Problems</p></th>
57 <th bgcolor="#B2B2B2" valign="top"><p>Related Documentation at Web Site</p></th>
58 </tr>
59 </thead>
60 <tbody>
61 <tr valign="top">
62 <td bgcolor="#F2F2F2"><p>Yes<br>Details below</p></td>
63 <td bgcolor="#F2F2F2"><p>Yes &#8212; Details labeled as <b>Deprecated methods</b> in descriptions of changes, below. See also <a href="#deprecated">Summary</a>.</p></td>
64 <td bgcolor="#F2F2F2"><p><a href="https://ed.fbk.eu/ltpda/mantis/login_page.php" target="_top">Bug Reports</a> at Web site</p></td>
65 <td bgcolor="#F2F2F2"><p>Printable Release Notes: <a href="http://www.lisa.aei-hannover.de/ltpda/downloads/version_2_1/files/Release_Notes_v2.pdf" target="_top">PDF</a></p></td>
66 </tr>
67 </tbody>
68 </table>
69 <p></p>
70 <ul>
71 <li><p><a href="#introduction">Introduction</a></p></li>
72 <li><p><a href="#newFeatures">New toolbox features</a></p></li>
73 <li><p><a href="#newWbFeatures">New Workbench features</a></p></li>
74 <li><p><a href="#newAOMethods">New AO methods</a></p></li>
75 <li><p><a href="#mc">Main Changes</a></p></li>
76 <li><p><a href="#deprecated">Deprecated methods</a></p></li>
77 </ul>
78
79 <!-- HEADLINE: Introduction -->
80
81 <h3 class="title" id="introduction">Introduction</h3>
82 <p>This version of LTPDA is 2.1. This document lists the changes since V2.0.1.</p>
83
84 <!-- HEADLINE: New toolbox features -->
85
86 <h3 class="title" id="newFeatures">New toolbox features</h3>
87 <p>Version 2.1 of LTPDA has various new features.</p>
88 <ul>
89 <li><p>Analysis Objects have two new properties, <b>dx</b> and <b>dy</b>,
90 for storing errors/uncertainties on the <b>x</b> and <b>y</b> data
91 vectors. Currently, the spectral estimation tools
92 (<b>psd, cohere</b>, etc) are calculating sample variances and
93 assigning the values to <b>dy</b>. In this release, errors are not
94 properly propagated through all additional functions; this is
95 sometimes left to the user to handle. In a future release, the aim is
96 to properly handle error propagation in all functions, where possible.
97 Often this will mean deleting these vectors, or calculating new errors
98 based on the input AOs.</p></li>
99 <li>
100 <p>All user objects now have the following new fields:</p>
101 <ul>
102 <li><p>description: a string that can be assigned to describe the object</p></li>
103 <li><p>procinfo: a <b>plist</b> containing additional information
104 produced during processing by an algorithm. The contents of the
105 <b>plist</b> depend on the algorithm being applied.</p></li>
106 </ul>
107 </li>
108 <li><p>Documentation (<b>>>help</b> method) has been significantly
109 simplified. Now the details of the parameters for configuring a method
110 are dynamically created and presented to the user in the MATLAB help
111 browser after clicking on the &lsquo;Parameter Sets&rsquo; link in the
112 help text.</p></li>
113 <li>
114 <p>New user classes:</p>
115 <ul>
116 <li><p><b>smodel</b>: defines parametric models of an X variable which can be combined and evaluated to AOs.</p></li>
117 <li><p><b>matrix</b>: a container class which can be used to group together other user objects and perform some basic matrix operations on the group of objects, not necessarily on the data in the objects.</p></li>
118 <li><p><b>filterbank</b>: represents a bank of digital filters. It can be either a &lsquo;parallel&rsquo; or &lsquo;serial&rsquo; filter bank.</p></li>
119 </ul>
120 </li>
121 <li><p>All user classes now support built-in models.</p></li>
122 <li><p>LTPDA now provides direct access to NDS (version 1) servers using
123 the AO constructor &lsquo;From NDS Server&rsquo;. This requires the (3rd party)
124 NDS client mex files to be available on the MATLAB path.</p></li>
125 <li><p>The repository interactions are now done through purpose written
126 java code so that no database toolbox is required. Also, the
127 repository GUI (repogui) has been removed and the various features
128 are replaced by individual GUI components which can be launched either
129 via the workbench or via the new workspace browser
130 (<b>workspaceBrowser</b>).</p></li>
131 <li><p>A new GUI, the Workspace Browser (workspaceBrowser) allows fast
132 access to various toolbox features as well as showing the current
133 LTPDA user objects in the workspace.</p></li>
134 </ul>
135
136 <!-- HEADLINE: New Workbench features -->
137
138 <h3 class="title" id="newWbFeatures">New Workbench features</h3>
139 <p>Apart from various cosmetic improvements, the workbench has the following new features:</p>
140 <ul>
141 <li><p>The workbench now has a &lsquo;recent files&rsquo; list under the File menu</p></li>
142 <li><p>The workbench now has the concept of an &lsquo;Execution plan&rsquo;. Any or
143 all of the pipelines in the workbench can be entered in the execution
144 plan. The full plan can then be executed in the order given. To edit
145 the plan: File->Plan->Edit. To run the plan: File->Plan->Run.</p></li>
146 <li>
147 <p>New block types:</p>
148 <ul>
149 <li><p>&lsquo;From Pipeline&rsquo; block allows the user to link
150 together pipelines in the current workbench. Double clicking
151 the &lsquo;From Pipeline&rsquo; block allows the user to select
152 the source to be from the output of any block on any other
153 pipeline in the workbench. This goes along with the new &lsquo;
154 Plan&rsquo; concept.</p>
155 </li>
156 <li><p>Mux/Demux blocks allow objects to be put in to, or removed from, arrays.</p></li>
157 <li><p>&lsquo;To Workspace&rsquo; block pushes the objects to the MATLAB workspace.</p></li>
158 </ul>
159 </li>
160 <li><p>A graphical representation of the current pipeline can be exported
161 as a JPEG image.</p></li>
162 <li><p>The workbench has a new panel called the &lsquo;Shelf&rsquo;.
163 Users can store subsystems on the shelf and pull them off anytime in
164 the future to include them in a different pipeline. The Shelf supports
165 nested categories, exporting and importing of categories, and adding
166 of subsystems from the canvas or from the shelf context menus.</p></li>
167 <li><p>The pipelines of the current workbench are now shown in a tree-like
168 structure, where the subsystems of each pipeline can also be seen.</p></li>
169 <li><p>The block-property table has been re-coded to more nicely present
170 the options to the user.</p></li>
171 <li>
172 <p>The parameter list table now supports:</p>
173 <ul>
174 <li><p>activating and deactivating individual parameters</p></li>
175 <li><p>double-click in-place editing of the key and value</p></li>
176 <li><p>selection of parameters with options via drop-down menus</p></li>
177 <li><p>selection of boolean parameters via check-boxes</p></li>
178 <li><p>editing of parameter values in special editors via the edit
179 button (&lsquo;...&rsquo;)</p></li>
180 <li><p>changing the type of a parameter (double/char/boolean) via the context menu</p></li>
181 </ul>
182 </li>
183 <li>
184 <p>The workbench has the following new block button commands:</p>
185 <ul>
186 <li><p><img alt="Controls save" width="18px" height="18px" src="images/release2_1_save.png">saves the outputs of selected objects to disk.</p></li>
187 <li><p><img alt="Controls save" width="18px" height="18px" src="images/release2_1_table.png">displays the data of the selected objects in tables.</p></li>
188 <li><p><img alt="Controls save" width="18px" height="18px" src="images/release2_1_report.png">present a report on the selected objects.</p></li>
189 </ul>
190 </li>
191 <li>
192 <p>New menu entries for</p>
193 <ul>
194 <li><p>show quickblock (ctrl-b)</p></li>
195 <li><p>edit canvas info (ctrl-i)</p></li>
196 <li><p>search workbench (ctrl-f)</p></li>
197 </ul>
198 </li>
199 <li><p>The element searching now has new features, like the ability
200 to choose whether to search for block names, algorithms, or both.
201 Info about the block <b>plist</b> is now shown as a tooltip on the
202 results table, and double clicking a result highlights that block in
203 the workbench.</p></li>
204 <li><p>The workbench now supports plain text documents.</p></li>
205 <li><p>The workbench output files have seen some optimisation and are much
206 smaller than in earlier versions.</p></li>
207 <li><p>A new special editor for keys: 'xunit', 'xunits', 'yunit', 'yunits', 'unit'.</p></li>
208 <li><p>A new special editor for assembling a list of colors that can, for
209 example, be passed to <b>iplot</b>. So far this will activate for any
210 parameter with key 'colors' or 'linecolors'.</p></li>
211 <li><p>A new special editor for a cell-array of line-styles, like that
212 used in configuring iplot.</p></li>
213 <li><p>A new special editor for building a list of markers. Activated for
214 key 'markers'.</p></li>
215 <li><p>A new special editor for the key 'plotinfo'. Allows to edit the
216 line style, line width, color and marker for AOs.</p></li>
217 <li><p>The workbench can now be attached to any or all output objects
218 from all blocks on a pipeline. The workbench can then be loaded from
219 the object, whether it&rsquo;s on disk or in the MATLAB workspace.
220 To attach the workbench to an object, select the block and set the
221 property &lsquo;Attach Workbench&rsquo; in the property table.
222 To import a pipeline from an existing object,
223 &lsquo;File->Import Pipelines->From LTPDA Object...&rsquo;.</p></li>
224 <li><p>Blocks can be &lsquo;Commented Out&rsquo; (deactivated) on
225 the pipeline. These &lsquo;commented out&rsquo; blocks will not be
226 considered during pipeline execution.</p></li>
227 <li>
228 <p>The workbench now supports some direct interaction with an LTPDA
229 Repository, avoiding the need to go through the repository GUI.
230 For example, it is possible to:</p>
231 <ul>
232 <li><p>(dis-)connect to a repository via the (dis-)connect (<img alt="Connect Button" width="18px" height="18px" src="images/release2_1_connect.png"><img alt="Disconnect Button" width="18px" height="18px" src="images/release2_1_disconnect.png">) button(s)</p></li>
233 <li><p>To submit the output of the selected blocks to the repository (pipeline must have been executed first) using the submit (<img alt="Connect Button" width="18px" height="18px" src="images/release2_1_add_to_database.png"><img alt="Disconnect Button" width="18px" height="18px" src="images/release2_1_disconnect.png">) button.</p></li>
234 <li><p>Query a repository using the query button (<img alt="Connect Button" width="18px" height="18px" src="images/release2_1_add_to_database.png"><img alt="Disconnect Button" width="18px" height="18px" src="images/release2_1_search_database.png">). Results of the query can be used to automatically build constructor blocks on the current pipeline.</p></li>
235 </ul>
236 </li>
237 <li><p>The workbench now has an autosave feature. This can be activated in the preferences (&lsquo;File->Preferences...&rsquo;) and the interval can be set.</p></li>
238 </ul>
239
240 <!-- HEADLINE: New AO methods -->
241
242 <h3 class="title" id="newAOMethods">New AO methods</h3>
243 <ul>
244 <li><p><b>ao/table</b>: display the data in the AO in a graphical table.</p></li>
245 <li><p><b>ao/normdist</b>: computes a normal distributed pdf based on the
246 mean and variance of the data in the AO.</p></li>
247 <li><p><b>ao/corr</b>: computes the sample correlation matrix using
248 Pearson's product-moment method.</p></li>
249 <li><p><b>ao/linSubtract</b>: subtract linear contributions to a data set.</p></li>
250 <li><p><b>ao/filtSubtract</b>: subtracts a frequency dependent noise
251 contribution from an input ao.</p></li>
252 <li><p><b>ao/hypot</b>: robust computation of square-root of the sum of the squares.</p></li>
253 <li><p><b>ao/xfit</b>: fits a function of x to a data set using simplex
254 non-linear fitting routine.</p></li>
255 <li><p><b>ao/tdfit</b>: fits a model to a set of input and output data.
256 The parametric model (<b>smodel</b>) should represent the system(s)
257 which gives the outputs for the given inputs.</p></li>
258 </ul>
259
260 <!-- HEADLINE: Main Changes -->
261
262 <h3 class="title" id="mc">Main Changes</h3>
263 <ul>
264 <li><p>All user-created objects now have a Universal Unique Identifier
265 (UUID) which is reset whenever the object is modified (a history step
266 is added).</p></li>
267 <li><p>Cross-spectral estimators (<b>ltfe, cohere</b>, etc) now only
268 accept two inputs and return a single output.</p></li>
269 <li><p><b>ao/lscov</b> now returns a vector of AOs, each containing a
270 single parameter, with units and errors.</p></li>
271 <li><p>The statespace modelling class has been heavily rewritten and as
272 such behaves differently than in previous versions. Review the LTPDA
273 documentation for the new behaviour of this class.</p></li>
274 <li><p>On Windows, Microsoft&rsquo;s Visual C++ compiler version 2008 is used
275 to compile the mex files. That means that the appropriate runtime
276 environment must be installed. The installation files for 32-bit
277 (<b>vcredist_x86.exe</b>) and 64-bit (<b>vcredist_x64.exe</b>) are
278 included in the ltpda/src directory.</p></li>
279 <li>
280 <p>updated versions of <b>fft</b> and <b>ifft</b>.</p>
281 <ul>
282 <li>
283 <p><b>fft</b></p>
284 <p>&ndash; added 'plain' option which output the standard matlab <b>fft</b> results. Available parameters are now 'type' = 'plain', 'one' (onesided), 'two' (twosided)</p>
285 <p>&ndash; frequency bins now are correctly calculated</p>
286 </li>
287 <li>
288 <p><b>ifft</b></p>
289 <p>&ndash; option twosided is no more necessary, the algorithm now is capable to distinguish between 'plain' fft, twosided fft, onesided fft with odd nfft or onesided fft with even nfft</p>
290 </li>
291 </ul>
292 </li>
293 <li><p><b>ao/iplot</b> now supports the <b>plotinfo</b> field of an AO.
294 This means that each AO can be given specific plotting attributes.
295 The <b>plotinfo</b> field can be set using <b>ao/setPlotinfo</b>.
296 It is a parameter list of properties and values; see help of
297 <b>ao/iplot</b> for supported properties. The values in <b>plotinfo</b>
298 override all other inputs to <b>iplot</b> for that particular AO.</p></li>
299 <li><p>The AO methods <b>polyfit, zDomainFit</b> and <b>sDomainFit</b> now return matrix objects. This change is not backwards compatible.</p></li>
300 </ul>
301
302 <!-- HEADLINE: Deprecated methods -->
303
304 <h3 class="title" id="deprecated">Deprecated methods</h3>
305 <p>The following ao methods are deprecated</p>
306 <ul>
307 <li><p><b>ao/curvefit</b>: has been replaced by <b>ao/xfit</b> and as such will no longer be maintained.</p></li>
308 <li><p><b>ao/pwelch</b>: is still deprecated. Use <b>ao/psd</b> instead.</p></li>
309 </ul>
310
311 <!-- END: Content file -->
312
313 </p>
314
315 <br>
316 <br>
317 <table class="nav" summary="Navigation aid" border="0" width=
318 "100%" cellpadding="0" cellspacing="0">
319 <tr valign="top">
320 <td align="left" width="20"><a href="releasenotesV2_2.html"><img src=
321 "b_prev.gif" border="0" align="bottom" alt=
322 "Version 2.2 LTPDA Toolbox Software"></a>&nbsp;</td>
323
324 <td align="left">Version 2.2 LTPDA Toolbox Software</td>
325
326 <td>&nbsp;</td>
327
328 <td align="right">Version 2.0.1 LTPDA Toolbox Software</td>
329
330 <td align="right" width="20"><a href=
331 "releasenotesV2_0_1.html"><img src="b_next.gif" border="0" align=
332 "bottom" alt="Version 2.0.1 LTPDA Toolbox Software"></a></td>
333 </tr>
334 </table><br>
335
336 <p class="copy">&copy;LTP Team</p>
337 </body>
338 </html>