Versions Compared

Version Old Version 11 New Version 12
Changes made by

Yannick Marchetaux

Akli Rahmoun

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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 :

tfid

Range 0 / Deadband

Lawmath function

normal

[-bm…bm]

y=axa*x+b

square_root

[-bm…bm]

y=a rac*sqrt(x)+b

quadratic

[-bm…bm]

y=racsqrt(axa*x+b)

transparent

[-bm…bm]

y=x

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


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 value the overflow to active. 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 overflow to active. It is translation task responsability to value overflow to active in this case.

The output limits are dependent on the output protocol. It is the responsibility of the translation task from the pivot format to manage the limitations of the formats used (and set the overflow to active if necessary).

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) transformation function is performed only if PIVOTTM.GTIM.MvTyp.q.Validity is different of "good" or if one of the attributes of PIVOTTM.MvTyp.q.DetailQuality is set to "true" the module sets PIVOTTM.GTIM.MvTyp. q.Validity to "invalid" and the output PIVOTTM.GTIM.MvTyp.mag.f to 0 (deletion of the PIVOTTM.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".

Filtering rules

R1 : application of scaling only for values measured with a configured law

R2 : application of quality control

R3 : verification of the absence of calculation errors

Data processing

This module is designed to work on values measured in pivot format. Other types of information 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 PIVOTTM.GTIM.Identifier) of the data to determine if the measured value is part of the information to be processed.

...

  • PIVOTTM.GTIM.MvTyp.mag.i => input value in INT32 format
  • PIVOTTM.GTIM.MvTyp.mag.f => input value FLOAT32
  • PIVOTTM.GTIM.MvTyp.q.Validity and PIVOTTM.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 :

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