Company Events Academic Community Support Solutions Products & Services Contact NI MyNI

Configure Scaling VI

LabVIEW 2013 Datalogging and Supervisory Control Module Help

Edition Date: June 2013

Part Number: 371618J-01

»View Product Info
Download Help (Windows Only)

Owning Palette: Variables & I/O Servers VIs

Requires: DSC Module

Configures the scaling settings of a shared variable.
Note  You can configure scaling settings of network-published shared variables only.

variable reference in specifies a reference number for a shared variable. Use the Create Shared Variable VI to create a refnum for a shared variable.
scaling settings specifies the scaling settings for the shared variable.
enable? specifies whether LabVIEW scales a shared variable. The default is FALSE.
data type specifies the data type of the shared variables that you want to configure. This VI automatically detects the data type of the shared variable.
scale type specifies the type of scaling to perform on the shared variable. This input applies to only shared variables with a Numeric data type.

0Linear (default)
1Square Root
raw zero scale specifies the minimum value of the scale you want to use to collect the data from the data source. The raw scale is the original scale that you used to collect the data. The raw zero scale value must be less than the raw full scale value. This input applies to only shared variables with a Numeric data type.
raw full scale specifies the maximum value of the scale you want to use to collect the data from the data source. The raw scale is the original scale that you used to collect the data. The raw full scale value must be greater than the raw zero scale value. This input applies to only shared variables with a Numeric data type.
engineering zero scale specifies the minimum value the Shared Variable Engine (SVE) and Human Machine Interface (HMI) application use to scale the data source. The engineering scale is the full range that you want the SVE to use to scale the data source. This input applies to only shared variables with a Numeric data type.
engineering full scale specifies the maximum value the SVE and HMI application use to scale the data source. The engineering scale is the full range that you want the SVE to use to scale the data source. This input applies to only shared variables with a Numeric data type.
engineering unit specifies the unit of data measurement, such as degrees Celsius, pounds, grams, and so on. This input applies to only shared variables with a Numeric data type.
coerce? specifies whether LabVIEW coerces the shared variable data to a range you specify. The default is FALSE. This input applies to only shared variables with a Numeric data type.

If you scale the data for a shared variable you can write, the data must be between the raw zero scale and raw full scale values. If you scale the data for a shared variable you can read, the data must be between the engineering zero scale and engineering full scale values.
invert? specifies whether LabVIEW inverts data from the data source before storing the data in the shared variable. The default is FALSE. This input applies to only shared variables with a data type of Boolean.
invert mask specifies a 32-bit value with which the SVE performs an XOR operation to produce the scaled value of a shared variable. The SVE inverts bits in the mask with a value 1 but does not invert bits with a value 0. The default invert mask is 0, indicating that the SVE inverts none of the bits. This input applies to only shared variables with a data type of U32 Bit Field.
select mask specifies a 32-bit value with which the SVE performs an AND operation to produce the scaled value of a shared variable. If you set the select mask of a bit to 0, the SVE sets the value of this bit to 0, regardless of the values received from the server. The default is FFFFFFFF, indicating that the SVE does not change values of any bits. This input applies to shared variables with a data type of U32 Bit Field.
reset when disabled? specifies whether to reset the value of scaling settings to the initial state when you disable scaling. If reset when disabled? is TRUE, LabVIEW resets the value. If reset when disabled? is FALSE, LabVIEW retains the value. The default is FALSE.
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
variable reference out returns the shared variable refnum that you wire to the variable reference in input.
error out contains error information. This output provides standard error out functionality.

 

Your Feedback! poor Poor  |  Excellent excellent   Yes No
 Document Quality? 
 Answered Your Question? 
Add Comments 1 2 3 4 5 submit