Under the File Menu are the selections to set the write options, read data and write results, load and save coordinate traces and AFPoly Progress, and exit AFPoly. Each of these features is described below.
File > Write Options – Select the option to append or replace when writing to files
File > Read AFU File and File > Read UNV File – Read an FRF dataset from an AFU or Universal file. 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 AFU File. The entire file is read, but only the FRFs are retained; all other function types are discarded. The FRF dataset is parsed for a consistent, fully populated FRF matrix. There must be at least one common response from each reference. FRFs with a reference coordinate having a negative direction are multiplied by negative one and the reference coordinates are set to the positive direction. The abscissa spacing can be either even or uneven but the abscissa attributes must be consistent. The supported ordinate numerator data types are acceleration, velocity, displacement, strain, excitation force, and force. The supported ordinate denominator data types are excitation force and force. This menu selection is only available in the Setup module.
File > Write ASH File and File > Write UNV File – Write shapes to an ASH or Universal file, with the append or replace and measured or back-expanded 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 ASH File. Only the shapes of the enabled poles (i.e., checked in the Poles List) are written. This menu selection is not available in the Setup module.
Whenever a shapes file is written, a CSV info file is also written to the same folder. The CSV info file has the same filename as the shapes file, but .info.csv is appended to the extension. This file contains sufficient information to recreate the poles and shapes, including the dataset identification, references and responses sieve, polyreference and residues model parameters, stability criterion, and the pole list.
File > Read Workspace – Read an FRF dataset 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 FRF dataset parsing and supported data types as for reading from a file apply. This menu selection is only available in the Setup module.
File > Write Workspace – Write shapes to an imat_shp in the MATLAB workspace, with the append or replace and measured or back-expanded options as selected. A variable selection dialog is presented from which to select the imat_shp to write. There is also an icon on the toolbar. Only the shapes of the enabled poles (i.e., checked in the Poles List) are written. This menu selection is not available in the Setup module.
Whenever an imat_shp is written to the MATLAB workspace, an info structure is also created. The info structure has the same variable name as the imat_shp, 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
File > Save Coordinate Trace – Save coordinate traces to a Universal file
File > Load Progress – Load a previously saved AFPoly Progress MAT-file. A file selection dialog is presented from which to browse and select the MAT-file to load. This menu selection is available only in the Setup module.
File > Save Progress – Save the AFPoly progress to a MAT-file. A file selection dialog is presented from which to browse and select the MAT-file to save. The MAT-file contains all of the data and information necessary to bring AFPoly back to (nearly) the same state as when the progress was saved. Preferences and axes settings (e.g., grid, scale, cursors) are not retained. By saving an AFPoly Progress MAT-file, an AFPoly session can be suspended and then continued at a later time by loading the AFPoly Progress MAT-file.
File > Exit AFPoly – Closes the AFPoly application without a confirmation dialog. Any unsaved results will be lost. Closing AFPoly with the [x] button on the upper-right corner of the figure will present a dialog to confirm the user's intentions before closing the application.