RRM 3-13 Transform

Transform Record

The Transform record combines features of the Calcout and Seq records, with 16 sets of the following fields:

• input link
• input-link status
• value (from input link or from calc expression)
• calc expression
• calc-expression status
• output link
• output-link status
• comment

For concreteness, here is the first set of fields:

• INPA - link from which value for A will be read
• IAV - status of INPA
• A - value
• CLCA - expression whose value might be written to A
• CAV - validity of expression CLCA
• OUTA - link to which A will be written
• OAV - status of OUTA

The value fields A-P are "process-passive", which means that writing to one of them from a CA client, or via a "CA" link, will cause the record to process, if its scan state is "Passive". If the input link associated with a value field is not blank and is not an initialization constant, then writes to that value field are not permitted.

Expressions are evaluated only if the associated value fields have not been modified (either by a Put from some external agent, or as the result of input-link execution) since the last time the record processed.

Parameter Fields

The fields in this record fall into these categories:

• scan parameters
• read parameters
• expression parameters
• output parameters
• operator display parameters
• alarm parameters

Scan Parameters

The Transform record has the standard fields for specifying under what circumstances the record will be processed. These fields are listed in Scan Fields. In addition, Scanning Specification explains how these fields are used. Since the Transform record supports no direct interfaces to hardware, it cannot be scanned on I/O interrupt, so its SCAN field cannot be I/O Intr.

Read Parameters

The read parameters for the Transform record consist of 16 input links INPA, INPB, ... INPP. The fields can be database links, channel access links, or constants. If they are links, they must specify another record's field. If they are constants, associated value fields will be initialized with the constants. These fields cannot be hardware addresses. In addition, the Transform record contains the IAV, IBV, . . . IPV fields which indicate the states of the link fields, for example, whether or not the specified PV was found and a link to it established. See Operator Display Parameters for an explanation of these fields.

See Address Specification for information on how to specify database links.

Field	Summary	Type	DCT	Initial	Access	Modify	Rec Proc Monitor
INPA	Input Link A	INLINK	Yes	0	No	No	N/A
INPB	Input Link B	INLINK	Yes	0	No	No	N/A
...	...	...	...	...	...	...	...
INPP	Input Link P	INLINK	Yes	0	No	No	N/A

Expression Parameters

Like the Calcout record, the Transform record has fields in which the developer or user can enter an infix expression to be evaluated when the record is processed. There are, in fact, 16 such fields, each of which is a member of its own (inputlink, value, expression, outputlink) group. For each group, if inputlink does not specify a PV name, then expression will be evaluated when the record processes, and the result will be placed in value.

Transform-record expressions are very similar to Calcout-record expression described elsewhere in this manual. Instead of the standard EPICS calc engine (which does not permit an expression to reference more than 12 input fields), Transform-record expressions are handled by the sCalcout (string calculation and output) record's engine. The differences, between these engines, that matter for transform-record expressions are the following:

• The constants PI (3.14159...), D2R (PI/180), R2D (180/PI), S2R (D2R/360), and R2S (1/S2R) are supported
• The functions MIN() and MAX() may have more than two arguments.
• The function NINT() (nearest integer) is supported.
• The function LN() (log base e) is a permitted alternative to LOGE()
• The function ATAN2() (alternative form of the arctangent function) is supported
• The binary operators '>&' (larger of the operands) and '<&' (smaller) are supported
• The binary operators '==' (equal) and '!=' (not equal) are permitted alternatives to '=' and '#', respectively.
• The unary operator '@' selects an input field by number. (E.g., '@0' means 'A'. If 'B' has the value 3, '@b' means 'D'.)
• The values of the variables A..P used in expressions may be the results of previously evaluated expressions.

Output Parameters

The Transform record has 16 output links, executed in order from OUTA to OUTP. Unlike the Calcout record, these links are not conditional; they execute every time the record processes.

Field	Summary	Type	DCT	Initial	Access	Modify	Rec Proc Monitor	PP
OUTA	Output Specification	OUTLINK	Yes	0	Yes	Yes	N/A	No
OUTB	Output Specification	OUTLINK	Yes	0	Yes	Yes	N/A	No
...	...	...	...	...	...	...	...	...
OUTP	Output Specification	OUTLINK	Yes	0	Yes	Yes	N/A	No

Operator Display Parameters

These parameters are used to present meaningful data to the operator. Some are also meant to represent the status of the record at run-time. An example of an interactive MEDM display screen that displays the status of the Transform record is located here.

The EGU field contains a string of up to 16 characters which is supplied by the user and which describes the values being operated upon. The string is retrieved whenever the routine get_units is called. The EGU string is solely for an operator's sake and does not have to be used. This field is pretty much useless for the Transform record, because it's unlikely to pertain to all value fields.

The IAV-IPV fields indicate the states of the links INPA-INPP. These fields can have three possible values:

• Ext PV NC -- the PV wasn't found on this IOC and a Channel Access link hasn't been established.
• Ext PV OK -- the PV wasn't found on this IOC and a Channel Access link has been established.
• Local PV -- the PV was found on this IOC.
• Constant -- the corresponding link field is a constant.

The OAV-OPV fields indicate the states of the OUTA-OUTP links. They has the same possible values as the IAV-ILV fields.

The CAV-CPV fields indicate the validity of the expressions in the CLCA-CLCP fields, respectively. If an expression is invalid, its status field is set to one.

The IVLA field specifies how the record should behave if any of its input links references a record that is in alarm. There are two possibilities:

• "Ignore Error" - Use whatever value was gotten from the link, and proceed as if there had not been any error indication.
• "Do Nothing" - Stop after all input values have been retrieved: do not evaluate expressions, and do not execute output or forward links.

See Fields Common to All Record Types for more on the record name (NAME) and description (DESC) fields.

Field	Summary	Type	DCT	Initial	Access	Modify	Rec Proc Monitor	PP
EGU	Engineering Units	STRING [16]	Yes	Null	Yes	Yes	No	No
PREC	Display Precision	SHORT	Yes	0	Yes	Yes	No	No
IAV	Link Status of INPA	RECCHOICE	No	1	Yes	No	No	No
IBV	Link Status of INPB	RECCHOICE	No	1	Yes	No	No	No
...	...	...	...	...	...	...	...	...
IPV	Link Status of INPP	RECCHOICE	No	1	Yes	No	No	No
OAV	Link Status of OUTA	RECCHOICE	No	0	Yes	No	No	No
OBV	Link Status of OUTB	RECCHOICE	No	0	Yes	No	No	No
...	...	...	...	...	...	...	...	...
OPV	Link Status of OUTP	RECCHOICE	No	0	Yes	No	No	No
CAV	CLCA Valid	LONG	No	0	Yes	Yes	No	No
CBV	CLCB Valid	LONG	No	0	Yes	Yes	No	No
...	...	...	...	...	...	...	...	...
CPV	CLCP Valid	LONG	No	0	Yes	Yes	No	No
NAME	Record Name	STRING [29]	Yes	0	Yes	No	No	No
DESC	Description	STRING [29]	Yes	Null	Yes	Yes	No	No

Alarm Parameters

The Transform record has no record-type-specific alarm fields. See Alarm Fields for the list of alarm fields common to all record types.

Record Support

Record Support Routines

init_record

For each constant input link, the corresponding value field is initialized with the constant value if the input link is CONSTANT or a channel access link is created if the input link is PV_LINK.

A routine sCalcPostfix is called to convert the infix expression in CLCA-CLCV to postfix notation. The results are stored in RPCA-RPCP.

process

See next section.

special

This is called if any of the fields A-P, CLCA-CLCP, INPA-INPP, OUTA-OUTP are changed. For expressions fields, special() calls sCalcPostfix. For value fields, special() keeps track of which fields have changed, because expressions will not be evaluated for fields that have been written to. For link fields, special() starts the process of checking link status.

get_value

No routine

get_units

No routine

get_precision

Retrieves PREC.

get_graphic_double

No routine

get_control_double

No routine

get_alarm_double

No routine

Record Processing

process()

The process() routine implements the following algorithm:

1. Fetch values from all valid input links.
2. For each value field <x>, in order from A to P: if the value has not been written to since the last time the record processed, call sCalcPerform(), which evaluates the expression specified in CLC<x> and stores the result in <x>.
3. Post all fields the record has changed.
4. Execute all valid output links, in order from OUTA to OUTP.
5. Execute the forward link, set PACT FALSE, and return.

execOutput()

1. If DOPT field specifies the use of OCAL, call the routine calcPerform for the postfix version of the expression in OCAL. Otherwise, use VAL.
2. If the Alarm Severity is INVALID, follow the option as designated by the field IVOA.
3. If the Alarm Severity is not INVALID or IVOA specifies "Continue Normally", put the value of OVAL to the OUT link and post the event in OEVT (if non-zero).
4. If an output delay was implemented, process the forward link.

---

EPICS Record Reference Manual - 7 JUNE 2006