Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time
November 16, 2022 22:43
June 25, 2022 14:07
August 4, 2019 12:52
August 8, 2020 16:40
November 16, 2022 22:40
July 10, 2020 15:53
August 9, 2020 17:41
November 16, 2022 22:41
August 18, 2021 09:53
August 4, 2017 23:51
December 15, 2019 10:11
July 7, 2020 10:13
November 6, 2022 14:08
July 10, 2020 15:53
November 16, 2019 18:04
November 16, 2022 22:39

PyPI version Anaconda-Server Badge DOI

What is survival analysis and why should I learn it? Survival analysis was originally developed and applied heavily by the actuarial and medical community. Its purpose was to answer why do events occur now versus later under uncertainty (where events might refer to deaths, disease remission, etc.). This is great for researchers who are interested in measuring lifetimes: they can answer questions like what factors might influence deaths?

But outside of medicine and actuarial science, there are many other interesting and exciting applications of survival analysis. For example:

  • SaaS providers are interested in measuring subscriber lifetimes, or time to some first action
  • inventory stock out is a censoring event for true "demand" of a good.
  • sociologists are interested in measuring political parties' lifetimes, or relationships, or marriages
  • A/B tests to determine how long it takes different groups to perform an action.

lifelines is a pure Python implementation of the best parts of survival analysis.

Documentation and intro to survival analysis

If you are new to survival analysis, wondering why it is useful, or are interested in lifelines examples, API, and syntax, please read the Documentation and Tutorials page



See our Contributing guidelines.