LTPDA Toolbox™

contents

Version 2.3 LTPDA Toolbox Software

This table summarizes what's new in Version 2.3:

• Introduction
• New toolbox features
• New Algorithms and Functions
• Changes to the LTPDA Workbench
• Updates to the Statespace Modelling class
• Deprecated methods

Introduction

This version of LTPDA is 2.3. This document lists the changes since V2.2.

New toolbox features

As well as a large number of bug fixes, version 2.3 of LTPDA has various significant changes and new features.

• The viewing of object history via the DOT interpreter now does a smarter job for shared sections of the history tree.
• The saving of LTPDA objects to XML files has been completely rewritten. The resulting XML files are now significantly smaller and the reading and writing is much faster.
• We no longer convert LTPDA objects to structures when saving to MAT files. This used to be necessary due to a bug in MATLAB R2008a, but that bug is now fixed and we can skip this step. This results in much faster saving and loading, and in smaller MAT files.
• The time class now supports arithmetic operations: plus and minus.
• pest/eval has been modified to allow evaluation of pest & smodels with multiple x (independent variables)
• The smodel class supports now multiple 'xvar', 'xvals', and 'xunits' values. This allows the evaluation of the outputs of multidimensional fit routines (e.g. lscov, bilinfit)

New Algorithms and Functions

• ao/removeVal - a method to remove unwanted values from a data set
• ao/rotate - applies a rotation factor to the input AOs
• ao/buildWhitener - builds a whitening filter for the input AO

Changes to the LTPDA Workbench

• The workbench now has a “Parameter Overview” dialog which shows a list of all parameters of all blocks on the active canvas. This is useful to compare the different parameters for different blocks. The table can be sorted by block name, parameter key, parameter value.
• The workbench now has a console showing messages, warnings, and errors. The console can be opened and brought to the front when the pipeline is executed. This behaviour is configurable in the workbench preferences.
• The layout of the controls and various panels has been changed to maximise the canvas area. Now all controls and tables are arranged in the tab panel on the left leaving the whole of the right of the screen for the canvas.
• The commenting-out of blocks is now more under the user’s control. To support this, the pipeline variables are no longer cleared from the MATLAB workspace when the pipeline is executed. That means that blocks which were previously executed and are then commented out, still have values in the workspace which can be used.
• ctrl-o (cmd-o) now offers to load a workbench from disk. This means that the current workbench will be reset (the user is prompted if the workbench is not saved) and then the workbench from disk will be loaded.
• ctrl-shift-o offers the user to import the pipelines from a workbench on disk in to the current workbench.
• Closing a pipeline (with the little cross on the pipeline window) no longer deletes it from the workbench. Double clicking the pipeline in the pipeline list makes the window appear again.
• To remove a pipeline from the workbench, you can right click in the pipeline list and select "remove pipeline" or select "Pipeline -> Remove from Workbench".
• The "File -> Export Active Pipeline As..." has now moved to "Pipeline -> Export As..."

Updates to the Statespace Modelling class

• The ssm property mmats was removed, as it was not used.
• The block names are now upper-case, port names lower case. The characters ' ' and '.' are now forbidden.
• The function resp returns the step/impulse response of an ssm for specified i/o.
• The function "bode2" is now "bode", and does not need the control toolbox.
• The function bode now has default values for the frequency vector.
• cpsd and psd are new functions. They return the output theoretical noise spectrum given an input psd/cpsd. cpsd accepts cross spectral inputs. psd takes only diagonal noise inputs, but returns the individual noise contributions as well as the total contribution, cpsd returns only the total contribution.
• The input indexes for kalman, simulate, bode, steadyState, psd, cpsd, resp was modified. Now are accepted : the strings 'ALL', 'NONE', or a cellstr with mixed port and block-names. Port names may be specified as 'portName ' or 'blockName.portName', 'blockName_portName' for a faster detection. The outputs are now returned in the order provided by the user in the cellstr.
• The function "reorganize" was introduced. It does a pre-processing of the system's matrices for the functions kalman, simulate, bode, steadyState, psd, cpsd, resp. If these functions are called multiple times, it allows for a faster execution.
• The noise inputs to simulate and kalman were modified to match each other, and split into two options ((two sided) 'cpsd' and 'variance') so the user can scale the input white noise according to his needs.
• simulate, kalman, psd, cpsdn bode and resp now call iplot if no output variable is provided by the user.
• The ssm built-in model facility looks for upper-case m-files names.
• The function parameterDiff provides a numerical differentiation of the system's outputs regarding some selected parameters.
• The function "append" allows to merge multiple ssms without assembling the input/output blocks. Assemble now works with a single system as an input.
• The conversion from/to a pzmodel bug is corrected, gain is now correct.
• The conversion from a parfrac is now enabled.

Deprecated methods

The following ao methods are deprecated

• timedomainfit
• straightLineFit
• curvefit
• evaluateModel

Version 2.3.1 LTPDA Toolbox Software

Version 2.2 LTPDA Toolbox Software

©LTP Team