QuantAsylum QA401, Руководство пользователя

Страница: 66 / 70

QuantAsylum QA401 User ’s Manual
Page
66
/// Retrieves the last collected data. If this is called while the analyzer is busy, the result is undefined. The returned data
/// is a PointF array of spectrum data, and each point contains the data amplitude (expressed linearly, and referenced to full
/// scale) and data frequency. Typically, you will want to convert this data into dB.
/// </summary>
/// <param name="channel"></param>
/// <returns></returns>
PointF [] GetData( QA401 . ChannelType channel);
/// <summary>
/// Retrieves the last collected time-domain data. If this is called while the analyzer is busy, the result is undefined. The
/// returned data is a PointF array of time data, and each point contains the data amplitude (y value, ranging from -1 to 1) and time
/// </summary>
/// <param name="channel"></param>
/// <returns></returns>
PointF [] GetTimeData( QA401 . ChannelType channel);
/// <summary>
/// Given a previous data acquisition, this will compute the power of the provided data. Note the provided data is in linear form,
/// but the returned result is in dB
/// </summary>
/// <param name="data"> array for data consisting of linear amplitude and frequency data </param>
/// <returns> Computed power in dB </returns>
double ComputePowerDB( PointF [] data);
/// <summary>
/// Given a previous data acquisition, this will compute the power of the provided data. Note the provided data is in linear form,
/// but the returned result is in dB
/// </summary>
/// <param name="data"> array for data consisting of linear amplitude and frequency data </param>
/// <returns> Computed power in dB </returns>
double ComputePowerDB( PointF [] data, double startFreq, double endFreq);
/// <summary>
/// Finds the peak and computes the power in presently selected units. Note the data is presented in linear form, but the result
/// is returned in dB
/// </summary>
/// <param name="data"></param>
/// <returns></returns>
double ComputePeakPowerDB( PointF [] data);
/// <summary>
/// Given a previous data acquisition, this will compute the THD of the provided data. The fundamental parameter specifies the target
/// fundamental, and the max frequency specifies the upper harmonic (in Hertz) that will be considered.
/// </summary>
/// <param name="data"> array for data consisting of linear amplitude and frequency data </param>
/// <param name="fundamental"> The desired fundamental frequency. The level at this frequency will be suppressed in the calculation,
/// while harmonics of this frequency will be used to determine the THD </param>
/// <param name="maxFreq"> Determines the max frequency that will be used for the THD computation </param>
/// <returns> THD level in % </returns>
double ComputeTHDPct( PointF [] data, double fundamental, double maxFreq);
/// <summary>
/// Computes the phase between a reference signal and a second signal and returns the phase between those signals in degrees
/// (-180 to +180). The input signals must be sine waves of the exact same frequency. The expected use of this function is as
/// follows: In situations where you are measuring a DUT using a single sine generated from the GEN1, the output and input time
/// data series can be retrieved using the GetData() call. Once you have the output and input time data, calling this function
/// will compute the phase between these signals. If 'applyCompensation' is true, then the routine will account for internal
/// delays in the QA401. This will ensure that in loopback mode the phase will be reported as 0 degrees for any frequency
/// between 0 Hz and Nyquist.
/// </summary>
/// <param name="reference"> The reference waveform </param>
/// <param name="signal"> The second signal. If this signal occurs slightly after the reference, this the phase will be indicated
/// as lagging </param>
/// <param name="applyCompensation"> If true, then the routine will compensate for delays inside the QA401. If false, the phase
/// calculation will not. The frequency of compensation must be specified if true, otherwise 0 may be used. </param>
/// <returns></returns>
double ComputePhase( PointF [] reference, PointF [] signal, bool applyCompensation, double compensationFreq);
/// Given a previous data acquisition, this will compute the THDN of the provided data. The fundamental parameter specifies the
/// target fundamental, and the max frequency specifies the upper harmonic (in Hertz) that will be considered. As this also contains
/// a noise calculation, the lower frequency bound must also be specified. It is expected that the minFreq less than fundamental
which is
/// less than maxFreq
/// </summary>
/// <param name="data"> array for data consisting of linear amplitude and frequency data </param>
/// <param name="fundamental"> The desired fundamental frequency. The level at this frequency will be suppressed in the calculation,
/// while harmonics of this frequency will be used to determine the THD </param>
/// <param name="maxFreq"> Determines the max frequency that will be used for the noise and THD computation </param>
/// <param name="minFreq"> Determines the min freuqency for the noise calculation </param>
/// <returns> THD level in % </returns>
double ComputeTHDNPct( PointF [] data, double fundamental, double minFreq, double maxFreq);
/// <summary>
/// Sets teh generator to the specified amplitude and frequency. The current units are used.
/// </summary>
/// <param name="gen"> Generator 1 or 2 </param>
/// <param name="isOn"> Sets on/off state </param>
/// <param name="amp"> Sets amplitude </param>
/// <param name="freq"> Sets frequency. This might be rounded, depending on the host settings </param>
void SetGenerator( QA401 . GenType gen, bool isOn, double amp, double freq);
/// <summary>
/// Sets the input and output offsets used in all calculations.
/// </summary>
/// <param name="inputOffsets"></param>
/// <param name="outputOffsets"></param>
void SetOffsets( double inputOffsets, double outputOffsets);
/// <summary>
/// Sets the units for data
/// </summary>