0
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 1
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 2 <!-- BEGIN: Content file -->
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 3
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 4 <a name="top_of_page"></a>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 5 <p>This table summarizes what's new in Version 2.2:</p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 6 <table cellspacing="0" class="body" cellpadding="4" border="2" width="100%">
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 7 <colgroup>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 8 <col width="25%">
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 9 <col width="25%">
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 10 <col width="25%">
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 11 <col width="25%">
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 12 </colgroup>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 13 <thead>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 14 <tr valign="top">
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 15 <th bgcolor="#B2B2B2" valign="top"><p>New Features and Changes</p></th>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 16 <th bgcolor="#B2B2B2" valign="top"><p>Version Compatibility Considerations</p></th>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 17 <th bgcolor="#B2B2B2" valign="top"><p>Fixed Bugs and Known Problems</p></th>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 18 <th bgcolor="#B2B2B2" valign="top"><p>Related Documentation at Web Site</p></th>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 19 </tr>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 20 </thead>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 21 <tbody>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 22 <tr valign="top">
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 23 <td bgcolor="#F2F2F2"><p>Yes<br>Details below</p></td>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 24 <td bgcolor="#F2F2F2"><p>Yes — Details labeled as <b>New repository manager</b> in descriptions of changes, below. See also <a href="#rm">Summary</a>.</p></td>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 25 <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>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 26 <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>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 27 </tr>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 28 </tbody>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 29 </table>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 30 <p></p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 31 <ul>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 32 <li><p><a href="#introduction">Introduction</a></p></li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 33 <li><p><a href="#newFeatures">New toolbox features</a></p></li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 34 <li><p><a href="#newFitting">New linear fitting tools in LTPDA</a></p></li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 35 <li><p><a href="#rm">New repository manager</a></p></li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 36 </ul>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 37
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 38 <!-- HEADLINE: Introduction -->
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 39
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 40 <h3 class="title" id="introduction">Introduction</h3>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 41 <p>This version of LTPDA is 2.2. This document lists the changes since V2.1.</p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 42
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 43 <!-- HEADLINE: New toolbox features -->
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 44
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 45 <h3 class="title" id="newFeatures">New toolbox features</h3>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 46 <p>Version 2.2 of LTPDA has various new features.</p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 47 <ul>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 48 <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>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 49 <li><p>A significant amount of work has been done on fitting tools (<a href="#newFitting">see below</a>).</p></li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 50 <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>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 51 </ul>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 52
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 53 <!-- HEADLINE: New linear fitting tools in LTPDA -->
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 54
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 55 <h3 class="title" id="newFitting">New linear fitting tools in LTPDA</h3>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 56 <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>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 57 <ol>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 58 <li><p>Fit parameters</p></li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 59 <li><p>Uncertainties on the fit parameters (given as standard deviations)</p></li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 60 <li><p>The reduced CHI2 of the fit</p></li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 61 <li><p>The covariance matrix</p></li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 62 <li><p>The degrees of freedom of the fit.</p></li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 63 </ol>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 64 <p>The following methods are implemented:</p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 65 <ul>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 66 <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>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 67 <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>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 68 <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>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 69 <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>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 70 <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>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 71 </ul>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 72
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 73 <!-- HEADLINE: New repository manager -->
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 74
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 75 <h3 class="title" id="rm">New repository manager</h3>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 76 <p>Until the main documentation is updated, the following a some quick tips to using
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 77 the new repository manager.</p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 78 <p>Only a single instance of the repository manager exists. It is created when you
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 79 run <b>ltpda_startup</b>. To access the repository manager, you can do:</p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 80 <div class="fragment"><pre>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 81 >> rm = LTPDARepositoryManager
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 82 ---- Repository Manager -----
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 83 connections: 0
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 84 connected: 0
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 85 ------------------------------</pre></div>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 86 <p>The Repository Manager has both a scripting interface and a graphical user interface. To launch the GUI:</p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 87 <div class="fragment"><pre>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 88 >> rm.showGui</pre></div>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 89 <img src="images/RepositoryManager.png" alt="Repository Manager" border="3" width="588px" height="267px" vspace="10px">
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 90 <p>Using the scripting interface, you can create new connections and search for existing connects:</p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 91 <div class="fragment"><pre>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 92 >> rm.newConnection('localhost', 'ltpda_test', 'hewitson')</pre></div>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 93 <p>specifying the hostname, the database and the username. You can also give the password
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 94 in plain text to the newConnection command, but that's clearly not advisable.</p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 95 <p>Making new connections like this allows you to set up your typical connections in
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 96 your <b>startup.m</b> file (after executing <b>ltpda_startup</b>).</p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 97 <p>A couple of words about time-outs. The repository manager uses two timers to maintain two
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 98 aspects of each connection.</p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 99 <p>The first timer handles whether or not the connection is actually connected to the server. This
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 100 timer is not user configurable and is set to fire every few seconds so that connections are
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 101 typically in the disconnected state (you can see this state in the 'age' column of the
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 102 repository manager gui). Whenever the user tries to use a valid existing connection, the
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 103 connection is opened and then locked until it is not needed anymore. This is transparent for
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 104 the user and is handled automatically in methods like <b>submit</b>, <b>retrieve</b> and <b>update</b>.</p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 105 <p>The second timer is user configurable via the LTPDA preferences. This timer defines when the
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 106 password for each connection expires. This creates a level of safety so that connections from
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 107 one user can not easily be abused by other uses. When this password fires, it checks how
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 108 long each connection has been idle, and clears the password if it is older than the setting in
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 109 the preferences. Connections with their password cleared are red on the repository manager
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 110 gui. The next time the user attempts to use a connection whose password has been cleared,
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 111 they will be prompted to re-enter the password.</p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 112
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 113 <!-- END: Content file -->