pols_if_at¶

pols_if_at(i, timing)[source]¶

Number of policies in-force

pols_if_at(t, timing) calculates and returns the number of policies in-force at various timings in step i. The second parameter timing takes a string value to indicate the timing, which is either 'BEG_STEP', 'DECR_LAST', 'AFT_MAT', 'AFT_NB' or 'DECR_NEXT'.

BEG_STEP

The number of policies in-force at the beginning of step i. At time 0, the value is read from pols_if_init(). For time > 0, it is equal to pols_if_at(i-1, 'DECR_NEXT').

DECR_LAST

The number of policies in-force reflecting decrement by lapse and death before the next policy anniversary in step i. Defined as:

pols_if_at(i, 'BEG_STEP') - pols_lapse(i, 'LAST') - pols_death(i, 'LAST')

AFT_MAT

The number of policies after reflecting maturity decrement. Defined as:

pols_if_at(i, 'DECR_LAST') - pols_maturity(i)

AFT_NB

The number of policies after reflecting increase by new business. Defined as:

pols_if_at(i, 'AFT_MAT') + pols_new_biz(i)

DECR_NEXT

The number of policies after reflecting decrement by lapse and death after the next policy anniversary in step i. Defined as:

pols_if_at(i, 'AFT_NB') - pols_lapse(i, 'NEXT') - pols_death(i, 'NEXT')