User Tools

Site Tools


Guide Section: Processing Object Data | EASAP Tree: DATA PROCESSING Branch

MAP finds the index in an Inputs: LIST that matches the SCALAR specified in Value: and returns the SCALAR with that same index from the Outputs: LIST.

All the possible values of the SCALAR specified in the Value: parameter must be known to ensure a match with one of the values specified in the Inputs: parameter.

The values in the Inputs: parameter must be unique.

Some examples of objects for which all the possible values are known are:

  • CHOICE LIST - Possible values are set in Choices: parameter
  • LOGICBOX - Possible values are TRUE or FALSE
  • COMPUTE containing logical expression - Values are 0.0 or 1.0
  • SLIDER - Possible values are Upper Bound: and Lower Bound: and the given number of values between them—be careful of situations where the number of values does not divide evenly into the range of values.
Essential Parameters:
Value:Name of SCALAR to match to Inputs: LIST (the 'key' value)
Inputs: LIST of possible Value:'s to be mapped to a value in Outputs:.
Outputs:LIST of output values that correspond to Inputs:
Optional Parameters:
Delimiter:Character to act as delimiter in DORs in Inputs: and Outputs: above. default→%
Unit Group:Associates value with an existing DIMENSIONAL GROUP
Trim Whitespace:Specify whether whitespace is trimmed when DORs used for Inputs: or Outputs: (default→Trim, Leave as is)