Generates a waveform that is the sum of integer cycle sine tones.


icon

Inputs/Outputs

  • cdbl.png amplitude —

    amplitude is the value that the sum of all the tones is scaled to and is the largest absolute value that the waveform contains. The default is –1.

    amplitude is useful when outputting the waveform to an analog output channel. If the maximum value that the hardware can output is 5 volts, set amplitude to 5. If amplitude ≤ 0, the scaling is not applied.

  • cbool.png reset signal —

    reset signal, if TRUE, resets the phase to the phase control value and the time stamp to zero. The default is FALSE.

  • c1ddbl.png tone frequencies —

    tone frequencies is an array in which each element is a single tone frequency. The size of this array must match the size of the tone amplitudes array and the size of the tone phases array.

  • c1ddbl.png tone amplitudes —

    tone amplitudes is an array in which each element is a single tone amplitude. The size of this array must match the size of the tone frequencies array and the size of the tone phases array.

  • c1ddbl.png tone phases —

    tone phases is an array in which each element is a single tone phase in degrees. The size of this array must match the size of the tone frequencies array and the size of the tone amplitude array.

  • cerrcodeclst.png error in (no error) —

    error in describes error conditions that occur before this node runs. This input provides standard error in functionality.

  • cnclst.png sampling info —

    sampling info contains sampling information.

  • cdbl.png Fs —

    Fs is the sampling rate in samples per second. The default is 1000.

  • cdbl.png #s —

    #s is the number of samples in the waveform. The default is 1000.

  • cbool.png coerce frequencies? —

    If coerce frequencies? is TRUE, the specified tone frequencies will be coerced to the nearest multiple of Fs/n.

  • imsdt.png signal out —

    signal out is the generated waveform.

  • idbl.png crest factor —

    crest factor is the ratio of the Peak voltage to the RMS voltage of signal out.

  • i1ddbl.png actual tone frequencies —

    actual tone frequencies are the tone frequencies generated after accounting for coercion, if coerce frequencies? is TRUE, and the Nyquist criteria.

  • ierrcodeclst.png error out —

    error out contains error information. This output provides standard error out functionality.

    • The frequency domain representation of this waveform is a sequence of impulses at the specified tone frequencies and zero at all other frequencies. The number of tones is determined by the size of the array inputs tone frequencies, tone amplitudes, and tone phases. The sine tones are generated using the frequency, phase, amplitude, and samples information. This raw array then is scaled so the largest absolute value is equal to amplitude. Finally, the waveform is bundled. The X0 element of the waveform always is set equal to 0 and the delta X element is set equal to 1/Fs.

    LabVIEW assumes tone phases to be referenced to the sine function. To reference tone phases to the cosine function, add 90 degrees. Be aware that this may change the crest factor. The following code excerpt shows how to reference tone phases to the cosine function:

    Examples

    Refer to the following example files included with LabVIEW.

    • labview\examples\Signal Processing\Waveform Measurements\Bandlimited Signal Generation.vi
    • labview\examples\Signal Processing\Waveform Measurements\Multitone with Amplitudes and Phases.vi