DAQmx Create Scale

DAQmx - Data Acquisition VIs and Functions

DAQmx Create Scale

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.

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

minibutton.gif  Place on the block diagram. minibutton.gif  Find on the Functions palette.

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.

DAQmx Create Scale (Linear)c.gif

civrn.gif name identifies the custom scale for later use, such as with the DAQmx Create Virtual Channel VI
cdbl.gif slope is the slope, m, in the equation.
cdbl.gif y-intercept is the y-intercept, b, in the equation.
cerrcodeclst.gif 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.
cbool.gif status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE.
ci32.gif code is the error or warning code. The default is 0. If status is TRUE, code is a negative error code. If status is FALSE, code is 0 or a warning code.
cstr.gif source identifies where an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.
ci32.gif pre-scaled units is the units of the values to scale.

Amps (10342) Amperes.
deg C (10143) Degrees Celsius.
deg F (10144) Degrees Fahrenheit.
deg R (10145) Degrees Rankine.
Degrees (10146) Degrees.
g (10186) G. 1 g is approximately equal to 9.81 m/s/s.
Hz (10373) Hertz.
Inches (10379) Inches.
Kelvins (10325) Kelvins.
Meters (10219) Meters.
Ohms (10384) Ohms.
Radians (10273) Radians.
Seconds (10364) Seconds.
Strain (10299) Strain.
Volts (10348) Volts.
cstr.gif 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.
iivrn.gif scale out is a reference to the custom scale this VI creates.
ierrcodeclst.gif 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.
ibool.gif status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.
ii32.gif code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
istr.gif source identifies where and why an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate 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.

DAQmx Create Scale (Map Ranges)c.gif

civrn.gif name identifies the custom scale for later use, such as with the DAQmx Create Virtual Channel VI
cdbl.gif 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.
cdbl.gif 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.
cerrcodeclst.gif 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.
cbool.gif status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE.
ci32.gif code is the error or warning code. The default is 0. If status is TRUE, code is a negative error code. If status is FALSE, code is 0 or a warning code.
cstr.gif source identifies where an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.
cdbl.gif pre-scaled minimum is the smallest value in the range of pre-scaled values. NI-DAQmx maps this value to scaled minimum.
cdbl.gif pre-scaled maximum is the largest value in the range of pre-scaled values. NI-DAQmx maps this value to scaled maximum.
ci32.gif pre-scaled units is the units of the values to scale.

Amps (10342) Amperes.
deg C (10143) Degrees Celsius.
deg F (10144) Degrees Fahrenheit.
deg R (10145) Degrees Rankine.
Degrees (10146) Degrees.
g (10186) G. 1 g is approximately equal to 9.81 m/s/s.
Hz (10373) Hertz.
Inches (10379) Inches.
Kelvins (10325) Kelvins.
Meters (10219) Meters.
Ohms (10384) Ohms.
Radians (10273) Radians.
Seconds (10364) Seconds.
Strain (10299) Strain.
Volts (10348) Volts.
cstr.gif 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.
iivrn.gif scale out is a reference to the custom scale this VI creates.
ierrcodeclst.gif 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.
ibool.gif status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.
ii32.gif code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
istr.gif source identifies where and why an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate 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.

DAQmx Create Scale (Polynomial)c.gif

civrn.gif name identifies the custom scale for later use, such as with the DAQmx Create Virtual Channel VI
cdbl.gif 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.
c1ddbl.gif 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.
cerrcodeclst.gif 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.
cbool.gif status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE.
ci32.gif code is the error or warning code. The default is 0. If status is TRUE, code is a negative error code. If status is FALSE, code is 0 or a warning code.
cstr.gif source identifies where an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.
ci32.gif pre-scaled units is the units of the values to scale.

Amps (10342) Amperes.
deg C (10143) Degrees Celsius.
deg F (10144) Degrees Fahrenheit.
deg R (10145) Degrees Rankine.
Degrees (10146) Degrees.
g (10186) G. 1 g is approximately equal to 9.81 m/s/s.
Hz (10373) Hertz.
Inches (10379) Inches.
Kelvins (10325) Kelvins.
Meters (10219) Meters.
Ohms (10384) Ohms.
Radians (10273) Radians.
Seconds (10364) Seconds.
Strain (10299) Strain.
Volts (10348) Volts.
cstr.gif 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.
iivrn.gif scale out is a reference to the custom scale this VI creates.
ierrcodeclst.gif 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.
ibool.gif status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.
ii32.gif code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
istr.gif source identifies where and why an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate 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.

DAQmx Create Scale (Table)c.gif

civrn.gif name identifies the custom scale for later use, such as with the DAQmx Create Virtual Channel VI
c1ddbl.gif scaled values is the array of scaled values that map to the values in pre-scaled values.
c1ddbl.gif pre-scaled values is the array of pre-scaled values that map to the values in scaled values.
cerrcodeclst.gif 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.
cbool.gif status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE.
ci32.gif code is the error or warning code. The default is 0. If status is TRUE, code is a negative error code. If status is FALSE, code is 0 or a warning code.
cstr.gif source identifies where an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.
ci32.gif pre-scaled units is the units of the values to scale.

Amps (10342) Amperes.
deg C (10143) Degrees Celsius.
deg F (10144) Degrees Fahrenheit.
deg R (10145) Degrees Rankine.
Degrees (10146) Degrees.
g (10186) G. 1 g is approximately equal to 9.81 m/s/s.
Hz (10373) Hertz.
Inches (10379) Inches.
Kelvins (10325) Kelvins.
Meters (10219) Meters.
Ohms (10384) Ohms.
Radians (10273) Radians.
Seconds (10364) Seconds.
Strain (10299) Strain.
Volts (10348) Volts.
cstr.gif 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.
iivrn.gif scale out is a reference to the custom scale this VI creates.
ierrcodeclst.gif 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.
ibool.gif status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.
ii32.gif code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
istr.gif source identifies where and why an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.