The Data Space#
Input data shared by every by-contract projection.
The four input CSVs are read here, once per model, and referenced from
Projection as data. Projection is
parameterized by idx, the position of a model point in the table, so each
Projection[i] is a separate ItemSpace with its own cells cache; if the readers lived
there, every model point would re-read every file.
Holding them in an unparameterized Space reads each file once no matter how many
contracts are projected.
Inputs are external files: plain CSVs in the model folder’s parent directory,
products/immediate_annuity/, rather than data stored inside the model. The model
folder therefore holds nothing but formulas — no _data/, no IOSpec, no embedded
values — so a diff of the model shows logic changes only. This follows
annuallife.TradLife_A; contrast basiclife.BasicTerm_S, which keeps its inputs
inside the model through modelx’s IOSpec machinery.
The consequence worth knowing: the model is not portable on its own. Copying the
SPIA_US_SEC folder without its parent’s CSVs produces a model that reads and then
fails on first evaluation.
Three of the tables are SPIA_US_S’s. The mortality table, the improvement scale and
the surrender-charge scale are the files SPIA_US_S reads, read here in place: one
copy of each table serves both models, so an edit to one reaches both. The model point
table is this model’s own, model_point_table_sec.csv; it sits beside
SPIA_US_S’s model_point_table.csv, which this model never opens.
input_dir() resolves the directory from _model.path.parent at run time, so
the model works wherever the repository is checked out. Each table has a filename
Reference and a reader Cells:
Reference |
Cells |
File |
|---|---|---|
model_point_file |
model_point_table() |
model_point_table_sec.csv |
mort_table_file |
mort_table() |
mort_table.csv |
improvement_scale_file |
improvement_scale() |
improvement_scale.csv |
surr_charge_file |
surr_charge_table() |
surr_charge_table.csv |
The model point table is checked as it is read. Six of its columns are the
in-force interface: policy_count and duration_mth, as in
basiclife.BasicTerm_SE, and the four columns of a contract’s opening state, each
covered life’s survival at the valuation date, the commutation fraction taken by then and
the 10-year CMT’s change since the annuity date. model_point_table() refuses a
table that lacks any of them, repeats a point_id, holds a count, a duration or a month
of death no contract can have, or holds an opening state no contract can be in. The checks
run in turn, and the first that fails raises, naming the missing column or every point
that fails it. It also refuses an annuity to commence more than future_horizon_mth
months after the valuation date, 120 months as shipped: future new business is written
over a stated horizon, so that no frame runs longer than the stop rule from the annuity
date plus that horizon. Set to 0, the Reference refuses future new business altogether.
Whether a contract still owes a payment at the valuation date is a rule of the product
rather than of the table, and Projection.proj_len checks it.
So is the surrender-charge scale. surr_charge_scale() reads its policy years by
value, once, and refuses a year that is not a whole number, a gap, a repeat or a blank
rate, naming the file; Projection.surr_charge_rate takes the scale’s first and last
years and its rates from there, never from the raw column.
The two mortality tables are keyed by (age, sex) and the surrender-charge table by
policy_year. They are separate files on purpose: the technical notes require the
best-estimate basis to be the 2012 IAM Basic table projected with Projection Scale
G2, two distinct objects with distinct provenance, and neither may be embedded in the
model — the shipped tables are illustrative [std] stand-ins. To swap in a licensed
basis, replace mort_table.csv with a same-schema file, or point mort_table_file
at a different name before the model computes anything. No formula changes. The
improvement scale is swappable the same way, which is how the notes’ first sensitivity —
a 50% / 150% scaling of tabulated improvement — is run. Replacing a file changes
SPIA_US_S too, which reads the same one.
The vectors. The readers return what the files hold, and no
Projection cell but model_point, a reporting cell, reads them.
The others read the arrays below instead, one element at a time, a
model point’s attribute being the element at its position, data.premium()[idx]. That
is what lets the model compile to C, as basiclife.BasicTerm_SC does: each array is a
numpy vector or table of int64 or float64, which compiles to a typed memoryview, never one
of bools, objects or text, and each check of a table is an int. Each model point column a
projection reads is one vector of the column’s own name, read element by element as
SPIA_US_S reads the point’s value, float() of an amount or a rate, int() of an
age, a month count or a year, bool() of a flag; and where a point’s value can be one
its projection cannot use, a 0/1 vector beside it, <column>_ok, says whether it is
usable. The text the projection branches on is decoded into 0/1 flags, each with a
has_* flag that says the value is one SPIA_US_S names. The mortality table and the
improvement scale, keyed by age and sex, are tabled by schedule, one per sex, and age,
padded from age 0, each point carrying the schedule of each life’s sex; the surrender
charges are a vector by policy year, padded from year 0:
Cells |
dtype |
Shape |
From |
|---|---|---|---|
point_id() |
int64 |
[point] |
the table’s index |
policy_count() |
float64 |
[point] |
|
duration_mth(), duration_mth_ok() |
int64 |
[point] |
|
premium() |
float64 |
[point] |
|
premium_ok() |
int64 |
[point] |
|
premium_tax_rate() |
float64 |
[point] |
|
premium_tax_rate_ok() |
int64 |
[point] |
|
annual_income() |
float64 |
[point] |
|
annual_income_ok() |
int64 |
[point] |
|
cola_rate() |
float64 |
[point] |
|
cola_rate_ok() |
int64 |
[point] |
|
survivor_pct() |
float64 |
[point] |
|
survivor_pct_ok() |
int64 |
[point] |
|
rating_factor() |
float64 |
[point] |
|
rating_factor_ok() |
int64 |
[point] |
|
primary_age(), primary_age_ok() |
int64 |
[point] |
|
joint_age(), joint_age_ok() |
int64 |
[point] |
|
certain_months() |
int64 |
[point] |
|
certain_months_ok() |
int64 |
[point] |
|
frequency(), frequency_ok() |
int64 |
[point] |
|
annuity_year(), annuity_year_ok() |
int64 |
[point] |
|
is_joint() |
int64 |
[point] |
|
commutation_enabled() |
int64 |
[point] |
the column, 1 on True |
issue_state_excludes_withdrawal() |
int64 |
[point] |
the column, 1 on True |
qualified() |
int64 |
[point] |
the column, 1 on True |
has_form() |
int64 |
[point] |
|
is_period_certain() |
int64 |
[point] |
|
is_certain_only() |
int64 |
[point] |
|
is_cash_refund() |
int64 |
[point] |
|
is_installment_refund() |
int64 |
[point] |
|
has_reduction_trigger() |
int64 |
[point] |
|
is_trigger_either() |
int64 |
[point] |
the same, 1 on either |
has_timing() |
int64 |
[point] |
|
is_arrears() |
int64 |
[point] |
the same, 1 on arrears |
has_mort_basis() |
int64 |
[point] |
|
is_scenario() |
int64 |
[point] |
the same, 1 on scenario |
death_mth_1(), death_mth_1_ok() |
int64 |
[point] |
|
death_mth_2(), death_mth_2_ok() |
int64 |
[point] |
|
lives_if_init_1() |
float64 |
[point] |
|
lives_if_init_2() |
float64 |
[point] |
|
commute_frac_cum_init() |
float64 |
[point] |
the column |
cmt10_shift_init() |
float64 |
[point] |
the column |
mort_sexes() |
int |
scalar |
mort_table.csv, checked |
mort_table_array() |
float64 |
[schedule, age] |
mort_table.csv |
mort_age_first(), mort_age_last() |
int64 |
[schedule] |
mort_table.csv |
mort_schedule_1() |
int64 |
[point] |
|
mort_schedule_2() |
int64 |
[point] |
|
improvement_sexes() |
int |
scalar |
improvement_scale.csv, checked |
improvement_array() |
float64 |
[schedule, age] |
improvement_scale.csv |
improvement_age_first() |
int64 |
[schedule] |
improvement_scale.csv |
improvement_age_last() |
int64 |
[schedule] |
improvement_scale.csv |
improvement_schedule_1() |
int64 |
[point] |
|
improvement_schedule_2() |
int64 |
[point] |
|
surr_charge_rate_array() |
float64 |
[policy_year] |
|
surr_charge_year_first() |
int |
scalar |
|
surr_charge_year_last() |
int |
scalar |
Each table is numbered by its own sexes, in sorted order, from schedule 1, so the two
tables need not hold the same sexes: mort_sexes() and improvement_sexes(), each
the table’s one check, an int, give the count. Schedule 0 is a row of padding whose first
age is 1 and whose last is 0, so that no age lies between them: a life whose sex a table
lacks, a blank among them, has schedule 0 there, and Projection’s reader of the table
refuses it, naming the point, the age and the life, at the first age it reads, as
SPIA_US_S’s .loc raised KeyError there. A point on the scenario basis, or a
single-life point’s second life, never reads it. surr_charge_scale() stays the
scale’s checked DataFrame, as at stage E, and the vector and its two extents are read
from it.
An array is read by element, never whole, in this Space as in
Projection. The compiler types an array cell as a memoryview only once
it has seen that every use of it, in either Space, is an element read: one len(),
slice, loop over it or numpy call on it anywhere, and the cell compiles as a Python
object. So an array derived here reads the table’s column, and a width comes from a table
or a check’s int, never from another cell’s array. Each age table’s check is one int cell
that its array, its extents and its schedules read first, so that a projection, which
reads an extent first, meets the same refusal as a reader of the array. The column
keywords of model_point_table()’s DataFrame.assign are passed as **{...},
since a keyword named as a cell of this Space, death_mth_1, would be rewritten by the
export.
What a point’s projection cannot use is refused where it reads it, by the point’s own
Projection cell, naming the point, never here: no point is refused for another’s
value, nor for a column its projection never reads, so that the model projects every
point SPIA_US_S projects to a number, as at stage E (D2). Where a vector cannot hold
a value, the vector holds 0 or NaN there and its _ok flag 0, and the
Projection accessor that reads the element raises:
text in a column of numbers, which
SPIA_US_S’sfloat()orint()refuses in the same cell, on every point that reads it;a blank, which
int()refuses, in an age, a month count, a frequency or a year, as inSPIA_US_S: a blankjoint_ageon a single-life point, a blankcertain_monthson a form without an elected period and a blankannuity_yearon the scenario basis are read by no projection, and refused only by a direct call;an int of
2**53or more in size, which an int64 cannot be trusted to hold (below), in those columns and induration_mthand the two death months;a blank or infinite amount or rate on a point whose projection reads it through a
max, aminor a comparison that would turn the missing value into a number, asSPIA_US_S’s would: the premium on a cash or installment refund, whose refund balance ismax(0, P - G)and whose refund period a searchG(k) >= P; the first year’s income and the COLA rate on every point, whose instalments every projection pays and its refund, its refund period and its withdrawal’s floor read through such amax,minor search; the survivor percentage on a joint contract of the four forms with a life contingency, whose payment factor the certain floor’smaxreads; and the rating factor on the table basis, whose mortality the samemaxreads in the end. Elsewhere a blank stays NaN, asSPIA_US_Sreads it, and so does every blankpremium_tax_rate, which onlyProjection.premium_net_ppreads, in a product.
That is the family’s cap rule (USLIB-SEC-PLAN.md §7.1), applied by point: a point
SPIA_US_S projects to a number only because a max or a min lost its missing
value is refused, in its projection, and no other. A fraction in an int column truncates,
as SPIA_US_S’s int() does, so a frequency written 12.5 is monthly. A text value of
form, reduction_trigger, timing or mort_basis that is none of
SPIA_US_S’s values sets no has_* flag, and the decode that reads the flag raises
SPIA_US_S’s message there, as at stage E; the values are compared exactly, case and
whitespace included, as SPIA_US_S compares them. A flag column is bool() of each
element as pandas reads it, as SPIA_US_S’s bool(model_point()[...]) is, so a blank
reads as True there too. What the table’s own checks refuse, model_point_table()
refuses for the whole table, as at stage E, and point_id() refuses a label that
is not a whole number below 2**53, naming every label at fault, when a label is first
read: they are the table’s keys and its in-force interface.
An int64 holds what it is read from. A float past int64 casts to the least int64
without a word, so a number read into an int64 vector is usable only below 2**53 in
size, where the int64 holds SPIA_US_S’s reading of it exactly; past it the flag is 0.
The large extract. model_point_table() reads the file whole, not in chunks
(low_memory=False), so that pandas infers each column’s type once: read in chunks, a
table of thousands of single lives with a joint point among them typed joint_sex chunk
by chunk and warned (DtypeWarning), though the frame was the same.
Cells Descriptions#
- input_dir()[source]#
The directory holding the input CSVs: the model folder’s parent.
Inputs are external files, not data stored inside the model, so the model folder is pure formulas. The path is resolved at run time from where the model was read, following
annuallife.TradLife_A.
- model_point_table()[source]#
The model point table, read from model_point_table_sec.csv and checked.
Indexed by
point_id. Six columns are the in-force interface:policy_count, the contracts the point stands for, andduration_mth, the months elapsed from the annuity date at the valuation date, as inbasiclife.BasicTerm_SE; then the opening state, per contract, as it stands at the start of month 0, before any month-0 event:lives_if_init_1andlives_if_init_2: each covered life’s probability of being alive at the valuation date, 1 or 0 on a real record, where a joint contract may carry one life already dead, and 0 for the second life of a single-life contract;commute_frac_cum_init: the cumulative commutation fraction applying in month 0, before any month-0 withdrawal;cmt10_shift_init: the 10-year CMT at the valuation date less the 10-year CMT at the annuity date, as a decimal, which moves the commutation discount rate.
The rest are
SPIA_US_S’s,pols_if_initrenamedpolicy_count, exceptrow_kind,source_policy_idandsource_mth, which record where the generator took each shipped row from and which no formula reads.The checks run over the whole table at once, and the first that fails raises
ValueError, naming the missing column or every point it fails on:the six in-force columns are present;
no
point_idappears twice;policy_countis a number, zero or more;duration_mthis a whole number of months, read by value, so that12.0is 12: positive for a contract in payment, 0 for one whose annuity date is the valuation date, negative for one commencing later;no annuity commences more than
future_horizon_mthmonths after the valuation date, soduration_mthis-future_horizon_mthor more. At 0 the model takes no future new business, and the message says so; a negative horizon is itself refused;lives_if_init_1andlives_if_init_2are probabilities, 0 to 1;commute_frac_cum_initis a number, 0 or more and below 1;cmt10_shift_initis a number, of either sign;a single-life contract has no second life:
lives_if_init_2is 0;a contract not yet in payment,
duration_mth0 or less, holds its values at the annuity date: each covered life 1, no commutation and no change in the CMT;each month of death,
death_mth_1anddeath_mth_2, is blank or a whole number of months, read by value, so that13.0is 13 and a fraction or text is refused, on every basis. The table is returned with the two columns as the numbers they were checked as, which is whatProjection.death_mthreads;on the scenario basis, each life’s opening status is its death month’s: 1 while the life survives to the valuation date,
death_mthblank, negative orduration_mthor later, asProjection.death_mthandProjection.lives_ifread it, and 0 once it has died. So the scenario’s step function, whichlives_iffollows after the valuation date, agrees with the opening value at it;a commutation fraction appears only where a commutation could have been taken before the valuation date: the contract holds the right, its issue state allows it, it has a certain period, an elected one or an installment refund’s, and
duration_mthis 13 or more, the first withdrawal being taken in policy month 12 and reducing the instalments from month 13. That is a necessary condition only: the check cannot see an installment refund’s derived period, which needs the projection, nor whether a certain period long enough for a withdrawal remained, and it does not ask whether the model’s own utilization assumption would have taken one, since a real record’s withdrawals do not depend on it.
Whether the contract still owes a payment at the valuation date needs the certain period, which an installment refund derives in
Projection, soProjection.proj_lenchecks it.The file is read whole,
low_memory=False, so that pandas types each column once, not chunk by chunk, which on a large extract warned and changed nothing. The two death columns are returned through**{...}, since their names are cells of this Space, which the export would rewrite as keywords.
- improvement_scale()[source]#
The generational improvement scale by age and sex, from improvement_scale.csv.
- surr_charge_table()[source]#
The commutation surrender-charge scale by contract year, surr_charge_table.csv.
- surr_charge_scale()[source]#
The surrender-charge scale by contract year, as
surr_charge_table()reads it, checked.The rates of surr_charge_table.csv, indexed by its policy years read by value, as
SPIA_US_S’s lookup matches them, so that a year written2.0is year 2.Projection.surr_charge_ratetakes the scale’s first and last years and its rates from here, so the extents and the values come from one checked column. A year that is not a whole number, text and a blank among them, is refused, naming every such year; so is a scale with no year, or whose years do not run from the first to the last without a gap or a repeat, from year 1 on, each with a rate.SPIA_US_Stakesint()of the raw years for the extents, so a year writtenxraises Python’s own message there, and one written3aturns the years to text and makes every lookup miss.
- point_id()[source]#
The model points’ labels, int64 by position: the table’s
point_idindex.The label
Projection.point_idreports for a position, and the one every refusal names. Read by value, so that a label written3.0is 3, and refused when a label is first read, naming every label at fault, where one is not a whole number, text and a blank among them, or is2**53or more in size: the labels are the table’s keys, as in the family’s other compiled models. A projection that names no point reads no label, and runs.
- policy_count()[source]#
The
policy_countcolumn, float64 by point, asmodel_point_table()checked it.
- duration_mth()[source]#
The
duration_mthcolumn, int64 by point:int()of each value, 0 whereduration_mth_ok()is 0.model_point_table()has refused a value that is not a whole number, read by value, so that12.0is 12.
- duration_mth_ok()[source]#
1 where
int()reads the point’sduration_mthbelow2**53in size, asprimary_age_ok(): 0 on a blank, and on text,"12.0"among them in a column pandas reads as text, whichint()refuses; a number read as one,12.0, is 12.
The
premiumcolumn, float64 by point:float()of each value, NaN on text.
1 where the point’s projection may read its
premium.0 on text, which
float()refuses, and on a blank or infinite premium on a cash or installment refund, whose refund balancemax(0, P - G)and refund periodG(k) >= Pwould turn it into a number. A blank stays NaN on the other forms, which read it only inProjection.premium_net_pp, asSPIA_US_Sdoes.
The
premium_tax_ratecolumn, float64 by point:float()of each value, NaN on text.
1 where
float()reads the point’spremium_tax_rate: 0 on text alone.A blank stays NaN, as
SPIA_US_Sreads it: onlyProjection.premium_net_pp, which no report reaches, reads the rate.
- annual_income()[source]#
The
annual_incomecolumn, B(1), float64 by point:float()of each value, NaN on text.
- annual_income_ok()[source]#
1 where the point’s
annual_incomeis a finite number: 0 on text, a blank and an infinity.Every projection pays its instalments, and its refund, its refund period and its withdrawal’s residual floor read them through a
max, aminor a search that would turn a missing income into a number.
- cola_rate_ok()[source]#
1 where the point’s
cola_rateis a finite number: 0 on text, a blank and an infinity.It compounds every instalment past the first policy year, which the projection reads as
annual_income_ok()says.
- survivor_pct()[source]#
The
survivor_pctcolumn, float64 by point:float()of each value, NaN on text.
- survivor_pct_ok()[source]#
1 where the point’s projection may read its
survivor_pct.0 on text, and on a blank or infinite percentage on a joint contract of the four forms with a life contingency, whose payment factor,
max(C, L), would turn a missing one into a number. A single-life contract and a certain_only one never read it.
- rating_factor()[source]#
The
rating_factorcolumn, float64 by point:float()of each value, NaN on text.
- rating_factor_ok()[source]#
1 where the point’s projection may read its
rating_factor.0 on text, and on a blank or infinite factor on the table basis, whose survival the payment factor’s
max(C, L)reads in the end: the mortality caps put their bound second, so a missing rating stays missing there, and themaxwould turn it into a number. The scenario basis never reads it.
- primary_age()[source]#
The
primary_agecolumn, int64 by point:int()of each value, 0 whereprimary_age_ok()is 0.
- primary_age_ok()[source]#
1 where
int()reads the point’sprimary_agebelow2**53in size.0 on text, a blank and an infinity, which
SPIA_US_S’sint()refuses, and on a number the int64 vector cannot be trusted to hold. A fraction truncates, asint()does.
- joint_age()[source]#
The
joint_agecolumn, int64 by point:int()of each value, 0 wherejoint_age_ok()is 0, a single-life point’s blank among them.
- joint_age_ok()[source]#
1 where
int()reads the point’sjoint_agebelow2**53in size.As
primary_age_ok(). A single-life point’s blank is 0 here, and no projection of such a point reads it.
- certain_months()[source]#
The
certain_monthscolumn, int64 by point:int()of each value, 0 wherecertain_months_ok()is 0.
- certain_months_ok()[source]#
1 where
int()reads the point’scertain_monthsbelow2**53in size.As
primary_age_ok(). Only a form with an elected certain period reads it.
- frequency()[source]#
The
frequencycolumn, int64 by point:int()of each value, 0 wherefrequency_ok()is 0.Any whole number is held;
Projection.payment_freqrefuses one that is not 12, 4, 2 or 1, withSPIA_US_S’s message.
- frequency_ok()[source]#
1 where
int()reads the point’sfrequencybelow2**53in size, asprimary_age_ok().
- annuity_year()[source]#
The
annuity_yearcolumn, int64 by point:int()of each value, 0 whereannuity_year_ok()is 0.
- annuity_year_ok()[source]#
1 where
int()reads the point’sannuity_yearbelow2**53in size.As
primary_age_ok(). Only the table basis reads it, to date improvement.
- commutation_enabled()[source]#
The
commutation_enabledcolumn, int64 by point: 1 wherebool()of the value is True.
- issue_state_excludes_withdrawal()[source]#
The
issue_state_excludes_withdrawalcolumn, int64 by point: 1 wherebool()of the value is True.
- death_mth_1()[source]#
The primary’s scenario month of death, int64 by point: -1 where blank.
The
death_mth_1column asmodel_point_table()checked it, a whole number of policy months or blank, the blank beingSPIA_US_S’s survivor, whichProjection.death_mthreads as -1; 0 wheredeath_mth_1_ok()is 0.
- death_mth_1_ok()[source]#
1 where
death_mth_1()holds the point’s month: blank, or below2**53.
- death_mth_2()[source]#
The joint annuitant’s scenario month of death, int64 by point: -1 where blank, as
death_mth_1().
- death_mth_2_ok()[source]#
1 where
death_mth_2()holds the point’s month: blank, or below2**53.
- lives_if_init_1()[source]#
The
lives_if_init_1column, float64 by point: checked bymodel_point_table().
- lives_if_init_2()[source]#
The
lives_if_init_2column, float64 by point: checked bymodel_point_table().
- commute_frac_cum_init()[source]#
The
commute_frac_cum_initcolumn, float64 by point: checked bymodel_point_table().
- cmt10_shift_init()[source]#
The
cmt10_shift_initcolumn, float64 by point: checked bymodel_point_table().
- mort_sexes()[source]#
mort_table.csv’s check, an int: the number of its sexes, each a schedule.
The table is read by value, as
SPIA_US_S’s.locmatches its keys, and refused, naming the file and every line at fault, where an age is not a whole number, text and a blank among them, a sex is blank, or a rate is not a finite number; and, naming the sex, where one sex’s ages do not run from its first to its last without a gap or a repeat, or one is negative, since the table is held from age 0.SPIA_US_SraisedKeyErroronly where a projection read a missing key, and read a blank rate as NaN. Every array, extent and schedule of the table reads this first.
- mort_table_array()[source]#
mort_table.csv’s rates, float64 by schedule and attained age,
[s, x].Schedule
sis thes-th of the table’s sexes in sorted order, from 1; row 0, and every age below a sex’s first, is NaN padding, whichProjection.mort_rate_base_atnever reads, since it checks the age againstmort_age_first()andmort_age_last()first.
- mort_age_last()[source]#
Each mortality schedule’s last age, int64 by schedule: 0 on schedule 0, so that no age lies between its extents.
- mort_schedule_1()[source]#
The mortality schedule of each point’s
primary_sex, int64 by point.The sex’s number in
mort_table_array(), matched asSPIA_US_S’s.locmatches it, and 0 where the table lacks it, a blank among them: a point on the scenario basis never reads the table, and one on the table basis is refused whereProjection.mort_rate_base_atfirst reads schedule 0.
- mort_schedule_2()[source]#
The mortality schedule of each point’s
joint_sex, int64 by point, asmort_schedule_1(): 0 on a single-life point’s blank, which nothing reads.
- improvement_sexes()[source]#
improvement_scale.csv’s check, an int: the number of its sexes, each a schedule.
The scale is read and refused as
mort_sexes()reads and refuses the mortality table, and numbered by its own sexes: the two tables need not hold the same ones.
- improvement_array()[source]#
improvement_scale.csv’s rates, float64 by schedule and attained age,
[s, x], padded asmort_table_array()is.
- improvement_age_first()[source]#
Each improvement schedule’s first age, int64 by schedule: 1 on schedule 0.
- improvement_age_last()[source]#
Each improvement schedule’s last age, int64 by schedule: 0 on schedule 0.
- improvement_schedule_1()[source]#
The improvement schedule of each point’s
primary_sex, int64 by point, numbered by the scale’s own sexes, asmort_schedule_1()by the table’s.
- improvement_schedule_2()[source]#
The improvement schedule of each point’s
joint_sex, int64 by point, asimprovement_schedule_1().
- surr_charge_rate_array()[source]#
The surrender-charge rates, float64 by policy year, from
surr_charge_scale().Indexed by the year itself, from 0, NaN below the scale’s first year, which
Projection.surr_charge_ratenever reads: it clamps the year tosurr_charge_year_first()andsurr_charge_year_last()first, and the scale’s check holds the first year to 1 or more.
- surr_charge_year_first()[source]#
The surrender-charge scale’s first policy year, an int, from
surr_charge_scale().
- surr_charge_year_last()[source]#
The surrender-charge scale’s last policy year, an int, from
surr_charge_scale().