blockPerformance
Extends from BusinessSimulation.Interfaces.PartialCLD.Performance (Evaluating a stock).
Information
This information is part of the Business Simulation Library (BSL). Please support this work and ► donate.
The output y is the dimensionless degree of membership to the set of "good performances" or "good outcomes" according to a chosen type of membership function. Using the PerformanceIndicator allows to quickly grasp how a system is currently performing with regard to some criterion with a value of 1 indicating best possible performance and a value of 0 indicating worst possible (and possbily unsustainable) performance.
The following grid displays all available membership function types without inversion (invertResults = false):
| Membership Function Type | a | b | c | d |
|---|---|---|---|---|
| ramp | foot | shoulder | ||
| triangular | left foot | center | right foot | |
| trapezoidal | left foot | left shoulder | right shoulder | right foot |
| sshaped | foot | shoulder | ||
| sigmoidal | steepness of transition area | center of transition area | ||
| pishaped | left foot | left shoulder | right shoulder | right foot |
| psigmoidal | steepness of left transition | center of left transition area | steepness of right transition | center of right transition area |
| gaussian | half width at half maximum | center of curve (maximum) | ||
| bell | width of core | steepness | center of core |
When inversion is turned on (invertResult = true) the result obtained from the membership function as specified will be subtracted from 1. Thus the ramp shown above can be made to ramp down from left to right with a being the shoulder and b the foot by inverting the results.
Implementation
![]() |
Notes
- The amount in the connected stock (
stockInfoInput) will be normalized by divison either by a constantreferenceValue (default = 1)or by the exogenous input u (hasConstantReference = false). - Using a polarity (
+,-,±) it is possible to indicate the basic relation between the amount in the stock and its performance value (e.g.,+indicating a "more-is-better" type of evaluation.
See also
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| String | pol (from Lookup) | "±" | Polarity |
| ReferenceType | referenceValue (from Lookup) | 1 | Constant reference value to normalize input |
| Ratio | a | Parameter to control shape of membership function | |
| Ratio | b | unspecified | Parameter to control shape of membership function |
| Ratio | c | unspecified | Parameter to control shape of membership function |
| Ratio | d | unspecified | Parameter to control shape of membership function |
| Structural Parameters | |||
| Boolean | hasConstantReference (from Lookup) | true | = true, if the reference value is given by a constant parameter |
| Boolean | hasStockInfoInput (from Lookup) | true | = true, if the input is given by the input connector u instead of stockInfoInput |
| MFT | mft | MFT.ramp | Membership function type to use |
| Boolean | invertResult | false | = true, if the degree of membership is to be inverted (i.e., y = 1 - mf(u)) |
Connectors
| Type | Name | Default | Description |
|---|---|---|---|
| Connectors.StockInfoInput | stockInfoInput (from Lookup) | ||
| Connectors.RealInput | u_ref (from Lookup) | Reference value for stock | |
| Connectors.RealInput | u (from Lookup) | Input for lookup (optional) |
Components
| Type | Name | Default | Description |
|---|---|---|---|
| RealOutput | y (from Lookup) | Output of output type |
Revisions
- Introduced in v2.0.0.
