rslife 0.2.0

A comprehensive Rust library for actuarial mortality table calculations and life insurance mathematics
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89

//! # RSLife Basic Usage Example
//!
//! This example demonstrates the basic usage of the rslife crate
//! for actuarial calculations using the new builder pattern API.

use rslife::prelude::*;

fn main() -> RSLifeResult<()> {
    println!("RSLife Basic Usage Example");
    println!("==========================");
    println!();

    // Load mortality data
    println!("Loading mortality table...");
    let mort_data = MortData::from_soa_url_id(1704)?;

    // Method 1: Create mortality table configuration using builder pattern
    println!("Creating MortTableConfig using builder pattern...");
    let mt_config = MortTableConfig::builder()
        .data(mort_data.clone())
        .radix(100_000)
        .pct(1.0)
        .assumption(AssumptionEnum::UDD)
        .build()
        .unwrap();

    // Method 2: Create another config with different settings using builder pattern
    println!("Creating second MortTableConfig with different settings (CFM)...");
    let mt_config_cfm = MortTableConfig::builder()
        .data(mort_data.clone())
        .radix(100_000)
        .pct(0.75) // Reduced mortality
        .assumption(AssumptionEnum::CFM) // Different assumption
        .build()
        .unwrap();

    println!("✓ Mortality table configured with both UDD and CFM assumptions");
    println!();

    // Life insurance calculations using builder pattern
    println!("\n=== Life Insurance Calculations (UDD assumption, age 30) ===");
    let term_10 = Ax1n().mt(&mt_config).i(0.03).x(30).n(10).call()?;
    let term_20 = Ax1n().mt(&mt_config).i(0.03).x(30).n(20).call()?;
    let endowment_15 = Axn().mt(&mt_config).i(0.03).x(30).n(15).call()?;

    println!("Life Insurance:");
    println!("  10-year term (Ax1n): {term_10:.6}");
    println!("  20-year term (Ax1n): {term_20:.6}");
    println!("  15-year endowment (Axn): {endowment_15:.6}");

    // Annuity calculations using CFM assumption
    println!("\n=== Annuity Calculations (CFM assumption, age 40) ===");
    let annuity_due = aaxn().mt(&mt_config_cfm).i(0.04).x(40).n(15).call()?;
    let life_annuity = aax().mt(&mt_config_cfm).i(0.04).x(40).call()?;

    println!("Annuities:");
    println!("  15-year annuity due: {annuity_due:.6}");
    println!("  Life annuity due: {life_annuity:.6}");

    // Survival probability calculations
    println!("\n=== Survival Calculations (direct MortTableConfig calls) ===");
    let survival_10_years = tpx().mt(&mt_config).x(30.0).t(10.0).k(0.0).call()?;
    let mortality_10_years = tqx().mt(&mt_config).x(30.0).t(10.0).k(0.0).call()?;

    println!("Survival calculations (10 years, age 30):");
    println!("  Survival probability (tpx): {survival_10_years:.6}");
    println!("  Mortality probability (tqx): {mortality_10_years:.6}");
    println!(
        "  Sum (should be 1.0): {:.6}",
        survival_10_years + mortality_10_years
    );

    // Demonstrate fractional ages and times
    println!("\n=== Fractional Age and Time Calculations ===");
    let fractional_survival = tpx()
        .mt(&mt_config)
        .x(45.5) // Fractional age
        .t(2.75) // Fractional time
        .call()?;

    println!("Fractional calculations:");
    println!("  2.75-year survival from age 45.5: {fractional_survival:.6}");

    println!("\n✓ All calculations completed successfully!");
    println!("✓ Demonstrated both UDD and CFM mortality assumptions!");
    println!("✓ Showcased flexible builder pattern with optional parameters!");

    Ok(())
}