Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/HealthCatalyst/healthcareai-r

R tools for healthcare machine learning
https://github.com/HealthCatalyst/healthcareai-r

healthcare machine-learning r

Last synced: about 1 month ago
JSON representation

R tools for healthcare machine learning

Awesome Lists containing this project

README

        

---
output: github_document
---

```{r, include = FALSE}
knitr::opts_chunk$set(collapse = TRUE, comment = "# >",
fig.height = 3, fig.width = 6, dpi = 96,
fig.path = "man/figures/README-")
options(tibble.print_max = 5)
library(healthcareai)
set.seed(6751)
```

# healthcareai

[![Appveyor Build Status](https://ci.appveyor.com/api/projects/status/0xrpe233o9a16l4l/branch/master?svg=true)](https://ci.appveyor.com/project/CatalystAdmin/healthcareai-r/)
[![Travis-CI Build Status](https://travis-ci.org/HealthCatalyst/healthcareai-r.svg?branch=master)](https://travis-ci.org/HealthCatalyst/healthcareai-r)
[![codecov badge](https://codecov.io/gh/HealthCatalyst/healthcareai-r/branch/master/graph/badge.svg)](https://codecov.io/gh/HealthCatalyst/healthcareai-r)
[![CRAN_Status_Badge](https://www.r-pkg.org/badges/version-last-release/healthcareai)](https://cran.r-project.org/package=healthcareai)
[![CRAN downloads badge](https://cranlogs.r-pkg.org/badges/grand-total/healthcareai)](https://cranlogs.r-pkg.org/badges/last-week/healthcareai)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/HealthCatalystSLC/healthcareai-r/blob/master/LICENSE)
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.999334.svg)](https://doi.org/10.5281/zenodo.999334)

## Overview

The aim of `healthcareai` is to make machine learning in healthcare as easy as possible. It does that by providing functions to:

- Develop customized, reliable, high-performance machine learning models with minimal code
- Easily make and evaluate predictions and push them to a database
- Understand how a model makes its predictions
- Make data cleaning, manipulation, imputation, and visualization as simple as possible

## Usage

`healthcareai` can take you from messy data to an optimized model in one line of code:

```{r, message = FALSE}
models <- machine_learn(pima_diabetes, patient_id, outcome = diabetes)
models
```

Make predictions and examine predictive performance:

```{r plot_predictions}
predictions <- predict(models, outcome_groups = TRUE)
plot(predictions)
```

## Learn More

For details on what's happening under the hood and for options to customize data preparation and model training, see [Getting Started with healthcareai](https://docs.healthcare.ai/articles/site_only/healthcareai.html) as well as the helpfiles for individual functions such as `?machine_learn`, `?predict.model_list`, and `?explore`.

Documentation of all functions as well as vignettes on various uses of the package are available at the package website: https://docs.healthcare.ai/.

Also, be sure to read our [blog](http://healthcare.ai/blog/) and watch our [broadcasts](https://www.youtube.com/channel/UCGZUobs_x712KbcL6RSzfnQ) to learn more about what's new in healthcare machine learning and how we are using this toolkit to put machine learning to work in real healthcare systems.

## Get Involved

We have a [Slack community](https://healthcare-ai.slack.com/) that is a great place to introduce yourself, share what you're doing with the package, ask questions, and troubleshoot your code.

### Contributing

If you are interested in contributing the package (great!), please read the [contributing](https://github.com/HealthCatalyst/healthcareai-r/blob/master/CONTRIBUTING.md) guide, and look for [issues with the "help wanted" tag](https://github.com/HealthCatalyst/healthcareai-r/labels/help%20wanted). Feel free to tackle any issue that interests you; those are a few issues that we feel would make a good place to start.

### Feedback

Your feedback is hugely appreciated. It is makes the package work well and helps us make it more useful to the community. Both feature requests and bug reports should be submitted as [Github issues](https://github.com/HealthCatalyst/healthcareai-r/issues/new).

**Bug reports** should be filed with a [minimal reproducable example](https://gist.github.com/hadley/270442). The [reprex package](https://github.com/tidyverse/reprex) is extraordinarily helpful for this. Please also include the output of `sessionInfo()` or better yet, `devtools::session_info()`.

## Legacy

Version 1 of `healthcareai` has been retired. You can continue to use it, but its compatibility with changes in the R ecosystem are not guaranteed. You should always be able to install it from github with: `install.packages("remotes"); remotes::install_github("HealthCatalyst/[email protected]")`.

For an example of how to adapt v1 models to the v2 API, check out the [Transitioning vignettes](https://docs.healthcare.ai/articles/site_only/transitioning.html).