tstool - A toolbox for nonlinear time series analysis


TSTOOL FREQUENTLY ASKED QUESTIONS WITH ANSWERS
15 Feb 1998 Christian Merkwirth 

Index
Section 1. Introduction and General Information
Q1.1 What is tstool ?
Q1.2 What software is required to run tstool ?
Q1.3 On which systems does TSTOOL run ?
Q1.4 What about Octave ?
Q1.5 How do I install tstool ?
Q1.6 Is there a graphical user inteface (GUI) for tstool ?
Q1.7 Is tstool PD ? Copyrighted ?
Section 2. Signal creation/import/export
How do I create a sine/noise/pulse signal ?
How do I convert a matlab vector/matrix to a signal ?
How do I create a signal from an ASCII file on disk ?
How do I create a signal from an WAVE file on disk ?
How do I load a signal that was previously stored on disk ?
How do I store a signal ?
Section . Analysing signals
Finding the minimum/maximum of a signal
Finding the first zero/zero crossing of a signal
Section . Extending tstool/Programming with tstool
How can I write a script to automatize common tasks ?
How can I write my own routines for the tstool package ?
What is class 'signal' for ?
What is class 'core' for ?
What is class 'description' for ?
What is class 'achse' for ?
Why is class 'achse' called 'achse' and not 'axis' ?
What is class 'unit' for ?
How is class 'unit' used in TSTOOL ?
Section 8. Miscellaneous information and questions answered
Section 9. Frequently encountered error messages

Section 1. Introduction and General Information

Question 1.1. What is tstool ?
tstool is a software package for nonlinear time series analysis, though it has a lot of features a general signal analysis package would have.

Question 1.2 What software is required to run tstool ?
tstool is written almost completely in MATLAB, a powerful language for scientific computing. Therefore you need MATLAB version 5.0 or higher to run tstool. MATLAB is not free !

Question 1.3 On which systems does TSTOOL run ?
It should work on any system which can run MATLAB 5.0 or higher !

Question 1.4 What about Octave ?
Octave is a freely available language for scientific computing that strongly resembles matlab. Unfortunately, TSTOOL will not run under Octave.
TSTOOL makes use of the object oriented features of MATLAB. In the current version of Octave (2.0.10) there's no support for classes. Even if classes will be supported in future, it's not shure wheter TSTOOL will work properly. Maybe someone is willing to port TSTOOL to Octave.

Question 1.5 How do I install tstool ?
Installation for UNIX systems :
TSTOOL comes as tarred and gzipped archive file (tstool.tgz). It is recommended
that you create an own directory (e.g. "tstool") where you can put all the files
belonging to tstool. In this directory, unpack it by typing :
% gunzip -c tstool.tgz | tar -xvf -
Installation for UNIX systems :
The easiest way to work with it now is to start MATLAB in the directory that you created to hold TSTOOL. Then all path settings will be done by the startup script that comes with TSTOOL. If you want to use your own startup.m somewhere else, you have to merge your own startup.m and the startup.m that comes with tstool by hand.
Some hints :
- tstoolpath.m must be in the same directory as the resulting startup.m
- only directory tstoolbox and tstoolbox/demos must by in MATLAB's search path.
Installation for Windows (95/NT) systems :
?????????????????? (don't know, what the hell is "Windows" ?)

Question 1.6 Is there a graphical user inteface (GUI) for tstool ?
Yes, there is. Simply type tstool on the matlab prompt and a graphical user inteface should come up.

Section . Extending tstool/Programming with tstool

What is class 'unit' for ?
Objects of class 'unit' try to model physical units. No one wonders that his computer can multiply real or complex numbers. But in physics or engineering, you also have to mulitply or divide physical units, just think of Ohm's law : R = U/I
So, give it a try and type : unit('V') / unit('A') on the matlab prompt.
What happens is :
MATLAB creates two unit objects by searching a unit database for the strings 'V' and 'A'. There it will find entries for Volt and Ampere. It will set all properties of both objects according to the data found in this database. Then MATLAB uses overloaded arithmetic to divide both unit objects. The properties of the resulting object will be completed by another lookup of the unit database.

How is class 'unit' used in TSTOOL ?
Consider the measurement of sound pressure with a microphon. All measured values are no pure numbers, they also have a physical unit, in this case Pascal ('Pa'). The unit that belongs to the measured data is called 'yunit' in TSTOOL jargon.
But not only the data values themself have a physical unit. There's also a x-axis (usually a time axis) that has a physical unit, e.g. unit('s') (seconds).
Because of TSTOOL's ability to handle multidimensional signals, there may be more than one x-axis, each with it's own unit.