CIFER®-MATLAB Interfaces: Development and ... - Cal Poly

CIFER ® support utilities:
Three functions are available to facilitate the retrieval of data from the CIFER ® database. The
getfr function, when given a frequency response name, will return arrays for frequency,
magnitude, phase and so on. The other function, writefr, allows the user to change values in these
arrays and pass them back in to be saved to the CIFER ® database. The third function is called
caselist and allows the user to query the database for which cases are stored for a particular
program.
Due to the simplicity of these functions, structures are not used to input data as is done for the
other CIFER ® programs and utilities. Thus, these functions do not have the empty call feature that
returns a list of structure field data types. They do still include help documentation which can also
be found in Appendix G.
getfr and writefr:
The getfr function is designed to give users access to all the arrays that make up a full frequency
response. The most complete call, shown below, will bring back arrays of all 10 frequency
response fields. The order in which these are returned is fixed; therefore if only coherence were
desired, variables to hold information for frequency, magnitude and phase would still be required
as shown in the second function call, which only returns four of the frequency response data
fields.
>> name = 'XVLATSWP_COM_ABCDE_AIL_P';
>> [frq,mag,pha,coh,gxx,gyy,gxy,rel,img,err] = getfr(name);
>> [frq,mag,pha,coh] = getfr(name);
Frequency responses can also be written back into the CIFER ® database through the writefr
function. The example below shows the creation of a new frequency response with all 10 data
arrays. Again, the order is fixed and, as above in the getfr example, not all the inputs need be
provided. If all inputs are not provided the user should keep in mind that CIFER ® will not have
access to any unspecified information in the event it must make calculations with the new
responses. The response names do not have to conform to CIFER ® naming conventions, though
doing so will help track new responses.
>> name = 'NEW_FREQUENCY_RESPONSE';
>> writefr(name, frq, mag, pha, coh, gxx, gyy, gxy, rel, img, err);
81