The Assumptions Space

Assumption input and calculations for individual policies.

This Space holds assumption parameters and rates used by Projection and its base spaces.

Most cells in this Space return per-policy NumPy arrays whose layout matches the rows of policy_data(), so callers index into them with the integer policy index idx. A few cells, such as asmp_tables() and mortality_tables(), return tables shared across all policies.

Parameters and References

input_data

Alias for InputData. Per-policy assumptions are read from the AssumptionTable range in input.xlsx via assumption(), and mortality / lapse tables from assumption_tables() and mortality_tables().

return_array

When True (the default), helper functions inherited from Utilities return NumPy arrays instead of pandas objects.

Type:

bool

Inherited helpers

Inherited from Utilities:

• pandas_to_array()

• map_to_policies()

Child spaces

• AsmpID: Enum-style codes identifying entries in the AsmpByDuration table.

Cells Summary

Commission Assumptions

Per-policy initial and renewal commission rates and the renewal commission term.

comm_init_prem()	Initial commission per premium
comm_ren_prem()	Renewal commission per premium
comm_ren_term()	Renewal commission term

Expense Assumptions

Per-policy acquisition and maintenance expense assumptions, expressed per annualized premium, per policy and per sum assured.

exps_acq_ann_prem()	Acquisition expense per annualized premium
exps_acq_pol()	Acquisition expense per policy
exps_acq_sa()	Acquisition expense per sum assured
exps_maint_ann_prem()	Maintenance expense per annualized premium
exps_maint_pol()	Maintenance expense per policy
exps_maint_sa()	Maintenance expense per sum assured

Tax and Inflation Assumptions

The consumption tax rate and the expense inflation rate.

cnsmp_tax()	Consumption tax rate
inflation_rate()	Inflation rate

Mortality

The mortality-table block and the per-policy indices that select each policy’s base mortality rates and its last mortality age.

mortality_tables()	Mortality tables read from input.xlsx.
mort_table_index()	Per-policy mortality table identifier.
mort_array_index()	Per-policy column index into mortality_tables().
last_mort_age()	Last mortality age per policy (first age where mortality reaches 1).

Mortality Factor and Lapse

The assumption-by-duration table and the per-policy indices that select mortality factors and lapse rates, together with its row count.

asmp_tables()	Assumption tables by duration.
mort_factor_index()	Per-policy column index into asmp_tables() for mortality factors.
lapse_rate_index()	Per-policy column index into asmp_tables() for lapse rates.
asmp_table_len()	Number of rows (durations) in asmp_tables().

Cells Descriptions

comm_init_prem()

Initial commission per premium

comm_ren_prem()

Renewal commission per premium

comm_ren_term()

Renewal commission term

exps_acq_ann_prem()

Acquisition expense per annualized premium

exps_acq_pol()

Acquisition expense per policy

exps_acq_sa()

Acquisition expense per sum assured

exps_maint_ann_prem()

Maintenance expense per annualized premium

exps_maint_pol()

Maintenance expense per policy

exps_maint_sa()

Maintenance expense per sum assured

cnsmp_tax()

Consumption tax rate

inflation_rate()

Inflation rate

mortality_tables()

Mortality tables read from input.xlsx.

Returns the full mortality-table block from the MortalityTables range as a 2-D NumPy array (when return_array is True), where rows are indexed by age and columns by (MortTable, Sex).

mort_table_index()

Per-policy mortality table identifier.

Maps the BaseMort assumption keyed by the model point lookup (product, policy type, gen) to each row of policy_data().

mort_array_index()

Per-policy column index into mortality_tables().

Returns a 1-D integer array of column positions in mortality_tables() for each policy’s (mort_table_index, sex) pair.

last_mort_age()

Last mortality age per policy (first age where mortality reaches 1).

asmp_tables()

Assumption tables by duration.

Returns the AsmpByDuration range from input.xlsx as a 2-D NumPy array indexed by duration (rows) and assumption ID (columns). Used by mort_factor() and lapse_rate() together with mort_factor_index() and lapse_rate_index().

mort_factor_index()

Per-policy column index into asmp_tables() for mortality factors.

Resolves each policy’s MortFactor assumption (referencing an AsmpID) to its column position in the AsmpByDuration table.

lapse_rate_index()

Per-policy column index into asmp_tables() for lapse rates.

Resolves each policy’s Surrender assumption (referencing an AsmpID) to its column position in the AsmpByDuration table.

asmp_table_len()

Number of rows (durations) in asmp_tables().