Matlab tools Laboratory of Fluid Mechanics

 

Usage of Labmenu. 2

Pulldown menus on the toolbar of Labmenu. 2

Usage of the View and Tools pulldown menus. 2

Conditions of data files (ASCII) to be read. 3

Purpose of the menu items. 4

Input, and output of the menu items. 5

Examples. 6

View: Measurements (Ascii) 6

View: Steerfile (*.dat) 7

Tools: Convert Ascii to Auke. 8

Tools: Refl. ir. wave. 9

Tools: Refl. reg. wave. 10

Tools: Variance spectrum.. 11

Tools: Amplitude spectrum.. 12


Usage of Labmenu

15 June 2005

 

Back to start

Pulldown menus on the toolbar of Labmenu

 

N.B.:     This program uses dialog boxes. In Matlab 7, dialog boxes will not be deleted immediately after clicking OK, but the program will continue; please don’t click OK again.

 

 

 

 

Usage of the View and Tools pulldown menus

Back to start

 

In most of the menu items, parameters are asked from the screen. In some cases, the parameters are read from a special input file.

The data to be processed must be stored in an ASCII-file. The conditions are listed in Conditions of data files (ASCII) to be read.

The options: View: measurements (ASCII) and Process: Refl. reg. wave will open submenus. From those menus data will be read into the workspace, and parameters can be changes by choosing options.

 

N.B.      After closing a (sub)menu, allways check the number of Matlab Windows (see Matlab icon in lower bar of monitor), and close all windows left open (except Labmenu).

            Don’t forget to jump back to a dialog box if help is consulted, and the box is left open.

 


Conditions of data files (ASCII) to be read

Back to start

 

 

 

 

The next errors may occur:

 

 

Number of colums in line -- of ASCII file ... must be the same as the previous line.

 

            In such a case, remove all spaces, signs, or numbers from the first position of each header line.

 

If the number of header lines specified is more than the actual number, no message will occur, but less data lines will be read.

 

 

where nchan is the number of channels used. If more data are needed, change the value of maxnum in \Functions\FN_indata7, line 86, or read the file in parts, using different sample numbers. Sample numbers to be read can be specified via the dialog box:

 

   read all samples?

           

            Specify No in this case.   

 

 

In a Dasylab file, it is preferable to store the time in decimal format. The time format with a ':' in Dasylab is not read as a time in Matlab.

 

For some scripts, a short manual has been written. The manuals can be viewed via Help, Manuals in Labmenu.

 

Back to start


Purpose of the menu items

Back to start

 

Menu Item

Purpose

Manual

View: Measurements

Menu to view measurements from ASCII-file

 

(ASCII)

 

 

 

 

 

View: Steerfile

Visualise a steerfile, generated by Multilin

 

(*.dat)

(DELFT-AUKE)

 

 

 

 

Tools:

Convert ASCII file to binary AUKE file, and generate

Man.doc

Convert ASCII to Auke

command file for DELFT-AUKE program Waves

 

 

 

 

Tools:

Separate irregular wave (continuous spectrum) in

Man.doc

Refl. ir. wave

incoming and reflected wave

 

 

 

 

Tools:

Separate regular wave in incoming and reflected

Refreg_eng.doc

Refl. reg. wave

wave

 

 

 

 

Tools:

Calculate variance spectrum for each wave gauge

Usage is same as

Variance spectrum

 

Decomp

 

 

 

Tools:

Calculate amplitude spectrum of a specified channel (1 channel);

 

Amplitude spectrum

Use in case of reg. wave with more harmonics;

for energies, use Variance spect.

 

 

Back to start


Input, and output of the menu items

Back to start

 

Menu Item

Input

Output

View: Measurements

Data file (*.asc);

Graph of desired samples from

(Ascii)

Parameters from screen

desired channels

 

 

 

View: Steerfile (*.dat)

Steerfile (.dat);

Graph of data specified by user

 

Parameters from screen

(from dialog box)

 

 

 

Tools:

Data file (*.asc);

AUKE file (*.dat, *.seq)

Convert Ascii to Auke

Parameters from screen

 

 

 

 

Tools: Refl. ir. wave

.txt-file with parameters about the

Spectra and/or time-series of

 

data file;

incoming and reflected wave

 

.txt-file with depth profile;

Data file (.asc)

 

 

 

 

Tools: Refl. reg. wave

Data file (*.asc);

.txt-file containing wave

 

Parameters from screen

parameters;

 

 

 

Tools:

 

Data file (*.asc);

 

Graph of variance spectrum per

 

Variance spectrum

Parameters from screen

gauge;

 

 

.txt-file containing wave parameters;

.asc-file containing spectra

 

 

 

Tools:

Data file (*.asc);

.txt-file of ampl. spectrum;

Amplitude spectrum

Parameters from screen

graph of amp. spectrum (no phase)

 

Back to start

 


Examples

Back to start

 

Each menu item has been tested using a specific input file.

The input files have been stored in .\Indata, and the output from the tests has been stored in .\Outdata.

 

Examples using specific input and out for each menu item:

View: Measurements (Ascii)

Back to start

 

 

N.B.:     This program uses dialog boxes. In Matlab 7, dialog boxes will not be deleted immediately after clicking OK, but the program will continue; please don’t click OK again.

 

N.B.      After closing a (sub)menu, allways check the number of Matlab Windows (see Matlab icon in lower bar of monitor), and close all windows left open (except Labmenu).

            Don’t forget to jump back to a dialog box if help is consulted, and the box is left open.

 

 

 

Read all samples?

Yes (use No in case of files of 20MB or more only)

Number of header lines

0 (because this is a Dasylab file)

time step in org. data file

0.1

column with times

1 (will be used to label the X-axes)

 

close the figures, and click on Plot: the samples or the figure type can be changed here

you will be back in the main Labmenu.

 

Back to start


View: Steerfile (*.dat)

 

Back to start

 

N.B.:     This program uses dialog boxes. In Matlab 7, dialog boxes will not be deleted immediately after clicking OK, but the program will continue; please don’t click OK again.

 

 

maximum number of samples

100 (-1 to end of file)

type of wave board (h hydraulic, e electrical)

h

units (val value, n normed value, V Voltage,

m amplitude of board in m)

V

 

 

Back to start

 


Tools: Convert Ascii to Auke

 

Back to start

 

N.B.:     This program uses dialog boxes. In Matlab 7, dialog boxes will not be deleted immediately after clicking OK, but the program will continue; please don’t click OK again.

 

 

Read all samples?

Yes (use No in case of files of 20MB or more only)

number of header lines

0 (because this is a Dasylab file)

time step in org. data file

0.1

water depth

0.6

number of columns to be analysed

4

 

column number: 2          (3, 4, and 5 in next screens)

x-cd:                             8          (8.25, 15, 15.25 in next screens)

scale factor:                  0.025    (in all screens)

(Note: the Dutch Windows version of Windows may hang if you try to overwrite an existing file)

 

Back to start

 


Tools: Refl. ir. wave

 

Back to start

 

N.B.:     This program uses dialog boxes. In Matlab 7, dialog boxes will not be deleted immediately after clicking OK, but the program will continue; please don’t click OK again.

 

Two input files are available: Jsh10.asc with 2 wave gauges, and H09s4.asc with 3 wave gauges.

Here only the file name and samples to be analysed will be asked from the screen. All othe parameters will be asked from .txt-files. Copy the text files, and supply your own case if you want to use your own measurements. More information in Help, Manuals, Refl. ir. wave, or in file \Docs\Decomp_eng.doc.

 

Read all samples?                      Yes (use No in case of files of 20MB or more only)

number of header lines:              0 (because this is a Dasylab file)

(Note: the Dutch Windows version of Windows may hang if you try to overwrite an existing file)

 

More information: Help, Manuals, Refl. ir. wave, or in file \Docs\Decomp_eng.doc.

 

Back to start

 


Tools: Refl. reg. wave

 

Back to start

 

N.B.:     This program uses dialog boxes. In Matlab 7, dialog boxes will not be deleted immediately after clicking OK, but the program will continue; please don’t click OK again.

 

N.B.      After closing a (sub)menu, allways check the number of Matlab Windows (see Matlab icon in lower bar of monitor), and close all windows left open (except Labmenu).

            Don’t forget to jump back to a dialog box if help is consulted, and the box is left open.

 

 

 

Read all samples?

Yes (use No in case of files of 20MB or more only)

number of header lines

0 (because this is a Dasylab file)

timestep in org. data file

0.02

number of harmonics to be printed

5

average waterdepth

0.5

 

OK

column number

6

x-cd in m

0

scale factor measurement values to m

0.0243

column number

5

x-cd in m

0.6

scale factor measurement values to m

0.0243

           

you will be back in the main Labmenu.

 

Back to start

 


Tools: Variance spectrum

 

Back to start

 

N.B.:     This program uses dialog boxes. In Matlab 7, dialog boxes will not be deleted immediately after clicking OK, but the program will continue; please don’t click OK again.

 

 

Read all samples?

Yes (use No in case of files of 20MB or more only)

number of header lines

0 (because this is a Dasylab file)

time step in org. data file

0.1

desired frequency step

0.02

max. frequency in graph

2

column with times

1

number of columns to be analysed

2

 

column number: 2          (3 in next screen)

scale factor:                  0.025    (in all screens)

type the time in seconds of the first and last sample to be used in the calculation (here: 150 and -1 resp.)

 

Back to start


Tools: Amplitude spectrum

 

Back to start

 

N.B.:     This program uses dialog boxes. In Matlab 7, dialog boxes will not be deleted immediately after clicking OK, but the program will continue; please don’t click OK again.

 

This option is of interest in case of a regular wave, because higher harmonics can be seen; in all other cases, the option Variance spectrum is preferrable, because amplitudes do not represent the amount of energy per frequency band; the phase must be included if using amplitudes.

 

Read all samples?

Yes (use No in case of files of 20MB or more only)

number of header lines

0 (because this is a Dasylab file)

time step in org. data file

0.02

threshold in spectrum; plot part of amp>thresh*amp_max

0.005

number of channels to be analysed

2

column number

5 (6 for second channel)

scale factor

0.0243

units

m

 

type the time in seconds of the first and last sample to be used in the calculation (here: 150 and -1 resp.)

 

Back to start