Module description

A transformation law function can be applied to the measured values. The application of the laws is carried out with each reception of measured value whatever its state (bit OV, invalid...).

Laws managed by the plugin :

function is applied for each received measured value.

List of applicable functions :

The value a=0 is always replaced by a=1.

Image Modified

Calculation error

If the square root parameter has a negative value, the output result is set to 0 bad quality and the "inconsistent" bit is set to 1.

If the result of the calculation does not correspond to the internal format of the variable (outside the functional type float32...), the output result is set to 0 bad quality and the OV bit is set to 1. The calculation is therefore stored in a double format before being converted to float32. 

Protocol abstraction

The plugin ignores the input and output protocols used.

If the value is in thrust (ex. HNZ) the plugin does not value the OV bit but is responsible for the translation task to the pivot format.

The output limits are dependent on the output protocol.

Quality control

Configuration

The following attributes are read from the Exchanged data configuration:

• Math function id
• Array of parameters (a, b, ...)
• The dead band (min and max), band of input values where the output is zero

Filtering rules

R1 : transformation function is performed only for measured values configured in the Exchanged data configuration.

R2 : transformation function is performed only if a valid tfid, array of parameters and dead band are configured.

R3 : (quality check) if PIVOTIf PIVOTTM.GTIM.MvTyp.q.Validity is different of from "good" or if one of the attributes of PIVOTTMPIVOT.MvTyp.q.DetailQuality is set to "true" the module sets PIVOTTMPIVOT.GTIM.MvTyp. q.Validity to "invalid" and the output PIVOTTMPIVOT.GTIM.MvTyp.mag.f to 0 (deletion of the PIVOTTMPIVOT.GTIM.MvTyp.mag.i if it exists) and the scaling is not performed.

If not, the scaling is done.

Configuration

A list of measured values must be passed to the module. Only the measured values with a scaling to be applied are configured in the module.

The following data must be configured in the module:

• Type of law
• The coefficients a and b
• The dead band (min and max)

The min and max limits are included in the dead band. The dead band is applied to the input value.

Format

The configuration data of this module are present in "Exchanged_data".

Pivot model interaction

This module is designed to work on values measured in pivot format. Other types of i are not affected by this module. 

Input

R4 : (calculation error check) If the square root parameter has a negative value, the output result is set to 0 bad quality and the "inconsistent" bit is set to 1.

R5: (calculation error check) If the result of the calculation does not correspond to the internal format of the variable (outside the functional type float32...), the output result is set to 0 bad quality and value the overflow to active. The calculation is therefore stored in a double format before being converted to float32. 

Data processing

Input

This filter plugin expects readings to be a pivot model measured values datapoints.

The module uses the identification (Attribute PIVOTTMPIVOT.GTIM.Identifier) of the data to determine if the measured value is part of the information to be processed.

The data read from the pivots format are :

• PIVOTTMPIVOT.GTIM.MvTyp.mag.i => input value in INT32 format
• PIVOTTMPIVOT.GTIM.MvTyp.mag.f => input value FLOAT32
• PIVOTTMPIVOT.GTIM.MvTyp.q.Validity and PIVOTTMPIVOT.MvTyp.q.DetailQuality => quality control

Output

The module applies performs the configured law transformation function to the measured value before sending forwarding it to the centersother services.

The data in the generated pivot format is :

• PIVOTTMPIVOT.GTIM.MvTyp.q.DetailQuality.inconsistent is set to "true" => Calcul errorif calculation check fails
• PIVOTPIVOTTM.GTIM.MVTyp.q.DetailQuality.overflow is set to "true" => Error if calculated value exceeds FLOAT32 format
• PIVOTTMPIVOT.GTIM.MVTyp.q.DetailQuality.inaccurate is set to "true" => Value if input value is in the dead band
• PIVOTTMPIVOT.GTIM.MvTyp.mag.f => Calculated output value If PIVOTTM(PIVOT.GTIM.MvTyp.mag.i => was positioned, it is deletedis not used). 
• Validity:
  • If overflow : PIVOTTMPIVOT.GTIM.MVTypMvTyp.q.Validity = is set to "invalid"
  • If inconsistent or inaccurate: PIVOTTMPIVOT.GTIM.MVTypMvTyp.q.Validity = is set to "questionable"
• if If the law transformation function is not is transparent : PIVOTTMPIVOT.GTIM.MvTyp.q.Source = is set to "substituted"
• The quality control positions eventually if the quality checks fails :
  • PIVOTTMPIVOT.GTIM.MvTyp.q.Validity à « invalid ».  is set to "invalid"
  • PIVOTPIVOTTM.GTIM.MvTyp.mag.f at 0If PIVOTTM is set to 0 (PIVOT.GTIM.MvTyp.mag.i => was positioned, it is deleted.  is not used).