DAQmx Create Scale (VI)
- Updated2023-02-21
- 15 minute(s) read
Installed With: NI-DAQmx
Creates and configures a custom scale. Apply custom scales to input and output channels to provide additional scaling. The instances of this polymorphic VI correspond to the type of scale this VI creates.
Linear
Creates a custom scale that uses the equation y=mx+b, where x is a pre-scaled value, and y is a scaled value. The equation is identical for input and output. If the equation is in the form x=my+b, you must first solve for y in terms of x.
.gif?_LANG=enus)
 |
name identifies the custom scale for later use, such as with the DAQmx Create Virtual Channel VI |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
 |
slope is the slope, m, in the equation. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
y-intercept is the y-intercept, b, in the equation. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
 |
error in describes error conditions that occur before this VI or function runs. The default is no error. If an error occurred before this VI or function runs, the VI or function passes the error in value to error out. If an error occurs while this VI or function runs, the VI or function runs normally and sets its own error status in error out. Use the Simple Error Handler or General Error Handler VIs to display the description of the error code. Use error in and error out to check errors and to specify execution order by wiring error out from one node to error in of the next node.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
 |
pre-scaled units is the units of the values to scale.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
scaled units is the units to use for the scaled value. You can use an arbitrary string. LabVIEW uses the units to label a graph or chart. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
 |
scale out is a reference to the custom scale this VI creates. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
 |
error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, error out describes the error status that this VI or function produces. Right-click the error out indicator on the front panel and select Explain Error from the shortcut menu for more information about the error.
|
Map Ranges
Creates a custom scale that scales values proportionally from a range of pre-scaled values to a range of scaled values.
.gif?_LANG=enus)
|
name identifies the custom scale for later use, such as with the DAQmx Create Virtual Channel VI |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
scaled minimum is the smallest value in the range of scaled values. NI-DAQmx maps this value to pre-scaled minimum. Read operations clip samples that are smaller than this value. Write operations generate errors for samples that are smaller than this value. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
scaled maximum is the largest value in the range of scaled values. NI-DAQmx maps this value to pre-scaled maximum. Read operations clip samples that are larger than this value. Write operations generate errors for samples that are larger than this value. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
error in describes error conditions that occur before this VI or function runs. The default is no error. If an error occurred before this VI or function runs, the VI or function passes the error in value to error out. If an error occurs while this VI or function runs, the VI or function runs normally and sets its own error status in error out. Use the Simple Error Handler or General Error Handler VIs to display the description of the error code. Use error in and error out to check errors and to specify execution order by wiring error out from one node to error in of the next node.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
pre-scaled minimum is the smallest value in the range of pre-scaled values. NI-DAQmx maps this value to scaled minimum. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
pre-scaled maximum is the largest value in the range of pre-scaled values. NI-DAQmx maps this value to scaled maximum. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
pre-scaled units is the units of the values to scale.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
scaled units is the units to use for the scaled value. You can use an arbitrary string. LabVIEW uses the units to label a graph or chart. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
scale out is a reference to the custom scale this VI creates. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, error out describes the error status that this VI or function produces. Right-click the error out indicator on the front panel and select Explain Error from the shortcut menu for more information about the error.
|
Polynomial
Creates a custom scale that uses an nth order polynomial equation. NI-DAQmx requires both a polynomial to convert pre-scaled values to scaled values (forward) and a polynomial to convert scaled values to pre-scaled values (reverse). If you only know one set of coefficients, use the DAQmx Compute Reverse Polynomial Coefficients VI to generate the other set.
.gif?_LANG=enus)
|
name identifies the custom scale for later use, such as with the DAQmx Create Virtual Channel VI |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
forward coeff is an array of coefficients for the polynomial that converts pre-scaled values to scaled values. Each element of the array corresponds to a term of the equation. For example, if index three of the array is 9, the fourth term of the equation is 9x3. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
 |
reverse coeff is an array of coefficients for the polynomial that converts scaled values to pre-scaled values. Each element of the array corresponds to a term of the equation. For example, if index three of the array is 9, the fourth term of the equation is 9y3. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
error in describes error conditions that occur before this VI or function runs. The default is no error. If an error occurred before this VI or function runs, the VI or function passes the error in value to error out. If an error occurs while this VI or function runs, the VI or function runs normally and sets its own error status in error out. Use the Simple Error Handler or General Error Handler VIs to display the description of the error code. Use error in and error out to check errors and to specify execution order by wiring error out from one node to error in of the next node.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
pre-scaled units is the units of the values to scale.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
scaled units is the units to use for the scaled value. You can use an arbitrary string. LabVIEW uses the units to label a graph or chart. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
scale out is a reference to the custom scale this VI creates. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, error out describes the error status that this VI or function produces. Right-click the error out indicator on the front panel and select Explain Error from the shortcut menu for more information about the error.
|
Table
Creates a custom scale that maps an array of pre-scaled values to an array of corresponding scaled values. NI-DAQmx applies linear interpolation to values that fall between the values in the table. Read operations clip scaled samples that are outside the maximum and minimum scaled values found in the table. Write operations generate errors for samples that are outside the minimum and maximum scaled values found in the table.
.gif?_LANG=enus)
|
name identifies the custom scale for later use, such as with the DAQmx Create Virtual Channel VI |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
scaled values is the array of scaled values that map to the values in pre-scaled values. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
pre-scaled values is the array of pre-scaled values that map to the values in scaled values. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
error in describes error conditions that occur before this VI or function runs. The default is no error. If an error occurred before this VI or function runs, the VI or function passes the error in value to error out. If an error occurs while this VI or function runs, the VI or function runs normally and sets its own error status in error out. Use the Simple Error Handler or General Error Handler VIs to display the description of the error code. Use error in and error out to check errors and to specify execution order by wiring error out from one node to error in of the next node.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
pre-scaled units is the units of the values to scale.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
scaled units is the units to use for the scaled value. You can use an arbitrary string. LabVIEW uses the units to label a graph or chart. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
scale out is a reference to the custom scale this VI creates. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, error out describes the error status that this VI or function produces. Right-click the error out indicator on the front panel and select Explain Error from the shortcut menu for more information about the error.
|