Mitsubishi Electric MELSEC iQ-R C Programming Manual page 24

DANL_AryBoundCompareTest
This function compares the specified wave and a check value to determine the upper/lower limit wave.
■Format
short DANL_AryBoundCompareTest (float* pfData, long lPoint, float* pfLowerLimit, float* pfUpperLimit, long* plResult)
■Argument
Argument Name
pfData Input data storage
destination
lPoint Data size
pfLowerLimit Lower limit wave
storage destination
pfUpperLimit Upper limit wave
storage destination
plResult Check result
• Optional setting (An operating condition can be changed with the DANL_SetOpCondition function.)
Setting
Number of significant digits
(Set to the first argument:
plSet[0])
Number of times of reference
value determinations
(Set to the second argument:
plSet[1])
■Description
• The wave specified to the input data storage destination (pfData) and the check value (upper/lower limit wave) are
compared. The result will be NG if the nth data in the input data storage destination (pfData) exceeds/less than the nth data
of the check value (upper/lower limit wave). However, when the specified wave is matched with the check value (upper/
lower limit wave), the result is OK.
When operating conditions are not changed with the DANL_SetOpCondition function, the default value (1) is set to the
number of times of reference value determinations. At this time, if the value exceeds/less than the check value (upper/lower
limit wave) even once, the result will be NG.
• The specified wave data is read from the start address specified to the input data storage destination (pfData) for the size
specified to the data size (lPoint). Reserve the area larger than the data size (lPoint) in the input data storage destination
(pfData).
• The check value (upper/lower limit wave) is read from the start address specified to the upper limit wave storage destination
(pfUpperLimit) or lower limit wave storage destination (pfLowerLimit) for the size specified to the data size (lPoint).
Reserve the area larger than the data size (lPoint) in the upper limit wave storage destination (pfUpperLimit) or lower limit
wave storage destination (pfLowerLimit).
• The values in the input data storage destination (pfData), lower limit wave storage destination (pfLowerLimit), and upper
limit wave storage destination (pfUpperLimit) are rounded off to the number of digits less than or equal to the specified
number of significant digits in the optional setting.
Ex.
(Example) When the number of significant digits is '4' (default), each setting value is rounded off as follows:
Input data storage destination (pfData) is 1.123489: 1.1235
Lower limit wave storage destination (pfLowerLimit) is 0.123489: 0.1235
Upper limit wave storage destination (pfUpperLimit) is 2.123489: 2.1235
3 DETAILS OF FUNCTIONS
22
3.1 Data Analysis Functions
Description
Specify the start address of wave data to be determined.
Specify the number of the array elements of wave data to be operated.
(Setting range: 1 to 1000000)
Specify the start address where a check value (lower limit wave) is to be stored.
Specify the start address where a check value (upper limit wave) is to be stored.
A check result is stored.
0: OK
1: NG
Default Description
value
4 Specify the number of significant digits of a fractional value.
The digits after the specified number of digits are rounded off.
(Setting range in the DANL_SetOpCondition function: 0 to 14)
1 Specify the number of consecutive points with which values are recognized as having exceeded or
fallen below the reference value.
The data is recognized as having exceeded or fallen below the reference value only when the number
of cross points has exceeded or fallen below the reference value for the number of specified cross
points consecutively.
(Setting range in the DANL_SetOpCondition function: 1 to 100)
IN/OUT
IN
IN
IN
IN
OUT