SVT UFF58 Write VI

Sound and Vibration Measurement Help


Edition Date: March 2018
Part Number: 372416L-01
View Product Info

DOWNLOAD (Windows Only)


LabVIEW 2018 Sound and Vibration Toolkit Help
LabVIEW 2019 Sound and Vibration Toolkit Help

Owning Palette: UFF58b VIs

Requires: Sound and Vibration Toolkit

Writes data to the UFF58 (universal file format) file specified by the file refnum input. This VI also writes the fields in records 1, 2, and 3, ID lines (1-3). You can write a single time domain waveform, multiple time domain waveforms, a single real frequency spectrum, multiple real frequency spectra, a single complex frequency spectrum, multiple complex frequency spectra, or generic data to a UFF file. If a frequency spectrum is in decibels, this VI converts the spectrum to linear before writing to the UFF58 file. The default instance, SVT UFF58 Write Time Waveform (1 Ch), writes a single time domain waveform to the file specified by the file refnum input. Wire data to the file refnum input to determine the polymorphic instance to use or manually select the instance.

Details  Example

Use the pull-down menu to select an instance of this VI.

SVT UFF58 Write Time Waveform (1 Ch)

data precision (double-precision:1) specifies the numeric precision of the data to be written to the file.

0double-precision (default)
1single-precision
ID lines (1-3) specifies the data in records 1, 2, and 3. ID line 1 typically is used for the function description. ID line 3 typically is used to identify when the function was created. The date is in the format DD-MM-YY, and the time is in the format HH:MM:SS.
ID line 1 (description) specifies the contents of ID line 1.
ID line 2 specifies the contents of ID line 2.
ID line 3 (date & time) specifies the contents of ID line 3.
file refnum specifies the UFF58 file refnum associated with the file you want to use.
waveform specifies a single time domain signal to write to the file.
t0 specifies the start time of the waveform.
dt specifies the time interval in seconds between data points in the waveform.
Y specifies the data values of the waveform.
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
dup file refnum returns the same value as the input file refnum. You can wire this output to the file refnum input of another UFF58b or UFF58 Advanced VI. You also can use this refnum to close the UFF file.
function refnum returns the reference to a function in the UFF58 file.
error out contains error information. This output provides standard error out functionality.

SVT UFF58 Write Time Waveform (N Ch)

data precision (double-precision:1) specifies the numeric precision of the data to be written to the file.

0double-precision (default)
1single-precision
ID lines (1-3) specifies the data in records 1, 2, and 3. ID line 1 typically is used for the function description. ID line 3 typically is used to identify when the function was created. The date is in the format DD-MM-YY, and the time is in the format HH:MM:SS.
ID line 1 (description) specifies the contents of ID line 1.
ID line 2 specifies the contents of ID line 2.
ID line 3 (date & time) specifies the contents of ID line 3.
file refnum specifies the UFF58 file refnum associated with the file you want to use.
waveforms specifies the time domain signals to write to the file.
t0 specifies the start time of the waveform.
dt specifies the time interval in seconds between data points in the waveform.
Y specifies the data values of the waveform.
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
dup file refnum returns the same value as the input file refnum. You can wire this output to the file refnum input of another UFF58b or UFF58 Advanced VI. You also can use this refnum to close the UFF file.
function refnums returns the references to all the functions in the UFF58 file.
error out contains error information. This output provides standard error out functionality.

SVT UFF58 Write Spectrum (Real) (1 Ch)

data precision (double-precision:1) specifies the numeric precision of the data to be written to the file.

0double-precision (default)
1single-precision
ID lines (1-3) specifies the data in records 1, 2, and 3. ID line 1 typically is used for the function description. ID line 3 typically is used to identify when the function was created. The date is in the format DD-MM-YY, and the time is in the format HH:MM:SS.
ID line 1 (description) specifies the contents of ID line 1.
ID line 2 specifies the contents of ID line 2.
ID line 3 (date & time) specifies the contents of ID line 3.
file refnum specifies the UFF58 file refnum associated with the file you want to use.
spectrum specifies a single spectrum to write to the file.
x0 specifies the start frequency or order of the spectrum.
dx specifies the frequency or order resolution of the spectrum.
Y specifies the magnitude of the power or amplitude spectrum.
spectrum info specifies a cluster that contains properties of the computed spectrum.
Note  You must wire spectrum info when performing extended measurements. Do not modify the spectrum info values. If you want to view the information, you can right-click the spectrum info wire and select Custom Probe»Spectrum Info from the shortcut menu.
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
dup file refnum returns the same value as the input file refnum. You can wire this output to the file refnum input of another UFF58b or UFF58 Advanced VI. You also can use this refnum to close the UFF file.
function refnum returns the reference to a function in the UFF58 file.
error out contains error information. This output provides standard error out functionality.

SVT UFF58 Write Spectrum (Real) (N Ch)

data precision (double-precision:1) specifies the numeric precision of the data to be written to the file.

0double-precision (default)
1single-precision
ID lines (1-3) specifies the data in records 1, 2, and 3. ID line 1 typically is used for the function description. ID line 3 typically is used to identify when the function was created. The date is in the format DD-MM-YY, and the time is in the format HH:MM:SS.
ID line 1 (description) specifies the contents of ID line 1.
ID line 2 specifies the contents of ID line 2.
ID line 3 (date & time) specifies the contents of ID line 3.
file refnum specifies the UFF58 file refnum associated with the file you want to use.
spectra specifies multiple spectra to write to the file.
x0 specifies the start frequency or order of the spectrum.
dx specifies the frequency or order resolution of the spectrum.
Y specifies the magnitude of the power or amplitude spectrum.
spectrum info specifies properties of the computed spectrum.
Note  You must wire spectrum info when performing extended measurements. Do not modify the spectrum info values. If you want to view the information, you can create a custom probe.
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
dup file refnum returns the same value as the input file refnum. You can wire this output to the file refnum input of another UFF58b or UFF58 Advanced VI. You also can use this refnum to close the UFF file.
function refnums returns the references to all the functions in the UFF58 file.
error out contains error information. This output provides standard error out functionality.

SVT UFF58 Write Spectrum (Complex) (1 Ch)

data precision (double-precision:1) specifies the numeric precision of the data to be written to the file.

0double-precision (default)
1single-precision
ID lines (1-3) specifies the data in records 1, 2, and 3. ID line 1 typically is used for the function description. ID line 3 typically is used to identify when the function was created. The date is in the format DD-MM-YY, and the time is in the format HH:MM:SS.
ID line 1 (description) specifies the contents of ID line 1.
ID line 2 specifies the contents of ID line 2.
ID line 3 (date & time) specifies the contents of ID line 3.
file refnum specifies the UFF58 file refnum associated with the file you want to use.
real part specifies the real part of the spectrum.
x0 specifies the start frequency or order of the spectrum.
dx specifies the frequency or order resolution of the spectrum.
Y Real specifies the real part of the complex spectrum.
imaginary part specifies the imaginary part of the spectrum.
x0 specifies the start frequency or order of the spectrum.
dx specifies the frequency or order resolution of the spectrum.
Y Im specifies the imaginary part of the complex spectrum.
spectrum info specifies a cluster that contains properties of the computed spectrum.
Note  You must wire spectrum info when performing extended measurements. Do not modify the spectrum info values. If you want to view the information, you can right-click the spectrum info wire and select Custom Probe»Spectrum Info from the shortcut menu.
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
dup file refnum returns the same value as the input file refnum. You can wire this output to the file refnum input of another UFF58b or UFF58 Advanced VI. You also can use this refnum to close the UFF file.
function refnum returns the reference to a function in the UFF58 file.
error out contains error information. This output provides standard error out functionality.

SVT UFF58 Write Spectrum (Complex) (N Ch)

data precision (double-precision:1) specifies the numeric precision of the data to be written to the file.

0double-precision (default)
1single-precision
ID lines (1-3) specifies the data in records 1, 2, and 3. ID line 1 typically is used for the function description. ID line 3 typically is used to identify when the function was created. The date is in the format DD-MM-YY, and the time is in the format HH:MM:SS.
ID line 1 (description) specifies the contents of ID line 1.
ID line 2 specifies the contents of ID line 2.
ID line 3 (date & time) specifies the contents of ID line 3.
file refnum specifies the UFF58 file refnum associated with the file you want to use.
real part specifies the real part of the spectrum.
x0 specifies the start frequency or order of the spectrum.
dx specifies the frequency or order resolution of the spectrum.
Y Real specifies the real part of the complex spectrum.
spectrum info specifies properties of the computed spectrum.
Note  You must wire spectrum info when performing extended measurements. Do not modify the spectrum info values. If you want to view the information, you can create a custom probe.
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
dup file refnum returns the same value as the input file refnum. You can wire this output to the file refnum input of another UFF58b or UFF58 Advanced VI. You also can use this refnum to close the UFF file.
function refnums returns the references to all the functions in the UFF58 file.
error out contains error information. This output provides standard error out functionality.

SVT UFF58 Write Generic

function type specifies the function type.

0general or unknown (default)
1time response
2auto spectrum
3cross spectrum
4frequency response function
5transmissibility
6coherence
7auto correlation
8cross correlation
9power spectral density (PSD)
10energy spectral density (ESD)
11probability density function
12spectrum
13cumulative frequency distribution
14peaks valley
15stress/cycles
16strain/cycles
17orbit
18mode indicator function
19force pattern
20partial power
21partial Coherence
22eigenvalue
23eigenvector
24shock response spectrum
25finite impulse response (FIR) filter
26multiple coherence
27order function
data precision (double-precision:1) specifies the numeric precision of the data to be written to the file.

0double-precision (default)
1single-precision
ID lines (1-3) specifies the data in records 1, 2, and 3. ID line 1 typically is used for the function description. ID line 3 typically is used to identify when the function was created. The date is in the format DD-MM-YY, and the time is in the format HH:MM:SS.
ID line 1 (description) specifies the contents of ID line 1.
ID line 2 specifies the contents of ID line 2.
ID line 3 (date & time) specifies the contents of ID line 3.
file refnum specifies the UFF58 file refnum associated with the file you want to use.
ordinate values (Y Real) specifies the real part of the spectrum.
ordinate values (Y Im) specifies the imaginary part of the spectrum.
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
abscissa minimum (x0) specifies the initial value of coordinates on the horizontal axis.
abscissa increment (dx) specifies the interval between data points in the signal.
dup file refnum returns the same value as the input file refnum. You can wire this output to the file refnum input of another UFF58b or UFF58 Advanced VI. You also can use this refnum to close the UFF file.
function refnum returns the reference to a function in the UFF58 file.
error out contains error information. This output provides standard error out functionality.

SVT UFF58 Write Details

Use the SVT UFF58 Write Spectrum (Real) (1 Ch) and SVT UFF58 Write Spectrum (Real) (N Ch) instances to write measurements such as power spectrum and power spectral density. Use the SVT UFF58 Write Frequency Spectrum (Complex) (1 Ch) and SVT UFF58 Write Frequency Spectrum (Complex) (N Ch) instances to write real and imaginary components of frequency response data. Use the SVT UFF58 Write Generic instance to write measurements such as coherence. If you use the SVT UFF58 Write Spectrum (Real) (1 Ch) or SVT UFF58 Write Spectrum (Real) (N Ch) instance, this VI converts any spectrum that is in decibels to linear before writing to the UFF58 file.

You cannot edit a UFF58 file with the UFF58b or UFF58 Advanced VIs after you write and close the file. If you need to edit the contents of an existing UFF58 file after you write and close the file, you can read the information then write modified information to a new UFF58 file.

Note  If you write to the same UFF58 file multiple times without using the SVT UFF58 Close File VI each time, you create new functions in the file every time you write to the UFF58 file. This VI does not append data within a single function.

Example

Refer to the Write Time Waveforms (UFF File) VI in the labview\examples\Sound and Vibration\UFF58 directory for an example of using the SVT UFF58 Write VI.

WAS THIS ARTICLE HELPFUL?

Not Helpful