split_relativities: Construct a relativities mapping for level splitting

In insurancerating: Actuarial Tools for Insurance Pricing Models

Construct a relativities mapping for level splitting

Description

Helper function to create a standardized data.frame defining relativities for sublevels within a risk factor level. This function is intended to be used as input for add_relativities().

Usage

split_relativities(new_levels, relativities)

Arguments

new_levels	Character vector. Names of the new sublevels.
relativities	Numeric vector. Relativities corresponding to each sublevel. Must have the same length as new_levels.

Details

This function provides a convenient and safe way to construct the required input structure for add_relativities(). Each call defines how a single level of a risk factor is split into multiple sublevels with corresponding relativities.

Value

A data.frame with columns:

new_level

Character. Name of the new sublevel.

relativity

Numeric. Multiplicative factor relative to the base level.

Examples

split_relativities(
  new_levels = c("residential", "commercial", "civil"),
  relativities = c(1.00, 1.10, 1.25)
)

insurancerating documentation built on July 30, 2026, 5:09 p.m.