Mercurial > hg > ltpda

comparison m-toolbox/html_help/help/ug/releasenotesV2_2.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.2 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_3.html"><img src="b_prev.gif" border="0" align=
30 "bottom" alt="Version 2.3 LTPDA Toolbox Software"></a>&nbsp;&nbsp;&nbsp;<a href=
31 "releasenotesV2_1.html"><img src="b_next.gif" border="0" align=
32 "bottom" alt="Version 2.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.2 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.2:</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>New repository manager</b> in descriptions of changes, below. See also <a href="#rm">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.2/files/Release_Notes_v2.2.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="#newFitting">New linear fitting tools in LTPDA</a></p></li>
74 <li><p><a href="#rm">New repository manager</a></p></li>
75 </ul>
76
77 <!-- HEADLINE: Introduction -->
78
79 <h3 class="title" id="introduction">Introduction</h3>
80 <p>This version of LTPDA is 2.2. This document lists the changes since V2.1.</p>
81
82 <!-- HEADLINE: New toolbox features -->
83
84 <h3 class="title" id="newFeatures">New toolbox features</h3>
85 <p>Version 2.2 of LTPDA has various new features.</p>
86 <ul>
87 <li><p>A reworking of the way connections to LTPDA repositories are handled. Now all connections are managed by the new "LTPDA Repository Manager" object which is created when <b>ltpda_startup</b> is executed. <i>All users should review their use of repository connection code in any scripts and make the appropriate changes to work with the repository manager</i> (<a href="#rm">see below</a>).</p></li>
88 <li><p>A significant amount of work has been done on fitting tools (<a href="#newFitting">see below</a>).</p></li>
89 <li><p>A new class called pest (parameter estimation) has been included which aims to capture details of the various fitting procedures in LTPDA. <i>Objects of this class are now output from all LTPDA fitting function, so some changes to existing analysis scripts and pipelines may be necessary</i>.</p></li>
90 </ul>
91
92 <!-- HEADLINE: New linear fitting tools in LTPDA -->
93
94 <h3 class="title" id="newFitting">New linear fitting tools in LTPDA</h3>
95 <p>The linear fitting tools are specialised <b>ao</b> methods, built around MATLAB's <b>lscov</b>. All of them return a <b>pest</b> (parameters estimate) object where the fields are containing:</p>
96 <ol>
97 <li><p>Fit parameters</p></li>
98 <li><p>Uncertainties on the fit parameters (given as standard deviations)</p></li>
99 <li><p>The reduced CHI2 of the fit</p></li>
100 <li><p>The covariance matrix</p></li>
101 <li><p>The degrees of freedom of the fit.</p></li>
102 </ol>
103 <p>The following methods are implemented:</p>
104 <ul>
105 <li><p><b>ao/linfit</b> solves an equation in the form <b>Y = P(1) + X * P(2)</b> for the fit parameters <b>P</b>.</p></li>
106 <li><p><b>ao/bilinfit</b> solves an equation in the form <b>Y = X(1) * P(1) + X(2) * P(2) + ... + P(N+1)</b> for the fit parameters <b>P</b>.</p></li>
107 <li><p><b>ao/polyfit</b> overloads <b>polyfit()</b> function of MATLAB for Analysis Objects. It finds the coefficients of a polynomial P(X) of degree N that fits the data Y best in a least-squares sense: <b>P(1)*X^N + P(2)*X^(N-1) +...+ P(N)*X + P(N+1)</b></p></li>
108 <li><p><b>ao/polynomfit</b> solves an equation in the form <b>Y = P(1) * X^N(1) + P(2) * X^N(2) + ...</b> for the fit parameters <b>P</b>. It handles arbitrary powers of the input vector and uncertainties on the dependent vector Y and input vectors X.</p></li>
109 <li><p><b>ao/lscov</b> is a wrapper for MATLAB's <b>lscov</b> function. It solves a set of linear equations by performing a linear least-squares fit. It solves the problem <b>Y = HX</b> where X are the parameters, Y the measurements, and H the linear equations relating the two.</p></li>
110 </ul>
111
112 <!-- HEADLINE: New repository manager -->
113
114 <h3 class="title" id="rm">New repository manager</h3>
115 <p>Until the main documentation is updated, the following a some quick tips to using
116 the new repository manager.</p>
117 <p>Only a single instance of the repository manager exists. It is created when you
118 run <b>ltpda_startup</b>. To access the repository manager, you can do:</p>
119 <div class="fragment"><pre>
120 >> rm = LTPDARepositoryManager
121 ---- Repository Manager -----
122 connections: 0
123 connected: 0
124 ------------------------------</pre></div>
125 <p>The Repository Manager has both a scripting interface and a graphical user interface. To launch the GUI:</p>
126 <div class="fragment"><pre>
127 >> rm.showGui</pre></div>
128 <img src="images/RepositoryManager.png" alt="Repository Manager" border="3" width="588px" height="267px" vspace="10px">
129 <p>Using the scripting interface, you can create new connections and search for existing connects:</p>
130 <div class="fragment"><pre>
131 >> rm.newConnection('localhost', 'ltpda_test', 'hewitson')</pre></div>
132 <p>specifying the hostname, the database and the username. You can also give the password
133 in plain text to the newConnection command, but that's clearly not advisable.</p>
134 <p>Making new connections like this allows you to set up your typical connections in
135 your <b>startup.m</b> file (after executing <b>ltpda_startup</b>).</p>
136 <p>A couple of words about time-outs. The repository manager uses two timers to maintain two
137 aspects of each connection.</p>
138 <p>The first timer handles whether or not the connection is actually connected to the server. This
139 timer is not user configurable and is set to fire every few seconds so that connections are
140 typically in the disconnected state (you can see this state in the 'age' column of the
141 repository manager gui). Whenever the user tries to use a valid existing connection, the
142 connection is opened and then locked until it is not needed anymore. This is transparent for
143 the user and is handled automatically in methods like <b>submit</b>, <b>retrieve</b> and <b>update</b>.</p>
144 <p>The second timer is user configurable via the LTPDA preferences. This timer defines when the
145 password for each connection expires. This creates a level of safety so that connections from
146 one user can not easily be abused by other uses. When this password fires, it checks how
147 long each connection has been idle, and clears the password if it is older than the setting in
148 the preferences. Connections with their password cleared are red on the repository manager
149 gui. The next time the user attempts to use a connection whose password has been cleared,
150 they will be prompted to re-enter the password.</p>
151
152 <!-- END: Content file -->
153
154 </p>
155
156 <br>
157 <br>
158 <table class="nav" summary="Navigation aid" border="0" width=
159 "100%" cellpadding="0" cellspacing="0">
160 <tr valign="top">
161 <td align="left" width="20"><a href="releasenotesV2_3.html"><img src=
162 "b_prev.gif" border="0" align="bottom" alt=
163 "Version 2.3 LTPDA Toolbox Software"></a>&nbsp;</td>
164
165 <td align="left">Version 2.3 LTPDA Toolbox Software</td>
166
167 <td>&nbsp;</td>
168
169 <td align="right">Version 2.1 LTPDA Toolbox Software</td>
170
171 <td align="right" width="20"><a href=
172 "releasenotesV2_1.html"><img src="b_next.gif" border="0" align=
173 "bottom" alt="Version 2.1 LTPDA Toolbox Software"></a></td>
174 </tr>
175 </table><br>
176
177 <p class="copy">&copy;LTP Team</p>
178 </body>
179 </html>