Under the File Menu are the selections to set the write options, read data and write results, load and save channels and setup files, load and save coordinate traces, and exit spFRF. Each of these features is described below.
File > Write Options – Select whether to append or replace when writing to files or the MATLAB workspace. Select whether to write ASCII or binary (Dataset 58) Universal files.
File > Read ADF File and File > Read UNV File – Read time response functions from an ADF or Universal file. The ADF file type will most likely be an ATI (time) file, which can contain only time response functions, but it could also be an AFU (function) file, which can contain other types of functions as well as time response functions. A file selection dialog is presented from which to browse and select the file to read. There is also an icon on the toolbar for Read ADF File. The entire file is read, but only the time response functions are retained; all other function types are discarded. The time response functions are verified for consistent attributes (number of elements, sampling type, amplitude units, normalization, and abscissa spacing, minimum, increment, data type, and type qualifier). This menu selection is available only in the Setup module.
File > Write ADF File and File > Write UNV File – In the Setup module, write time response functions to an ADF or Universal file, with the append or replace, and ASCII or binary (Universal File Format Dataset 58) options as selected. A file selection dialog is presented from which to browse and select the file to write. There is also an icon on the toolbar for Write ADF File. The time response functions are sieved to the channels sieve and truncated to the Time Range. The ADF file type will most likely be an ATI (time) file, which can contain only time response functions, but it could also be an AFU (function) file.
In the Results module, write spectral functions (FRF, coherence, auto-spectra, cross-spectra, etc.) to an ADF or Universal file, with the append or replace, and ASCII or binary (Universal File Format Dataset 58) options as selected. A file selection dialog is presented from which to browse and select the file to write. There is also an icon on the toolbar for Write ADF File. The spectral functions are truncated to the Clear Lower and Clear Upper frequency range. The ADF file type must be an AFU (function) file.
Whenever a spectral functions file is written, a CSV info file is also written to the same folder. The CSV info file has the same filename as the spectral function file, but .info.csv is appended to the extension. This file contains sufficient information to recreate the signal processing results, including dataset identification, channels sieve, and setup parameters.
File > Read Workspace – Read time response functions from an imat_fn in the MATLAB workspace. A variable selection dialog is presented from which to select the imat_fn to read. There is also an icon on the toolbar. The same function sieving and consistent attribute verifying as for reading from a file apply. This menu selection is available only in the Setup module.
File > Write Workspace – In the Setup module, write time response functions to an imat_fn in the MATLAB workspace, with the append or replace option as selected. A variable selection dialog is presented from which to select the imat_fn to write. There is also an icon on the toolbar. The time response functions are sieved to the channels sieve and truncated to the Time Range.
In the Results module, write spectral functions (FRF, coherence, auto-spectra, cross-spectra, etc.) to an imat_fn in the MATLAB workspace, with the append or replace option as selected. A variable selection dialog is presented from which to select the imat_fn to write. There is also an icon on the toolbar. The spectral functions are truncated to the Clear Lower and Clear Upper frequency range.
Whenever a spectral functions imat_fn is written to the MATLAB workspace, an info structure is also created. The info structure has the same variable name as the imat_fn, but with _info appended. This structure contains the same information as a CSV info file, as described above.
File > Load Coordinate Trace – Load coordinate traces from a Universal file or an imat_ctrace (or a cell array of imat_ctrace if more than one) in the MATLAB workspace. A file or variable selection dialog is presented from which to select the file or workspace variable to load. The coordinate traces can be used as filters in the Channels dialog or for sieving from the Responses listbox context menu in the Setup module. The loaded coordinate traces are appended to any that may have been loaded previously. Use the Clear All menu selection to clear all of the coordinate traces that have been loaded.
File > Save Coordinate Trace – Save coordinate traces to a Universal file or an imat_ctrace (or a cell array of imat_ctrace if more than one) in the MATLAB workspace. A file or variable selection dialog is presented from which to select the file or workspace variable to save. The coordinate traces created in the Channels dialog can be saved for future use with this operation.
File > Load Channels – Load a previously saved spFRF Channels CSV file and set the channels sieve from the references, responses, and disabled channels listed in the file. A channel is uniquely determined by its response coordinate and data type. A file selection dialog is presented from which to select the file to load. This menu selection is available only in the Setup module.
File >Save Channels – Save the current channels sieve to an spFRF Channels CSV file. A file selection dialog is presented from which to select the file to save. The saved channels file can then be loaded to set the channels sieve. This menu selection is available only in the Setup module.
File > Load Setup – Load a previously saved spFRF Setup CSV file and set all of the signal processing parameters from the information contained in the file. A file selection dialog is presented from which to browse and select the file to load. This menu selection is available only in the Setup module.
File > Save Setup – Save the current signal processing parameters to an spFRF Setup CSV file. A file selection dialog is presented from which to select the file to save. The saved setup file can then be loaded to set all of the signal processing parameters. This menu selection is available only in the Setup module.
File > Exit spFRF – Closes the spFRF application without a confirmation dialog. Any unsaved results will be lost. Closing spFRF with the [x] button on the upper-right corner of the figure will present a dialog to confirm the user intentions before closing the application.