Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jimbrig/lossrx
An R package, plumber API, database, and Shiny App for Actuarial Loss Development and Reserving Workflows.
https://github.com/jimbrig/lossrx
actuarial-science claims-data claims-reserving data-science insurance modelling property-casualty reserving rpackage rshiny rstats workflow
Last synced: 3 months ago
JSON representation
An R package, plumber API, database, and Shiny App for Actuarial Loss Development and Reserving Workflows.
- Host: GitHub
- URL: https://github.com/jimbrig/lossrx
- Owner: jimbrig
- License: other
- Created: 2021-10-26T16:14:20.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-08-06T20:09:35.000Z (3 months ago)
- Last Synced: 2024-08-07T00:28:43.929Z (3 months ago)
- Topics: actuarial-science, claims-data, claims-reserving, data-science, insurance, modelling, property-casualty, reserving, rpackage, rshiny, rstats, workflow
- Language: R
- Homepage: https://docs.jimbrig.com/lossrx/
- Size: 38.2 MB
- Stars: 10
- Watchers: 4
- Forks: 1
- Open Issues: 6
-
Metadata Files:
- Readme: README.Rmd
- Changelog: CHANGELOG.md
- License: LICENSE
- Codemeta: codemeta.json
Awesome Lists containing this project
- jimsghstars - jimbrig/lossrx - An R package, plumber API, database, and Shiny App for Actuarial Loss Development and Reserving Workflows. (R)
README
---
output: github_document
---
```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
out.width = "100%"
)
```
# lossrx 
[](https://github.com/jimbrig/lossrx/actions)
[](https://lifecycle.r-lib.org/articles/stages.html#experimental)
[](http://www.repostatus.org/#wip)
*View the [Changelog](inst/CHANGELOG.md) for detailed progression on development of the package.*
*View the [Latest Database Documentation](https://dbdocs.io/jimbrigf0cdc6204e/Actuarial-Database) for a detailed look into its structure.*
## Contents
**Table of Contents**
- [Overview](#overview)
- [Installation](#installation)
- [Data](#data)
- [Data Preparation](#data-preparation)
- [Database](#database)
## Overview
The desired outcome of the `lossrx` R package is to provide actuaries and data scientists valuable tools and frameworks for performing Property Casualty related workflows.
Specifically, the package will contain:
- A suite of utility and workflow oriented functions bundled as an R package
- A plumber API that serves various endpoints related to a backend database and models
- A comprehensive, yet simple migration-friendly relational database representing the various entities, attributes, and relationships involved with actuarial reserving.[^1]
- A demo Shiny App for Actuarial Loss Development and Reserving including triangles, loss development factor selection, preliminary ultimates, etc. and a backend database/API to store results and selections.
- Comprehensive documentation and tests
## Installation
You can install the development version of `lossrx` with `pak`: [^2]
```r
pak::pak("jimbrig/lossrx")
```
## Data
### Data Preparation
This package utilizes a lot of data and in turn has a lot of code inside the [data-raw](data-raw) folder. I recommend taking a look at its [README](data-raw/README.md) to gain an understanding of how the data was prepared for both use in the package as well as included and uploaded to the database.
Data is prepared in the following ways:
- Simulated transactional claims data using the [claims_transactional.R Simulation R Script](https://github.com/jimbrig/lossrx/blob/main/data-raw/scripts/claims_transactional.R)
- Downloaded and extracted using ropensci's [piggyback package](https://github.com/ropensci/piggyback) - see the [dataprep.R Script](https://github.com/jimbrig/lossrx/blob/main/data-raw/scripts/dataprep.R).
- Supplemental *mocked data* generated using the [Mockaroo API](https://www.mockaroo.com/) for randomizing certain data attribute's.
- Uploaded and merged into the relational database using `SQL`, `R`, `CSVs`, and `YAML` files (see below about database details).
- Certain datasets are budled and included with the package as native `.rda` packaged data files.
### Database
*View Detailed [Database Documentation](https://dbdocs.io/jimbrigf0cdc6204e/Actuarial-Database) created via `dbdocs`*
The core database files are housed in the [inst/database](inst/database) directory and are included on package installation.
[^1]: See the [database container package](https://github.com/jimbrig/lossrx/pkgs/container/actuarialdb) for details on how to run the database as a container image.
[^2]: Similarly, you can install the package using the more common `devtools::install_github()` and `remotes::install_github()`
## Checks
Latest `R CMD CHECK`:
```R
-- R CMD check results -------------------------------------- lossrx 0.0.2 ----
Duration: 1m 19.3s
0 errors v | 0 warnings v | 0 notes v
R CMD check succeeded
```
> Jimmy Briggs | 2022