Skip to main content

kernels.TailSpec

A tail, held fixed like a ConventionalCandidate.

Usage

Source

kernels.TailSpec(
    kind,
    factor=None,
    decay=None,
    attach_lag=None,
    fit_lags=(None, None),
    steps=None,
    rows=None,
    sigma=None,
    std_err=None,
    option_prefix=""
)

Ages are months from the start of the origin period; counts are development steps. Every field is checked when the spec is made; the checks that need the triangle (an age on its grid, two factors to fit a curve to) are made by apply_tail().

Attributes

kind: str

One of TAIL_KINDS.

factor: float or None

"constant" only, and needed there: the development from attach_lag to ultimate, such as 1.05. A positive finite number; below 1 is allowed (a triangle whose losses fall after the last age).

decay: float or None

"constant" only: from 0 to 1, the share of each tail step’s development that the next step keeps. None is 0.5.

attach_lag: int or None

The age the ratio of the first link the tail replaces develops FROM, a development age of the triangle. None is the last observed age, where nothing is replaced.

fit_lags: tuple of (int or None, int or None)

Curves only: the first and the last link to fit the curve to, each named by the age it develops FROM, both included. None at either end is the edge of the triangle.

steps: int or None

Curves only: development steps extrapolated beyond the last observed age, 1 to MAX_STEPS. None is 100.

rows: int or None

How many development steps beyond the last observed age are shown one by one; the rest of the tail is carried by the last of them. It never moves an ultimate. None is 12 // dev_grain_months (at least 1, and for a curve at most steps).

sigma, std_err: float or None

Mack only: the tail step’s sigma and the tail factor’s standard error, each used instead of the value read off the other sigmas. Zero or a positive finite number.

option_prefix: str
How refusals name the fields: "" names them as here, "tail_" as ibnr.methods does (tail_decay, and tail for kind). It changes no number, and specs that differ only in it are equal.