Package: tidyactuarial 0.2.0

tidyactuarial: Tidy Tools for Actuarial Mathematics and Life Contingencies

Provides tidyverse-aligned tools for actuarial mathematics and life contingencies, including life tables, survival probabilities, actuarial present values of cash flows, life annuities, life insurance, premiums, reserves, multiple-life calculations, Monte Carlo simulation, collective risk models, insurance coverage, tail risk measures, and deterministic cash-flow diagrams. The package emphasizes clear actuarial notation, reproducible workflows, and pipe-friendly tools for actuarial education and applied actuarial analysis.

Authors:Julian Fajardo [aut, cre]

tidyactuarial_0.2.0.tar.gz
tidyactuarial_0.2.0.zip(r-4.7-any)tidyactuarial_0.2.0.zip(r-4.6-any)tidyactuarial_0.2.0.zip(r-4.5-any)
tidyactuarial_0.2.0.tgz(r-4.6-any)tidyactuarial_0.2.0.tgz(r-4.5-any)
tidyactuarial_0.2.0.tar.gz(r-4.7-any)tidyactuarial_0.2.0.tar.gz(r-4.6-any)
tidyactuarial_0.2.0.tgz(r-4.6-emscripten)
manual.pdf |manual.html✨
DESCRIPTION |NEWS
card.svg |card.png
tidyactuarial/json (API)

# Install 'tidyactuarial' in R:
install.packages('tidyactuarial', repos = c('https://julianfajardo1908.r-universe.dev', 'https://cloud.r-project.org'))

Bug tracker:https://github.com/julianfajardo1908/tidyactuarial/issues

Pkgdown/docs site:https://julianfajardo1908.github.io

Datasets:

On CRAN:

Conda:

4.78 score 296 downloads 102 exports 25 dependencies

Last updated from:2466fc143b. Checks:9 OK. Indexed: yes.

TargetResultTimeFilesSyslog
linux-develOK204
source / vignettesOK260
linux-releaseOK241
macos-releaseOK243
macos-oldrelOK212
windows-develOK218
windows-releaseOK231
windows-oldrelOK214
wasm-releaseOK115

Exports:a_angleA_xjaccrued_interestaccumulation_factoradd_insuranceadd_premium_scheduleaggregate_distributionaggregate_momentsamort_scheduleamort_schedule_generalannuity_arithannuity_geomannuity_multiannuity_xannuity_xyapply_coverageapv_life_flowbond_book_valuebond_callable_pricebond_cash_flowsbond_convexitybond_durationbond_pricebond_ytmbootstrap_spot_curvecollective_risk_speccommutation_tableconvexity_cash_flowcoverage_specdiscount_factordiscount_factor_spotdiscretize_severitydistribution_convolutiondistribution_momentsduration_cash_flowe_xe_xyempirical_frequencyempirical_severityforward_curveforward_ratefrequency_specfuture_valuefv_flowimmunize_durationimmunize_duration_convexityinsurance_variable_kinsurance_xinsurance_xjinsurance_xyinterest_equivalentsirr_flowirr_flow_multikm_lifetablelife_contractlifetablelt_taumc_annuitymc_insurancemc_lossmc_multilife_statusmc_premiummc_reservemd_tablemortality_law_tablepar_rateplot_cash_flowplot_contingent_cash_flowplot_immunization_gapplot_kmportfolio_convexityportfolio_durationpremium_grosspremium_xpremium_xypresent_valuepv_flowreserve_xreserve_xys_angleseverity_specsimulate_aggregatesimulate_annuity_xsimulate_frequencysimulate_insurance_xsimulate_lifetimesimulate_lifetimessimulate_severitysinking_fund_schedulesolve_valuestandardize_intereststop_loss_premiumsummary_mct_Ext_pxt_pxyt_qxt_qxjtail_value_at_riskto_payment_basisvalue_at_riskyield_curve

Dependencies:clicpp11dplyrfarvergenericsggplot2gluegtableisobandlabelinglifecyclemagrittrpillarpkgconfigR6RColorBrewerrlangS7scalestibbletidyselectutf8vctrsviridisLitewithr

Loans, Amortization, and General Payment Schedules
Introduction | $$B_t | $$\boxed{B_t | A level-payment loan | $$L | $$\boxed{R | \frac | $$i_p | \frac | $$50{,}000 | Interest, principal repayment, and the balance recurrence | $$I_t | $$A_t | $$I_1 | 50{,}000(0.01) | $$A_1 | 1{,}112.22-500 | $$B_1 | 50{,}000-612.22 | Prospective and retrospective balances | L(1+i)^t | Extra principal payments | General payment schedules | A loan with changing interest rates | $$120{,}000 | A payment rule that depends on the outstanding balance | $$A | $$R_t | \frac | $$R_1 | 833.33+0.01(50{,}000) | $$R_ | $$\text | Level payment versus constant principal | Negative amortization | Final actuarial reading

Last update: 2026-10-25
Started: 2026-09-14

Bonds, Duration, Convexity, and Immunization
Introduction | Bond cash flows and the value equation | $$P | Valuing a coupon bond | 45 | Yield to maturity as an inverse problem | $$935{,}000 | Book value | $$BV_t | P(1+i)^t | Callable bonds | $$P_s(i) | $$P_{\max}(i) | From price to sensitivity | $$P(i) | $$\frac | $$\frac | Duration and convexity of a cash-flow stream | $$w_j(i) | $$D_{\text{Mac}}(i) | $$D_{\text{mod}}(i) | -\frac | $$C(i) | A general cash-flow example | Specialization to bonds | Portfolio duration and convexity | From sensitivity to immunization | $$W_H(i) | $$\frac | The surplus function and Redington | $$S''(i_0) | An integrated immunization example | The immunization gap | Final actuarial reading

Last update: 2026-09-14
Started: 2026-09-14

Financial Mathematics with tidyactuarial
Introduction | Accumulation and discounting | $$\boxed{A(s,t) | $$\boxed{v(s,t) | \frac | $$A(s,t) | $$v(s,t) | $$a(t) | $$A(2,5) | \frac | $$v(2,5) | Equivalent interest-rate conventions | $$d | $$v | $$\delta | $$i^ | $$d^ | From financial factors to monetary values | $$FV | $$PV | 1000(1.06)^4 | Equations of value and focal dates | $$\boxed{\sum_{j=1}^{n}C_j A(t_j,f) | $$A(t_j,f) | $$\sum_ | Replacing two obligations by one payment | $$X | General cash-flow valuation | $$V(f) | $$V(0) | $$V(T) | Solving for an unknown date | $$V_0 | $$12000(1.08)^ | $$x | $$F(x) | From arbitrary cash flows to annuities | $$\boxed | $$\boxed{PV | Immediate and due annuities | $$a_ | $$PV\approx1000(7.721735) | $$\ddot | Accumulated values of level annuities | $$s_ | $$\boxed | Final financial reading

Last update: 2026-09-14
Started: 2026-09-14

Life Contingencies with tidyactuarial
From financial value to actuarial value | $${}_tE_x | A small life table | $$p_x | \frac{l_{x+1}}{l_x},\qquadq_x | 1-p_x | $${}_tp_x | \frac{l_{x+t}}{l_x},\qquad{}_tq_x | $$ | \frac | \frac | $$ | 1-0.9550 | Actuarial discounting: the pure endowment | $$ | $$ | \frac | A temporary life annuity-due | $$\ddot a_ | A temporary life insurance | $$ | $$A^ | An actuarial identity as an audit | $$A^ | 1 | d,\ddot a_ | $$d | Net premium by the equivalence principle | $$\operatorname{APV}(\text{premiums}) | $$P,\ddot a_ | $$P | Reserves: valuing the remaining contract | $${}_tV | \operatorname{APV}_t(\text{future benefits}) | $${}_2V | 100000A^ | The same contract as a pipe workflow | Moving to a benchmark life table | Final actuarial reading

Last update: 2026-09-14
Started: 2026-09-14

Readme and manuals

Help Manual

Help pageTopics
Level annuity factor a-angle-na_angle
Accrued coupon interest and clean/dirty bond pricesaccrued_interest
Accumulation factor under conventional or time-varying interestaccumulation_factor
Add an insurance benefit specification to a life contractadd_insurance
Add a contingent premium-payment schedule to a life contractadd_premium_schedule
Compute the aggregate loss distributionaggregate_distribution
Calculate moments of a collective aggregate lossaggregate_moments
Amortization schedule with optional prepayment adjustmentamort_schedule
General amortization schedule with variable rates and paymentsamort_schedule_general
Arithmetic annuity factorannuity_arith
Geometric annuity factorannuity_geom
Actuarial present value of a multi-life annuity (up to 3 independent lives)annuity_multi
Actuarial present value of a life annuityannuity_x
Actuarial present value of a two-life annuityannuity_xy
Apply an insurance contract to a loss severity specificationapply_coverage
Actuarial present value of a payment stream under mortalityapv_life_flow
Book value of a level coupon bond at a coupon datebond_book_value
Price of a callable bond at a target minimum yieldbond_callable_price
Cash flow structure of a level coupon bondbond_cash_flows
Discrete convexity of a level coupon bond under a flat yieldbond_convexity
Macaulay and modified duration of a level coupon bond under a flat yieldbond_duration
Price of a level coupon bond from its yieldbond_price
Yield to maturity of a level coupon bondbond_ytm
Sample bond contracts for fixed-income examplesbonds_sample
Bootstrap a spot yield curve from instrument pricesbootstrap_spot_curve
Sample cash flows for interest theory examplescash_flows_sample
Specify a collective risk modelcollective_risk_spec
Build an annual commutation table (discrete ages)commutation_table
Convexity of a general cash-flow streamconvexity_cash_flow
Specify an insurance coverage contractcoverage_spec
Discount factor under conventional or time-varying interestdiscount_factor
Spot discount factordiscount_factor_spot
Discretize a continuous claim severity distributiondiscretize_severity
Specify a convolution of probability distributionsdistribution_convolution
Calculate moments of a frequency or severity distributiondistribution_moments
Duration of a general cash-flow streamduration_cash_flow
Expected future lifetime from an annual life tablee_x
Expected future lifetime for two independent livese_xy
Specify an empirical claim frequency distributionempirical_frequency
Specify an empirical claim severity distributionempirical_severity
Construct a forward-rate curve from spot ratesforward_curve
Compute an implied forward rate from a discrete spot curveforward_rate
Specify a claim frequency distributionfrequency_spec
Future value of a single paymentfuture_value
Future value of a general cash flowfv_flow
Duration-based immunization with multiple assetsimmunize_duration
Duration and convexity immunization with multiple assetsimmunize_duration_convexity
Actuarial present value of a life insurance with variable k-thly benefitsinsurance_variable_k
Actuarial present value of a life insuranceinsurance_x
Cause-specific term/whole-life insurance APV under multiple decrementsA_xj insurance_xj
Actuarial present value of a two-life insuranceinsurance_xy
Equivalent interest rates in FM actuarial notationinterest_equivalents
Internal rate of return for a cash flowirr_flow
Multiple internal rates of return for a cash flowirr_flow_multi
Kaplan-Meier survival curve and a lifetable-style life tablekm_lifetable
Create a life-contingency contract specificationlife_contract
Build an annual life table (tidy tibble) from lx, qx, px, or mxlifetable
Sample loan contracts for amortization examplesloans_sample
Total-decrement lifetable from a multiple decrement table: lt_tault_tau
Compute simulated present values for life annuitiesmc_annuity
Compute simulated present values for life insurance benefitsmc_insurance
Compute Monte Carlo loss random variables for life contingenciesmc_loss
Compute multiple-life simulated status variablesmc_multilife_status
Compute Monte Carlo net premiums for life contingenciesmc_premium
Compute Monte Carlo prospective reserves for life contingenciesmc_reserve
Multiple decrement table (annual, discrete ages)md_table
Colombian mortality tablesmortality_colombia_tables
Generate a tidy life table from a theoretical mortality lawmortality_law_table
World mortality sample panel, 2015-2023mortality_world_sample_2015_2023
World mortality sample, 2023mortality_world_sample_2023
Sample multiple decrement probabilitiesmultiple_decrement_sample
Par coupon rate implied by a spot yield curvepar_rate
Plot a cash-flow diagramplot_cash_flow
Plot discrete life-contingent cash flowsplot_contingent_cash_flow
Plot immunization performance under interest-rate shiftsplot_immunization_gap
Plot a Kaplan-Meier survival curveplot_km
Compute portfolio convexity as a market-value-weighted averageportfolio_convexity
Compute portfolio duration as a market-value-weighted averageportfolio_duration
Gross premium under a simple expense-loaded equivalence principlepremium_gross
Net premium for single-life insurance by the equivalence principlepremium_x
Net premium for two-life insurance by the equivalence principlepremium_xy
Present value of a single paymentpresent_value
Print an aggregate loss distributionprint.tidyact_aggregate_distribution
Print a collective risk model specificationprint.tidyact_collective_risk_spec
Print a convolution specificationprint.tidyact_convolution_spec
Print a frequency distribution specificationprint.tidyact_frequency_spec
Print a payment severity specificationprint.tidyact_payment_spec
Print a severity distribution specificationprint.tidyact_severity_spec
Present value of a general cash flowpv_flow
Benefit reserves for single-life insurancereserve_x
Benefit reserves for two-life insurancereserve_xy
Level annuity accumulation factor s-angle-ns_angle
Specify an individual claim severity distributionseverity_spec
Simulate a collective risk modelsimulate_aggregate
Monte Carlo simulation of a life annuitysimulate_annuity_x
Simulate claim counts from a frequency modelsimulate_frequency
Monte Carlo simulation of a life insurancesimulate_insurance_x
Simulate future lifetimes from a life tablesimulate_lifetime
Simulate future lifetimes for multiple livessimulate_lifetimes
Simulate individual claim severitiessimulate_severity
Sinking fund amortization schedule for a loansinking_fund_schedule
SOA Illustrative Life Tablesoa08lt
Solve a scalar equation of valuesolve_value
Standardize an interest rate to the annual effective rate istandardize_interest
Net stop-loss premiumstop_loss_premium
Summarise Monte Carlo simulation outputsummary_mc
Pure endowment (discounted survival): {}_tE_xt_Ex
t-year survival probability from a life tablet_px
Two-life survival probability for independent livest_pxy
t-year death probability from a life tablet_qx
t-year probability of decrement by cause j: t_qxjt_qxj
Tail Value at Risk (Expected Shortfall)tail_value_at_risk
Specify a change from per-loss to per-payment basisto_payment_basis
Value at Risk for actuarial lossesvalue_at_risk
Validate a yield curve and compute discount factorsyield_curve