WaveAR User`s Manual
Contents
1. 10 AutoFit button automatically fits the slider parameters by least squares best fit to data 11 Print Results button and Create Fit File checkbox prints results to screen or to file if Create Fit File option checked 12 Probe Data button panel allows further inspection of data View Spectrum view spectrum at selected x location Check Sampling Rate determine sampling rate to avoid spectral leakage and aliasing 4 2 Additional features of WaveAR Sample rate estimation WaveAR can help determine a sampling rate to avoid spectral leakage and aliasing Load the data as directed in the previous sections The CSV data file does not require measurements for all x locations measurements from single x location is sufficient After loading the data press the Check Sampling Rate button and the Estimate Good Sampling Rate window appears Figure 11 Enter the desired number of data samples auto filled with number of samples in loaded data the desired signal period the maximum frequency to plot and the number of WaveAR User s Manual page 11 of 19 EJ WaveAR data fitting for file autowavedata csv Fi EJ WaveAR v1 0 TE 263 hfcm g0 error 1 0 0000 error 0 0001 First Harmonic Parameters Jarameters lock Number of Samples n alpha_2 0 Period of Signal to Sample T s 2 63 Maximium sampling frequency fs_max Hz 100 Number of harmonics to resohre 10 12 Distance from2. a E Ea X v9 0 00 Conditional Format Format Painter n dU ea a ae ae aes Aa B e E Formatting as Table Clipboard a Alignment E Number E M29 vi Ready 6 Example 1 2 100 125 150 175 200 225 250 275 300 325 3 99543 7 0826 9 68753 11 43 12 0428 11 43 9 68753 7 0826 3 99543 0 839274 2 02207 4 33888 6 00723 7 06177 3 97651 6 94627 9 44312 11 1096 11 6951 11 1096 9 44312 6 94627 3 97651 0 923619 1 86697 4 15455 5 83312 6 92536 3 91165 6 54256 8 72817 10 1763 10 6833 10 1763 8 72817 6 54256 3 91165 1 15811 1 42534 3 62404 5 32643 6 52148 3 77828 5 88707 7 59541 8 70939 9 09643 8 70939 7 59541 5 88707 3 77828 1 49019 0 76453 2 81149 4 53207 5 86596 3 54398 5 00517 6 12616 6 83076 7 07107 6 83076 6 12616 5 00517 3 54398 1 8419 0 014629 1 81364 3 51863 4 98446 3 17348 3 93092 4 42149 4 68962 4 77396 4 68962 4 42149 3 93092 3 17348 2 12282 0 793224 0 74608 2 36997 3 91141 2 63676 2 70579 2 5915 2 44534 2 38237 2 44534 2 5915 2 70579 2 63676 2 24527 1 45237 0 27288 1 17515 2 6886 1 91691 1 37702 0 74431 0 249518 0 063622 0 249518 0 74431 1 37702 1 91691 2 13935 1 8913 1 13859 0 01814 1 3635 1 0165 0 00423 1 02383 1 7698 2 04278 1 7698 1 02383 0 00423 1 0165 1 76556 2 04276 1 77401 1 03113 0 012679 0 03865 1 38483 2 6361 3 51969 3 83818 3 51969 2 6361 1 38483 0 03865 1 12299 1 88323 2 13935 1 92343 1 38692 1 19921 2 71177 4 03941 4 94822 5 2713 4 94822 4 0394
3. 251615 1 43653 2 23595 2 63339 2 70653 0 03865 1 38483 2 6361 3 51968 3 83818 3 51968 2 6361 1 38483 0 03865 1 12299 1 88323 2 13935 1 92343 1 38692 1 01651 0 00423 1 02383 1 7698 2 04278 1 7698 1 02383 0 00423 1 01651 1 76557 2 04276 1 77401 1 03113 0 012677 1 91691 1 37702 0 744312 0 24952 0 063625 0 24952 0 744312 1 37702 1 91691 2 13935 1 8913 1 13859 0 01815 1 3635 2 63676 2 70579 2 5915 2 44534 2 38237 2 44534 2 5915 2 70579 2 63676 2 24527 1 45237 0 272879 1 17515 2 68861 3 17348 3 93092 4 42149 4 68962 4 77397 4 68962 4 42149 3 93092 3 17348 2 12282 0 793224 0 74608 2 36997 3 91141 3 54398 5 00517 6 12616 6 83076 7 07107 6 83076 6 12616 5 00517 3 54398 1 8419 0 014628 1 81364 3 51863 4 98446 3 77828 5 88707 7 59541 8 7094 9 09643 8 7094 7 59541 5 88707 3 77828 1 49019 0 76453 2 81149 4 53207 5 86596 3 91165 6 54256 8 72817 10 1763 10 6833 10 1763 8 72817 6 54256 3 91165 1 15811 1 42534 3 62404 5 32643 6 52148 3 97651 6 94627 9 44312 11 1096 11 6951 11 1096 9 44312 6 94627 3 97651 0 923619 1 86697 4 15456 5 83312 6 92536 3 99543 7 0826 9 68753 11 43 12 0428 11 43 9 68753 7 0826 3 99543 0 839274 2 02207 4 33888 6 00723 7 06177 3 97651 6 94627 9 44312 11 1096 11 6951 11 1096 9 44312 6 94627 3 97651 0 923619 1 86697 4 15455 5 83312 6 92536 3 91165 6 54256 8 72817 10 1763 10 6833 10 1763 8 72817 6 54256 3 91165 1 15812 1 42534 3 62404 5 32643 6 52147 gt 3 77828 5 88707 7 5954 8 70939 9 09643 8 70939 7 5
4. 8 7758 1 1037 0 2500 6 9896 9 7168 1 8147 0 5000 7 2150 9 9974 2 0406 0 7500 6 8954 9 5984 1 7212 Figure 17 Lambda and lambda_2 are the wavelengths of the first and free second harmonics respectively The first harmonic second harmonic and rms amplitudes denoted by eta_1 eta_2 and eta_rms are defined in Eqs 6 4 and 7 in Landry et al 2012 respectively 7 Save the displayed results to a file by checking the Create Fit File box and pressing the Print Results button The resulting data files autowavedata fit and autowavedata fig a text fitting file and MATLAB figure file respectively will be saved to the same run folder where the data was initially loaded If a fitting parameter was locked by using the checkboxes the resulting data file names will be appended to indicate what was locked e g autowavedata_hold_R fit indicates that R was locked 7 Companion program VirtualWave Similar to WaveAR VirtualWave may be run as a standalone executable or in MATLAB The user should select the appropriate file same convention as WaveAR to run the software 7 1 Overview of VirtualWave GUI The VirtualWave GUI has panel groups for each parameter set e g first harmonic wave physical tank data sampling free second harmonic and visualization parameters Figure 18 The first and free second harmonic parameters for the VirtualWave program are the same as those presented in the main text for the
5. WaveAR software Additional data sampling parameters may be defined such as the sampling rate fs and the number of samples n for each of the WaveAR User s Manual page 17 of 19 VirtualWave VirtualWave A Virtual Water Wave Field Generator First harmonic wave parameters Incident amplitude A cm Enable Stokes Amplitude attenuation L Period T sec 2 Generate Reflection coefficient R Reflection phase shift theta Enable file saving Free second harmonic parameters Physical tank parameters Still water depth h cm Amplitude A 2 em z Reflection coeficient R 2 Data sampling parameters 2 Number of samples n 2048 Incident amplitude phase shit alpha 2 Sampling frequency fs Hz 42 4673 Reflection phase shift theta_2 Virtual probe locations xprobe m e g 0 0 5 22 0 05 22 Visualization parameters Spatial range x m i e 0 0 1 22 0 01 23 Temporal range t sec i e 0 0 08 5 26 0 0 08 5 26 Figure 17 Main VirtualWave GUI selected virtual wave gage probe locations Pressing the button in the data sampling parameter panel executes the Estimate appropriate sampling rate feature described on page 11 of this manual This estimate is explained in Eq 9 in Landry et al 2012 By entering the desired values in the Estimate appropriate sampling rate window and pressing Ok the estimated rate replaces the tex
6. file is displayed 4 Description of the main WaveAR GUI In this section various elements on the WaveAR interface are discussed in greater detail TE 363 h em g0 file autowavedata csv xi 0 error 1 0 0000 error 0 0001 First Harmonic Parameters HH Free Second Harmonic Parameters Create Fit File Figure 10 The main WaveAR GUI WaveAR User s Manual page 10 of 19 4 1 Key parameters in the WaveAR GUI 1 Wave period period of the water wave automatically loaded from data file see data file format section 2 Still water level still water level swl of the experimental tank facility automatically loaded from data file see data file format section 3 Lock checkboxes locks the parameter so the value will remain unchanged during the AutoFit data fitting algorithm listed in bullet 8 4 First harmonic fitting parameters A incident wave amplitude R reflection coefficient theta phase of the reflection coefficient L attenuation coefficient 5 file displays the name of the loaded file 6 Longitudinal offset oftset for x location values 7 errors harmonic fit errors as presented in Eq 8 of Landry et al 2012 8 Free second harmonic fitting parameters A_2 incident wave amplitude alpha_2 phase of the incident wave amplitude R_2 reflection coefficient theta_2 phase of the reflection coefficient 9 Get Data button allows the user to load data from a CSV file within a run folder
7. lock lock A 2 1 alpha_2 0 A 5 0004 l i fa 4 6 686794 9 R 0 99983 4 299982 theta 0 9999 4 theta_2 0 L 0 4 Probe Data View Spectrum Check Sampling Rate 1 8 36548e 868 2 226045e 614 2 22045e 814 Get Data AutoFit Print Results Create Fit File eta_2 cm 2 WaveAR results for data file autowavedata csv File USGHeSsiARAVTODE OF Amplitudes cm 6 3 7 6 3 1 3 6 Pa 6 3 1 3 6 fe 6 3 O 3 6 Wia 6 3 1 3 6 6 3 2 ae 6 je 6 3 1 3 6 7 6 3 O 3 6 SEER HONEA e h j jei N jh jei N GE eh jeh ORR C jh jh pk GE i H E NS NO D NO NO t G t ie ek o a Ua Oe be L a a hon eee ee one Cae co 0 2 4 6 8 10 12 14 16 18 20 22 Distance from Start of Sandbed x m TTI F Figure 8 Results printed to console window WaveAR User s Manual page 9 of 19 EJ WaveAR v1 0 TEE 263 hfem g0 file autowavedata csv xO 0 error 1 0 0000 error 0 0001 First Harmonic Parameters H _ Free Second Harmonic Parameters lock Create Fit File File autowavedata fit OPENED for writing in gt gt gt gt Co Users blandry2 Dropbox Blake_MattHancock code_and_example_data File CLOSED lt lt lt lt lt lt gt autowavedata fit and figd lt lt lt Figure 9 Results printed to output data file Full path to output
8. 1 2 71177 1 19921 0 251614 1 43653 2 23595 2 63339 2 70654 2 39549 3 93415 5 2051 6 04417 6 33744 6 04417 5 2051 3 93415 2 39549 0 77152 0 770236 2 10385 3 15917 3 92112 3 54398 5 00517 6 12616 6 83076 7 07107 6 83076 6 12616 5 00517 3 54398 1 8419 0 01463 1 81364 3 51863 4 98446 4 55628 5 88384 6 8118 7 35485 7 53296 7 35485 6 8118 5 88384 4 55628 2 8415 0 79893 1 45373 3 74287 5 85625 5 34921 6 53658 7 28026 7 67338 7 79433 7 67338 7 28026 6 53658 5 34921 3 655 1 46356 1 11522 3 86819 6 50355 5 85476 6 93847 7 55134 7 83945 7 92057 7 83945 7 55134 6 93847 5 85476 4 18596 1 90756 0 876617 3 92784 6 90193 6 02844 7 07415 7 63987 7 89035 7 95722 7 89035 7 63987 7 07415 6 02844 4 3704 2 06345 0 790862 3 94496 7 03641 5 85476 6 93846 7 55134 7 83945 7 92057 7 83945 7 55134 6 93846 5 85476 4 18596 1 90755 0 876617 3 92784 6 90193 5 34921 6 53658 7 28026 7 67338 7 79433 7 67338 7 28026 6 53658 5 34921 3 655 1 46356 1 11522 3 86819 6 50355 gt 4 55627 5 88384 6 8118 7 35485 7 53296 7 35485 6 8118 5 88384 4 55627 2 8415 0 79893 1 45373 3 74287 5 85625 3 54398 5 00517 6 12616 6 83076 7 07107 6 83076 6 12616 5 00517 3 54398 1 8419 0 01463 1 81364 3 51863 4 98446 2 39548 3 93415 5 2051 6 04416 6 33744 6 04416 5 2051 3 93415 2 39548 0 77152 0 770237 2 10385 3 15917 3 92112 1 19921 2 71177 4 03941 4 94822 5 2713 4 94822 4 03941 2 71177 1 19921 0
9. 8 186485776 Recommended Sample Frequency 97 3384 Using number of sample points 2646 Figure 12 Output from the Check Sampling Rate button Appropriate sampling rates are displayed with a gt next to the recommended rates Frequency spectrum The spectrum at a given x locations is produced by clicking the View Spectrum button in the Probe Data panel on the main WaveAR GUI A list dialog window appears for selecting the x location s to produce spectrums Figure 13 Multiple selections are accomplished by holding the shift key and or ctrl key while clicking the desired positions Click OK to confirm selection Another window appears prompting for number of harmonics to plot up to Figure 14 After specifying a value and clicking OK a plot window entitled Single Sided Spectral Plots displays the spectra corresponding to the user specified x locations Figure 15 WaveAR User s Manual page 13 of 19 BJ WaveARr v1 0 Til h cm First Harmonic Parameters lock Ln Prd in ha A 5 0004 rae in Fa iri fa R 0 99963 En fe 8 ia N ino in j Figure 13 List dialog window to select the x positions for spectral viewing BJ WaveAR v1 0 T a h em file aut 0 eror 1 0 0000 error2 0 0001 First Harmonic Parameters lock A 5 0004 R 0 99963 Create Fit File Figure 14 Input dialog for number of harmonics to plot i
10. 954 5 88707 3 77828 1 49019 0 76453 2 81149 4 53207 5 86596 3 54398 5 00517 6 12616 6 83076 7 07107 6 83076 6 12616 5 00517 3 54398 1 8419 0 01463 1 81364 3 51863 4 98446 Figure 16 CSV data file displayed in MS Excel Color corresponds to legend above Open the WaveAR program Click Get Data button Browse the example data folder within the WaveAR folder select the 3 4 5 autowavedata csv file and click Open to load the file After the WaveAR data fitting window appears manually adjust the sliders on the main WaveAR program window Helpful hint start by adjusting the values A and R Once the fit is fairly close press the AutoFit button to optimize the fit least squares error for each harmonic corresponding to the fit will update see Figure 10 circle 7 The theta sliders may need to be readjusted if they are positioned at 0 or 2r WaveAR User s Manual page 16 of 19 6 Click the Print Results button with the Create Fit File option unchecked and the following text should appear either in the console or command window T sec 2 63 T_2 sec 1 315 h cm 60 lambda m 6 00794 lambda_2 m 2 45935 A cm 5 00043 R 0 999828 theta 0 9999 A_2 cm 1 alpha_2 0 R 2 0 theta _ 2 0 L 0 X1 m 0 Xend m 22 Error of fit for 1st harm 0 0000 Error of fit for 2nd harm 0 0001 X m eta_rms cm eta_1 cm eta_2 cm 0 0000 6 2543
11. AR v1 0 TRE 263 h cm gp file autowavedata csv xO 0 error 1 1 0000 error 1 0000 First Harmonic Parameters Free Second Harmonic Parameters lock lock A 2 0 alpha_2 0 Coe E F Wi L EN a R_2 0 theta 0 theta_2 0 L 0 E Create Fit File Figure 5 Main WaveAR GUI with First Harmonic Parameters Free Second Harmonic Parameters and Probe Data panels which appear after loading data WaveAR User s Manual page 6 of 19 4 By adjusting the parameter sliders the fitted and measured wave harmonic amplitudes are matched across the entire domain e g the wave tank First and second harmonic fits denoted by blue and red lines resp Figure 6 HJ WaveAR v1 0 TE 963 Hem gp file autowavedata csv xi 0 error 0 6762 error 0 4255 First Harmonic Parameters 444 44 _ Free Second Harmonic Parameters lock ck A 0 Coama aor Petes C Create Fit File j WaveAR data fitting for file autowavedata csv File Edit View Insert Tools Desktop Window Help OGMs s Qooes B O8 ao iB ro ai Ea rT a ra ir i Hl Harmonic Amplitudes cm sai as Vd Vd al 1 14 20 Distance from Start of Sandbed x m Figure 6 Data fitting by adjusting parameter sliders in the main WaveAR GUI Blue and red lines denote the 1 and 2 harmonic amplitude fits respectively WaveAR User s Manual page 7 of 19 5 Once the fitted and measured profiles are cl
12. Start of Sandbed x m Figure 11 Estimate Good Sampling Rate input dialog displays after clicking the Check Sampling Rate button on the main WaveAR GUI harmonics to resolve Then click OK and text similar to Figure 12 is displayed Appropriate sampling rates are indicated by gt The program recommends the fastest of these rates at the bottom of the output e g 97 3384 Hz for 2048 points Figure 12 WaveAR User s Manual page 12 of 19 EJ WaveAR v1 0 TEE 263 h cm go file autowavedata cay xO 0 error 1 0 0000 efror 0 0001 First Harmonic Parameters _ Free Second Harmonic Parameters lock lock A 2 4 alpha_2 8 3655e 008 aso O eS a IE i a AE R2 2 22704e 014 theta_2 2 22404e 014 P Perea Probe Drata ___ ___ n eee l View Spectrum Check Sampling Rate Create Fit File 4 C Users blandry2 Dropbox Blake_MattHancock code_and_example_data complied_versions Wa Check Sampling Number of samples found 2648 Period found 2 63 sec Entered wave period 2 6368 sec Min sampling for 3 harmonics is 4 563 Hz Complete List tHpoints2sample 20489 p GOOD values between 4 56274 Hz and i188 Hz H of Waves Sampling Frequency He 2 389 35361 174 6761 33846 66920 33460 16730 08365 04183 52091 FOBAE 38023 19811 02506 04753 02376 H1188 131872 262144 52426
13. WaveAR User s Manual lt WaveAR v1 0 i es 4 C Users blandry2 Dropbox Blake_MattHancock code_and_example_da _ E x T s 263 h cm r x0 0 error 1 0 6515 error2 0 4401 Number of samples found 2040 Period found 2 63 sec Entered wave period 2 6300 sec Min sampling for 3 harmonics is 4 563 Hz First Harmonic Parameters Free Second Harmonic Parameters lock lock A2 0 alpha_2 3 2954 A 5 1163 gt 7 100 Hz R 0 44186 gt as gt of Waves Sampling Frequency Hz Time2sample min b theta 4 7489 theta_2 2 1 A 194 67601 RT 8 97 33840 0 35 16 48 66920 0 70 32 24 33460 1 40 GetData AutoFt Print Resutts 64 12 16730 2 81 128 08365 5 61 i 256 3 04183 11 22 Check Sampling Rate ee 512 52091 22 44 1024 76046 44 89 2048 38023 89 77 a B bow rn 4896 19611 179 54 ata Fitting 8192 09506 359 08 16384 104753 718 17 File 32768 PERA 1436 33 L 2 65536 01188 2872 66 OGmas Aavoue2 08 131072 00594 5745 32 262144 524288 1048576 00297 11490 65 00149 22981 29 45962 58 eka n A a A Recommended Sample Frequency 97 3384 sing number of sample points 2048 W Single Sided Spectral Plots File A ERES 08 b o oo Harmonic Amplitudes cm Harmonic Amplitudes cm Distance from Start of Sandbed x m Period sec by B
14. e code The WaveAR source code consists of two files 1 WaveAR fig contains the graphical user interface GUI components and 2 WaveAR m contains the main supporting functions The following setup steps are recommended 1 Ensure MATLAB 2006 or later is installed with optimization toolbox 2 Unzip the WaveARsource folder and navigate to this folder within the Current Directory window in the MATLAB workspace 3 Once in the folder tyoe WaveAR on the MATLAB command prompt and press the enter key to run the program 3 Software use 1 After installation the following should appear for the corresponding installation method a Standalone executable When the executable starts a black console window appears Figure 2 circle 1 Shortly after the console and main WaveAR graphical user interface also appear Figure 2 circle 2 Depending on computer performance the second window may load after a 30 second delay For the program to run both windows must be open If the console window is closed the main WaveAR interface will also close b MATLAB source code After typing WaveAR on the command prompt and pressing the enter key only the WaveAR GUI will appear Figure 2 circle 2 The black console window Figure 2 circle 1 will not appear the MATLAB command window will display any printed output ey T s 263 h cm 60 run Get Data Figure 2 Black console window red circle 1 and
15. flected components Computers amp Geoscience submitted WaveAR User s Manual page 19 of 19
16. lake J Landry and Matthew J Hancock WaveAR User s Manual page 1 of 19 WaveAR User s Manual Contents 1 2 slIPEROGUCTION assanar aA eet eevee Stl Mere a E ENEG 2 1 Standalone executable cccccccssssssseeeceeeeseeeeeeees 22 MATLAB SOUIEE COE aid ncennstanciccetocesseeltndetactannctants SONWANE USE aiid scares a aaroni N Description of the main WaveAR GUL cccceeeceee sees 4 1 Key parameters in the WaveAR GU cccceee 4 2 Additional features Of WaVeAR ccccccssseeseeeeeeees Sample rate estimation sincrecnierlcoiedaciaticelacnees Frequency spectrum s ssseesessesssrsrsreseseoresrseereerseese SDA TIE TORINO sissess a hin ast a N SEK AINA Oisiactest A entstoh eat a Alatetehadsah ct Maula Tact ta Companion program VirtualWave n os 7 1 Overview of VirtualWave GUL ccccccccsssseseeeeeeees 7 2 QUCDUL ae asic ine ae Referentes ccccccccccccesecescscscececececccececececscsscucecscceucucuceces WaveAR User s Manual page 2 of 19 1 Introduction This manual introduces the WaveAA software for parameter estimation from Stokes wave measurements An description of the algorithms in WaveAR may be found in Landry et al 2012 2 Installation WaveAR may be run as a standalone executable or from MATLAB This section outlines each method All files may be downloaded from Attp vtchl illinois edu software the WaveAR webpage 2 1 Standalone executable WaveAR is run fr
17. n the spectrum plot WaveAR User s Manual page 14 of 19 Fi Single Sided Spectral Plots File EJ WaveAR v1 0 Seas Aan o TE 263 h First Harmonic F lock E Harmonic Amplitudes em 6 Period sec Figure 15 Example of spectrum plot for selected x locations i e 1 5 2 2 5 3 3 5 and 5 m 5 Data file format WaveAR loads data files in Comma Separated Value CSV format which can be created and edited in text editors e g WordPad PsPad TextEditor or in Microsoft Excel Figure 16 depicts the CSV data file format corresponding to the fill color legend below Fill Color Denotation Tank parameters cell A1 Wavemaker input frequency Hz documentation only cell B1 Wavemaker input span units documentation only cell C1 Tank still water depth cm cell D1 Estimated wave period sec cell E1 Measured water temperature C X position cm of each column of surface wave measurements row 2 column B onward Sampling rate of the data Hz cell A2 Time values of the measured wave elevation sec column A row 3 downward Measured surface elevations for each x position column cm upper left cell B3 WaveAR User s Manual page 15 of 19 ro i BRIE Bela ia iu ale ine OW N on AWIN e CO WV WAN D F Ww WwW N Be e B w N 38 39 X w Insert Page Layout Formulas Data Review View Load Test Acrobat Team Calibri X c Wrap Text General E 85 7 Normal J x Z
18. om a single executable file which requires the 200116 MATLAB Compiler Runtime MCR available on the WaveAR webpage http vtchl illinois edu software The following setup steps are recommended 1 If you do not have MATLAB 2011b installed you will need to install the free 2011b MCR Note the version number is important 2 Unzip the WaveAR folder which should unzip to a folder entitled WaveAR 3 Within the WaveAA folder find the correct executable file that corresponds to your computer s operating system OS a WaveAR_64 exe executable for 64 bit Windows OS b WaveAR exe executable for Windows 32 bit OS c WaveAR dmg executable for Mac OS X d WaveAR executable for Linux OS 4 To run the program simply double click on the corresponding executable file e g see Figure 1 for example of 64 bit version exe GQ Blake MattHancock code WaveAR_64 distrib v Search distrib Organize v Include in library Share with Burn New folder Name Date modified Type A Favorites E Desktop amp readme tt 9 25 2011 4 06 PM _ Text Document ip Downloads A WaveAR 64 exe 9 25 2011 4 06 PM Application B Landry Blake J E My Documents 2011_Fall a _Projects a Dropbox Recent Places TARP cee hsl tarp fs C3 Libraries Documents b 2 items N Figure 1 WaveAR executable file for user specified OS e g Windows 64 bit version shown WaveAR User s Manual page 3 of 19 2 2 MATLAB sourc
19. only for compiled versions and main WaveAR GUI red circle 2 which appear shortly after running the WaveAR program WaveAR User s Manual page 4 of 19 2 After the WaveAR window s appear the user loads data by clicking the Get Data button This opens a standard file browser The user simply selects the appropriate comma separated value csv file to process and clicks the Open button to load and process the file Figure 3 Ey Wave R w1 0 A Choose csv file to process Look in Ji WaveAR E c E t Name E Date modified Type a be ee b autowavedata csv 1 19 2012 9 52PM Microsoft EL autowavedatal2 csv 1 19 2012 9 52 PM Microsoft Bate Fit File wi File name autowaved ata csv Y Files of type comma seperated value csv Figure 3 File browser dialog to select the csv file for processing 3 Once the data file is loaded successfully the WaveAR data fitting window appears Figure 4 and the main WaveAR GUI now has First Harmonic Parameters Free Second Harmonic Parameters and Probe Data button panels Figure 5 WaveAR User s Manual page 5 of 19 py WaveAR data fitting for file autowavedata csv File Edit View Insert Tools Desktop Window Help WHSeas s AA8TS9EL B 08 an Harmonic Amplitudes em Distance from Start of Sandbed x m Figure 4 WaveAR data fitting window appears after data is loaded Bi Wave
20. ose the user can press the AutoFit button to perform a least squares best fit Figure 7 While AutoFit can be pressed at any time it is recommended to select initial parameters as a good first guess for the AutoFit command BJ WaveAR v1 0 TEE 263 hicem g0 file autowawedata csw xi 0 error 1 0 0000 error2 0 0001 First Harmonic Parameters 4 4 Free Second Harmonic Parameters lock lock A 221 A alpha_2 0 E E E Create Fit File File Edit View Insert Tools Desktop Window Help Ogul ARDDA alajn 10 m E sha Lari a 3 a E gi 2 Ee a E om 1E Distance from Start of Sandbed x m Figure 7 Resulting parameter fit after pressing the AutoFit button The blue and red lines virtually coincide with the underlying data WaveAR User s Manual page 8 of 19 6 After a proper fit has been achieved the user can print the fitting results to the console window for immediate display by pressing the Print results button Figure 8 or to a user specified data file by checking the Create fit File prior to pressing the Print results button Figure 9 E Wavear v1 0 i 4 C Users blandry2 Dropbox Blake_MattHancock code_and_example o X G WUsers blandry2 Dropbox Blake_MattHancockNcode_and_examp lep 63 Tis 263 h cm 60 file autowavedata csv x0 0 error 1 0 0000 error2 0 0001 1 315 First Harmonic Parameters Free Second Harmonic Parameters
21. t in the button Clicking the button again copies that value into the Sampling frequency value field Data fields that require an array of numbers e g Virtual probe locations follow the MATLAB array convention For example to create a vector from 0 to 22 spaced by 0 25 enter 0 0 25 22 7 2 Output Pressing the Generate button in the main VirtualWave GUI generates a plot window with instantaneous snapshots of the surface elevation as well as harmonic and rms amplitudes Figure 19 If the Enable file saving was checked on the main VirtualWave GUI the user may WaveAR User s Manual page 18 of 19 Edit View Insert Tools Desktop Window Help OGMS s Q88CD84 8 08 90 time 5 2 sec 66 66 1 continuous amp 1 sampled 1 sampled continuous amp sampled 0 12 Distance along tank m Figure 18 VirtualWave results window Top instantaneous surface elevation plotted at different times Middle first and second harmonic amplitudes Both continuous and sampled at fixed probe locations versions are shown Bottom rms amplitude Both continuous and sampled versions are shown then save the output to file The output file may then be loaded into WaveAR by following the instructions in the Software use section above 8 References Landry B J Hancock M J Mei C C Garc a M H 2012 WaveAR A software tool for calculating parameters for water waves with incident and re
Download Pdf Manuals
Related Search