blockSplitProportionally

Allocate an available amount according to priorities

Extends from Interfaces.PartialConverters.Policy_MO (Policy block with multiple outputs).

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

TypeNameDefaultDescription
BooleanshiftPrioritiesfalse= true, if all priorities are to be shifted to prevent negative inputs, otherwise negative inputs are simply set to zero (splitFactors.shiftInputs)
Structural Parameters
Integernout (from BasePolicy_MO)2Number of outputs

Connectors

TypeNameDefaultDescription
Interfaces.Connectors.RealInputuAvailable amount to be allocated
Interfaces.Connectors.RealMultiInput[nout]u_pPriorities for allocation (i.e., utilities)

Components

TypeNameDefaultDescription
RealMultiOutputy (from Policy_MO)Vector of policy output signals