Should I click Overwrite?

When to click Overwrite vs Cancel during data analysis

Do I click overwrite or not?

First, look at the name of the file Matlab is asking about.

text
text

Is the message asking you to overwrite a file called:

  1. wave_viewer_params.mat
    1. Will you need to run waverunner in the future? For example, are you still on the "initial audio check," aka step #3 of the General Analysis Guide? Or, do you dislike the parameters that you applied to all trials, and you plan to apply new parameters to all trials?
      1. Yes, I need to run waverunner again. Then click Overwrite.
      2. No, I do not need to run waverunner again. Then click Cancel.
  2. Something else, such as 1.mat, 214.mat, or dataVals.mat
    1. Do you want to make changes to the file that it's asking about? For example, did you click the reload_dataVals button in the check_dataVals GUI? Or did you move the user events of a trial file (see description below) and you want to save the new position of those user events?
      1. Yes, I want to change that file. Then click Overwrite.
      2. No, I do not want to change that file. Then click Cancel.

Files and folders that appear in a participant's data folder after finishing data analysis:

folders

I want to understand what these files are

What is wave_viewer_params.mat?

Wave_viewer_params is a file which holds information related to audioGUI parameters. For example, it stores information like LPC order, amplitude threshold, and preemphasis. It is not associated with any individual trial. 

When you run waverunner at the command window (step #4 in the general analysis guide), the computer find the parameters in wave_viewer_params.mat and applies those settings to each "trial file" (see below). So, wave_viewer_params on its own does not do anything. It is only used when running waverunner. This is why we recommend only saving wave_viewer_params during the initial audio check, aka step #3 of the general analysis guide; the contents of wave_viewer_params.mat are irrelevant if you aren't going to run waverunner again.

More info is in wave_viewer_params and default audioGUI parameters.

What is a trial file?

Trial files are things called 1.mat, 78.mat, etc. They are stored in the "trials" folder or the "trials_signalOut" folder. They are created as part of the data analysis process.

Each trial file stores the audioGUI parameters that were chosen for that file, as well as the formant values that show up in audioGUI. When you run waverunner in step #4 of the general analysis guide, waverunner copies the parameters from wave_viewer_params into each trial file.

You may also notice that when you mark a trial as bad in check_audio, the command window prints out a message saying, "Trial ## saved for trials folder. Trial ## saved for trials_signalOut folder." The trial file is also what stores whether a trial is good or bad. So, check_audio is telling you that it made a change to trial ##'s trial file.

What is dataVals.mat?

dataVals.mat is a compiled version of information from all the trial files in an experiment. Therefore, it's only created after you finish looking at all of the trials one-by-one in audioGUI. When we want to actually perform statistics on our experiments, it's helpful to have all the relevant info in one file, rather than split out across all the trial files.

The check_dataVals GUI is loading in information from dataVals.mat; it does not pull information from each trial file. This is why you will not immediately see the check_dataVals GUI update if you find a bad trial and fix it in audioGUI. audioGUI only saves the fix to the trial file. You need to use the reload_dataVals button to update dataVals.mat. Then the fix will appear in the check_dataVals GUI.



Keywords:
overwrite, cancel, dataVals, trial, save, matlab, file 
Doc ID:
114231
Owned by:
Chris N. in SMNG Lab Manual
Created:
2021-10-12
Updated:
2026-08-27
Sites:
Speech Motor Neuroscience Group