Range Lookup

apama.analyticskit.blocks.core.RangeLookup

Finds the range in which the input value lies.

Ranges are defined using a list of unique upper bound values in increasing order. The lower bound of the first range depends on the value of the Minimum Value parameter. The lower bound of each subsequent range is defined by the upper bound of the previous range. The range to which an input value equal to a boundary value belongs depends on the Exclude Upper parameter. The block outputs the mapped value for the range the input lies within, or a failed flag if the input value is not within any of the ranges.

Parameters

Name | Description | Type | Notes |

Minimum Value | The lower bound of the first range (first row). If nothing is specified, negative infinity is taken as the minimum value. | float | Optional |

Ranges | A boundary and mapped value pair for the upper bound of a range for which to look up the input value and a mapped value that is to be used as the output value if the input value lies within the range. | List of Upper Bound value and Mapped Value | |

Exclude Upper | If selected, an input value equal to the upper bound of a row is considered to be part of the range of the next row. If not selected, such an input value is considered to be part of the range of the current row. | boolean | Default: true |

Type | The type that is to be used for the output value. | Option - one of: Float Boolean String | Optional |

Input Port Details

Name | Description | Type |

Value | The input value for which the range is to be found. | float |

Output Port Details

Name | Description | Type |

Mapped | The Mapped Value for the range that is matched. | any |

Failed | Is true when the input does not lie in any range. Otherwise it is false. | boolean |