# Introducing PySurvival

### PySurvival is an open source python package for Survival Analysis modeling.

## PySurvival is an open source python package for Survival Analysis modeling.

Today, we’re excited to introduce **PySurvival**, a python package for Survival Analysis modeling.

This article is the first installment in a four part series, which will include tutorials designed to demonstrate how to easily make the most of the package. You can also find these tutorials on the official website:

*PySurvival Logo*

## What is PySurvival ?

PySurvival is an open source python package for Survival Analysis modeling — the modeling concept used to analyze or predict when an event is likely to happen. It is built on top the most commonly used machine learning packages: NumPy, SciPy, and PyTorch.

PySurvival provides a very easy way to navigate between theoretical knowledge on Survival Analysis and detailed tutorials on how to conduct a full analysis, as well as build and use a model. The package contains:

- 10+ models ranging from the Cox Proportional Hazard model and the Neural Multi-Task Logistic Regression, to Random Survival Forest
- Summaries of the theory behind each model as well as API descriptions and examples
- Detailed tutorials on how to perform exploratory data analysis, survival modeling, cross-validation and prediction, for churn modeling and credit risk, for example
- Performance metrics to assess the models’ abilities like c-index or brier score
- Simple ways to load and save models

## Installation

If you have already installed a working version of gcc, the easiest way to install Pysurvival is using pip.

```
pip install pysurvival
```

The complete installation steps can be found here.

## Introduction to Survival analysis

### What is Survival Analysis ?

** Survival analysis is used to analyze or predict when an event is likely to happen**. It originated in medical research, but its use has greatly expanded to many different fields. For instance:

- Banks, lenders and other financial institutions use it to predict the speed of repayment of loans
- Businesses use it to predict when a client will churn
- Companies use it to predict when employees will decide to leave
- Engineers/manufacturers use it to predict when a machine will break

### Censoring: why regression models cannot be used?

The real strength of Survival Analysis is its capacity to handle situations when the event has not happened yet. To illustrate this, let’s take the example of two customers of a company and follow their active/churn status between January 2018 and April 2018:

*Figure 1 — Example of censoring*

**customer A**started doing business prior to the time window, and as of April 2018, is still a client of the company**customer B**also started doing business before January 2018, but churned in March 2018

Here, we have an explicit depiction of the event for customer B. However, we have no information about customer A, except that he/she hasn’t churned yet at the end of the January 2018 to April 2018 time window. This situation is called **censoring**.

One might be tempted to use a regression model to predict when events are likely to happen. But to do that, one would need to disregard censored samples, which would result in a loss of important information. Fortunately, Survival models are able to take censoring into account and incorporate the uncertainty, so that instead of predicting ** the time** of an event, we predict

**.**

*the probability that an event happens at a particular time**PySurvival Logo*