https://github.com/kasaai/conjuror
Uniform interface for synthesizing insurance data
https://github.com/kasaai/conjuror
actuarial-science insurance rstats
Last synced: 4 months ago
JSON representation
Uniform interface for synthesizing insurance data
- Host: GitHub
- URL: https://github.com/kasaai/conjuror
- Owner: kasaai
- License: other
- Created: 2019-08-11T17:51:43.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2019-09-19T04:55:55.000Z (over 5 years ago)
- Last Synced: 2024-08-13T07:13:25.370Z (8 months ago)
- Topics: actuarial-science, insurance, rstats
- Language: R
- Homepage: https://conjuror.kasa.ai
- Size: 54.7 KB
- Stars: 4
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- jimsghstars - kasaai/conjuror - Uniform interface for synthesizing insurance data (R)
README
# conjuror
[](https://www.tidyverse.org/lifecycle/#experimental)
[](https://travis-ci.org/kasaai/conjuror)
## Overview
Data simulators are important for advancing insurance research because publicly available datasets from industry are scarce. The conjuror package and conventions aim to unify the interfaces of data simulation packages and make them more accessible to researchers and practitioners. It provides a set of standardized methods and functions for package authors to implement and use, along with a set of principles for each research discipline developed with input from the community.
## Framework
The main class in conjuror is `charm`, representing a specification that includes parameters needed to define a simulation run. The conjuror package provides the `scribe()` function as the constructor of charms, and package authors can call it from a user-facing helper function. The `conjure()` method is an S3 generic, which should be implemented for each charm class. In other words, a simulation package should provide at least two user-facing functions:
1. A helper function, e.g. `my_simulator()`, that takes user-input parameters and returns an object of class `c("my_simulator", "charm")`.
2. A `conjure.my_simulator()` method that performs the actual simulation.
It is expected that parameters related to mathematical properties of the simulation be defined in the constructor, while parameters dealing with runtime behavior, such as random seeds and parallelism, be defined in the `conjure()` method.
## Example
See the [simulationmachine](https://github.com/kasaai/simulationmachine) package for a sample implementation of the conjuror interface.
## Installation
You can install the current development version of conjuror from GitHub with
``` r
remotes::install_github("kasaai/conjuror")
```