%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

Documentation of variables contained in lidarIR_sharedData.mat and used to produce Figures in submission of manuscript 2018JC014441, Remote Sensing of Spilling and Plunging Breakers in the Surf Zone, to the Journal of Geophysical Research - Oceans.  

Written by Roxanne J Carini
rjcarini@uw.edu
August 3, 2018

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

path: file path
fn: file names
targets: indices of files to use

NOTE: For all cell arrays, each cell contains all data from an individually tracked wave.

xprofilesCat: cross-shore x-values of uniformly gridded LIDAR data
zprofilesCat: elevation z-values of uniformly gridded LIDAR data
profilesMaskCat: IR breaker identification along wave profile (0=nonbreaking, 1=breaking)

tcat: time stamps (epoch time)
xcat: x-location of tracked peaks
zcat: z-elevation of tracked peaks
ztrprecat: z-elevation of tracked preceding troughs
xNormCat: normalized x coordinates
zNormCat: normalized z coordinates
Hcat: trough-to-peak wave height
Tcat: trough-to-trough wave period
hMSLcat: water depth of mean sea level (MSL)
zMSLcat: z-elevation of bathymetry relative to MSL

horizAsymmCat: horizontal asymmetry
vertSkewCat: veritcal skewness
waveWidthCat: "wavelength" relative to wave profile crossing MSL
linslopecat: wave slope estimate from linear fit to the upper XX% of the wave face
pH: vector of fractions 0.XX of the wave face used to create linear fit wave slopes

manTypecat: manual breaker type classification (0=nonbreaking, 1=steady state, 2=spilling onset observed, 3=plunging onset observed)
countNB: number of non-breaking waves tracked
countPlunge: number of plunging breakers tracked
countSpill: number of spilling breakers tracked
countSS: number of steady state breakers tracked
countTotal: number of total waves tracked
indNB: indices for non-breaking waves within concatenated arrays
indPlunge: indices for plunging breakers within concatenated arrays
indSpill: indices for spilling breakers within concatenated arrays
indSS: indices for steady state breakers within concatenated arrays