Appendix A3- Software Routines (*.m files)

 

Name

Description

audvidplayer

Play sound of DATA vector (ie plotted data only)

bin2xwav

Convert *.bin (ARP binary) files into *.x.wav files

calc_ltsa

Calculate spectral averages and save to ltsa file

check_dirlist_times

Get recording parameters and run difftime_dirlist for one file or whole directory 

check_ltsa_time

Check to see if plot time is within file limits

check_time

Check time of start of plot based on PARAMS.plot.dvec time

ck_ltsaparams

Check user defined ltsa parameters and adjusts/gives suggestions of better parameters so that there is integer number of averages per xwav file, called by mk_ltsa. 

control

Toggle on/off control window pull-down menus and buttons set and implement newtime, newtseg, newstep, coordinate display

control_ltsa

Toggle on/off control window pull-down menus and buttons set and implement newtime, newtseg, newstep, coordinate display

coorddisp

Display cursor values from Plot window in message window

decimatexwav

Decimate XWAV file

decimatexwav_dir

Decimate all XWAV files in directory

difftime_dirlist

This function reads raw HARP files disk directory and compares times between directory entries, used for data quality checking

disp_headSummary

Display PARAMS.headall structure in useful format

disp_msg

Display messages in message window

disp_pick

Display pickxyz in message window

displaybut

Display button operation

editHeader_psds

Used to change time or other header values for psds files (not used)

editHeader_xwav

Used to change time or other header values for XWAV files

filepd

File pull-down menu options/operations

get_headers

Open data files and read headers

get_ltsadir

Get directory of WAV/XWAV files

get_ltsaparams

Get parameters needed for generating LTSA’s from user

get_recordingparams

Get recording parameters needed for checking dirlist times

getIndexBin

Get time bin index in LTSA plot

helppd

Help pull-down menu

hrp2wav

Convert *.hrp files into *.wav files

hrp2xwav

Convert *.hrp files into *.x.wav files

init_coorddisp

Initializing cursor values

init_ltsadata

Initializing ltsa data stuff

init_ltsaparams

Initializing ltsa parameters

initcontrol

Initializing control window GUI

initdata

Initializing data and timing info

 

Name

Description

initparams

Initializing parameters

initpulldowns

Generate figure pull-down menus

initwins

Initialize plot, control and command (display) windows

little2big_2byte

Reads N x 2 array (a) and converts the 2 values from each row from little endian format to big endian format – array (b)

little2big_4byte

Reads N x 4 array (a) and converts the 4 values from each row from little endian format to big endian format – array (b)

logfmap

Return a matrix for premultiplying spectrograms to map the rows into a log frequency space

make_multixwav

Script to run write_hrp2xwavs over many hrp files to make xwavs

mk_headSummary

Make Summary of header values

mk_ltsa

Make LTSAs from XWAV files in a directory

mkspecgram

Make spectrogram plot from DATA

motion

Control motion of DATA plot with push button in control window

motion_ltsa

Control motion of DATA plot with push button in control window

multibin2xwav

Convert multiple *.bin files to *.x.wav files

obs2xwav

Convert *.obs files into *.x.wav files

pickxwav

Turn on picking time in LTSA files and open corresponding xwav file (i.e. zoom in)

pickxyz

Pick x, y, z cursor data from plot window

plot_ltsa

Plot LTSA data in plot window

plot_specgram

Plot spectrogram of data in plot window

plot_spectra

Plot spectra of data in plot window

plot_timeseries

Plot time series of data in plot window

plot_triton

Checks to see which plots are to be plotted and plots them

rdxwavhd

Reads XWAV or *.wav file header

read_ltsadata

Read LTSA data

read_ltsahead

Read LTSA header and directories

read_rawHARPdata

Reads one raw HARP disk data file, ~60000 sectors the first timing header will be read and used. 

read_rawHARPdir

Calls the function read_rawHARPhead to get disk header values then reads the directory list, rearranges values and puts values in global PARAMS variable

read_rawHARPhead

Read raw HARP disk header info from raw HARP datafile (*.hrp) and put disk header info into global variable structure PARAMS

read_xwavHDRfile

Hdrfile for hrp2xwavs input for generating xwavs from hrp files

readseg

Read a segment of data from opened file

timenum

Convert string time in format made from timestr.m (used to solve rounding problems created by datestr.m and outputs msecs and usecs)

Name

Description

timestr

Can be used instead of datestr.m to solve the rounding problems created by datestr.m and outputs msecs and usecs

toolpd

Tools pull-down menu operation

triton

MAIN

write_hrp2wavs

Writes multiple XWAV (*.x.wav) files(~1GB) from single raw HARP disk file (*.hrp).  The HRP files are essentially images if raw disks

write_ltsahead

Setup values for ltsa file and write header & directories for new ltsa file

write_XWAVhead

Write XWAV header values to output files

wrxwavhd

Write XWAV header values to output files