aaEngineeringUnitInsert
- Last UpdatedMar 10, 2025
- 1 minute read
Inserts an engineering unit.
Syntax
aaEngineeringUnitInsert Unit, DefaultTagRate, IntegralDivisor
where:
|
Argument |
Description |
|---|---|
|
Unit |
The unit of measure. Examples are mph, grams, and pounds. This value is of data type nvarchar(32), with no default. |
|
DefaultTagRate |
The default rate, in milliseconds, at which tags are cyclically stored, based on engineering units. Although the system does not make use of this engineering unit based tag rate, you can reference this value in custom SQL scripts. The value you enter for this tag rate does not affect the default storage rate set for the tag. This value is of data type int, with a default of 10000. |
|
IntegralDivisor |
The factor to be applied when integrating a rate with the units [EngUnits/TimeUnit] to a quantity with units [EngUnits]. This factor is called the integral divisor. The default value of 1 assumes a time unit of seconds and ensures that a rate of [Unit/second] is correctly integrated to [Unit]. For a time unit of minutes, set the integral divisor value to 60; for a unit of hours, set the integral divisor value to 3600. The integral divisor is applied similarly to rates or quantities that are not expressed in terms of a time unit. For example, to convert watts to watt-hours, the integral divisor is 1/3600. To convert watts to kilowatt-hours, the integral divisor is 1/3600000. This value is of data type float(25), with a default of 1. |
Permission
Execute permission defaults to the aaPowerUsers and aaAdministrators groups.