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

as input and up to five outputs to collect the desired information. The least complex call and the
corresponding output are shown below:
>> in = cifrms;
>> in.name = 'XVLATSWP_FRE_A0000_AIL_P';
>> cifrms(in);
**** Frequency Response Information ****
First Freq: 0.13963
Last Freq: 31.41590
Number of values in frequency response: 923
**** Mean-square value results ****
Mean Square Value = 9.244088
Root Mean Squared Value = 3.040409
In this example the name of a frequency response is specified; when the structure is created it
assumes defaults for inputs such as source and input/output integration selection. These defaults
are defined in Appendix F and can be accessed by an empty call to the function as mentioned
above. Single-character inputs such as those for source are not case-sensitive. No outputs need be
specified; the function will print all the results to the screen. A more complex call is shown below
without the printed output, and using name-value pairs for input. The name-value pairs do not
have to be specified in a particular order as long as they occur in pairs.
>> in = cifrms;
>> name = 'XVLATSWP_FRE_A0000_AIL_P';
>> scorrect = 2;
>> minfreq = 10;
>> maxfreq = 30;
>>
[msv,rms,pts,min,max]=cifrms(in,'name',name,'spower',scorrect,'minfreq',
minfreq,'maxfreq',maxfreq,'toscrn','off');
This example specifies limits to the frequency range examined and sets the ‘power of s’
correction factor to 2. The default values can be used for these variables by assigning the inputs a
value of 0. The output variables store the information that results from the function call; ‘msv’
and ‘rms’ store the mean square value and root mean squared value, respectively. The variable
'pts' stores the number of points in the response, and ‘min’ and ‘max’ store the minimum and
maximum frequencies in the response. Fewer outputs can be specified if desired. Finally, the
printed output can be turned off by the ‘toscrn’ field in the structure.
One other feature of the cifrms function is the ability to calculate a fraction of a full range rms
value. The ‘minfreq’ and ‘maxfreq’ fields must be set equal to use this option. The printed output
is slightly different and the variable outputs change slightly. ‘msv’ stores the full range rms value,
75