SplitProportionally

Allocate an available amount according to priorities

Diagram

Information

This information is part of the Business Simulation Library (BSL). Please support this work and ► donate.

The output vector y is a proportional split (→ProportionalSplitFactors) of the single input u, which may be a rate or simply an available amount of entities.

Notes

  • The allocation or split does not account for capacity or demand restrictions, so that the allocated amount may be higher than feasible. If this is not intended, the more general Allocation policy component should be used.

  • If the priorities are given in the form p_i = exp( f(attributes_i) ) this component can be used to obtain a Logit type of choice model.

See also

Allocation

Revision history

  • Introduced in version 2.0.0

Parameters (2)

nout

Value: 2

Type: Integer

Description: Number of outputs

shiftPriorities

Value: false

Type: Boolean

Description: = true, if all priorities are to be shifted to prevent negative inputs, otherwise negative inputs are simply set to zero (splitFactors.shiftInputs)

Connectors (3)

y

Type: RealMultiOutput[nout]

Description: Vector of policy output signals

u

Type: RealInput

Description: Available amount to be allocated

u_p

Type: RealMultiInput[nout]

Description: Priorities for allocation (i.e., utilities)

Components (2)

splitFactors

Type: ProportionalSplitFactors

Description: Split factors add up to one

proportions

Type: ScalarMultiplication

Description: Total amount split up into proportions