Model CharityFractionSets

This model tracks the fractional ownership of each charity in every investment option, used to determine how exit amounts are allocated.

Purpose

CharityFractionSets provides the mapping of options to charities and their respective fractional shares. It is essential for calculating allocations and ensuring that each charity receives the correct portion of option exits.

Structure

The model is a dictionary mapping option IDs to dictionaries of charity IDs and their shares:

CharityFractionSets:
	{OptionId}:
		{CharityId}: Share owned by charity (decimal)
		{CharityId}: Share owned by charity (decimal)
		...
	...

Note: Shares are not normalized fractions. To obtain the actual fraction of ownership for a charity in an option, divide the share by the divisor registered in the OptionWorths2 model:

$$ \text{Fraction}_{option}(charity) = \frac{\text{Share}_{option}(charity)}{\text{Divisor}_{option}} $$

Relationships

• Generated by: Calculator
• Uses: OptionWorths2, Donations2
• Consumed by: Allocations, AmountsToTransfer
• Updated by: CONV_ENTER, DONA_UPDATE_CHARITY, META_CHARITY_PARTITION

Implementation Notes

• Shares are updated when donations enter options, or when charity assignments change.
• Actual fractions are calculated by dividing shares by the divisor from OptionWorths2; this ensures allocations are proportional to true ownership.
• Used to drive allocation calculations and ensure financial correctness in payouts.