LabVIEW Electrical Power Toolkit API Reference

Table of Contents

Convert Data to Waveforms VI

  • Updated2023-02-21
  • 13 minute(s) read

Convert Data to Waveforms VI

Owning Palette: Power Quality VIs

Requires: Electrical Power Toolkit

Converts resampled voltage and current data to voltage and current waveforms of different line configurations. This VI also arranges the order of the elements in the waveforms of each three-phase electrical power system for further measurement. For example, the orders are A-B-C-N for the four-channel method and A-B-C for the three-channel method. You must manually select the polymorphic instance you want to use.

Details  Examples

Single Line, 2D SGL

Note Note  Converts the single-precision signal data to waveforms for single-bus single-line systems.

reset? specifies whether to reset the calculation process. The default is FALSE. When you run this VI for the first time, the calculation process resets automatically.
physical channels specifies the order of the physical channels that you use to acquire data from physical data acquisition modules.
Note  When you specify the wiring input of the Initialize System VI as 3xUph + 2xI or 3xUline + 2xI, the Convert Data to Waveforms VI converts data only from Current Phase A (L1) and Current Phase C (L3). When you specify the wiring input of the Initialize System VI as 1xUph + 1xI, the Convert Data to Waveform VI converts data only from Voltage Phase A (L1) and Current Phase A (L1).
data in specifies multichannel resampled voltage and current signals using single-precision numbers. The number of rows corresponds to the number of samples per 10/12 cycles and the number of columns corresponds to the number of physical channels.
sample rate specifies the instantaneous sample rate, in hertz, of every 10/12 cycles. sample rate is the multiplication of the instantaneous frequency and the number of samples per cycle.
timestamp specifies the absolute timestamp of the end of every 10/12 cycles. You acquire timestamp from timing resources such as GPS or real-time clock.
system info in specifies the basic configuration of the electrical power system. Use the Initialize System VI to generate the basic configuration information.
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
voltage waveforms returns 10/12-cycle voltage waveforms using double-precision numbers. This VI arranges the order of the elements in the waveforms for further measurement, for example, A-B-C-N for four channels method and A-B-C for three channels method.
t0 returns the start time of the waveform.
dt returns the time interval, in seconds, between data points in the waveform.
Y returns the data values of the waveform.
current waveforms returns 10/12-cycle current waveforms using double-precision numbers. This VI arranges the order of the elements in the waveforms for further measurement. For example, A-B-C-N is for the four-channel method and A-B-C for the three-channel method.
Note  When you specify the wiring input of the Initialize System VI as 3xUph + 2xI or 3xUline + 2xI, the Convert Data to Waveforms VI returns the data for Current Phase B (L2) from Current Phase A (L1) and Current Phase C (L3).
t0 returns the start time of the waveform.
dt returns the time interval, in seconds, between data points in the waveform.
Y returns the data values of the waveform.
system info out returns information about the basic configuration of the electrical power system.
error out contains error information. This output provides standard error out functionality.
interval length returns the duration, in seconds, of every 10/12-cycle interval.

Single Line, Cluster

Note Note  Converts the signal cluster to waveforms for single-bus single-line systems.

reset? specifies whether to reset the calculation process. The default is FALSE. When you run this VI for the first time, the calculation process resets automatically.
physical channels specifies the order of the physical channels that you use to acquire data from physical data acquisition modules.
Note  When you specify the wiring input of the Initialize System VI as 3xUph + 2xI or 3xUline + 2xI, the Convert Data to Waveforms VI converts data only from Current Phase A (L1) and Current Phase C (L3). When you specify the wiring input of the Initialize System VI as 1xUph + 1xI, the Convert Data to Waveform VI converts data only from Voltage Phase A (L1) and Current Phase A (L1).
data block specifies the data block that you build with the Build Data Blocks VI.
resampled signal specifies the resampled even-angle-spaced signal that you build with the Build Data Blocks VI. The number of rows corresponds to the number of physical channels and the number of columns corresponds to the number of samples per 10/12 cycles.
sample rate specifies the instantaneous sample rate, in hertz, of every data block. sample rate is the multiplication of the instantaneous frequency and the number of samples per cycle.
timestamp specifies the timestamp of the end of every data block.
system info in specifies the basic configuration of the electrical power system. Use the Initialize System VI to generate the basic configuration information.
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
voltage waveforms returns 10/12-cycle voltage waveforms using double-precision numbers. This VI arranges the order of the elements in the waveforms for further measurement, for example, A-B-C-N for four channels method and A-B-C for three channels method.
t0 returns the start time of the waveform.
dt returns the time interval, in seconds, between data points in the waveform.
Y returns the data values of the waveform.
current waveforms returns 10/12-cycle current waveforms using double-precision numbers. This VI arranges the order of the elements in the waveforms for further measurement. For example, A-B-C-N is for the four-channel method and A-B-C for the three-channel method.
Note  When you specify the wiring input of the Initialize System VI as 3xUph + 2xI or 3xUline + 2xI, the Convert Data to Waveforms VI returns the data for Current Phase B (L2) from Current Phase A (L1) and Current Phase C (L3).
t0 returns the start time of the waveform.
dt returns the time interval, in seconds, between data points in the waveform.
Y returns the data values of the waveform.
system info out returns information about the basic configuration of the electrical power system.
error out contains error information. This output provides standard error out functionality.
interval length returns the duration, in seconds, of every 10/12-cycle interval.

Multiple Lines, 2D SGL

Note Note  Converts the single-precision signal data to waveforms for single-bus multiple-line and multiple-bus systems.

reset? specifies whether to reset the calculation process. The default is FALSE. When you run this VI for the first time, the calculation process resets automatically.
data in specifies multichannel resampled voltage and current signals using single-precision numbers. The number of rows corresponds to the number of samples per 10/12 cycles and the number of columns corresponds to the number of physical channels.
sample rate specifies the instantaneous sample rate, in hertz, of every 10/12 cycles. sample rate is the multiplication of the instantaneous frequency and the number of samples per cycle.
timestamp specifies the absolute timestamp of the end of every 10/12 cycles. You acquire timestamp from timing resources such as GPS or real-time clock.
system info in specifies the basic configuration of the electrical power system. Use the Initialize System VI to generate the basic configuration information.
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
voltage waveforms returns 10/12-cycle voltage waveforms using double-precision numbers one three-phase system after another in the sequence defined in the Initialize System VI. This VI arranges the order of the elements in the waveforms for each system, for example, A-B-C-N for four channels method and A-B-C for three channels method.
t0 returns the start time of the waveform.
dt returns the time interval, in seconds, between data points in the waveform.
Y returns the data values of the waveform.
current waveforms returns 10/12-cycle current waveforms using double-precision numbers one three-phase system after another in the sequence defined in the Initialize System VI. This VI arranges the order of the elements in the waveforms for each system, for example, A-B-C-N for four channels method and A-B-C for three channels method.
Note  When a three-phase system has only two current channels, this VI does not automatically calculate the third current. For example, if you specify Current Phase A (L1) and Current Phase C (L3), this VI does not calculate Current Phase B (L2) automatically.
t0 returns the start time of the waveform.
dt returns the time interval, in seconds, between data points in the waveform.
Y returns the data values of the waveform.
system info out returns information about the basic configuration of the electrical power system.
error out contains error information. This output provides standard error out functionality.
interval length returns the duration, in seconds, of every 10/12-cycle interval.

Multiple Lines, Cluster

Note Note  Converts the signal cluster to waveforms for single-bus multiple-line and multiple-bus systems.

reset? specifies whether to reset the calculation process. The default is FALSE. When you run this VI for the first time, the calculation process resets automatically.
data block specifies the data block that you build with the Build Data Blocks VI.
resampled signal specifies the resampled even-angle-spaced signal that you build with the Build Data Blocks VI. The number of rows corresponds to the number of physical channels and the number of columns corresponds to the number of samples per 10/12 cycles.
sample rate specifies the instantaneous sample rate, in hertz, of every data block. sample rate is the multiplication of the instantaneous frequency and the number of samples per cycle.
timestamp specifies the timestamp of the end of every data block.
system info in specifies the basic configuration of the electrical power system. Use the Initialize System VI to generate the basic configuration information.
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
voltage waveforms returns 10/12-cycle voltage waveforms using double-precision numbers one three-phase system after another in the sequence defined in the Initialize System VI. This VI arranges the order of the elements in the waveforms for each system, for example, A-B-C-N for four channels method and A-B-C for three channels method.
t0 returns the start time of the waveform.
dt returns the time interval, in seconds, between data points in the waveform.
Y returns the data values of the waveform.
current waveforms returns 10/12-cycle current waveforms using double-precision numbers one three-phase system after another in the sequence defined in the Initialize System VI. This VI arranges the order of the elements in the waveforms for each system, for example, A-B-C-N for four channels method and A-B-C for three channels method.
Note  When a three-phase system has only two current channels, this VI does not automatically calculate the third current. For example, if you specify Current Phase A (L1) and Current Phase C (L3), this VI does not calculate Current Phase B (L2) automatically.
t0 returns the start time of the waveform.
dt returns the time interval, in seconds, between data points in the waveform.
Y returns the data values of the waveform.
system info out returns information about the basic configuration of the electrical power system.
error out contains error information. This output provides standard error out functionality.
interval length returns the duration, in seconds, of every 10/12-cycle interval.

Convert Data to Waveforms Details

Related Information
Connections and Wiring
Line and Bus Configurations
Power Transmission

Examples

Refer to the following VIs for examples of using the Convert Data to Waveforms VI:

  • Single Bus Multiple Line Power Quality Applications VI: labview\examples\Electrical Power\Power Quality\Multiple Line Applications (cRIO) (Delta-Sigma)
  • Multiple Bus Power Quality Applications VI: labview\examples\Electrical Power\Power Quality\Multiple Line Applications (cRIO) (Delta-Sigma)

Log in to get a better experience