Matlab
tools Laboratory of Fluid Mechanics
Pulldown
menus on the toolbar of Labmenu.
Usage of
the View and Tools pulldown menus
Conditions
of data files (ASCII) to be read
Input,
and output of the menu items
15 June 2005
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.
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.
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.
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. |
|
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) |
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:
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.
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 |
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)
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.
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 |
|
x-cd
in m |
0.6 |
scale
factor measurement values to m |
0.0243 |
you will be back in the
main 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.
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.)
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.)